READS 要求の修飾フィールド

モニター・プログラムは、READS 要求の修飾域 を使用して、要求によって返されるデータに関する制約を指定できます。

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

修飾域が存在しない場合 (2 進ゼロの長さ)、情報は、アクティブなすべての関連スレッドおよびデータベース・アクセス・スレッドから取得されます。 存在していても非アクティブなデータベース・アクセス・スレッドに関しては、 情報は獲得されません。

特定のトレース・レコードは修飾できません。 IFCID として 0001、0002、0106、0202、0217、0225、0230 が含まれるトレース・レコードの修飾は無視されます。

他のすべての同期レコードは修飾可能です。ただし、特定のトレース・レコードでは使用できる修飾フィールドが限定されます。 特定のトレース・レコードが使用可能な修飾についての情報は、表 4を参照してください。

READS 要求の修飾域フィールド

修飾域の長さが 2 進ゼロでない限り (この場合は、修飾域は存在しません)、モニター・プログラムにより提供される修飾域の アドレスは、次の表に示されているモニター・プログラムによりフォーマットされるエリアを指しています。

表 1. 修飾域のフィールド. このエリアは、アセンブラー・マッピング・マクロ DSNDWQAL によりマップされます。
名前 16 進オフセット データ・タイプ 説明
WQALLEN 0 符号付き 2 バイトの整数 修飾域の長さ + 4。 以下の定数は修飾域長さフィールドを設定します。
  • 変更の始まりWQALLN11 (1024 バイト)変更の終わり
  • WQALLN9 (920 バイト)
  • WQALLN6 (264 バイト)
  • WQALLN5 (192 バイト)
  • WQALLN4 (168 バイト)
  • WQALLN21 (156 バイト)
  • WQALLN22 (120 バイト)
  • WQALLN23 (78 バイト)

特定のトレース・レコードが使用可能な修飾フィールドについての情報は、表 4を参照してください。

修飾域の修飾フィールドの場所について詳しくは、prefix.SDSNMACS データ・セットのメンバー DSNDWQAL を参照してください。

  2 符号付き 2 バイトの整数 予約済み
WQALEYE 4 文字、4 バイト ブロックの目印 (WQAL)
WQALACE 8 アドレス スレッド識別トークン値。 この値は、特定の要求スレッドを示しています。 使用されない場合は、2 進ゼロ。
WQALAIT2 C アドレス 予約済み
WQALPLAN 10 文字、8 バイト プラン名。使用しない場合は 2 進ゼロ。
WQALAUTH 18 文字、8 バイト 現行 1 次許可 ID。使用しない場合は 2 進ゼロ。
WQALOPID 20 文字、8 バイト 元の許可 ID。使用しない場合は 2 進ゼロ。
WQALCONN 28 文字、8 バイト 接続名。使用しない場合は 2 進ゼロ。
WQALCORR 30 文字、12 バイト 相関 ID。使用しない場合は 2 進ゼロ。
WQALREST 3C 文字、32 バイト IFCID 0149 が指定されたときの特定ロック要求のリソース・トークン。 このフィールドは、モニター・プログラムで設定しなければなりません。 モニター・プログラムは、IFCID 0150 に関する以前の READS 要求から、 または IFCID 0147 または 0148 に関する READS 要求から、この情報を 獲得することができます。
WQALHASH 5C 16 進、4 バイト IFCID 0149 が指定された場合の特定ロック要求に関するリソース・トークンを 指定したリソース・ハッシュ値。 このフィールドは、モニター・プログラムで設定しなければなりません。 モニター・プログラムは、IFCID 0150 に関する以前の READS 要求から、 または IFCID 0147 または 0148 に関する READS 要求から、 この情報を取り出すことができます。
WQALASID 60 16 進、2 バイト 処理のアドレス・スペース を指定する ASID。
WQALFOPT 62 16 進、1 バイト IFCID 0150 用のフィルター・オプション。
変更の始まりX'80'変更の終わり
変更の始まりローカルまたはグローバルの待機者を持つリソースに対してロック情報を戻す。 (WQALLCON)変更の終わり
X'40'
1 つ以上の利害関係のある エージェントがいるリソースに対してのみロック情報を戻す。(WQALMAGN)
変更の始まりX'20'変更の終わり
待機者がいる リソースに対してのみロック情報を戻す。(WQALWAIT)
WQALFLGS 63 16 進、1 バイト 147/148 レコードに対するオプション。
X'40'
アクティブ関連エージェント 147/148 レコードは、この READS 要求では 書き込みされません。WQAL148NR = OFF の場合は、DDF/RRSAF ロールアップ・レコードが書き込まれます。(WQAL148NA)
X'80'
DDF/RRSAF ロールアップ 147/148 レコードは、この READS 要求では 書き込みされません。WQAL148NA = OFF の場合は、 アクティブ関連エージェント・レコードが書き込まれます。1 (WQAL148NR)
WQALLUWI 64 文字、24 バイト 要求されたスレッドの LUWID (論理作業単位 ID)。 使用されない場合は、2 進ゼロ。
  7C 文字、16 バイト ロケーション名。 これが指定された場合、 データは、指定されたロケーションで生成された分散エージェントについてのみ 戻されます。

