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