トランザクショナル分散オブジェクト基盤 TPBroker ユーザーズガイド
XAトレースとは,XAインタフェースで連携しているときにTPBrokerとリソースマネージャとの間で発行されたXA関数のトレースのことです。OTSは,リソースマネージャに対するXA関数の呼び出し結果がエラーの場合に,トレースを出力します。XAトレースは,$TPSPOOL/logの下にXAtraceという名称でテキストファイルとして出力されます。XAトレースファイルは,最大1メガバイトです。1メガバイトを超えると使用中のファイルをXAtrace.bakにコピーし,新規にXAトレースファイルを作成します。
XAトレースの出力形式の例を次に示します。関数ごとに次のように出力されます。
- <この項の構成>
- (1) xa_open/xa_closeの場合
- (2) xa_wait/xa_wait_recovery/ax_unregの場合
- (3) xa_recoverの場合
- (4) xa_completeの場合
- (5) xa_start_2/ax_reg_2の場合
- (6) 上記以外の場合
(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:トランザクションブランチ識別子
All Rights Reserved. Copyright (C) 2012, 2015, Hitachi, Ltd.