trnls

名称

トランザクションの状態表示

ページの先頭へ

形式

trnls ｛-t 〔-｛a｜c｝〕
      ｜-T トランザクショングローバル識別子〔-｛a｜c｝〕
      ｜-bc
      ｜-B システムノードID 〔-｛a｜c｝〕
      ｜-rc
      ｜-R RM名+RM拡張子 〔-｛a｜c｝〕｝

ページの先頭へ

機能

トランザクションマネジャが管理しているトランザクションに関する情報，またはトランザクションブランチ数を表示します。

トランザクションに関する情報を次に示します。

1. トランザクショングローバル識別子

   システムノードIDとグローバルトランザクション番号（グローバルトランザクションを管理するためにシステムで一意に付けた番号）を合わせた識別子

2. トランザクションブランチ識別子

   システムノードIDとトランザクションブランチ番号（トランザクションブランチを管理するためにシステムで一意に付けた番号）を合わせた識別子

3. トランザクション第1状態

   トランザクションブランチの処理状態

4. トランザクション第2状態

   トランザクションブランチのプロセスに関する状態

5. トランザクション第3状態

   トランザクションブランチの通信状態

6. プロセスID

   トランザクションブランチが動作しているプロセスのプロセスID

7. サーバ名

   トランザクションブランチを起動しているサーバの名称

8. サービス名

   トランザクションブランチを起動しているサービスの名称

9. トランザクション記述子

   同一トランザクショングローバル識別子を持つトランザクションブランチを区別するためのインデクス番号

10. ブランチ記述子

    一つのトランザクションブランチから分岐したトランザクションブランチを区別するためのインデクス番号

11. 親トランザクション記述子

    該当するトランザクションブランチを生成したトランザクションのトランザクション記述子

トランザクションブランチ数の表示内容を次に示します。

1. トランザクショングローバル識別子

   システムノードIDとグローバルトランザクション番号（グローバルトランザクションを管理するためにシステムで一意に設けた番号）を合わせた識別子

2. システムノードID

   OpenTP1のシステムノードID

3. リソースマネジャ名

   トランザクションブランチ下で使用しているリソースマネジャの名称

4. トランザクションブランチ数

   処理中のトランザクションブランチの数

ページの先頭へ

オプション

ページの先頭へ

出力形式

●「trnls -ta」と指定した場合

• 1，および2：1行で表示します。

• 2：トランザクションが複数ある場合，トランザクションの数だけ繰り返し表示します。

• aaaaaaaa：OpenTP1のシステムノードID（8文字）

• bbbbbbbb：グローバルトランザクション番号（8けた）

• cccccccc：トランザクションブランチ番号（8けた）

• dd...dd：トランザクション第1状態（20文字以内）

  • BEGINNING…トランザクションブランチ開始処理中状態

  • ACTIVE…実行中状態

  • SUSPENDED…中断中状態

  • IDLE…同期点処理へ移行状態

  • PREPARE…コミット（1相目）処理中状態

  • READY…コミット（2相目）処理待ち状態

  • HEURISTIC_COMMIT…ヒューリスティック決定コミット処理中状態

  • HEURISTIC_ROLLBACK…ヒューリスティック決定ロールバック処理中状態

  • COMMIT…コミット処理中状態

  • ROLLBACK_ACTIVE…ロールバック処理待ち状態

  • ROLLBACK…ロールバック処理中状態

  • HEURISTIC_FORGETTING…ヒューリスティック決定後のトランザクションブランチ終了処理中状態

  • FORGETTING…トランザクションブランチ終了処理中状態

• e：トランザクション第2状態（1文字）

  • u…ユーザサーバプロセスでのユーザサーバ実行中状態

  • r…トランザクション回復プロセスでのトランザクションブランチ回復処理実行中状態

  • p…トランザクション回復プロセスでの他トランザクションブランチの回復処理完了待ち状態

    なお，第1状態がREADYでルートトランザクションブランチが同一計算機内にない場合，ユーザの指示待ち状態です。また，XAリソースサービスを使用している場合，XAリソースサービスの指示待ち状態です。

• f：トランザクション第3状態（1文字）

  • s…送信中^※

  • r…受信中^※

  • n…送受信中^※ではありません

• gg...gg：プロセスID（10進数）

• hh...hh：サーバ名（8文字以内）

• ii...ii：サービス名（32文字以内）　ただし，SUPの場合は空白

• jjjjjjjjjj：トランザクション記述子（10進数）

• kkkkkkkkkk：ブランチ記述子（10進数）　ただし，ルートトランザクションブランチの場合は，'**********'が表示されます。

• llllllllll：親トランザクション記述子（10進数）　ただし，ルートトランザクションブランチの場合は，'**********'が表示されます。

注※

送信中，受信中とは，トランザクションブランチ間の同期合わせのことです。

●「trnls -tc」，または「trnls -T　トランザクショングローバル識別子 -c」と指定した場合

• 1：グローバルトランザクションの数だけ繰り返し表示します。

• aaaaaaaa：OpenTP1のシステムノードID（8文字）

• bbbbbbbb：グローバルトランザクション番号（8けた）

• ccccc：グローバルトランザクション内のトランザクションブランチ数（10進数）

●「trnls -bc」，または「trnls -B　システムノードID -c」と指定した場合

• 1：トランザクションが実行されている計算機の数だけ繰り返し表示します。

• aaaaaaaa：OpenTP1のシステムノードID（8文字）

• bbbbb：該当する計算機で現在実行されているトランザクションブランチ数（10進数）

●「trnls -rc」，または「trnls　-R　RM名＋RM拡張子　-c」と指定した場合

• 1：トランザクションを実行中のリソースマネジャの数だけ繰り返し表示します。

• aa...aa：リソースマネジャ名＋リソースマネジャ拡張子（33文字以内）

• bbbbb：該当するリソースマネジャで，現在実行されているトランザクションブランチ数（10進数）

●-a，および-cオプションを指定しない場合

• 1：トランザクションの数だけ繰り返し表示します。

• aaaaaaaa：OpenTP1のシステムノードID（8文字）

• bbbbbbbb：グローバルトランザクション番号（8けた）

• cccccccc：トランザクションブランチ番号（8けた）

• dd...dd：トランザクション第1状態（20文字以内）

  詳細は「「trnls -ta」と指定した場合」を参照してください。

• e：トランザクション第2状態（1文字）

  詳細は「「trnls -ta」と指定した場合」を参照してください。

• f：トランザクション第3状態（1文字）

  詳細は「「trnls -ta」と指定した場合」を参照してください。

• gg...gg：プロセスID（10進数）

• hh...hh：サーバ名（8文字以内）

• ii...ii：サービス名（32文字以内）　ただし，SUPの場合は空白

ページの先頭へ

出力メッセージ

メッセージID	内容	出力先
KFCA00970-E	trnlsコマンドの処理エラーです	標準エラー出力
KFCA00975-I	ヘルプメッセージ	標準出力
KFCA00978-E	trnlsコマンドの使用方法が正しくありません	標準エラー出力
KFCA00979-E	trnlsコマンドの実行環境が整っていません	標準エラー出力

ページの先頭へ

注意事項

CUPから起動するトランザクションは，クライアントサービス定義のparallel_countオペランドで指定した最大プロセス数まで同時に実行できます。このプロセス上で実行しているトランザクションの状態は，trnlsコマンドで確認できます。trnlsコマンドを実行すると，サーバ名は'_clttrn'と表示されます。

ページの先頭へ