例: SITE A で IFI プログラムが実行されて おり、WQALLOCN に SITE A が指定されている場合は、SITE A で実行されているデータベース・アクセス・ スレッドおよび分散関連エージェントが報告されます。 ローカルの非分散エージェントは報告されません。

例: WQALLOCN に SITE B が指定されており、IFI プログラムはまだ SITE A で実行 されている場合は、SITE B の分散関連エージェントをサポートして実行されているデータベース・ アクセス・スレッドに関する情報が報告されます。

例: WQALLOCN が指定されていない場合は、SITE A (IFI プログラムが実行されているサイト) で 実行されるすべてのスレッドに関する情報が戻されます。この情報には、ローカル非分散スレッド、ローカル・データベース・ アクセス・エージェント、およびローカル分散関連エージェントが含まれます。

WQALLTYP 8C 文字、3 バイト ログ・データ・アクセス・タイプを指定します。ログ・レコード・コントロール・インターバル (CI) を獲得するためには、「CI」を指定しなければなりません。
WQALLMOD 8F 文字、1 バイト ログ・データ・アクセスのモード 変更の始まり
'D'
WQALLRBA に RBA 値およびメンバー ID が指定されている単一のログ・レコードを検索します。位置がログに保持されている時に D 要求を出すと、要求は失敗し、保持されていたログ位置を終了します。
'F'
WQALLCRI に指定された基準を満たす、WQALLRBA に指定された LRSN または RBA を超えるログ・レコードを要求するために、最初の呼び出しとして使用されます。
'H'
アクティブ・ログで最上位の LRSN またはログ RBA を検索します。値は、IFI 通信域 (IFCA) の IFCAHLRS フィールドに返されます。 戻り域に返されたデータはなく、この呼び出しの戻りコードは、データが戻されなかったことを示すことになります。
'N'
WQALLCRI で指定された基準を満たす残りのログ・レコードを要求するために、モード F または N の呼び出しに続いて使用されます。 * および任意のオプションが WQALLOPT に指定されています。プログラムの戻り域に収まる限りのログ・レコードが返されます。
'T'
以前の F または N の要求により保持されていたログ位置を終了します。これにより、保持されていたリソースは解放されます。
変更の終わり
WQALLNUM 90 16 進、2 バイト 戻されるログ CI 数。有効範囲は、X'0001' から X'0007' までです。
WQALCDCD 92 文字、1 バイト データ記述要求フラグ
'A'
DATA 要求が領域から最初に出された場合、 または DATA 要求が特定の表に関して変更された場合のみ、データ記述が 戻されることを示します。これがデフォルトです。
'N'
データ記述が戻されないことを示します。
'Y'
新しい要求ごとにリスト内の各表に対するデータ記述が 戻されることを示します。
  93 16 進、1 バイト 予約済み
変更の始まり 変更の終わり 変更の始まり94変更の終わり 変更の始まり16 進、8 バイト変更の終わり 変更の始まり予約済み変更の終わり
WQALGBPN 9C 文字、8 バイト IFCID 0254 のグループ・バッファー・プール名。IFCID 0199 の バッファー・プール名。 単一バッファー・プールまたはグループ・バッファー・プールを指定するためには、 バッファー・プール名を 16 進数で指定し、その後に 16 進数のブランクを 続けます。

