The transaction utility is the system administration utility for transaction processing.
transaction {keyword} {num{-num}} {(options}
| options | f | Same as ’off’. |
| h | Suppresses heading. | |
| g | Applies operation to whole machine. | |
| n | Same as ’on’. | |
| s | Suppresses messages. | |
| z | Examines all processes even if there is no active transaction. |
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. Note: The setting
displayed by this command reflects the TCL default setting. If the
default has been modified by a lower-level BASIC program, then these
changes are not reflected. However, if the cache setting is then changed
by the transaction TCL command, then the changes are reflected in all lower-level BASIC programs.
|
|
| 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. Note: The setting
displayed by this command reflects the TCL default setting. If the
default has been modified by a lower-level BASIC program, then these
changes are not reflected. However, if the cache setting is then changed
by the transaction TCL command, then the changes are reflected in all lower-level BASIC programs.
|
|
| status | Displays the status of a transaction for the current line. The following information displays. | |
| PIB | Process ID. | |
| Status | Transaction status 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 displays 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. | |