IMS 接続機能トレース表のコンテンツ

アプリケーション・プログラムが (SQL 要求を介して) Db2® に対して呼び出しを行うと、リソースを割り振り (プラン ID)、呼び出しを処理することができます。

IMS™ 接続機能は、リソースの割り振りなどの WALTAREA 内でのイベント (制御状況ポイント と呼ばれる) をトレースします。通常のアプリケーション呼び出しパスは、WAU トレース表でトレースされます。

以下のセクションでは、個々のトレース項目のフォーマットとトレースについて説明し、トレース項目内の個々のフィールドがいつ更新されるかを示しています。

IMS トレース・アクティビティーのシーケンス

制御状況ポイントは、以下の表で主要なコンテンツです。
制御状況ポイント A
IMS が IMS 接続機能を呼び出すと、32 バイトのトレース項目がブランクになり、出口 ID および固有の昇順番号に置き換えられます。
制御状況ポイント B
IMS 接続機能が Db2 を呼び出す直前に、呼び出し機能フィールドが更新されます。
制御状況ポイント C
Db2 が IMS 接続機能に制御を返すと、状況フィールドが更新されます。
制御状況ポイント D
接続機能が 1 つ以上のサブルーチンを呼び出した場合、サブルーチン情報は、サブルーチンの完了後にトレースされます。
制御状況ポイント E
IMS 接続機能が IMS に制御を返すと、戻りコードが更新されます。
表 1. IMS 接続機能トレース項目のフォーマット
値と長さ トレース ID シーケンス番号 呼び出し機能 呼び出し状況 サブルーチン RC
CSP で入力 A A B C D E
長さ (バイト) 4 2 6 6 12 2
注:

制御状況ポイント (CSP) の A、B、C、D、および E は、以下のように定義されます。

CSP A のトレース ID、シーケンス番号: トレース表の各項目の先頭には「目印」があり、トレース表内のさまざまなトレース ID フィールドの値を識別するのに役立ちます。

トレース ID:
  • WAL トレースの場合、トレース ID フィールドは、以下のいずれかのイベントに設定されます。
    ABRT
    リカバリー単位の打ち切りを継続します (ロールバック)。
    CMD0
    Db2 コマンドを処理します。
    COMC
    リカバリー単位のコミットを継続します (フェーズ 2)。
    CTHD
    Db2 にスレッドを作成します。
    ECHO
    Db2 が作動可能かどうかを判別します。
    ID00
    Identify: IMS アプリケーションから Db2 への接続を初期化します。
    INIT
    IMS 接続機能の作業域を初期化します。
    PREP
    リカバリー単位をコミットする (フェーズ 1) 準備をします。
    RI00
    IMS と Db2 の間の未確定作業単位を解決します。
    SIGN
    Db2 に新規ユーザーをサインオンさせます。
    SOFF
    Db2 からユーザーをサインオフさせます。
    SUBT
    Db2 または IMS のサブシステムの終了を処理します。
    TRMI
    Terminate Identify: Db2 への接続を終了します。
    TRMT
    Db2 と IMS の間のスレッドを終了します。
  • WAU トレースの場合、トレース ID フィールドは、以下のいずれかのイベントに設定されます。
    NORC
    SQL 要求を処理するための通常の呼び出し。
    SNO0
    システムは、例外条件を処理するための操作が可能な状態ではありません。

シーケンス番号:

トレース ID に続くシーケンス番号は、他のトレース項目に関して、トレース項目が記録された順序を反映しています。 その後、トレース表が循環した場合に、このシーケンス番号を使用してイベントの正しい順序を判別することができます。

CSP B での呼び出し機能
Db2 に対する要求が行われたことを示します。 このコードは内部的に使用されます。値がブランクであるか非ブランクであるかについてのみ注意してください。
CSP C での呼び出し状況
Db2 に対する要求が完了したこと、および制御が IMS 接続機能に返されたことを示します。この Db2 戻りコードおよび理由コードは、イベントの完了時に Db2 から IMS 接続に返されます。
CSP D でのサブルーチン
呼び出された ID (ルーチンへの呼び出し後にトレースされます)。通常、この情報は、問題の診断には適用されません。
CSP E での戻りコード
出口からの IMS 接続機能戻りコード。

各トレース表 (WAL および WAU) の最初のトレース項目の前には、文字ストリング「TRCx」が付きます。 トレース項目におけるフィールド値の組み合わせ、およびそれらが何を示しているかについては、以下の表を参照してください。

表 2. IMS 接続機能トレースの制御状況ポイント
制御状況ポイント 注釈
A B C D E
n b b n/a b 呼び出しが IMS 接続機能に入りました。
n n b n/a b 呼び出しは Db2 内にあります。
n n n n/a b 呼び出しは Db2 から戻り、IMS 接続機能またはサブルーチンにあります。
n n/a n/a n/a n
  • 呼び出しが IMS に戻りました。
  • 呼び出しは IMS にあり、IMS 接続機能に渡されたことはありません。あるいは
  • この項目は残留トレース項目です。
注:
n
非ブランク・フィールドを表します。
b
ブランク・フィールドを表します (つまり、X'40')。
n/a
このフィールドに利用できない情報が含まれていることを示します。