TurboIMAGE/XL Database Management System Reference Manual MPE/iX V6.5 (30391-90011)

Chapter 5 215
TurboIMAGE/XL Library Procedures
DBOPEN
DBOPEN
INTRINSIC NUMBER 401
Initiates access to the database and establishes the user class number and access mode for
all subsequent database access. DBOPEN is used in conjunction with DBCLOSE to establish
and terminate access to a database.
Syntax
DBOPEN, base,password,mode,status
Parameters
base is the name of an integer array containing a string of ASCII characters.
The string must consist of two blanks followed by a left-justified database
name (maximum 6 characters) and terminated by a semicolon or blank
( ), for example, " orders;". If the database is successfully opened,
TurboIMAGE/XL replaces the two blanks with a value called the base ID.
The base ID uniquely identifies this access path between the database and
the process calling DBOPEN. In all subsequent accesses to the database, the
first halfword of base must be this base ID; therefore, the array should not
be modified. The base ID contains a number that distinguishes between
the 63 access paths allowed for each process for accessing a given
database.
NOTE The base ID cannot be passed between processes in an attempt to reduce the
number of required DBOPEN calls.
To access a database catalogued in a group other than the user's log-on
group, the database name must be followed by a period and the group
name, for example, ORDERS.GROUPX. If the database is in an account other
than the user's account, the group name must be followed by a period and
the account name, for example, ORDERS.GROUPX.ACCOUNT1.
You can use an MPE/iX FILE command before executing the application
program to equate the database name or the database-access file name to
another database or database-access file name. You can use only the
formal file designator, actual file designator, and the
DEV= parameters. For
additional information on the database-access file, refer to chapter 9.
password is the name of an integer array containing a left-justified string of ASCII
characters consisting of an optional password followed by an optional user
identifier.
The following constructs are valid for the password and user identifier (a
represents a blank):