lfedit - create or maintain logical RMSfile definitions
lfedit [-vx] [ lfname ]
lfedit -c [-evx] [-C comment ] [-D directory ] [ lfname b
Lfedit creates or modifies the definition for a logical RMSfile. Lfname names the logical RMSfile. A logical RMSfile has three parts, the RMS definition file, the RMSfile, and an entry in the RMSfile catalog.
When lfedit is invoked with -C, the RMSfile is created if it does not already exist. If the create (-C) flag is omitted, the existing RMSfile for lfname is modified.
Invoking lfedit on a logical RMSfile first either creates or modifies the RMS definition file of lfname with the filedef(C-1) command. The RMS definition file contains the description for an RMS data file. This description defines the type of data organization that is used, field definitions for the RMSfile, and definitions of primary and optional secondary key fields. Once the RMS definition file has been created or modified, the RMSfile is either created or converted to the new definition description. If the logical RMSfile is being created, an entry in the RMSfile catalog is added.
The following flags apply to lfedit:
-c Creates the logical RMSfile lfname. An entry in the RMSfile catalog cannot already exist for lfname. To create the RMSfile, filedef(C-1) is invoked to create the RMS definition file. Once the definition file has been created, an empty RMSfile is created and a logical RMSfile entry for lfname is added to the RMSfile catalog. If a file exists in the named directory that matches the logical name, or the name is too long for a file entry, a unique name is generated for RMSfile's pathname.
The optional flags -e, -C and -D apply only with the create (-c) flag.
-e Enters expert mode by displaying a parameter form and allows input of arguments that are available with lfedit. This flag only applies when the create (-c) flag has been specified with a logical RMSfile that does not already exist. The parameter form accepts input in the same manner as form(C-1).
-v Displays progress information on standard output.
-x Displays on standard output commands run by lfedit.
Supplies the description of lfname that is stored with the logical RMSfile entry. If the -C flag is specified. The argument comment is required and must be quoted if embedded with blanks, tabs or newlines. If this flag is omitted, the description is set to null.
Names the directory to contain the new RMSfile. The new RMSfile must reside within a directory named data. This directory must be an absolute pathname or a pathname relative to the database's home directory. The directory containing the '.\data' directory must also contain a directory named '.\def. The '.\def directory contains the RMS definition file for the new logical RMSfile. If the -D flag is not specified, the directory data (relative to the database's home directory) is used.
If the argument lfname is omitted, a parameter form is displayed requesting the name of the logical RMSfile name. This form accepts input in the same manner as form(C-1).
form(C-1), filedef(C-1), lfadmin(C-1), lfupd(C-1), createlf(C-1), makelf(C-1), expandlf(C-1), convrtlf(C-1).
Chapter 4, Creating RMSfiles.
If the logical RMSfile is not contained within a directory named data or the RMS definition file is not contained within a directory name def, the RMS definition file and RMSfile must be maintained separately (not using lfedit(C-1). The RMS definition file would be maintained with filedef(C-1). The RMSfile can either be created with createlf(C-1) or makelf(C-1). If the RMS definition file has been modified, the RMSfile needs to be converted to the new definition with the convrtlf(C-1) command.