OpenTP1 Version 7 Operation

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

xarls (Display XAR transaction information)

Format

xarls [-c| [-a|-p process-ID] [-r]]

Function

The xarls command displays on the console information about either a specific transaction or about all transactions managed by the XA resource service.

Options

-c

Displays the management information of the XA resource service.

-a

Displays the management information of the XA resource service, and the status of all the transactions being managed by the XA resource service.

-p process-ID~<decimal>

Specifies the process ID of the transaction to be displayed. The transactions associated with the specified process ID are displayed.

-r

Displays the status of all the transactions being managed by the XA resource service, recovery information for the transactions, and the transaction information contained in the XID.

Output formats

(1) When displaying transaction information

[Figure]

AA...AA
Entry number (decimal)

BB...BB
Transaction start time (ctime format)

CC...CC
Process ID (decimal)

XX...XX
Port number of the RAP-processing listener (decimal)

DD...DD
Transaction status
A: Active
I: Idle
P: Prepared
HH: Heuristic Hazard
HC: Heuristic Commit
HR: Heuristic Rollback
HM: Heuristic Mix
***: Initial status

EE...EE
Rollback-only mark
INIT: Initial status
RBONLY1: Marked active transaction
RBONLY2: No transaction
RBONLY3: Unmarked active transaction

FF...FF
Time when rollback-only status occurred (ctime format)

GG...GG
OpenTP1 transaction ID (80 character hexadecimal)

HH...HH
Transaction global identifier (character string, 16 characters)

II...II
Transaction branch identifier (character string, 16 characters)

JJ...JJ
Client transaction ID (280 character hexadecimal)

KK...KK
DID information (32 character hexadecimal)
A DID is a transaction identifier managed by MSDTC. **** is displayed for transaction branches that have no DID information.

LL...LL
Node ID information (32 character hexadecimal)
**** is displayed for transaction branches that have no node ID information.

MM...MM
Recovery information used for MSDTC linkage (hexadecimal (length varies))
**** is displayed for transaction branches that have no recovery information.

(2) When displaying management information

[Figure]

aa...aa
XAR version (decimal)

bb...bb
XAR shutdown status (character string)
RUNNING: Normal
HOLD: Shut down

cc...cc
Number of transaction branches (decimal)

dd...dd
Length of time to wait for idle transaction branches (decimal)

ee...ee
Trace record number (decimal)

ff...ff
Event level (decimal)

gg...gg
Maximum number of records (decimal)

hh...hh
File number of writable file (decimal)
1: Online XAR file
2: Backup XAR file
3: No writable files

ii...ii
Maximum size of RI data that can be stored in the XAR file (decimal)

jj...jj
XAR file status (character string)
RUNNING: Normal
HOLD: Shut down
INIT: Initializing

kk...kk
Physical file name (character string)

ll...ll
Number of records in the XAR file (decimal)

mm...mm
Length of records in the XAR file (decimal)

nn...nn
Time of file creation (ctime format)

oo...oo
Time at which the XAR file entered online mode (ctime format)

pp...pp
Time at which the XAR file was last closed (ctime format)

Output messages

Message ID Description Output destination
KFCA32029-E Processing could not continue due to insufficient memory. Standard error output
KFCA32103-E Invalid usage of the xarls command. Standard error output
KFCA32123-E Processing could not execute because shared memory was unavailable. Standard error output
KFCA32124-E V/R of the XA resource service is invalid. Standard error output
KFCA32129-I Help message Standard output
KFCA32131-E No transactions were found. Standard error output
KFCA32132-E There is no transaction with the specified process ID. Standard error output
KFCA32143-E The XA resource service is inactive. Standard error output

Notes

To minimize its impact on processing performance, the xarls command references information without locking. In this case, *** is displayed as the status of transactions managed by the XA resource service that were in the process of being released at execution of the xarls command. Zeroes (0) are displayed for the decimal and hexadecimal format data of these transactions.