例: バッファー・プール BP1 を指定するには、このフィールドに X'C2D7F14040404040' を書き込みます。

複数のバッファー・プール、またはバッファー・プール・グループを指定するには、バッファー・プール名の任意の位置でパターン・マッチング文字 X'00' を使用します。X'00' は、この位置とその後のすべての位置にどのような文字があってもよいことを示しています。

例: このフィールドに X'C2D7F10000000000' と入力したとすれば、名前が BP1 で始まるすべてのバッファー・プールについてデータが必要であることを示すので、IFI は、BP1、BP10 から BP19、および BP16K0 から BP16K9 用のデータを収集します。

例: このフィールドに X'C2D700F100000000' と入力したとすれば、名前が BP で始まるすべてのバッファー・プールについてデータが必要であることを示すので、IFI は、すべてのバッファー・プール用のデータを収集します。IFI は位置 4 の X'F1' を 無視します。これは、最初の X'00' の後に発生したからです。

WQALLCRI A4 16 進、1 バイト ログ・レコード選択基準

どのタイプのログ・レコードが返されるかを示します。

X'00' (WQALLCR0)
変更データ・キャプチャーのためのログ・レコードおよびリカバリー単位制御のためのログ・レコードのみ。
X'01' (WQALLCR1)
GDPS® Active/Active ZDL 環境のプロキシー・データ共用グループからの、変更データ・キャプチャーのためのログ・レコードおよびリカバリー単位制御のためのログ・レコードのみ。 ログの有効範囲終了点に達するまで、レコードが返されます。
X'02' (WQALLCR2)
GDPS Active/Active ZDL 環境内のプロキシー・データ共用グループからのすべてのタイプのログ・レコード。ログの有効範囲終了点に達するまで、レコードが返されます。
X'03' (WQALLCR3)
GDPS Active/Active ZDL 環境のプロキシー・データ共用グループからの、変更データ・キャプチャーのためのログ・レコードおよびリカバリー単位制御のためのログ・レコードのみ。 データ共用グループのすべてのメンバーについて、ログの終了点に達するまで、レコードが返されます。
X'04' (WQALLCR4)
GDPS Active/Active ZDL 環境内のプロキシー・データ共用グループからのすべてのタイプのログ・レコード。データ共用グループのすべてのメンバーについて、ログの終了点に達するまで、レコードが返されます。
X'FF' (WQALLCRA)
すべてのタイプのログ・レコード。このオプションを使用すると、大量のデータ・ボリュームが検索されることがあり、Db2® のパフォーマンスが低下する場合があります。
WQALLOPT A5 16 進、1 バイト 圧縮解除に関連する処理オプション:
X'00'
解凍をしないことを指示します。(WQALLOP0)
X'01'
ログ・レコードが圧縮されている場合にそれらを 解凍することを指示します。(WQALLOP1)
WQALFLTR A6 16 進、1 バイト IFCID 0316 要求用に、WQALFLTR は フィルター方式を指定します。
X'00'
フィルター操作をしないことを指定します。この値は、戻り域に収まるできるだけ多くのキャッシュ・ステートメントのための情報を 戻すことを Db2 に指定します。(WQALFLT0)
X'01'
特定の統計フィールドについて最高の値を持つ キャッシュ・ステートメントの情報を戻すように、Db2 に指定します。統計フィールドは WQALFFLD に 指定します。Db2 は、戻り域に収まるできるだけ多くのステートメントの情報を戻します。(WQALFLT1)

例: 戻り域が 10 個のステートメントについての情報を戻す大きさであれば、 指定された統計フィールドに関して最高値を持つ 10 個のステートメントが報告されます。

