eetrncmt
形式
eetrncmt -g サービスグループ名 {-t 〔-f〕 |-T トランザクション識別子 〔-f〕}
機能
eetrncmtコマンドは,グローバルトランザクションを構成している各トランザクションブランチが何らかの要因(通信障害など)でトランザクションを決着できないときに実行します。eetrnlstrコマンドを実行して表示された情報中のステータスがREADY(p),READY(d),またはREADY(i)状態のときに,トランザクションブランチを強制的にコミットし,ほかのトランザクションブランチに連絡完了後,トランザクションを終了します。ルートトランザクションブランチがコミットされた場合に実行してください。
eetrncmtコマンドを実行してトランザクションをコミットする場合,ほかのトランザクションとの不整合を発生させないために,グローバルトランザクション内のほかのトランザクションブランチもコミットしてください。通信障害が発生している場合,トランザクションブランチ間の連絡が完了するまでトランザクションを終了できません。このとき,-fオプションを指定すると,トランザクションを強制的に終了できます。通信障害が一時的な場合,-fオプションは指定しないでeetrncmtコマンドを実行してください。
オプション
●-g サービスグループ名 〜〈1〜31文字の識別子〉
TP1/EEプロセスのサービスグループ名を指定します。
●-t
トランザクションのステータスがREADY(p),READY(d),またはREADY(i)状態のすべてのトランザクションのコミットを受け付けます。さらに,コミットするトランザクションに関する情報を標準出力に出力します。
●-f
トランザクションを強制終了します。
-fオプションの指定を省略すると,トランザクションは強制終了されません。
●-T トランザクション識別子 〜〈144文字の16進数〉
指定されたトランザクション識別子(XID)を持つトランザクションのステータスがREADY(p),READY(d),またはREADY(i)状態であれば,コミットを受け付けます。さらに,コミットするトランザクションに関する情報を標準出力に出力します。
トランザクション識別子は,eetrnlstrコマンドで知ることができます。
出力形式
日本語の出力形式を次に示します。
英語の出力形式を次に示します。
出力形式中の,右端の数字の意味を次に示します。
-
1:1トランザクションの情報を,改行を含まないで1行で表示します。トランザクションが複数ある場合,トランザクション数分表示します。
出力形式中の,各変数の意味を次に示します。
変数 |
意味 |
---|---|
aa....aa |
トランザクション識別子(16進数) |
bb....bb |
トランザクション記述子(10進数) トランザクションブランチを区別するためのインデクス番号を表示します。 |
cc....cc |
トランザクション第1状態(20文字以内) トランザクションブランチの処理状態を表示します。
|
d |
トランザクション第2状態(1文字) トランザクションブランチのTP1/EEプロセスに関する状態を表示します。
|
ee....ee |
サービス名(31文字以内) トランザクションブランチを起動しているサービス名を表示します。 サービス名がないトランザクションの場合は,「*」を表示します。 |
ff....ff |
スレッドID(10進数) トランザクションブランチが動作しているスレッドのIFA番号を表示します。 |
gg....gg |
ブランチ記述子(10進数) 一つのトランザクションブランチから分岐したトランザクションブランチを区別するためのインデクス番号を表示します。ルートトランザクションブランチの場合は,「**********」を表示します。 |
hh....hh |
親トランザクション記述子(10進数) 該当するトランザクションブランチを生成したトランザクションのトランザクション記述子を表示します。ルートトランザクションブランチの場合は,「**********」を表示します。 |
ii....ii |
トランザクションブランチ数(10進数) 処理中のトランザクションブランチ数を表示します。 |
jjjjjjjj |
中央処理通番(16進数) |
出力メッセージ
メッセージID |
内容 |
出力先 |
---|---|---|
KFSB90901-E |
コマンドの形式が不正です。 |
標準エラー出力 |
KFSB90902-E |
フラグ引数が不正です。 |
標準エラー出力 |
KFSB90904-E |
コマンドが失敗しました。 |
標準エラー出力 |
KFSB90905-E |
領域の確保に失敗しました。 |
標準エラー出力 |
KFSB90906-E |
内部矛盾が発生しました。 |
標準エラー出力 |
KFSB90919-I |
ヘルプメッセージ |
標準出力 |
注意事項
トランザクションのコミットは,eetrncmtコマンドの実行とは非同期で実行します。