LFUPD

NAME

lfupd - update the logical RMSfile catalog

SYNOPSIS

lfupd -a [-v] [-C comment ] [-L boolean ] [-R boolean ] -S sysname lfile

lfupd -d [-v] lfile

lfupd -u [-v] [-C comment ] [-L boolean ] [-R boolean ] [-S sysname ] lfile

DESCRIPTION

This command is for internal RMSfile catalog maintenance only. It is run only by other C/Base commands. Use the lfadmin(C-1) command for general RMSfile catalog manipulation.

Each invocation of lfupd either adds, updates or deletes a logical RMSfile entry from the RMSfile catalog. It is the only C/Base command that physically alters the logical RMSfile catalog.

One of the following flags must be specified to indicate the operation to be performed by lfupd:

-a Adds an entry for the named logical RMSfile to the RMSfile catalog. Lfile specifies the name of the logical RMSfile. The -S flag must be supplied when adding a logical RMSfile entry to the RMSfile catalog. The argument sysname supplied specifies the pathname of the RMS data file. This can be an absolute pathname or a pathname relative to the home directory of the database.

The optional flags -C, -L and -R are available to initialize catalog fields. If the -C flag is omitted, the description field is set to null. If the -R flag is omitted, the real file field is set to the boolean value yes. If the -L flag is omitted, the logging status field for lfile is set to the boolean value no.

-d Deletes the logical RMSfile entry for lfile from the RMSfile catalog. The RMS data and definition file is not removed from the system.

-u Updates the catalog entry for the existing logical RMSfile lfile. At least one optional flag (-C, -L, -R, or -S) must be supplied when updating a logical RMSfile entry.

The meanings of the optional flags are:

-v Display progress information on standard output.

-C comment

Supplies the description of lfile that is stored with the logical RMSfile entry. If the -C flag is specified, comment is required and must be quoted if embedded with blanks, tabs or newlines. If this flag is omitted when adding a logical RMSfile, the description is set to null. If this flag is omitted when the -u flag is specified, the description for the logical RMSfile is unchanged.

-L boolean

Specifies the logging status of lfile. The logging status for an RMSfile indicates whether changes to the RMS data file are to be logged. Boolean is either set to yes, log changes made to the RMS data file, or no, do not log such changes. If the logging status is set to yes, the named database must have defined a logfile. The default value for the logging status is no.

-R boolean

Specifies the real file status for an RMSfile. For now, this value must be yes, which is the default value.

-S sysname

Names the system pathname for the logical RMSfile lfile. Sysname can be an absolute pathname (e.q. \cbase\demo\mag), or a pathname relative to the home directory of the database (e.q. data\mag).

SEE ALSO

addlf(C-1), dblist(C-1), dbfile)C-1), createlf(C-1), removelf(C-1), makelf(C-1), lfadmin(C-1).