iX V6.5 (30391-90011)

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 ﬁle 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 ﬁle.

-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.