OpenTP1 Version 7 Programming Guide
(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.
- Undecided transaction information is output to the directory $DCDIR/spool/dctrninf/ of the node in which the transaction service exists.
- Every time full recovery of transaction service occurs, undecided transaction information is output as one file. The filename is r1 + transaction service starting time (unique 8-digit hexadecimal number).
This file name is displayed in the message log which indicates that undecided transaction information was output. Delete files which are no longer necessary.
Delete unnecessary files containing undecided transaction information following the procedure shown below:
- When deleting a file with a command:
Execute the trndlinf command.
- When deleting information created previously in online mode at OpenTP1 activation:
Specify the delete condition in the trn_recovery_list_remove and trn_recovery_list_remove_level operands of the transaction service definition.
(2) Output contents of undecided transaction information
The following items are output as undecided transaction information.
- OpenTP1 system node ID
System node ID of OpenTP1
- Global transaction number
Unique number for managing global transaction set by the system
- Transaction branch number
Unique number for managing transaction branch set by the system
- Transaction's first status
Processing status of transaction branch
- Transaction's second status
Status of transaction branch process
- Transaction's third status
Communication status of transaction branch
- Process ID
ID of the process operating the transaction branch
- Server name
Name of the server which started the transaction branch
- Service name
Name of the service which started the transaction branch
- Transaction descriptor
Index number to make distinction between transaction branches having the same transaction global ID
- Branch descriptor
Index number to make distinction between transaction branches that branched from one transaction branch. For root transaction branch, ********** is displayed.
- 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
- 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
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.