dbupd - update the database catalog
dbupd -a [-v] [-C comment ] [-L logfile ] -H homedir dbname dbupd -d [-v] dbname dbupd -u [-v] [-C comment ] [-H homedir ] [-L logfile ] dbname
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.
dblist(C-1), dbfile(C-1),
dbhome(C-1), dbadd(C-1),
dbcreate(C-1),
dbremove(C-1), dbrm(C-1),
dbadmin(C-1).