グローバル・トレースの開始

Db2® グローバル・トレースは、(インストール・アクションまたはマイグレーション・プロセス時に指定されるパラメーターによって) 始動時に自動的に開始するか、または -START TRACE(GLOBAL) コマンドを使用して開始できます。

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

グローバル・トレースは、Db2 内で行われる主な機能イベントや例外イベントに関連したデータを提供します。トレースが開始すると、Db2 は 1 から 32 までのトレース番号 (TNO) を割り当てます。この番号マスクは、SMF または GTF に外部化される標準トレース・レコード・ヘッダーに表示されます。

次の例に示されるように、Db2 グローバル・トレースを他のトレース・タイプと区別するために、トレースの開始時に「GLOBAL」を指定してください。

-START TRACE(GLOBAL)

Db2 をインストールまたはマイグレーションするときに、グローバルな保守容易性データの収集を開始します。Db2 グローバル・トレースによって記録されるイベントは、イベント ID (EID) で識別されます。EID は、Db2 が外部化するグローバル・トレース・レコードに表示されます。

グローバル・トレースの適用範囲の制限

診断に役立つようにグローバル・トレースの適用範囲を制限するには、複数のキーワードを指定できます。

CLASS
トレースがモニターするイベントの 1 つ以上のクラス
DEST
トレース・データが送信される先の 1 つ以上の宛先
PLAN
トレースがモニターする 1 つ以上の特定の Db2 プラン
AUTHID
トレースがモニターする 1 つ以上の特定の許可 ID
RMID
トレースがモニターする 1 つ以上の特定のリソース・マネージャー
IFCID
トレースがモニターする計測機能構成コンポーネント ID (IFCID)
LOCATION
トレースがモニターする特定のロケーション

COMMENT キーワードはトレースの適用範囲を制限するのではなく、その目的を定義します。TDATA キーワードは、各レコードに置かれるヘッダーを指定します (レコードの宛先が RES である場合を除く)。

複数のトレース

使用するキーワードとパラメーターに応じて、1 つの -START TRACE コマンドで複数のトレースを呼び出すことができます。

  • PLAN または AUTHID に指定される複数のパラメーターは、複数のトレースを呼び出します。次のコマンドは、3 つのトレースを呼び出します。
    -START TRACE(GLOBAL) AUTHID(USER1,USER2,USER3)

    これらのトレースの表示と停止を、個別に、またはまとめて行うことができます。

  • CLASS、DEST、または RMID に指定される複数のパラメーターは、1 つのトレースのみを呼び出します。次のコマンドは 1 つのトレースを呼び出します。
    -START TRACE(GLOBAL) DEST(SMF,GTF)

    このコマンドによって開始された個々のクラスまたは宛先は、表示することも停止することもできません。

クラスの指定

CLASS キーワードは、グローバル・トレースに特定のクラスまたはタイプのトレース・イベントを指定します。

  • クラス 1. 主要機能と例外用に予約済み
  • クラス 2. ユーティリティーのトレース、および中程度の機能用に予約済み
  • クラス 3. その他のすべてのモジュール入り口/出口
  • クラス 4. 予約済み
  • クラス 5. 予約済み
  • クラス 6. IFI でのインストール使用に予約済み
  • クラス 7. 分散イベント用
  • クラス 8. 要求と応答のロケーションでの分散イベントに対する SQL ステートメントのトレース用
  • クラス 9. DDF 診断情報のトレース用
  • クラス 10. 詳細な DBM1 ストレージ使用情報のトレース用

グローバル・トレース・コマンドのデフォルトは、トレース・クラス 1、2、および 3 の開始です。「CLASS」は通常、グローバル・トレースに指定してはなりません。

重要: グローバル・トレース・クラス 1、2、および特に 3 は、システム・パフォーマンスを大幅に低下させ、GTF または SMF に外部化される場合に大量のデータを生成する可能性があります。

