DBCREATE C-1

NAME

dbcreate - create a new database

SYNOPSIS

dbcreate dbname directory [ logfile ] [ description ]

DESCRIPTION

Dbcreate adds a definition for a new database to the C/Base database catalog. It also creates a new directory in the requested directory and writes the absolute pathname of that directory on standard output. This new directory becomes the home directory of the database. Dbname specifies the name of the new database. No other database can be defined with the same name. The database name can be up to 32 characters long and should not contain blanks. If the name is longer than the length allowed by the system, a shorter name is chosen by dbcreate. If a file or directory already exists in the named directory, dbcreate picks a new unique name. Directory specifies the absolute pathname of a directory in which dbcreate is to create the new database. Obviously, in order for this to work, the named directory must already exist. Dbcreate creates a directory for the database within the given directory. Logfile specifies the name of a file used to record changes to RMSfiles within the database. The logfile may be specified either as an absolute pathname or as a pathname relative to the home directory of the database. Dbcreate creates the logfile if it does not exist. If this argument is not given on the command line dbcreate requests it. 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. Dbcreate requests a value for this argument if not given on the command line.

 

SEE ALSO

dbrm(C-1), dbremove(C-1), dbadd(C-1), dbadmin(C-1).

 

NOTES

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