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