tcl.transaction Verb: Access/TCL

tcl.transaction

Command tcl.transaction Verb: Access/TCL
Applicable release versions: AP 6.2
Category TCL (746)
Description system administration utility for transaction processing.

The "transaction" utility provides several different functions depending on the "keyword" provided. Current "keyword" values include:

CACHE ON/OFF Changes or queries the default cache condition for the process. The global default can be examined or set by adding the "g" option. See the BASIC "transaction cache" statement for more information on this setting.

FLUSH ON/OFF Changes or queries the default flush condition for the process. The global default can be examined or set by adding the "g" option. See the BASIC "transaction flush" statement for more information on this setting.

STATUS Displays the status of a transaction for the current line. The following information is displayed.

- Pib Process ID.
- Status Transaction status. This is "inactive," "active," or "commit." Normally, processes in the "inactive" state are not displayed unless the (z option is used.
- Size Number of operations in the current transaction.
- ID# Transaction id number.
- Name Transaction name if the "name" parameter was specified in the "begin work" statement.

Another process, or range of processes may be queried by specifying that process or process range. If the "g" option is used, then the information is displayed for the whole machine.

RECOVER Recovers transactions after a system halt. This operation should only be executed during the SYSTEM-COLDSTART macro while the system is in single-user mode. The "recover" option attempts to roll-forward each committed transaction. If this fails, then the transaction is rolled-back. If the transaction cannot be completely rolled-back, then an error is printed and the transaction is aborted.
Syntax transaction {keyword} {num{-num}} {(options}
Options h Suppress heading.

g Apply operation to whole machine.

s Suppress messages.

z Examine all processes even if there is no active transaction.
Example
Purpose
Related basic.begin.work