X'02'
特定の統計フィールドについてしきい値を超える キャッシュ・ステートメントの情報を戻すように、Db2 に指定します。統計フィールド名は WQALFFLD に指定します。しきい値は WQALFVAL に 指定します。Db2 は、戻り域に収まるできるだけ多くの、この条件を満たすステートメントの情報を戻します。
X'04'
単一のキャッシュ・ステートメント に関する情報を戻すように、Db2 に指示します。 アプリケーションは、フィールド WQALSTID に 4 バイトのキャッシュ・ステートメント ID を書き込みます。 この修飾子を指定した IFCID 0316 要求は、IFCID 0172 または IFCID 0196 と併用して、 タイムアウトまたはデッドロックに関係したステートメントに関する情報を取得することを目的としています。
IFCID 0401 要求の場合:
X'00'
フィルター操作をしないことを指定します。この値は、戻り域に収まるできるだけ多くのステートメントのための情報を 戻すことを Db2 に指定します。(WQALFLT0)
X'02'
特定の統計フィールドについてしきい値を超える ステートメントの情報を戻すように、Db2 に指定します。統計フィールド名は WQALFFLD に指定します。しきい値は WQALFVAL に 指定します。Db2 は、戻り域に収まるできるだけ多くの、この条件を満たすステートメントの情報を戻します。
IFCID 0317 要求用に、WQALFLTR は フィルター方式を指定します。
X'04'
単一のキャッシュ・ステートメント に関する情報を戻すように、Db2 に指示します。 アプリケーションは、フィールド WQALSTID に 4 バイトのキャッシュ・ステートメント ID を書き込みます。 この修飾子を指定した IFCID 0317 要求は、IFCID 0172 または IFCID 0196 と併用して、タイムアウトまたは デッドロックに関係したステートメントに関する情報を取得することを目的としています。
IFCID 0306 要求の場合は、WQALFLTR は Db2 がデータ共用環境内のログ・レコードを マージするかどうかを指定します。
X'00'
Db2 がデータ共用メンバーからのログ・レコードをマージすることを指定します。(WQALMERG)
X'03'
Db2 がデータ共用メンバーからのログ・レコードをマージしないことを指定します。(WQALNOMR)
WQALFFLD A7 文字、1 バイト IFCID 0316 要求の場合、WQALFLTR が X'01' または X'02' であれば、このフィールドは、Db2 が報告するキャッシュ・ステートメントを決めるために使用される統計フィールドを指定します。 以下の値を入力することができます。
'A'
累算経過時間 (QW0316AE)。このオプションは、QWALFLTR=X'01' の場合のみ有効。(WQALFFLA)
'B'
バッファー読み取りの数 (QW0316NB)。(WQALFFLB)
'C'
累算 CPU 時間 (QW0316CT)。このオプションは、QWALFLTR=X'01' の場合のみ有効。(WQALFFLC)
'E'
ステートメントの実行数 (QW0316NE)。(WQALFFLE)
'G'
GETPAGE 要求の数 (QW0316NG)。(WQALFFG)
'I'
索引スキャンの数 (QW0316NI)。(WQALFFLI)
'L'
並列グループの数 (QW0316NL)。(WQALFFLL)
'P'
処理された行数 (QW0316NP)。(WQALFFLP)
'R'
検査された行数 (QW0316NR)。(WQALFFLR)
'S'
実行されたソートの数 (QW0316NS)。(WQALFFLS)
'T'
表スペース・スキャンの数 (QW0316NT)。(WQALFFLT)

(次の行に続く。)

WQALFFLD
(続き)
A7 文字、1 バイト

(前の行からの続き。 )

'W'
バッファー書き込みの数 (QW0316NW)。(WQALFFLW)
'X'
RID の数が 1 つ以上の内部 Db2 限度を超えるために、RID リストが 使用されなかった回数 (QW0316RT)。
'Y'
十分なストレージが使用できなかったために、RID リストが 使用されなかった回数 (QW0316RS)。(WQALFFLY)
'1'
同期入出力のための累算待ち時間 (QW0316W1)。このオプションは、QWALFLTR=X'01' の場合のみ有効。(WQALFFL1)
'2'
ロック要求のための累算待ち時間 (QW0316W2)。 このオプションは、QWALFLTR=X'01' の場合のみ有効。(WQALFFL2)。
'3'
同期実行単位切り替えのための累算待ち時間 (QW0316W3)。 このオプションは、QWALFLTR=X'01' の場合のみ有効。(WQALFFL3)
'4'
グローバル・ロックのための累算待ち時間 (QW0316W4)。このオプションは、QWALFLTR=X'01' の場合のみ有効。(WQALFFL4)
'5'
他のスレッドによる読み取り活動のための累算待ち時間 (QW0316W5)。 このオプションは、QWALFLTR=X'01' の場合のみ有効。(WQALFFL5)
'6'
他のスレッドによる書き込みアクティビティーのための累算待ち時間 (QW0316W6)。 このオプションは、QWALFLTR=X'01' の場合のみ有効。(WQALFFL6)
'7'
ロック要求のための累算待ち時間 (QW0316W7)。このオプションは、QWALFLTR=X'01' の場合のみ有効。(WQALFFL7)。
'8'
統計が最後に変更されたときの更新タイム・スタンプ (QW0316W8)。 このオプションは、QWALFLTR=X'01' の場合のみ有効。(WQALFFL8)。
'9'
ステートメントが最初に動的ステートメント・キャッシュまたは EDM プールに入ったときの挿入タイム・スタンプ (QW0316W9)。QWALFLTR=X'01'。(WQALFFL9)
WQALFVAL A8 符号付き 4 バイト整数 IFCID 0316 要求の場合、WQALFLTR が X'02' であれば、 このフィールドと WQALFFLD によって、Db2 が報告するキャッシュ・ステートメントが決められます。

