LFUPD C-1





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



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

SEE ALSO


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