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).




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)