報告の対象にするには、キャッシュ・ステートメントは WQALFFLD の値を 持つ必要があり、その値が WQALFVAL に指定された値以上で なければなりません。Db2 は、戻り域に収まるできるだけ多くの、この条件を満たすステートメントの情報を報告します。

WQALSTNM AC 文字、16 バイト IFCID 0317 要求の場合、WQALFLTR が X'04' でなければ、 このフィールドは Db2 が報告するキャッシュ・ステートメントの名前を指定します。 これは、Db2 がステートメントをキャッシュする時に生成する名前です。 この名前を入手するには、IFCID 0316 に対して READS 要求を出します。 名前はフィールド QW0316NM に置かれます。 このフィールドと WQALSTID によって、キャッシュ・ステートメントが固有に識別されます。
WQALSTID BC 符号なしの 4 バイト整数 IFCID 0316 または IFCID 0317 要求の場合、 このフィールドは Db2 が報告するキャッシュ・ステートメントの ID を指定します。Db2 は、ステートメントのキャッシュ時にこの ID を生成します。
ID を取得するには、以下の オプションを使用します。
  • IFCID 0317 要求の場合、WQALFLTR が X'04' でなければ、IFCID 0316 に対して READS 要求を出すことによって、この ID を取得します。ID はフィールド QW0316TK に置かれます。 このフィールドと WQALSTNM によって、キャッシュ・ステートメントが固有に識別されます。
  • IFCID 0316 または IFCID 0317 要求の場合、WQALFLTR が X'04' であれば、IFCID 0172 または IFCID 0196 に対して READS 要求を出すことによって、この ID を取得します。ID は、フィールド QW0172H9 (デッドロックの保有者のキャッシュ・ ステートメント ID)、QW0172W9 (デッドロックの待機者用のキャッシュ・ステートメント ID)、 または QW0196H9 (タイムアウトの保持者用のキャッシュ・ステートメント ID) にあります。この フィールドによって、キャッシュ・ステートメントが固有に識別されます。
WQALEUID C0 文字、16 バイト ユーザーのワークステーション・ユーザー ID の最初の 16 バイト。この値は、Db2 への接続に使用した許可 ID と異なってもかまいません。
WQALEUTX D0 文字、32 バイト ユーザーが実行しているトランザクションまたはアプリケーションの名前の最初の 32 バイト。 この値は、アプリケーションの実行に使用されるプロダクトではなく、 実行中のアプリケーションを識別します。
WQALEUWN F0 文字、18 バイト ユーザーのワークステーション名の最初の 18 バイト。この値は、Db2 への接続に使用した許可 ID と異なってもかまいません。
WQALPLOC 102 文字、128 バイト パッケージのロケーション名。
WQALPCOL 182 文字、128 バイト ユーザーが実行しているパッケージのコレクション名。
WQALPPNM 202 文字、128 バイト ユーザーが実行しているパッケージのプログラム名。
WQALROLE 282 文字、128 バイト ユーザーの接続ロール。クライアントがこの情報を提供しない場合、 このフィールドには 2 進ゼロが含まれます。
WQALRTBL 302 文字、128 バイト 参照される表の名前。
WQALEXCD 382 文字、4 バイト このフィールドは、実行する除外フィルターのレベルを次の値に従って指定します。
X'80000000'
除外フィルターをプラン名 (WQALPLAN) によって指定します。
X'40000000'
除外フィルターを現在の許可 ID (WQALAUTH) によって指定します。
X'20000000'
除外フィルターをオリジナルの許可 ID (WQALOPID) によって指定します。
X'10000000'
除外フィルターを接続名 (WQALCONN) によって指定します。
X'08000000'
除外フィルターを相関名 (WQALCORR) によって指定します。
X'04000000'
除外フィルターをキャッシュ・ステートメント (WQALASID) によって指定します。
X'02000000'
除外フィルターをロケーション名 (WQALLUWI) によって指定します。
X'01000000'
除外フィルターをロケーション名 (WQALLOCN) によって指定します。
X'00800000'
除外フィルターをワークステーション ID (WQALEUID) によって指定します。
X'00400000'
除外フィルターをトランザクション名またはアプリケーション名 (WQALEUTX) によって指定します。
X'00200000'
除外フィルターをワークステーション名 (WQALEUWN) によって指定します。
X'00100000'
除外フィルターをパッケージ・ロケーション名 (WQALEPLOC) によって指定します。
X'00080000'
除外フィルターをパッケージ・コレクション名 (WQALEPCOL) によって指定します。
X'00040000'
除外フィルターをパッケージ・プログラム名 (WQALEPPNM) によって指定します。
X'00002000'
除外フィルターを接続ロール (WQALEROLE) によって指定します。
  386 文字、2 バイト 予約済み
