モニター・プログラムからの IFI の呼び出し

Db2® 外部のプログラムまたは機能を使用して IFI 機能を呼び出して、コマンドの実行依頼、トレース・データの取得、および IFI を介した Db2 へのデータの受け渡しを行うことができます。

手順

プログラム固有のプログラミング・インターフェース情報の開始
プログラムから IFI を呼び出すには、次のようにします。

  1. モニター・プログラムに DSNWLI の呼び出しを組み込みます。 IFI は、アセンブラーおよび PL/I プログラムから呼び出すことができます。 以下の例は、アセンブラー・プログラムにおける IFI の呼び出しを 説明しています。IFI 関連の例は、すべてアセンブラーで書かれています。
    CALL DSNWLI,(function,ifca,parm-1,...parm-n),VL
    この呼び出しで渡されるパラメーターは、機能を指定し、その機能により使用される連絡域を指し、指定された機能に依存するその他の情報を指定します。パラメーター・リストの長さが異なるため、最後のパラメーターの 高位ビットをオンにして、そのリストの最後のパラメーターであることを示してください。例えば VL オプションは、可変長パラメーター・リストであることを示し、アセンブラーのビットをオンにします。
  2. 正しい言語インターフェースでプログラムをリンク・エディットします。

    DSNULI 言語インターフェース・モジュールは 31 ビット RRS、CAF、TSO、および CICS® アプリケーションにリンクできます。 DSNULI を 24 ビット・アプリケーション・プログラムにリンクすることはできません。以下の各言語インターフェース・モジュールには、IFI のための DSNWLI エントリー・ポイントも用意されています。

    • CAF DSNALI
    • TSO DSNELI
    • CICS DSNCLI
    • IMS™ DFSLI000
    • RRSAF DSNRLI

    CAF DSNALI、つまり CAF (呼び出し接続機能) 言語インターフェース・モジュールには、DSNWLI2 の 2 番目のエントリー・ポイントが含まれています。DSNALI とプログラムとをリンク・エディットしたモニター・プログラムは、DSNWLI に 直接 IFI 呼び出しを実行することができます。 DSNALI をロードするモニター・プログラムは、DSNWLI2 もロードし、 そのアドレスを保管しなければなりません。 モニター・プログラムが DSNWLI を呼び出す場合、プログラムには、DSNWLI への 呼び出しを処理し、実際の DSNWLI2 ルーチンを呼び出すためのダミー・エントリー・ポイントが必要です。

次のタスク

モニター・プログラムの要件を次に示します。
接続
IFI 要求を出すモニター・プログラムを、スレッド・レベルで Db2 に接続する必要があります。プログラムに SQL ステートメントが含まれている場合は、プログラムを プリコンパイルし、BIND 処理を使用して Db2 プランを作成してください。モニター・プログラムに SQL ステートメントが含まれていない場合は、プリコンパイルの必要はありません。ただし、すべての接続環境において、IFI のみのプログラム (SQL ステートメントを含まないプログラム) がプログラム自体のプランを持たない場合でも、任意のプランを使用して、スレッド・レベルで Db2 と接続できます。
ビット・モード
モニター・プログラムは、24 ビット・モードまたは 31 ビット・モードの いずれかで実行することができます。
許可
ユーザーからの最初の READA または READS 呼び出しを実行するときに、プラン実行者の 1 次許可 ID またはいずれかの 2 次許可 ID に、MONITOR1 または MONITOR2 特権が付与されているかどうかの許可検査が行われます。インストール・システムでアクセス制御許可出口ルーチンを使用する場合は、 その出口ルーチンが、モニター・トレースを使用できる特権を 制御することがあります。許可に障害がある場合は、出口ルーチンからの戻りコードと理由コードが 入っている監査トレース (クラス 1) レコードが生成されます。 これは IFCID 0140 に含まれます。
プログラム固有のプログラミング・インターフェース情報の終了
.