LFEDIT C-1





Copyright (C) 1994-95 Conetic Software Systems, Inc. All names, products, and services mentioned are the trademarks of their respective organizations.



NAME


lfedit - create or maintain logical RMSfile definitions

SYNOPSIS


lfedit [-vx] [ lfname ]
lfedit -c [-evx] [-C comment ] [-D directory ] [ lfname b

DESCRIPTION


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

SEE ALSO


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.

NOTES


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.