7.4.5 XAトレース
XAトレースとは，XAインタフェースで連携しているときにTPBrokerとリソースマネージャとの間で発行されたXA関数のトレースのことです。OTSは，リソースマネージャに対するXA関数の呼び出し結果がエラーの場合に，トレースを出力します。XAトレースは，$TPSPOOL/logの下にXAtraceという名称でテキストファイルとして出力されます。XAトレースファイルは，最大1メガバイトです。1メガバイトを超えると使用中のファイルをXAtrace.bakにコピーし，新規にXAトレースファイルを作成します。
XAトレースの出力形式の例を次に示します。関数ごとに次のように出力されます。
- 〈この項の構成〉
(1) xa_open／xa_closeの場合
- 出力形式
YYYY/MM/DD hh:mm:ss.SSS aaa(bbb) ccccccc rmid=dd flags=0xeeeeeeee rtn=ff RMName=gggggg xa_info="hhhhhh...hhhhhh"
- （凡例）
-
YYYY/MM/DD：日付
hh:mm:ss.SSS：時刻（ミリ秒）
aaa：プロセスID
bbb：スレッドID
ccccccc：関数名
dd：リソースマネージャ識別子
0xeeeeeeee：オプションフラグの値
ff：リターン値
gggggg：リソースマネージャ名（定義名）
hhhhhh...hhhhhh：オープン（クローズ）文字列
(2) xa_wait／xa_wait_recovery／ax_unregの場合
- 出力形式
YYYY/MM/DD hh:mm:ss.SSS aaa(bbb) ccccccc rmid=dd flags=0xeeeeeeee rtn=ff
- （凡例）
-
YYYY/MM/DD：日付
hh:mm:ss.SSS：時刻（ミリ秒）
aaa：プロセスID
bbb：スレッドID
ccccccc：関数名
dd：リソースマネージャ識別子
0xeeeeeeee：オプションフラグの値
ff：リターン値
(3) xa_recoverの場合
- 出力形式
YYYY/MM/DD hh:mm:ss.SSS aaa(bbb) ccccccc rmid=dd flags=0xeeeeeeee rtn=ff RMName=gggggg count=hh XID=(0xmmmmmmmm,0xnnnnnn.......oooooo,0xpppppp......qqqqqq)
- （凡例）
-
YYYY/MM/DD：日付
hh:mm:ss.SSS：時刻（ミリ秒）
aaa：プロセスID
bbb：スレッドID
ccccccc：関数名
dd：リソースマネージャ識別子
0xeeeeeeee：オプションフラグの値
ff：リターン値
gggggg：リソースマネージャ名（定義名）
hh：XID数
0xmmmmmmmm：XIDのフォーマットID
0xnnnnnn.......oooooo：トランザクショングローバル識別子
0xpppppp......qqqqqq：トランザクションブランチ識別子
(4) xa_completeの場合
- 出力形式
YYYY/MM/DD hh:mm:ss.SSS aaa(bbb) ccccccc rmid=dd flags=0xeeeeeeee rtn=ff RMName=gggggg handle=hh retval=ii
- （凡例）
-
YYYY/MM/DD：日付
hh:mm:ss.SSS：時刻（ミリ秒）
aaa：プロセスID
bbb：スレッドID
ccccccc：関数名
dd：リソースマネージャ識別子
0xeeeeeeee：オプションフラグの値
ff：リターン値
gggggg：リソースマネージャ名（定義名）
hh：非同期オペレーションのハンドル値
ii：非同期オペレーションのリターン値
(5) xa_start_2／ax_reg_2の場合
- 出力形式
YYYY/MM/DD hh:mm:ss.SSS aaa(bbb) ccccccc rmid=dd flags=0xeeeeeeee rtn=ff RMName=gggggg XID= (0xhhhhhhhh, 0xiiiiii.......jjjjjj, 0xkkkkkk......llllll) XACTL=(0xmmmmmmmm,nn)
- （凡例）
-
YYYY/MM/DD：日付
hh:mm:ss.SSS：時刻（ミリ秒）
aaa：プロセスID
bbb：スレッドID
ccccccc：関数名
dd：リソースマネージャ識別子
0xeeeeeeee：オプションフラグの値
ff：リターン値
gggggg：リソースマネージャ名（定義名）
0xhhhhhhhh：XIDのフォーマットID
0xiiiiii.......jjjjjj：トランザクショングローバル識別子
0xkkkkkk......llllll：トランザクションブランチ識別子
0xmmmmmmmm：オプションフラグの値
nn：タイムアウト値
(6) 上記以外の場合
- 出力形式
YYYY/MM/DD hh:mm:ss.SSS aaa(bbb) ccccccc rmid=dd flags=0xeeeeeeee rtn=ff RMName=gggggg XID= (0xhhhhhhhh, 0xiiiiii.......jjjjjj, 0xkkkkkk......llllll)
- （凡例）
-
YYYY/MM/DD：日付
hh:mm:ss.SSS：時刻（ミリ秒）
aaa：プロセスID
bbb：スレッドID
ccccccc：関数名
dd：リソースマネージャ識別子
0xeeeeeeee：オプションフラグの値
ff：リターン値
gggggg：リソースマネージャ名（定義名）
0xhhhhhhhh：XIDのフォーマットID
0xiiiiii.......jjjjjj：トランザクショングローバル識別子
0xkkkkkk......llllll：トランザクションブランチ識別子