TurboIMAGE/XL Database Management System Reference Manual (30391-90012)

136 Chapter5
TurboIMAGE/XL Library Procedures
Using TurboIMAGE/XL Intrinsics
Using TurboIMAGE/XL Intrinsics
On the following pages, the calling parameters for each procedure are defined in
alphabetical order for easy look-up rather than the order in which they appear in the call
statement. Every parameter must be included when a call is made because a parameter's
meaning is determined by its position.
NOTE All parameters must be on halfword boundaries. Database names, data set
names, and data item names that are passed to the TurboIMAGE/XL
intrinsics must be in uppercase.
Table 5-1. TurboIMAGE/XL Procedures
Procedure Function
DBBEGIN When logging, designates the beginning of a transaction and optionally
writes user information to the log file.
DBCLOSE Terminates access to a database or a data set, or resets the pointers of a data
set to their original state.
DBCONTROL Allows a process operating in exclusive mode to enable or disable the deferred
output (AUTODEFER) option. Also allows a process to enable or disable the
critical item update (CIUPDATE) option, activate deadlock detection, and set
wildcard character and BTREEMODE1 option for database,or for the current
DBOPEN without affecting other processes operating on the same database.
DBDELETE Deletes an existing entry from a data set.
DBEND When logging, designates the end of a transaction and optionally writes user
information to the log file.
DBERROR Supplies an ASCII language message that interprets the status information
set by any callable TurboIMAGE/XL procedure. The message is returned to
the calling program in a buffer.
DBEXPLAIN Examines status information returned by a TurboIMAGE/XL procedure and
prints a multiline message on the $STDLIST device.
DBFIND Locates the first and last entries of a data chain in preparation for access to
entries in the chain for non-B-Tree searches. For B-Tree searches, master and
detail data sets can be included.
DBGET Reads the data item values of a specified entry.
DBINFO Provides information about the database being accessed, such as the name
and description of a data item or data set. It also provides information on
logging, including logging of dynamic and multiple database transactions,
and on third-party indexing, critical item update, and other options.
DBLOCK Locks one or more data entries, a data set, or an entire database (or a
combination of these) temporarily to allow the process calling the procedure
to have exclusive access to the locked entities.