LFRM

NAME

lfrm - remove a logical RMS data and definition file

SYNOPSIS

lfrm [ -vx] [ logicalfile ]

DESCRIPTION

Lfrm removes a logical RMSfile that is no longer needed. In addition to removing the RMS data file, lfrm also removes the RMS data dictionary file, the RMS definition file, any indices, and the catalog entry for the logical RMSfile. Once removed, the RMSfile is no longer accessible to any program.

The following flags apply to lfrm:

-v Displays progress information on standard output.

-x Displays on standard output the commands run by lfrm.

If the logicalfile argument is omitted, a parameter form is displayed requesting the name of the logical RMSfile to be removed. This form accepts input in the same manner as form(C-1).

Lfrm will only remove logical RMSfiles that are contained within a directory named data. The directory containing the .\data directory must also contain a directory named .\def. When locating the definition file, the definition file name is configured from the RMSfile name by swapping the data directory name with the def directory name. A definition file will only be removed if it has the same name as the data file. If no definition file exists, a warning message is displayed.

FILES

data\datafile

def\deffile

SEE ALSO

deletelf(C-1), form(C-1), filedef(C-1), lfedit(C-1), lfupd(C-1), makelf(C-1).

NOTES

If the logical RMSfile is not contained within a directory named data, the RMSfile and RMS definition file must be removed separately. The RMSfile is removed by running deletelf (C-1). This command performs some of the same function as lfrm, except that the RMS definition file is not removed. The definition file would have to be first located, then removed with the rm(C-1) command.