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.
-C comment
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.
-D directory
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).
FILES
data/datafile
def/deffile
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.