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

修飾域が存在しない場合 (2 進ゼロの長さ)、情報は、アクティブなすべての関連スレッドおよびデータベース・アクセス・スレッドから取得されます。 存在していても非アクティブなデータベース・アクセス・スレッドに関しては、 情報は獲得されません。
特定のトレース・レコードは修飾できません。 IFCID として 0001、0002、0106、0202、0217、0225、0230 が含まれるトレース・レコードの修飾は無視されます。
他のすべての同期レコードは修飾可能です。ただし、特定のトレース・レコードでは使用できる修飾フィールドが限定されます。 特定のトレース・レコードが使用可能な修飾についての情報は、表 4を参照してください。
READS 要求の修飾域フィールド
修飾域の長さが 2 進ゼロでない限り (この場合は、修飾域は存在しません)、モニター・プログラムにより提供される修飾域の アドレスは、次の表に示されているモニター・プログラムによりフォーマットされるエリアを指しています。
| 名前 | 16 進オフセット | データ・タイプ | 説明 |
|---|---|---|---|
| WQALLEN | 0 | 符号付き 2 バイトの整数 | 修飾域の長さ + 4。
以下の定数は修飾域長さフィールドを設定します。
特定のトレース・レコードが使用可能な修飾フィールドについての情報は、表 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 用のフィルター・オプション。
|
| WQALFLGS | 63 | 16 進、1 バイト | 147/148 レコードに対するオプション。
|
| 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 バイト | ログ・データ・アクセスのモード
![]()
|
| WQALLNUM | 90 | 16 進、2 バイト | 戻されるログ CI 数。有効範囲は、X'0001' から X'0007' までです。 |
| WQALCDCD | 92 | 文字、1 バイト | データ記述要求フラグ
|
| 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 バイト | ログ・レコード選択基準 どのタイプのログ・レコードが返されるかを示します。
|
| WQALLOPT | A5 | 16 進、1 バイト |
圧縮解除に関連する処理オプション:
|
| WQALFLTR | A6 | 16 進、1 バイト | IFCID 0316 要求用に、WQALFLTR は
フィルター方式を指定します。
IFCID 0401 要求の場合:
IFCID 0317 要求用に、WQALFLTR は
フィルター方式を指定します。
|
| WQALFFLD | A7 | 文字、1 バイト | IFCID 0316 要求の場合、WQALFLTR が X'01' または X'02' であれば、このフィールドは、Db2 が報告するキャッシュ・ステートメントを決めるために使用される統計フィールドを指定します。
以下の値を入力することができます。
(次の行に続く。) |
| WQALFFLD
(続き) |
A7 | 文字、1 バイト | (前の行からの続き。 )
|
| 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 を取得するには、以下の
オプションを使用します。
|
| 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 バイト | このフィールドは、実行する除外フィルターのレベルを次の値に従って指定します。
|
| 386 | 文字、2 バイト | 予約済み | |
| WQALFVAL64 | 388 | 符号付き整数、8 バイト | IFCID 0316 および 0401 要求の 64 ビットのしきい値。値がゼロでなく、ターゲット・システムがDB2® 10 以降である場合は、この値は WQALFVAL の代わりに使用されます。 |
WQALLRBA![]() |
390![]() |
文字、12 バイト![]() |
IFCID 129 では、3 番目から 12 番目のバイトが、返される CI の開始ログ RBA です。
上位 2 バイトは使用されません。IFCID 306 の場合:
![]() |
| WQALWQLS | 3A0![]() |
アドレス、4 バイト | 将来のために予約済みです。 0 でなければなりません。 |
| WQALWQL4 | 3A4![]() |
アドレス、4 バイト | WQLS のアドレス、または 0。 |
予約済み![]() |
3A8![]() |
文字、8 バイト![]() |
予約済み![]() |
- 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 進ゼロでない限り (この場合は、修飾域は存在しません)、モニター・プログラムにより提供される修飾域の
アドレスは、次の表に示されているモニター・プログラムによりフォーマットされるエリアを指しています。

| 名前 | 16 進オフセット | データ・タイプ | 説明 |
|---|---|---|---|
| WQLSLEN | 0 | 符号付き整数、4 バイト | WQLS の長さ。 |
| WQLSEYE | 4 | 文字、2 バイト | ブロックの目印 (WQLS) |
| 予約済み | 8 | 文字、48 バイト | 予約済み |
| WQLSTYPE | 38 | 文字、4 バイト | 修飾項目のタイプ |
| WQLSITEM | 3C | 符号付き整数、4 バイト | 修飾項目の数 |
| WQLSLIST | 40 | 配列 | WQLSDBPS 内の修飾項目のリスト。 |

WQLSDBPS は、WQLS のオフセット X'40' に配置されています。

| 名前 | 16 進オフセット | データ・タイプ | 説明 |
|---|---|---|---|
| WQLSDBID | 0 | 16 進、2 バイト | データベースの DBID。 |
| WQLSPSID | 2 | 16 進、2 バイト | 表スペースの PSID、または ALTER TABLE 診断ログ・レコードの表の OBID。 |

モニター・プログラムが修飾域を初期化しないと、READS 要求 は拒否されます。
IFCID が使用する修飾フィールド
以下の表に、同期データが含まれる特定の IFCID に使用可能な修飾フィールドをリストします。これらの IFCID の説明については、READS 要求のトレース・フィールドを参照してください。
| これらの IFCID | 使用できる修飾フィールド | すべての修飾を使用するための最小の長さ (WQALLEN 定数)3 |
|---|---|---|
| 0001, 0002, 0104, 0106, 0202, 0217, 0225, 0230, 0373 | なし。 すべての修飾が無視される。 | 適用されない。 |
| 0124, 0147, 0148, 0150, 0346 | WQALLN9 | |
| 0129 |
|
WQALLN23 |
| 0149 |
|
WQALLN6 |
| 0150 |
|
WQALLN21 |
| 0185 |
|
WQALLN4 |
| 0199、0254 |
|
WQALLN5 |
| 0306 |
|
WQALLN11 |
| 0316 |
以下のフィールドによるフィルター処理は、IFCID 0316 のその他すべてのフィルターが適用された後に限り適用されます。
|
WQALLN9 |
| 0317 |
|
WQALLN5 |
| 0401 |
|
WQALLN9 |
- Db2 によって、フィールドを部分的に修飾し、 残りのフィールドを 2 進ゼロで埋めることができます。例えば、CICS® スレッド の 12 バイトの相関値には、位置 5 から 8 に 4 文字の CICS トランザクション・コードが含まれています。CICS トランザクション・コード AAAA を想定すると、次の 16 進 qual-area 相関修飾を使用して、相関値 AAAA (5 から 8 桁目が X'00000000C1C1C1C100000000') を持つ最初のトランザクションを検出できます。
- このフィールドの X'00' は、パターン・マッチング文字を示します。X'00' がこのフィールドのどの位置にあってもそれが示していることは、バッファー・プール (その名にはその位置とすべての後続位置に任意の文字が含まれている) に対して IFI がデータを収集するということです。
- 指定の WQALLEN 定数は、指定の IFICID のすべての修飾を使用するために必要な最小修飾域の長さを表します。任意の IFCID に関して、長さを大きくして指定することも可能です。 ただし、長さは、こうした定数のいずれかと一致しなければなりません。
