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

156 Chapter5
TurboIMAGE/XL Library Procedures
DBEND
DBEND
INTRINSIC NUMBER 413
Designates the end of a sequence of TurboIMAGE/XL procedure calls regarded as a static
or multiple database transaction (based on the mode) for the purposes of logging and
recovery. The text parameter can be used to log user information to the log file. DBEND is
used in conjunction with DBBEGIN to begin and end a static or multiple database
transaction.
Syntax
DBEND,{ base
baseidlist
transid
} ,text,mode,status,textlen
Parameters
base is the name of the array used as the base parameter when opening the
database. The first element of the array must contain the base ID returned
by DBOPEN. (Refer to DBOPEN for more information about the base ID.) Use
with DBEND mode 1 or 2.
baseidlist is the name of an integer array containing the list of base IDs which are
involved in a multiple database transaction. Use with DBEND mode 3 or 4,
and set the first two halfwords to binary zeroes. The layout of this array is
shown here (each element is a halfword, or two bytes):
Element Contents
1-2 Must be set to binary zeroes.
3 The number of base IDs involved in the multiple database
transaction. Must be a number between 1 and 15,
inclusive.
4-
n Base IDs of the databases involved in the transaction.
Base ID is the first halfword of the
base parameter used
to call TurboIMAGE intrinsics.
transid is the name of the integer array containing the two-halfword
transaction ID. The transaction ID was returned by DBBEGIN mode 3 or 4.
Use with DBEND mode 3 or 4, and do not set the first two halfwords to
binary zeroes.
text is an array up to 256 halfwords long which contains user ASCII or binary
data to be written to the log file as part of the DBEND log record.
mode must be an integer equal to 1, 2, 3, or 4.
Mode 1: End of static transaction.