DBADD C-1

NAME

dbadd - add a database definition

SYNOPSIS

dbadd dbname homedir [ logfile ] [ description ]

DESCRIPTION

This command is for internal database catalog maintenance only. It is run only by other C/Base commands. To create a database, use the -c (create) flag with the dbadmin(C-1) command. Dbadd adds a definition for a new database to the C/Base database catalog. Adding a definition only defines the database, it does not create the database. This command is intended for converting older applications to C/Base. Dbname gives the name of the database. It can be up to 32 characters long and should not contain blanks. Homedir specifies the home directory of the database. This directory must exist before running this command. The home directory is prepended to a relative path name when opening a logical file. The home directory is also used by the start(C-1) and toolkit(C-1) commands to determine where the database resides on the system. Logfile specifies the name of a file used to record changes to the database's logical RMSfiles. If specified, the file must exist prior to running this command. When the named database is opened, or a logical RMSfile within the database is opened for writing, the specified logfile is opened. If no logfile is given, no transaction logging is done for the database. The description argument, if given, is recorded in the C/Base database catalog for documentation purposes. This value is not needed or used by the system.

SEE ALSO

dbcreate(C-1), dbrm(C-1), dbadmin(C-1).

NOTES

Dbadd may not be supplied in future releases. The C/Base command dbadmin(C-1) performs the operations of dblist(C-1), dbhome(C-1), dbadd(C-1), dbcreate(C-1) and dbremove(C-1). The binary program for dbadmin is copied to each of the above programs for backwards compatibility. In addition, for all programs copied from the dbadmin program, each one has a corresponding resource file copied from the dbadmin resource file (/usr/cbase/lib/cbase/resource/dbadmin.r).