OpenTP1 Version 7 Programming Guide

[Contents][Index][Back][Next]

Appendix A. Output Format of Undecided Transaction Information

If trn_tran_recovery_list = Y is defined in the OpenTP1 transaction service definition at full recovery of OpenTP1, undecided transaction information can be output to the directory of the node of the transaction service.

Organization of this section
(1) Names of directory and file to which undecided transaction information is output
(2) Output contents of undecided transaction information
(3) Output format of undecided transaction information

(1) Names of directory and file to which undecided transaction information is output

The names of the directory and file to which undecided transaction information is output are as follows.

Delete unnecessary files containing undecided transaction information following the procedure shown below:

(2) Output contents of undecided transaction information

The following items are output as undecided transaction information.

  1. OpenTP1 system node ID
    System node ID of OpenTP1
  2. Global transaction number
    Unique number for managing global transaction set by the system
  3. Transaction branch number
    Unique number for managing transaction branch set by the system
  4. Transaction's first status
    Processing status of transaction branch
  5. Transaction's second status
    Status of transaction branch process
  6. Transaction's third status
    Communication status of transaction branch
  7. Process ID
    ID of the process operating the transaction branch
  8. Server name
    Name of the server which started the transaction branch
  9. Service name
    Name of the service which started the transaction branch
  10. Transaction descriptor
    Index number to make distinction between transaction branches having the same transaction global ID
  11. Branch descriptor
    Index number to make distinction between transaction branches that branched from one transaction branch. For root transaction branch, ********** is displayed.
  12. Parent transaction descriptor
    Transaction identifier of the transaction which generated the corresponding transaction branch. For root transaction branch, ********** is displayed.

(3) Output format of undecided transaction information

Figure A-1 shows the output format of undecided transaction information. Figure A-2 gives an output example.

Figure A-1 Output format of undecided transaction information

[Figure]

Explanation:

(1) Time at which full recovery was started
mmm: Month (lowercase letters)
dd: Day
HH: Hours
MM: Minutes
SS: Seconds
yyyy: Year (d, H, M, S, and y are digits.)

(2) Transaction information
aaaaaaaa:
OpenTP1 system node ID (8 characters)
bbbbbbbb:
Global transaction number (hexadecimal character string)
cccccccc:
Transaction branch number (hexadecimal character string)
dd...dd:
Transaction's first status (20 or less characters)
BEGINNING: Transaction branch start processing is underway.
ACTIVE: Executing
SUSPENDED: Suspended
IDLE: Changing to synchronization point processing
PREPARE: Under commit (phase 1) processing
READY: Waiting for commit (phase 2) processing
HEURISTIC_COMMIT: Heuristic decision commit processing is underway.
HEURISTIC_ROLLBACK: Heuristic decision rollback processing is underway.
COMMIT: Commit processing is underway.
ROLLBACK_ACTIVE: Waiting for rollback processing
ROLLBACK: Rollback processing is underway.
HEURISTIC_FORGETTING: Transaction branch termination processing after heuristic decision is underway.
FORGETTING: Transaction branch termination processing is underway
e:
Transaction's second status (1 character)
u: User server executing a user server process
r: Transaction branch recovery processing in a transaction recovery process
p: Waiting for completion of recovery other transaction branch processing in a transaction recovery process
When the first state is READY and the root transaction branch is not in the same node, direction by the user is awaited.
f:
Transaction's third status (1 character)
s: In sending
r: In receiving
n: Not in sending or receiving
"In sending or receiving" means that the transaction manager is in progress of communication for synchronization between the transaction branches.
gg...gg:
Process ID (decimal number)
hh...hh:
Server name (8 or less characters)
ii...ii:
Service name (32 or less characters) (For SUP, spaces are set.)
jjjjjjjjjj:
Transaction identifier (decimal number)
kkkkkkkkkk:
Branch identifier (decimal number)#
llllllllll:
Originating transaction identifier (decimal number)#

#
For root transaction branch, ********** is displayed.

Figure A-2 Output example of undecided transaction information

[Figure]