計測機能連絡域 (IFCA)
モニター・プログラムの計測機能連絡域 (IFCA) は、モニター・プログラム と IFI との間の連絡域です。IFCA の戻りコードおよび理由コード・フィールドに、呼び出しが正常に終了したかどうかの情報が入ります。 IFCA は、すべての IFI 要求の必須パラメーターです。

モニター・プログラムは、IFCA のためのストレージの割り振りとその 初期設定を実行しなければなりません。 モニター・プログラムでは、IFCA を 2 進ゼロに初期化しなければならず、また、目印、4 バイトの所有者フィールド、および長さフィールドを設定しなければなりません。 IFCA を正しく初期化しておかないと、IFI 要求は拒否されます。
さらに、モニター・プログラムは、IFCA 戻りコードおよび 理由コード・フィールドを検査し、要求の状況を判別しなければなりません。
IFCA フィールドについては、次の表で説明します。
| 名前 | 16 進オフセット | データ・タイプ | 説明 |
|---|---|---|---|
| IFCALEN | 0 | 16 進、2 バイト | IFCA の長さ |
| IFCAFLGS | 2 | 16 進、1 バイト | 処理フラグ
|
| 3 | 16 進、1 バイト | 予約済み | |
| IFCAID | 4 | 文字、4 バイト | ブロックの目印 (IFCA) |
| IFCAOWNR | 8 | 文字、4 バイト | モニター・プログラムが用意する所有者フィールド。 この値は、OPn 宛先の所有権を確立する場合、および リクエスターが OPn 宛先からデータを取得できることを 確認する場合に使用されます。この値は、プランの所有者 ID と同じではありません。 |
| IFCARC1 | C | 4 バイトの符号付き整数 | IFI 呼び出しの戻りコード。2 進ゼロが入っている場合は、正常な呼び出しを意味しています。 他の戻りコードについて詳しくは、X'E6......' codesを参照してください。 COMMAND 要求からの 8 の戻りコードについては、IFCAR0 と IFCAR15 の値に追加情報が含まれています。 |
| IFCARC2 | 10 | 4 バイトの符号付き整数 | IFI 呼び出しの理由コード。2 進ゼロが入っている場合は、正常な呼び出しを意味しています。 他の理由コードについて詳しくは、X'E6......' codesを参照してください。 |
| IFCABM | 14 | 4 バイトの符号付き整数 | 戻り域に移動されたバイト数。 ゼロ以外の値がこのフィールドに収納されると、呼び出しから 情報が戻されたことを意味します。 完全なレコードだけが、モニター・プログラム域に移動されます。 |
| IFCABNM | 18 | 4 バイトの符号付き整数 | 戻り域に収納されずにバッファーに入れられたままのバイト数。 別の READA 要求により、そのデータが検索されます。 特定の IFI 要求を実行すると、返される情報の量が分かります。 戻り域がいっぱいの場合は、それ以外の要求を実行しても、終了します。 |
| 1C | 4 バイトの符号付き整数 | 予約済み | |
| IFCARLC | 20 | 4 バイトの符号付き整数 | READA 要求が出される前に失われたレコード数を示しています。 レコードは、バッファーの内容が IFI READA 要求により アプリケーション・プログラムに転送される前に OP バッファー・ストレージを使いきると、失われます。OP バッファーに入り切らないレコードは書き込まれずに、 失われたレコードとしてカウントされます。 |
| IFCAOPN | 24 | 文字、4 バイト | READA 要求に指定される宛先名。 このフィールドは要求されたバッファーを示すもので、READA 要求では必須です。 モニター・プログラムは、このフィールドを設定しなければなりません。 計測機能は、モニター・プログラム から OPn 宛先に対し START TRACE が出されると、このフィールドを満たします。 モニター・プログラムが複数の OPn 宛先トレースを開始すると、 最初のトレースがこのフィールドに書き込まれます。 ユーザーのモニター・プログラムが OPn 宛先トレースを開始しなかった 場合は、フィールドは修正されません。 非同期バッファーを探すために、OPn 宛先と 所有者 ID が後続の READA 呼び出しで使用されます。 |
| IFCAOPNL | 28 | 2 バイトの符号付き整数 | 開始された OPn 宛先の長さ。IFI によってコマンドが入力される時に、この値は X'0004' に設定されます。OPn 宛先が開始されると、開始されたすべての OPn 宛先の 長さが含まれるように、その長さが増やされます。 |
| 2A | 2 バイトの符号付き整数 | 予約済み | |
| IFCAOPNR | 2C | 文字、それぞれが 4 バイトの 8 つのフィールド | 8 個の OPn 宛先値を戻すためのスペース |
| IFCATNOL | 4C | 2 バイトの符号付き整数 | トレース番号 + 4 の長さ。IFI によってコマンドが入力される時に、この値は X'0004' に設定されます。 トレースが開始されると、開始されたすべてのトレース番号が含まれるように この長さは拡張されます。 |
| 4E | 2 バイトの符号付き整数 | 予約済み | |
| IFCATNOR | 50 | 文字、それぞれが 2 バイトの 8 つのフィールド | 開始された最大 8 つの EBCDIC トレース番号を収納するスペース。 トレース番号は、 その後の呼び出しで MODIFY TRACE コマンドが使用される場合は、 必須です。 |
| IFCADL | 60 | 16 進、2 バイト | 診断情報の長さ |
ICFADDF![]() |
62![]() |
16 進、2 バイト![]() |
診断情報レベル:X'8000。この診断域は Db2® 11 以降に対するものです。 ![]() |
| IFCADD | 64 | 文字、80 バイト | 診断情報。
|
| IFCAGRSN | 98 | 4 バイトの符号付き整数 | IFI が、データ共用グループのメンバーから要求データを呼び出し、グループ・メンバーから必ずしも 全データが戻されない状態に対する理由コード。 |
| IFCAGBM | 9C | 4 バイトの符号付き整数 | 他のデータ共用グループ・メンバーから戻され、 戻り域に収まるデータの全長。 |
| IFCAGBNM | A0 | 4 バイトの符号付き整数 | 他のデータ共用グループ・メンバーから戻されるが、 戻り域に収まらないデータの全長。 |
| IFCADMBR | A4 | 文字、8 バイト | IFI 要求が実行される単一のデータ共用 グループ・メンバーの名前。 それ以外の場合、このフィールドはブランクです。 このフィールドにメンバー名が含まれていれば、Db2 はフィールド IFCAGLBL を無視します。 |
| IFCARMBR | AC | 文字、8 バイト | データが戻されるデータ共用 グループ・メンバーの名前。Db2 は、このフィールドを、IFI 要求を行う アプリケーションの IFCA ではなく、戻り域に配置される IFCA の 各コピーに設定します。 |

IFCARA64、
X'20' 