DBUPD C-1





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



NAME


dbupd - update the database catalog

SYNOPSIS


dbupd -a [-v] [-C comment ] [-L logfile ] -H homedir dbname
dbupd -d [-v] dbname
dbupd -u [-v] [-C comment ] [-H homedir ] [-L logfile ] dbname

DESCRIPTION


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

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

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

-a 	Adds an entry for the named database to the database catalog.  
	Dbname specifies the name of the database.  An entry in the 
	database catalog cannot already exist for dbname.  The -H flag 
	must be supplied when adding a database entry to the database 
	catalog.  The argument homedir supplied with the -H flag specifies
	the home directory of the database.  This directory must be an 
	absolute pathname and it must exist prior to performing this 
	operation.

	The optional flags -C and -L are available to initialize catalog
	fields.  The -C flag initializes the description catalog field.  
	If it is omitted, the description is set to null. The -L flag names
	the optional logfile that is stored in the database catalog.  If it
	is omitted, the logfile is set to null.

-d 	Deletes the database entry for dbname from the database catalog.
	This does not remove the actual database, only the database catalog
	entry.  Before a database entry can be removed, all logical RMSfiles, 
	reportfiles and formfiles for that database must be removed.

	With the -d flag, only users that can remove the home directory of 
	dbname can remove the database entry from the database catalog.

-u 	Updates the database catalog entry for the defined database dbname.  
	At least one of the optional flags (-C, -H, or -L) must be supplied 
	when updating a database entry.

The meanings of the optional flags are:

-v 	Displays progress information on standard output.

-C comment
	Supplies the description of dbname that is recorded with the 
	database catalog entry.  This description is not needed or used 
	by the system.  The argument comment is requied with the -C flag 
	and must be quoted if embedded with blanks, tabs or newlines.  If
	this flag is omitted when adding or creating a database, the 
	description is set to null.  If this flag is omitted when the 
	update (-u) flag is specified, the description for the database 
	is unchanged.

-H homedir
	Names the home directory pathname for the database dbname.  This 
	option is used only with the update (-u) flag.  Homedir must be 
	specified as an absolute pathname (e.q. /usr/cbase/demo and must
	exist before attempting to change the home directory for dbname.

-L filename
	Names the pathname for a file used in recording changes made to any 
	logical RMSfile defined for dbname.  When adding or updating a 
	database entry, the file used for logging must exist prior to 
	running this command.  When creating a database with the -c flag,
	the logfile is created.  The filename can be specified as an 
	absolute pathname (e.q. /usr/cbase/demo/logfile), or a pathname 
	relative to the home directory of the database.

SEE ALSO


dblist(C-1), dbfile(C-1), dbhome(C-1), dbadd(C-1), dbcreate(C-1), 
dbremove(C-1), dbrm(C-1), dbadmin(C-1).