グローバル・トレースの開始
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」は通常、グローバル・トレースに指定してはなりません。
クラス 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 を示しています。
| 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。
