モニター・プログラムからの非同期データ要求

非同期バッファーを要求するモニター・プログラムを作成することができます。 このバッファーには、トレース・イベントが発生するたびにトレース・データが記録されます。 モニター・プログラムでは READA 関数を呼び出して、OPn バッファーから非同期でデータを読み取ることができます。

このタスクについて

プログラム固有のプログラミング・インターフェース情報の開始
Db2® は、START TRACE コマンドによって アクティブ化されるすべての IFCID データをバッファーに保管し、 そのデータを READA 要求でモニター・プログラムに渡すことができます。IFCID イベントには以下のタイプの情報が格納されます。
  • 保守容易性
  • 統計
  • アカウンティング
  • パフォーマンス
  • 監査データ
  • IFI 書き込み機能のために定義されている IFCID

手順

非同期データを要求するモニター・プログラムを作成するには、以下の方法を使用します。

  • モニター・プログラムから START TRACE コマンドを発行し、非同期データの収集を開始するバッファー・ロケーションを指定します。 総称値または特定のオンライン・パフォーマンス・モニター宛先 OPn (ここで、n は 1 から 8 の整数) を指定できます。 トレースが開始されると、Db2 は情報が発生した時点でその情報を収集し、 バッファーに保管します。
  • 他のトレースまたはプログラムとの競合を避けるため、初期 START TRACE コマンドに総称 OPX オプションを指定します。 OPX を指定すると、計測機能は、次に使用可能なバッファー宛先スロットを割り当て、OPn 宛先名をモニター・プログラムに返します。 プログラムは後続の START TRACE コマンドまたは MODIFY TRACE コマンドを使用して、計測機能で指定された宛先にデータを転送することができます。
  • READA 要求を発行して、バッファーに入れられたデータをモニター・プログラムに移動します。
  • 以下の状況では、特定の初期 OPn 宛先を使用します。
    • 同一の OPn 宛先に対して複数の非同期トレースを開始する場合。 このためには、モニター・プログラムに OPn 宛先を 指定しなければなりません。 開始された OPn 宛先は、IFCA に戻されます。
    • 特定の IFCID が開始されるように、モニター・プログラムが特定のモニター・クラス (使用可能として定義) と特定の宛先 (例えば OP7) を指定している場合。 オペレーターは、DISPLAY TRACE コマンドを使用して、どのモニターがアクティブで、 どのイベントがトレースされているかを、判別することができます。
  • 大きなバッファーを使用するようにモニター・プログラムを構成し、データ損失を避けるために小さな WBUFBC 値を指定します。 データが失われるのは、モニター・プログラムがデータを獲得する前に、 バッファーがいっぱいになった場合です。 Db2 はバッファーが空になるのを待ちません。代わりに、次の READA 要求実行時にモニター・プログラムに対し、データが失われたことを通知します (IFCA の IFCARLC フィールドを使用)。
  • 以下のロジックを使用するプログラムを作成して、端末に非同期データを表示します。
    1. 初期化を行う。
    2. GETMAIN を使用して、START TRACE コマンドの BUFSIZE 値と等しいストレージ域を取得する。
    3. バッファーが 20% 満たされると常に POST によってこのルーチンがウェイクアップされるように、IFI を介して以下のコマンドを発行する。
      START TRACE=ACCTG DEST=OPX
    4. IFCA に示されている状況を検査し、コマンド要求が 正常に実行されたかどうかを判別する。
    5. バッファーがポストされるまで WAIT。
    6. ポスト・フラグをクリアする。
    7. READA 要求を発行してバッファー・データを取得する。
    8. READA 要求の状況を確認する。
    9. 情報の非ブロック化を行う。
    10. 端末に情報を表示する。
    11. WAIT へ戻る (ループ)。
      プログラム固有のプログラミング・インターフェース情報の終了