非同期バッファーを要求するモニター・プログラムを作成することができます。
このバッファーには、トレース・イベントが発生するたびにトレース・データが記録されます。
モニター・プログラムでは 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 フィールドを使用)。
- 以下のロジックを使用するプログラムを作成して、端末に非同期データを表示します。
- 初期化を行う。
- GETMAIN を使用して、START TRACE コマンドの BUFSIZE 値と等しいストレージ域を取得する。
- バッファーが 20% 満たされると常に POST によってこのルーチンがウェイクアップされるように、IFI を介して以下のコマンドを発行する。
START TRACE=ACCTG DEST=OPX
- IFCA に示されている状況を検査し、コマンド要求が
正常に実行されたかどうかを判別する。
- バッファーがポストされるまで WAIT。
- ポスト・フラグをクリアする。
- READA 要求を発行してバッファー・データを取得する。
- READA 要求の状況を確認する。
- 情報の非ブロック化を行う。
- 端末に情報を表示する。
- WAIT へ戻る (ループ)。