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

Chapter 5 139
TurboIMAGE/XL Library Procedures
DBBEGIN
DBBEGIN
INTRINSIC NUMBER 412
Designates the beginning 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. DBBEGIN is
used in conjunction with DBEND to begin and end a static or multiple database transaction.
Syntax
DBBEGIN,{ base
baseidlist
} ,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
base when calling DBBEGIN mode 1 (static transaction).
baseidlist is the name of the integer array containing the base IDs of the databases
which are involved in a multiple database transaction. Use
baseidlist
when calling DBBEGIN mode 3 or 4 (multiple database transaction). The
layout of this array is shown here (each element is a halfword or two
bytes):
Element Contents
1-2 The application program must set these two halfwords to
binary 0s before calling DBBEGIN. After returning to the
calling program, these two halfwords contain the
transaction ID. This ID can be used in order to end the
transaction by calling DBEND.
3 The number of base IDs involved in the multiple database
transaction. This 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/XL intrinsics.
text is the name of 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 DBBEGIN log
record. The text argument is used to assign each particular transaction a
distinct name. (Refer to "Discussion" below for more information.)
mode is an integer indicating the type of transaction desired as follows:
Mode 1: Indicates a static transaction.