This section describes how to print the recovery record (PRR) and suspect transaction journal (STJ) file.
Recovery information relating to incomplete transactions is stored in the Suspect Transaction Journal (STJ file) in the ATM transaction manager’s recovery file in certain situations. For example:
during a forced restart of ATM; or
when an administrator forcibly terminates a global transaction using Online Services.
In these cases, transactions are lost to ATM and therefore cannot be completed normally. Transaction integrity may be compromised. For example, a branch of a global transaction on one database might be committed while another branch is backed out.
Each item in the STJ file represents a suspect transaction. The STJ print program T1STJP can be used to:
identify the suspect transactions; and
determine their status when they were last under the control of ATM.
ATM recovery file (PRR file) contains information on all prepared global transactions or branches that are incomplete.
The same print program which is used to print the STJ file (T1STJP) can be used to print the PRR file.
The sample job member ATMSPRNT, which is located in the ATM install JOBS library, can be used to run the STJ print program T1STJP. Before executing this job, modify the ADARUN parameters and Natural parameters according to the requirements of your installation.
This utility requires that the ATM transaction manager be active. Set up the job step as if it were using ATM to coordinate its transactions. That is, suitable client session controls must be defined, the job step must use an ADALNK module which has the Adabas System Coordinator stub linked in, and the ATM library must be available to the job step.
T1STJP execution is controlled by parameters read from the CMSYNIN input. Two parameters are expected:
Parameter | Description |
---|---|
File ID |
The identity of the file from which data will be read. Possible values are
Note: Note: |
ATM ID | The node ID of the ATM transaction manager which owns the STJ or PRR file. If this parameter is omitted, it will default to the node ID of the ATM that is associated with the Adabas System Coordinator Group specified in the job’s client runtime controls. |
Suspect transaction journal and recovery records are reported in physical sequence. The field marked “Last act” in the report provides an indication of the time when the record was stored.