データ共用グループにおける IFI の使用
データ共用グループの 1 つのメンバー上で実行されるアプリケーションで IFI READA お よび READS 呼び出しを使用すると、データ共用グループの他のメンバーからトレース・データを 収集することができます。

- IFCAGLBL
- このフラグをオンに設定して、READS または READA 要求を データ共用グループの全メンバーに送る必要があることを示します。
- IFCADMBR
- IFI READS、READA、または COMMAND 要求をデータ共用グループの
単一メンバーで実行したい場合は、このフィールドにグループ・メンバーの
名前を割り当てます。 このフィールドに名前を指定すると、Db2® は IFCAGLBL を無視します。
Db2 が IFI 要求を実行する際に、指定した名前がアクティブでない場合、Db2 は
エラーを戻します。
推奨事項: データ共用グループの他の メンバーで SCOPE(GROUP) をサポートしない Db2 コマンドを出すには、IFCADMBR フィールドを設定して IFI COMMAND を出してください。
- IFCARMBR
- IFCA に続くデータを生成した データ共用メンバーの名前。Db2 は、リクエスターのプログラムの戻り域に 配置される IFCA のコピーにこの値を設定します。
- IFCAGRSN
- 他のデータ共用グループ・メンバーから必ずしも全データが戻されたわけではない 場合に Db2 が設定する理由コード。
- IFCAGBM
- データ共用グループの他メンバーから戻されて、要求プログラムの戻り域に収容 できるデータのバイト数。
- IFCAGBNM
- データ共用グループのメンバーから戻されたが、要求プログラムの 戻り域に収容できないデータのバイト数。
単独の Db2 サブシステムに対する READA または READS 要求の場合と同様に、READA または READS 要求を出す前に START TRACE コマンドを出す必要があります。パラメーター SCOPE(GROUP) を指定して START TRACE を発行すれば、データ共用グループの全メンバーで トレースを開始することができます。READA 要求の場合、START TRACE コマンドで DEST(OPX) を指定します。Db2 は、すべてのデータ共用メンバーから データを収集し、READA 要求が出されたメンバーの OPX バッファーに戻します。
SCOPE(GROUP) がアクティブである間に新規メンバーがデータ共用グループに参加した場合は、 新規メンバーでトレースが開始されます。
データ共用グループの全メンバーに READS または READA を呼び出しを出すと、Db2 は リクエスターのプログラムの戻り域に全メンバーからのデータを戻します。ローカル・メンバーからのデータが最初になり、その後 IFCA、他の全メンバー からのデータの順で続きます。
例
ローカル Db2 が DB2A と呼ばれていて、グループ内の他の 2 つのメンバーが DB2B および DB2C であるとすれば、戻り域は以下のようになります。
DB2A のデータ
IFCA for DB2B (Db2 sets IFCARMBR to DB2B)
DB2B のデータ
IFCA for DB2C (Db2 sets IFCARMBR to DB2C)
DB2C のデータ
IFI アプリケーションが、データ共用グループの他の単一メンバーからのデータ を要求すると (IFCADMBR にはメンバー名が含まれています)、リクエスターのプログラムの戻り域には、 そのメンバーのデータが戻されますが、メンバーの IFCA は含まれません。 要求に関するすべての情報は、リクエスターのプログラムの IFCA にあります。
データ共用グループに対する READA または READS 要求は、 単一の Db2 に対する READA または READS 要求よりもはるかに多くのデータを生成することができるので、戻り域のサイズを増やして、追加のデータを収容できるようにする必要があります。