クラス 7 が指定される場合、以下のイベントがトレースされます。

  • Db2 への VTAM® 出口
  • すべての VTAM 呼び出し/戻り
  • バッファー送信/受信
  • Db2 のキューに入れられた会話割り振り要求

クラス 8 が指定される場合、以下のイベントがトレースされます。

  • 変更前にロケーション SQL ステートメントの要求
  • 変更後にロケーション SQL ステートメントの要求と応答の両方

宛先の指定

DEST キーワードは、グローバル・トレース・データが送信される先のロケーションを指定します。

宛先には以下のものがあります。

  • RES — 常駐トレース表
  • GTF — 汎用トレース機能
  • OPn — トレース出力の宛先
  • SMF — システム管理機能
  • SRV — 保守容易性ルーチン

デフォルト宛先は常駐トレース表 (RES) です。これは、拡張共通サービス域 (ECSA) の 16 MB 境界より上にあります。インストール定義パラメーター TRACTBL は、RES が存在するかどうか、およびそのサイズを決定します。グローバル・トレース・データは、GTF、SMF、または OPn にも送信できます (ここで、n は、特定の宛先に対応する、1 から 8 までの値です)。SMF は推奨されません。SRV は IBM® サービス担当員用に予約されています。

DEST キーワードを使用してロケーションを指定する場合は、適切な省略形を使用してください。例えば、 DEST (汎用トレース機能) ではなく、DEST(GTF) を指定します。

-START TRACE(GLOBAL) DEST(GTF)

トレース・データを複数の宛先に送信できます。次の例では、RES と GTF の両方にデータを送信します。

-START TRACE(GLOBAL) DEST(GTF,RES)

プランの指定

PLAN キーワードは、特定の 1 つ以上の Db2 プランのアクティビティーにトレースを制限します。最大 8 つのプラン名を指定できます。デフォルトはアスタリスク (*) です。これは、すべてのプランに対するトレースを呼び出します。

複数のプランが指定される場合は、複数のトレースが呼び出されます。次の例では、SAMPLE1 のトレースと SAMPLE2 のトレースを呼び出します。

-START TRACE(GLOBAL) PLAN(SAMPLE1,SAMPLE2)

トレースが複数のプランに対して呼び出される場合、1 つの許可 ID のみを指定してください。

許可 ID の指定

AUTHID キーワードは、最大 8 つの許可 ID のアクティビティーにトレースを制限します。指定される許可 ID は、1 次許可 ID でなければなりません。デフォルトはアスタリスク (*) です。これは、すべての現行の 1 次許可 ID に対するトレースを呼び出します。

複数の許可 ID が指定される場合は、複数のトレースが呼び出されます。次の例では、USER1 に対する 1 つのトレースと USER2 に対する 1 つのトレースを呼び出します。

-START TRACE(GLOBAL) AUTHID(USER1,USER2)

トレースが複数の許可 ID に対して呼び出される場合、1 つのプランのみを指定してください。

リソース・マネージャーの指定

RMID キーワードは、特定の Db2 リソース・マネージャーのアクティビティーにトレースを制限します。最大 8 つのリソース・マネージャーを指定できます。デフォルトはアスタリスク (*) です。これは、任意のリソース・マネージャーに対するトレースを呼び出します。

次の表は、グローバル・トレースの RMID を示しています。

