DBOPEN C-3





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



NAME


dbopen - open default database

SYNOPSIS


dbopen (dbname)
char *dbname;

DESCRIPTION


Dbopen opens a database for further use. The database name
becomes the default when parsing or opening logical names. The
named database must exist in the C/Base database catalog. If a
log file is associated with the database, it is opened at this
time. Upon successful opening of the database, a value of 0
(zero) is returned.

The default database name plays an important role in parsing
logical names. If the database name is not explicitly given, the
default is used.  The default database name can be changed by
issuing multiple dbopen calls provided that the log file names
are the same for each database.

If dbname is an empty string or a NULL pointer, the environment
variable DBASE names the database.

SEE ALSO


dbfind(C-3), dbfindn(C-3), dbparse(C-3), dlopen(C-3)

DIAGNOSTICS

Dbopen returns a non-zero value if the database cannot be opened
and sets the RMS error message describing the reason.