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

140 Chapter5
TurboIMAGE/XL Library Procedures
DBBEGIN
Mode 3: Indicates a multiple database transaction with one log
record per database. If user logging is enabled for the
databases, mode 3 generates multiple entries in the log file
in order to mark multiple database transactions. For
example, assume that base IDs 11, 12, and 13 are involved
in a multiple database transaction. DBBEGIN mode 3 (with
base IDs 11, 12, and 13 specified in the
baseidlist
parameter) generates the following log record sequence:
DBBEGIN (11, 1/3)
DBBEGIN (12, 2/3)
DBBEGIN (13, 3/3)
.
.
.
database updates
.
.
.
DBEND (11, 1/3)
DBEND (12, 2/3)
DBEND (13, 3/3)
where the notations 1/3, 2/3, 3/3 in the log records indicate
"first of three," "second of three," and "third of three."
Refer to chapter 7 for more details about user logging.
Mode 4: Indicates a multiple database transaction. If user logging
is enabled for the databases, mode 4 generates one entry
in the log file in order to mark multiple database
transactions. For example, assume that base IDs 11, 12,
and 13 are involved in a multiple database transaction.
DBBEGIN mode 4 (with base IDs 11, 12, and 13 specified
in the
baseidlist parameter) generates the following log
record sequence:
MDBXBEGIN (11, 12, 13)
.
.
.
database updates
.
.
.
MDBXEND (11, 12, 13)
Refer to chapter 7 for more details about user logging.
status is the name of an array of 10 halfwords in which TurboIMAGE/XL returns
status information. If the procedure executes successfully, the status array
contents are:
Element Contents
1 If the procedure succeeds, the return status is 0. Table 5-3.
describes the contents of element 1 when the procedure
does not succeed.