表 1. リソース・マネージャー ID (RMID)
RMID Dec(Hex) リソース・マネージャー
1(01) 初期設定プロシージャー
2(02) エージェント・サービス管理
3(03) リカバリー管理
4(04) リカバリー・ログ管理
6(06) ストレージ管理
7(07) 関連メモリーに対するサブシステム・サポート
8(08) SSI 機能に対するサブシステム・サポート
9(09) 予約済み
10(0A) バッファー管理
11(0B) 予約済み
12(0C) システム・パラメーター管理
13(0D) プリコンパイラー
14(0E) データ管理
15(0F) 予約済み
16(10) 計測コマンド、トレース、ダンプ・サービス
17(11) LOB 管理
18(12) データ・スペース管理
19(13) データ・スペース管理、AMS サブコンポーネント
20(14) サービス・コントローラー
21(15) データベース・ユーティリティー
22(16) リレーショナル・データベースのサポート
23(17) 汎用コマンド処理
24(18) メッセージ生成プログラム
25(19) 分散リレーショナル・データ・システム・マネージャー
26(1A) 計測アカウンティングおよび統計
27(1B) 分散通信リソース・マネージャー
28(1C) 分散トランザクション・マネージャー (DDF アドレス・スペース)
29(1D) Distributed Data Interchange Services
30(1E) 分散トランザクション・マネージャー (DSCF アドレス・スペース)
31(1F) グループ・マネージャー

PLAN キーワードや AUTHID キーワードとは異なり、複数の RMID が指定される場合でも、複数のトレースは開始しません。次の例では、5 つのリソース・マネージャーに対して 1 つのトレースを呼び出します。

-START TRACE(GLOBAL) RMID(1,7,14,18,24)

IFCID の指定

IFCID キーワードは、オプションで開始する IFCID (トレース・イベント) を指定します。

トレース・タイプが指定される場合、START TRACE コマンドで指定されるトレース・タイプの有効な IFCID とクラスがすべて開始されます。

ロケーションの指定

LOCATION キーワードは、リモート・ロケーションに接続されているスレッドのアクティビティーにトレースを制限します。つまり、分散処理に関係するスレッドにトレースを制限します。

ローカル・ロケーションのトレース・レコードのみが記録されます。最大 8 つのロケーション名を指定できます。デフォルトは LOCATION(*) です。これは、リモート・ロケーションに接続されているかどうかに関係なく、任意のスレッドに対するトレースを呼び出します。

複数のロケーションが指定される場合は、複数のトレースが呼び出されます。次の例では、LOC1 に接続されているスレッドに対するトレースと、LOC2 に接続されているスレッドに対するトレースを呼び出します。

-STA TRACE(GLOBAL) LOCATION(LOC1,LOC2)

トレースが複数のロケーションに対して呼び出される場合、1 つのプランと 1 つの許可 ID のみを指定できます。

コメントの指定

COMMENT キーワードを使用すると、SMF または GTF に送信されるトレース・データに説明の句を付加することができます。 この情報は、複数のトレース間の区別に役立ちます。

SMF または GTF では、コメントは、「トレースの開始」が行われたことを文書化するレコード内に表示されます。RES では、コメントは表示されません。

コメントに任意の文字ストリングを入力してください。ただし、ブランク、コンマ、および特殊文字はアポストロフィで囲む必要があります。例えば、次のように指定します。

-START TRACE(GLOBAL) DEST(GTF)
   COMMENT('INVESTIGATE SQL LOOP')

このコマンドは、グローバル・トレースを開始し、データを GTF に送信します。GTF に書き込まれるトレース開始レコード (IFCID 0004) は、トレースが開始したことを示し、コメント 'INVESTIGATE SQL LOOP' を含みます。

トレース・レコード・ヘッダーの指定

TDATA キーワードは、各トレース・レコードの製品セクションに置かれている製品セクション・ヘッダーのタイプを指定します。グローバル・トレースのデフォルトはトレース・ヘッダーです。

TDATA 指定は、どの情報がレコードに付加されるかを示します。トレース・ヘッダーが必要な場合は、それを指定する必要があります。また、以下のいずれかの値も指定することができます。

  • レコード上に相関ヘッダーを配置する場合は、COR。
  • レコード上に CPU ヘッダーを配置する場合は、CPU。CPU ヘッダーには、z/OS® TCB または SRB の実行における現在の CPU 時間が示されます。
  • レコード上にトレース・ヘッダーを配置する場合は、TRA。
  • レコード上に分散ヘッダーを配置する場合は、DIST。

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