DBCREATE C-1





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



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