| touch | Index Level | trap |
| Syntax | transaction {keyword} {num{-num}} {(options} |
| Category | TCL |
| Type | Verb |
| 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. Note that 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 WILL be 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. See the BASIC "transaction flush" statement for more information on this setting. Note that 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 WILL be reflected in all lower-level BASIC programs. 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. |
| Options |
h Suppress heading.
g Apply operation to whole machine. s Suppress messages. z Examine all processes even if there is no active transaction. |
| See Also | BEGIN WORK |
| Example | |
| Warnings | |
| Compatibility | D3 7.0 |
| touch | Index Level | trap |