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

240 Chapter5
TurboIMAGE/XL Library Procedures
DBXUNDO
DBXUNDO
INTRINSIC NUMBER 422
Rolls back the active sequence of TurboIMAGE/XL procedure calls which are considered a
dynamic transaction.
Syntax
DBXUNDO ,{ 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.)
baseidlist Name of the integer array containing the base IDs of the databases which
are involved in the DMDBX. Use the same
baseidlist parameter of
DBXBEGIN mode 3, when calling DBXUNDO to roll back a DMDBX.
text is an array up to 256 halfwords long that contains user ASCII or binary
data to be written to the log file as part of the DBXUNDO log record.
mode Must be a halfword equal to 1 when employing base as the base
parameter or 3 when using
baseidlist with the matching DBXBEGIN
call.
Mode 1: Dynamically roll back DBPUT, DBDELETE, and DBUPDATE
intrinsics whichcompletedsuccessfully since the matching
DBXBEGIN mode 1 call.
Mode 3: Dynamically roll back DBPUT, DBDELETE, and DBUPDATE
intrinsics which completed successfully inside the DMDBX
to their respective databases since the matching
DBXBEGIN mode 3 call. If user logging is enabled for the
databases, mode 3 generates multiple entries in the log
file, one for each database, in order to mark the roll back of
the dynamic transaction.
status is the name of an array of 10 halfwords in which TurboIMAGE/XL returns
status information about the procedure. If the procedure executes
successfully, the status array contents are as follows:
Element Contents
1 If the procedure succeeds, the return status is 0. Table
5-26. describes the contents of element 1 when the
procedure does not succeed.
2-4 Unchanged from previous procedure call using this array.