計測機能連絡域 (IFCA)

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

プログラム固有のプログラミング・インターフェース情報の開始

モニター・プログラムは、IFCA のためのストレージの割り振りとその 初期設定を実行しなければなりません。 モニター・プログラムでは、IFCA を 2 進ゼロに初期化しなければならず、また、目印、4 バイトの所有者フィールド、および長さフィールドを設定しなければなりません。 IFCA を正しく初期化しておかないと、IFI 要求は拒否されます。

さらに、モニター・プログラムは、IFCA 戻りコードおよび 理由コード・フィールドを検査し、要求の状況を判別しなければなりません。

IFCA フィールドについては、次の表で説明します。

表 1. 計測機能連絡域. IFCA は、アセンブラー・マッピング・マクロ DSNDIFCA によりマップされます。
名前 16 進オフセット データ・タイプ 説明
IFCALEN 0 16 進、2 バイト IFCA の長さ
IFCAFLGS 2 16 進、1 バイト 処理フラグ
  • IFCAGLBL, X'80'

    データ共用グループの全メンバーに対して IFI 要求が処理される場合には、 このビットはオンです。

  • IFCASYNC、X'40'

    同期的にも非同期的にも実行可能なコマンドの場合、そのコマンドを IFI が同期的に実行する際に、このビットはオンです。

  • 変更の始まりIFCARA64、 X'20'

    このビットがオンの場合、戻り域の最初の 8 バイトには、実際の 64 ビットの 2 GB 境界より上の戻り域 (すべての戻り情報が配置される) へのポインターが含まれます。 IFCID 0306 要求の場合は、共通ストレージに両方の戻り域がなければなりません。2 GB 境界より上の領域の最初の 4 バイトには、4 バイト・ストリング「I306」が含まれている必要があります。

    変更の終わり
  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 バイト 診断情報。
  • IFCACR0、 オフセット 64、4 バイト

    COMMAND 要求の場合、 このフィールドには -1 またはコマンドを実行したコンポーネントからの戻りコードが含まれます。

  • IFCACR15、オフセット 68、 4 バイト
    COMMAND 要求の場合、IFCACR15 フィールドには次のいずれかの値が含まれます。
    0
    コマンドが正常に終了。
    4
    内部エラー
    8
    コマンド内のエラーにより、コマンドは処理されなかった。
    12
    コマンドを実行したコンポーネントが IFCAR0 に戻りコードを戻した。
    16
    コマンド処理中に異常終了が起こった。いつエラーが起こったかにより、コマンド処理は完了していない場合があります。 詳しくは、IFCAR0 を参照してください。
    20
    応答バッファー・ストレージが使用できない。コマンドは完了しましたが、応答メッセージは使用できません。 詳しくは、IFCAR0 を参照してください。
    24
    DSNMSTR アドレス・スペースにストレージが使用できない。 コマンドは処理されませんでした。
    28
    CSA ストレージが使用できない。応答バッファーが使用可能であれば、コマンドは部分的に完了している場合があります。 詳しくは、IFCAR0 を参照してください。
    32
    ユーザーはコマンドの発行を許可されていない。コマンドは処理されませんでした。
  • IFCAR0、オフセット 6C、4 バイト

    IFCARC2 が 00E60834、00E60835、または 00E60836 の場合の、IFCID 0129 要求のログ・マネージャーの理由コード。

  • IFCAR15、 オフセット 70、4 バイト

    IFCARC2 が 00E60834、00E60835、または 00E60836 の場合の、IFCID 0129 要求のログ・マネージャーの戻りコード。

  • IFCAR15 オフセット 70、4 バイト
  • IFCAGBPN、オフセット 74、8 バイト。

    これは、IFCARC2 が 00E60838 または 00E60860 の場合にエラーになって いるグループ・バッファー・プール名です。

  • IFCABSRQ、オフセット 88、4 バイト。
    • 変更の始まり理由コードが 00E60863 で、IFI 要求が GDPS® Active/Active Zero Data Loss 環境内のプロキシー・データ共用グループに対する READS 要求である場合、この値は診断理由コードです。変更の終わり
    • 理由コードが 00E60864 である場合、この値は、必要とされる戻り域のサイズです。
  • IFCAHLRS、オフセット 8C、10 バイト
    このフィールドには以下のいずれかの値が含まれます。
    • WQALLMOD='H' の場合は、アクティブ・ログで最も高い LRSN またはログ RBA。
    • WQALLMOD=L' の場合は、システムの現行および前の LRSN との差。
  • 変更の始まりIFCAFCI、オフセット 8C、10 バイト

    IFCARC2 が 00E60854 または 00E60834 の場合、このフィールドは IFCAHLRS をオーバーレイします。ここには、アクティブ・ログの最初の CI のアドレスが含まれます。

    変更の終わり
IFCAGRSN 98 4 バイトの符号付き整数 IFI が、データ共用グループのメンバーから要求データを呼び出し、グループ・メンバーから必ずしも 全データが戻されない状態に対する理由コード。
IFCAGBM 9C 4 バイトの符号付き整数 他のデータ共用グループ・メンバーから戻され、 戻り域に収まるデータの全長。
IFCAGBNM A0 4 バイトの符号付き整数 他のデータ共用グループ・メンバーから戻されるが、 戻り域に収まらないデータの全長。
IFCADMBR A4 文字、8 バイト IFI 要求が実行される単一のデータ共用 グループ・メンバーの名前。 それ以外の場合、このフィールドはブランクです。 このフィールドにメンバー名が含まれていれば、Db2 はフィールド IFCAGLBL を無視します。
IFCARMBR AC 文字、8 バイト データが戻されるデータ共用 グループ・メンバーの名前。Db2 は、このフィールドを、IFI 要求を行う アプリケーションの IFCA ではなく、戻り域に配置される IFCA の 各コピーに設定します。
プログラム固有のプログラミング・インターフェース情報の終了