WQALFVAL64 388 符号付き整数、8 バイト IFCID 0316 および 0401 要求の 64 ビットのしきい値。値がゼロでなく、ターゲット・システムがDB2® 10 以降である場合は、この値は WQALFVAL の代わりに使用されます。
変更の始まりWQALLRBA変更の終わり 変更の始まり390変更の終わり 変更の始まり文字、12 バイト変更の終わり 変更の始まりIFCID 129 では、3 番目から 12 番目のバイトが、返される CI の開始ログ RBA です。 上位 2 バイトは使用されません。

IFCID 306 の場合:

  • WQALLMOD が 'D' の場合、上位 2 バイトはメンバー ID で、残りのバイトは使用されるログ RBA または LRSN です。
  • WQALLMOD が 'F' の場合、3 番目から 12 番目のバイトが、使用されるログ RBA または LRSN です。 上位 2 バイトは使用されません。
変更の終わり
WQALWQLS 変更の始まり3A0変更の終わり アドレス、4 バイト 将来のために予約済みです。 0 でなければなりません。
WQALWQL4 変更の始まり3A4変更の終わり アドレス、4 バイト WQLS のアドレス、または 0。
変更の始まり予約済み変更の終わり 変更の始まり3A8変更の終わり 変更の始まり文字、8 バイト変更の終わり 変更の始まり予約済み変更の終わり
注:
  1. DDF/RRSAF 147/148 ロールアップ・レコードに有効なフィルター は、WQALEUID、WQALEUTX、および WQALEUWN のみです。147/148 要求では、以下の WQAL フィールドのいずれか が X'00' ではない場合、DDF/RRSAF レコードは処理されません。
    • WQALACE
    • WQALAUTH
    • WQALOPID
    • WQALPLAN
    • WQALCORR
    • WQALLUWI
    • WQALLOCN
    • WQALASID
    • WQALCONN
    • WQALPLOC
    • WQALPCOL
    • WQALPPNM
    • WQALROLE

変更の始まりWQLS は、IFCID 0306 レコードをフィルターに掛けるために使用するエリアをマップします。 修飾域の長さが 2 進ゼロでない限り (この場合は、修飾域は存在しません)、モニター・プログラムにより提供される修飾域の アドレスは、次の表に示されているモニター・プログラムによりフォーマットされるエリアを指しています。変更の終わり

変更の始まり
表 2. WQALWQLS の修飾域のフィールド. このエリアは、アセンブラー・マッピング・マクロ DSNDWQAL によりマップされます。このエリアは、IFCID 0306 レコードをフィルターに掛けるために使用するエリアをマップします。
名前 16 進オフセット データ・タイプ 説明
WQLSLEN 0 符号付き整数、4 バイト WQLS の長さ。
WQLSEYE 4 文字、2 バイト ブロックの目印 (WQLS)
予約済み 8 文字、48 バイト 予約済み
WQLSTYPE 38 文字、4 バイト 修飾項目のタイプ
WQLSITEM 3C 符号付き整数、4 バイト 修飾項目の数
WQLSLIST 40 配列 WQLSDBPS 内の修飾項目のリスト。
変更の終わり

