READS 要求のトレース・フィールド

モニター・プログラムでは、READS 関数を呼び出して、特定の具体的トレース・レコードからの同期データを要求できます。

プログラム固有のプログラミング・インターフェース情報の開始
計測機能インターフェースに対する READS 呼び出しでは、以下のトレース・レコードを要求できます。
0001
以下を含む、システム・サービス・アドレス・スペースに関する統計データ。
  • システム・サービスのタスク制御ブロック (TCB) およびサービス要求ブロック (SRB) 時間
  • データベース・サービス (DDF 統計を含む)
  • 内部リソース・ロック・マネージャー (IRLM) アドレス・スペース
  • LPAR、Db2® サブシステム、または Db2 アドレス・スペースごとの使用状況の情報
  • CPU 使用率
  • ストレージ・メトリック
0002
データベース・サービス・アドレス・スペースに関する統計データ。
0104
現在のアクティブ・ログ・データ・セットの情報
0106
静的システム・パラメーター。
01241
以下についての状況情報を提供するアクティブ SQL スナップショット。
  • 処理
  • SQL ステートメント・テキスト
  • リレーショナル・データ・システム入力パラメーター・リスト (RDI) ブロック
  • 特定のバインドおよびロッキング情報

要求では、プロセスが Db2 に接続され、プロセスにカーソル表が割り振られており (RDI および状況情報が提供されている)、そしてプロセスが Db2 でアクティブになっている (使用可能であれば SQL テキストが提供されている) ことが必要なので、取得されるデータの量は可変です。 用意される SQL テキストには、SQL ホスト変数は含まれません。また 4000 バイトに切り捨てられています。

動的 SQL の場合、IFI は、元の SQL ステートメントを用意します。RDISTYPE フィールドには、実行されている実際の SQL 機能が入ります。例えば、SELECT ステートメントの場合、RDISTYPE フィールドはカーソルのオープン、フェッチ、またはその他の機能が実行されていたことを 示す場合があります。 静的 SQL の場合、DECLARE CURSOR ステートメントが表示され、RDISTYPE はその機能を示します。RDISTYPE フィールドは、マッピング・マクロ DSNXRDI によりマップされます。

01291
Db2 リカバリー・ログ・レコードが含まれている 1 つ以上 の VSAM コントロール・インターバル (CI) を戻します。これらのレコードをリモート・サイト・リカバリー で使用するために戻す場合、IFI を使用できます。
01471
Db2 スレッドまたは非スレッド・レベルの処理の状況要約を示すアクティブ・スレッド・スナップショット。
01481
Db2 スレッドまたは非スレッド・レベルの処理のより詳細な状況を示す アクティブ・スレッド・スナップショット。
01491
どのエレメント (スレッド識別トークン) がロックを保持していて、特定の リソースおよびハッシュ・トークンのロック待ち状態であるかを示す情報。 このデータは、IFCID 0150 と同じフォーマットです。
01501
特定のユーザーまたは所有者 (スレッド識別トークン) により保持され、 待ち状態にあるすべてのロック。
0185
この DATA 要求で戻される獲得データが含まれている 各表に関するデータ記述。 IFCID 0185 データは、Db2 によって起動される伝搬出口ルーチンを 介してのみ使用可能です。
01991
Db2 データ・セットによるバッファー・プール使用情報。Db2 はこの情報を、 インストール・パネル DSNTIPN の DATASET STATS TIME フィールドで指定されたインターバルで報告します。各インターバルの開始時に、Db2 はこれらの統計を 0 にリセットします。
0202
動的システム・パラメーター。
0217
DBM1 アドレス・スペースに関するストレージ詳細レコード。
0225
DBM1 アドレス・スペースに関するストレージ要約レコード。
0230
データ共用に関するグローバル統計。
02341
ユーザー許可情報。
02541
データ共用グループ内のグループ・バッファー・プールの使用状況。
0306
データ共用または非データ共用環境で、圧縮されたまたは解凍された ログ・レコードを戻します。ログ・レコードを読み取るための IFCID 0306 の使用について詳しくは、完全なログ・データの読み取り (IFCID 0306)を参照してください。
03161
動的ステートメント・キャッシュの内容についての情報を戻します。IFI アプリケーションは、キャッシュ内のすべてのステートメントの情報を要求することができます。修飾パラメーターを指定すると、返されるデータを制限することができます。 Db2 はキャッシュされたステートメントについて、次の情報を報告します。
  • ステートメントを固有に識別するステートメント名と ID
  • IFCID 0318 がアクティブの場合は、ステートメントのパフォーマンス統計
  • ステートメント・テキストの最初の 60 バイト
0317
動的ステートメント・キャッシュ内の SQL ステートメントのテキスト 全体および PREPARE 属性ストリングを戻します。IFCID 0316 出力からの ステートメント名およびステートメント ID を入力する必要があります。動的ステートメント・キャッシュに関する情報を得るための IFI の使用法について詳しくは、READS 呼び出しによる動的ステートメント・キャッシュのモニターを参照してください。
0346
Db2 スレッドに対して、呼び出されたパッケージをすべてモニターします。
0369
接続タイプごとに集約したアカウンティング統計を返します。
0373
DSNHDECP ロード・モジュール、または Db2 の始動時に接続サブシステムによってロードされたユーザー指定のアプリケーションのデフォルト・モジュールへのポインターを戻します。
0401
EDM プール内でトラッキングされる静的 SQL ステートメントに関する情報を返します。 指定されたステートメントを使用してカタログを照会し、ステートメント・テキストを識別することができます。 IFCID 0400 がアクティブ化されると、データが累算されます。 静的 SQL ステートメントに関する情報を取得するための IFI の使用について詳しくは、READS 呼び出しによる静的 SQL ステートメントのモニターを参照してください。
注:
  1. 以下の IFCID フィールドは、READS 呼び出しでのみ使用できます。
    • 0124
    • 0129
    • 0147
    • 0148
    • 0149
    • 0150
    • 0199
    • 0234
    • 0254
    • 0316

IFCID フィールド記述について詳しくは、prefix.SDSNMACS データ・セットのマッピング・マクロを参照してください。

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