transaction Utility

The transaction utility is the system administration utility for transaction processing.

Syntax

transaction {keyword} {num{-num}} {(options}

Parameter(s)

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.

See Also

begin work Statement