変更の始まりWQLSDBPS は、WQLS のオフセット X'40' に配置されています。変更の終わり

変更の始まり
表 3. WQLSDBPS の修飾域のフィールド. このエリアは、アセンブラー・マッピング・マクロ DSNDWQAL によりマップされます。このエリアは、WQLSTYPE='DBPS' の場合に IFCID 0306 レコードをフィルターに掛けるために使用するエリアをマップします。
名前 16 進オフセット データ・タイプ 説明
WQLSDBID 0 16 進、2 バイト データベースの DBID。
WQLSPSID 2 16 進、2 バイト 表スペースの PSID、または ALTER TABLE 診断ログ・レコードの表の OBID。
変更の終わり

モニター・プログラムが修飾域を初期化しないと、READS 要求 は拒否されます。

IFCID が使用する修飾フィールド

以下の表に、同期データが含まれる特定の IFCID に使用可能な修飾フィールドをリストします。これらの IFCID の説明については、READS 要求のトレース・フィールドを参照してください。

表 4. 特定の IFCID が使用する修飾フィールド
これらの IFCID 使用できる修飾フィールド すべての修飾を使用するための最小の長さ (WQALLEN 定数)3
0001, 0002, 0104, 0106, 0202, 0217, 0225, 0230, 0373 なし。 すべての修飾が無視される。 適用されない。
0124, 0147, 0148, 0150, 0346
  • WQALACE
  • WQALAIT2
  • WQALPLAN1
  • WQALAUTH1
  • WQALOPID1
  • WQALCONN1
  • WQALCORR1
  • WQALASID
  • WQALLUWI1
  • WQALLOCN1
  • WQALEUID
  • WQALEUTX
  • WQALEUWN
  • WQALPLOC
  • WQALPCOL
  • WQALPPNM
  • WQALROLE1
WQALLN9
0129
  • WQALLTYP
  • WQALLMOD
  • WQALLRBA
  • WQALLNUM
WQALLN23
0149
  • WQALREST
  • WQALHASH
WQALLN6
0150
  • WQALFOPT
WQALLN21
0185
  • WQALCDCD
WQALLN4
0199、0254
  • WQALGBPN2
WQALLN5
0306
  • WQALFLTR
  • WQALLMOD
  • WQALLRBA
  • WQALLCRI
  • WQALLOPT
  • 変更の始まりWQALWQLS変更の終わり
WQALLN11
0316
  • WQALFLTR
  • WQALFFLD
  • WQALFVAL
  • WQALFVAL64
  • WQALSTID

以下のフィールドによるフィルター処理は、IFCID 0316 のその他すべてのフィルターが適用された後に限り適用されます。

  • WQALEUID
  • WQALEUTX
  • WQALEUWN
  • WQALRTBL
WQALLN9
0317
  • WQALFLTR
  • WQALSTNM
  • WQALSTID
WQALLN5
0401
  • WQALFLTR
  • WQALFFLD
  • WQALFVAL
  • WQALFVAL64
WQALLN9
注:
  1. Db2 によって、フィールドを部分的に修飾し、 残りのフィールドを 2 進ゼロで埋めることができます。例えば、CICS® スレッド の 12 バイトの相関値には、位置 5 から 8 に 4 文字の CICS トランザクション・コードが含まれています。CICS トランザクション・コード AAAA を想定すると、次の 16 進 qual-area 相関修飾を使用して、相関値 AAAA (5 から 8 桁目が X'00000000C1C1C1C100000000') を持つ最初のトランザクションを検出できます。
  2. このフィールドの X'00' は、パターン・マッチング文字を示します。X'00' がこのフィールドのどの位置にあってもそれが示していることは、バッファー・プール (その名にはその位置とすべての後続位置に任意の文字が含まれている) に対して IFI がデータを収集するということです。
  3. 指定の WQALLEN 定数は、指定の IFICID のすべての修飾を使用するために必要な最小修飾域の長さを表します。任意の IFCID に関して、長さを大きくして指定することも可能です。 ただし、長さは、こうした定数のいずれかと一致しなければなりません。

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