TRANSTART

Marks the start of a local transaction.

Command Class

TCL-I command.

Syntax

TRANSTART {transaction-information}

Syntax Elements

transaction-information
Text describing the current local transaction. This is written to the transaction-start item.

This information makes it easier to identify the transaction or iteration of a transaction when examining the TL-ERRORS, TL-REJECT or clean log files in a Transaction Logging database.

If no transaction information is supplied, the system uses the file name and item-id containing the program performing the transaction along with the time and date.

Comments

TRANSTART checks that the current process is not within a transaction (transactions cannot be nested) and that Transaction Handling is running. If the process is within a transaction or Transaction Handling is not running, it displays an appropriate error message and exits to TCL; otherwise, it writes a transaction-start image to the raw log.

Transactions cannot be nested. A TRANSTART command followed by another TRANSTART command without an intervening TRANSEND or TRANSABORT command will cause a run-time error.

Item Locks

Within a transaction, the release of Item locks is deferred until the transaction is committed or aborted.

Go to top button