lfupd - update the logical RMSfile catalog
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
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 logg-ing 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. /usr/cbase/demo/mag), or a
pathname relative to the home directory of the database (e.q.
data/mag).
addlf(C-1), dblist(C-1),
dbfile)C-1), createlf(C-1), removelf(C-1),
makelf(C-1), lfadmin(C-1).