IFI への Db2 ログ・バッファーの書き込み
診断のために、Db2® ログ・バッファーの内容がアクティブ・ログに書き込まれるときに、その内容を確認したい場合があります。

例えば、ジョブで反復可能な障害が検出されるときに、ログ・バッファーからログ・レコードをキャプチャーすることができます。アクティブ・ログに書き込まれるログ・バッファーのコピーを対話式にキャプチャーして、ログ CI のコピーがトランスポートされるか、リモートまたはローカルのデータ・セットに配置できるようにすることができます。
IFI への Db2 ログ・バッファーの書き込みを開始するために、アプリケーションは IFI COMMAND インターフェースを使用して次の Db2 コマンドを発行できます。
-START TRACE(P) CLASS(30) IFCID(126) DEST(OPX)
ただし、以下のとおりです。
- P は、Db2 パフォーマンス・トレースの開始を示します。どの Db2 トレース・タイプでも使用できます (アカウンティング、統計、パフォーマンス、監査、モニター、グローバル)。
- CLASS(30) は、ユーザー定義のトレース・クラスです (31 および 32 も、 ユーザー定義クラスです)。
- IFCID(126) は、Db2 ログ・バッファーの記録を活動化します。
- DEST(OPX) は、次に使用可能な内部 Db2 オンライン・パフォーマンス (OP) バッファーへのトレースを開始します。この OP バッファーのサイズは、START TRACE の BUFSIZE キーワードにより明示的に制御することができます。有効なサイズの範囲は 256 KB から 16M までであり、サイズは 4 で割り切れる必要があります。
START TRACE コマンドが有効になると、その時点から Db2 が終了するまでの間、Db2 リカバリー・ログ・マネージャー (RLM) は 4 KB ログ・バッファー VSAM コントロール・インターバル (CI) を OP バッファーおよびアクティブ・ログに書き込みます。IFI COMMAND 呼び出しの一部として、アプリケーションは、 ポストすべき ECB と、OP バッファーの書き込みしきい値 (この値を超えると、 アプリケーションはバッファーの内容を取り出すためにポストされます) を指定します。 OP バッファーの内容を取り出すために、IFI READA 要求が発行されます。
特定ログ・レコードの読み取り: IFCID 129 または IFCID 306 を IFI READS 要求と共に使用し、プログラムで初期化した戻り域に、アクティブ・ログのログ・レコードの特定の範囲を戻すことができます。IFI プログラムで次のコマンドを入力します。
CALL DSNWLI(READS,ifca,return_area,ifcid_area,qual_area)
IFCID 129 または IFCID 306 は IFCID 領域に表示されなければなりません。