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.

Text is only written to the clean log if there is something in the transaction. So if you do TRANSTART then TRANSEND with nothing between, the TRANSTART/TRANSEND is not written to the 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 - for example:

:TRANSTART
:TRANSTART
[1155] There is a transaction already active for this process

Item Locks

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