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

Chapter 5 141
TurboIMAGE/XL Library Procedures
DBBEGIN
2-4 Unchanged from previous procedure call using this array.
5-10 Procedure call information. Refer to "Library Procedure
Error Messages" in appendix A for a description of this
information.
textlen is an integer equal to the number of halfwords to be logged from the text
parameter, or is a negative integer equal to the number of bytes to be
logged. Length can be zero.
Discussion
DBBEGIN is called to designate the beginning of a sequence of TurboIMAGE/XL procedure
calls which are jointly considered a single logical transaction. The transaction is either a
static or multiple database transaction, based on the mode. The end of such a sequence is
designated by a matching call to DBEND. If the calling process is logging, DBBEGIN causes a
log record to be written to the log file which includes such information as the time, date,
and user text buffer. DBBEGIN log records are used by the database recovery program
DBRECOV to identify the beginning of all logical transactions.
DBBEGIN returns an error condition if it is called twice without an intervening call to DBEND
or if it is called while a dynamic transaction is still active, whether the process is actually
logging or not.
Table 5-4. DBBEGIN Return Status Values
Calling Errors: -11 Bad database reference.
-31 Bad mode.
-139 Invalid number of base IDs.
-140 Bad base ID list.
-141 All MDBX databases must be on the same system.
-142 All MDBX databases must log to the same log file.
-143 Logging must be enabled or disabled for all MDBX databases.
-144 MUSTRECOVER must be enabled or disabled for all MDBX
databases.
-145 Roll-back must be enabled or disabled for all MDBX databases.
-151 Text length greater than 512 bytes.
-152 Transaction is in progress.
-221 Cannot begin transaction when a dynamic transaction is active.
-222 Only DBXUNDO allowed when a dynamic transaction encounters
an error.