-START TRACE コマンド ( )Db2

-START TRACE コマンドは Db2 のトレースを開始します。

このコマンドにはもう 1 つのオプションがあり、またその他のいくつかのオプションにも追加の値があります。 この追加情報は、 IBM® サポートの指示の下でのサービスおよび使用を目的としています。

省略形: -STA TRA

環境 -START TRACE

このコマンドは、 z/OS® コンソール、DSNセッション、 DB2I パネル（ DB2 COMMANDS）、 IMS または CICS® 端末、または計装機能インターフェース（IFI）を使用するプログラムから発行できます。

データ共有の範囲： グループまたはメンバー

承認 -START TRACE

このコマンドを実行するには、次のいずれかの特権または権限を含む処理の特権セットを 使用する必要があります。
  • TRACE 特権
  • SQLADM 権限
  • システム DBADM 権限
  • SYSOPR 権限
  • SYSCTRL 権限
  • SYSADM 権限
  • SECADM 権限

ログオンしている z/OS コンソールまたは TSO SDSF から発行された Db2 コマンドは、1 次および 2 次許可 ID を使用して Db2 許可によって検査することができます。 変更の開始 z/OS にログインしたユーザーIDは、 または同様のセキュリティサーバーで定義されている必要があります。 RACF変更の終わり

構文 -START TRACE

構文図を参照するビジュアルシンタックスダイアグラムをスキップするSTART TRACE(PERFMACCTGSTATAUDITMONITOR)DEST(,GTFSMFSRVOP nOPX)constraint blockfiltering blockRMIDCOMMENT( ストリング)SCOPE(LOCALGROUP)

constraint block

構文図を参照するビジュアルシンタックスダイアグラムをスキップするPLAN(*,plan-name部分計画名)PKGLOC(*,パッケージの場所部分パッケージ場所)PKGCOL(*,パッケージコレクションID部分パッケージ収集ID)PKGPROG(*,パッケージプログラム名部分パッケージプログラム名)AUTHID(*,authorization-id部分承認ID)CLASS(*,整数)LOCATION(*,location-name< luname>部分< luname> *ipaddr部分IPアドレス)USERID(*,ユーザーID部分ユーザＩＤ)APPNAME(*,アプリケーション名部分的なアプリケーション名)WRKSTN(*,ワークステーション名部分ワークステーション名)CONNID(*,connection-idぶぶんせつぞくアイディー)CORRID(*,相関 ID (correlation-id)部分相関ID)ROLE(*,コネクションロール部分接続役割 ID)IFCID(*,IFCID)BUFSIZE(*kバイト)AUDTPLCY12(,ポリシー名)TDATA(,CORRELATIONTRACECPUDISTRIBUTED)ASID(x' dddd')
注:
  • 1 AUDTPLCYでCLASSまたはIFCIDを指定しないでください。 AUDTPLCY はトレース・タイプ AUDIT に適用されます。
  • 2 異なるフィルタリング条件で複数のAUDTPLCYトレースを指定すると、すべてのAUDTPLCYトレースのフィルタリングがUNION形式になります。

filtering block

構文図を参照するビジュアルシンタックスダイアグラムをスキップするXPLAN(,plan-name部分計画名)XPKGLOC(,パッケージの場所部分パッケージ場所)XPKGCOL(,パッケージコレクションID部分パッケージ収集ID)XPKGPROG(,パッケージプログラム名部分パッケージプログラム名)XAUTHID(,authorization-id部分承認ID)XLOC(,location-name部分位置名<luname>部分< luname> *ipaddr部分IPアドレス)XUSERID(,ユーザーID部分ユーザＩＤ)XAPPNAME(,アプリケーション名部分的なアプリケーション名)XWRKSTN(,ワークステーション名部分ワークステーション名)XCONNID(,connection-idぶぶんせつぞくアイディー)XCORRID(,相関 ID (correlation-id)部分相関ID)XROLE(,コネクションロール部分接続役割 ID)

オプションの説明 -START TRACE

トレースのタイプを指定する必要があります。

オプション PERFM、ACCTG、STAT、AUDIT、および MONITOR は、 開始されたトレースのタイプを識別するものです。
( PERFM )
パフォーマンス・トレース (performance trace) は、パフォーマンスの分析とチューニングを目的としています。 このトレースには、システムの特定のイベントに関するレコードが含まれ、分散データ処理に関連したイベントのレコードも含まれます。 データは、プログラム、リソース、ユーザー、およびサブシステムに関連したチューニングのために使用できます。

省略形: P

( ACCTG )
アカウンティング・トレース (accounting trace) は、トランザクションの処理が完了した時点で書き込まれるトランザクション・レベルのデータを記録します。 Db2 キャパシティプランニングやアプリケーションプログラムのチューニングを行うためのデータを提供します。

略号：A

( STAT )
統計トレースは、 Db2 のさまざまなコンポーネントから一定の間隔で放送される統計データを収集します。 統計の収集間隔は、インストール中に指定できます。

省略形: S

統計トレースを選択するときは、LOCATION を指定できません。

( AUDIT )
監査証跡は、 Db2 のセキュリティ対策に関する情報を収集し、データアクセスが許可された目的のみに限定されていることを確認するために使用することができます。

省略形: AU

( MONITOR )
モニタートレースにより、接続されたモニタプログラムは、計測機能インターフェース（IFI）への呼び出しを通じて、 Db2 のトレースデータにアクセスすることができます。 モニター・プログラムからトレース・データにアクセスするには、READA 要求を発行することにより OPx バッファー経由で非同期にアクセスするか、READS 要求を発行することによりモニター戻り域経由で同期的にアクセスすることができます。

省略形: MON

SCOPE
データ共用グループのコマンドの有効範囲を指定します。
( LOCAL)
ローカル・メンバーのトレースのみを開始することを指定します。
(GROUP)
データ共用グループのメンバーすべてのトレースを開始することを指定します。

変更の開始FL 509 改ざん防止監査ポリシーを使用する監査トレースを開始する際に、SCOPE(GROUP) を指定することはできません。変更の終わり

ASID(x' dd dd')
トレース・データを収集するアドレス・スペースを指定します。

dddd は、4 バイトの 16 進アドレス・スペース ID (ASID) です。

COMMENT ( 文字列 )
トレース出力 (常駐のトレース・テーブルを除く) に複製されるコメントを付けます。 このオプション は、コマンドが出された理由を記録するために使用できます。

string は任意の文字ストリングです。ブランク、コンマ、または特殊文字を含んでいる場合はアポストロフィで囲む必要があります。

RMID
リソース・マネージャー ID を指定します。 最大 8 個までの有効な RMID (1 または 2 桁の ID) を指定できます。 アカウンティング・トレースまたは統計トレースに RMID を指定することはできません。
DEST
どこにトレース出力を記録するかを指定します。 複数の値を使用できますが、同じ値を 2 回使用してはなりません。 この値を指定しないと、トレース出力は、以下の表に示されているデフォルト宛先に送られます。

START TRACEコマンドを発行した後、指定した宛先がアクティブでなかったり、非アクティブになったりした場合は、 DSNW133I というメッセージが表示され、トレースデータが失われたことを示します。 これは GTF、SRV、 SMF といった宛先に適用されます。 さらに、OP n や OPX といった宛先についても、 アプリケーション・プログラムが START TRACE を出さないとこのメッセージを受け取ります。

省略形: D

指定可能な値とデフォルト値は、開始されるトレースのタイプによって異なります。 以下の表を参照してください。
表 1. トレース・タイプごとの指定可能な宛先
タイプ GTF SMF SRV OPn OPX
PERFM デフォルト 許可 許可 許可 許可
ACCTG 許可 デフォルト 許可 許可 許可
STAT 許可 デフォルト 許可 許可 許可
AUDIT 許可 デフォルト 許可 許可 許可
MONITOR 許可 許可 許可 許可 デフォルト
各値の意味は以下のとおりです。
GTF
z/OS generalized trace facility (GTF) Db2 からのレコードのレコード識別子は、 X'0FB9' です。
SMF
z/OS System Management Facilities (SMF) SMF のレコードタイプは、 のトレースレコードのIFCIDレコードに依存します。以下はその詳細です。 Db2
IFCID レコード
SMF レコード・タイプ
1 (システム・サービス統計)
0100
2 (データベース・サービス統計)
0100
3 (エージェント・アカウンティング)
0101
202 (動的システム・パラメーター)
0100
225 (システムストレージの概要統計)
0100
230 (データ共用グローバル統計)
0100
239 (パッケージ・アカウンティング)
0101
変更の開始369 (アカウンティング統計の集約)変更の終わり
変更の開始変更の終わり
変更の開始0100変更の終わり
すべてのその他
0102
SRV
ユーザー作成ルーチンへの出口。 このルーチンの作成方法とその例については、 ライブラリー prefix .SDSNMACS のマクロ DSNWVSER を参照してください。
OP n
特定の宛先。

n には 1 から 8 の整数を指定できます。

OPX
最初の空き OP n スロットを使用する総称宛先。

OP n バッファーに対するトレースを開始するアプリケーションだけが、その バッファーを読み取ることができます。

OPX 宛先へのトレースは、バッファーが未使用としてマークされる前に すべて停止しなければなりません。 前に使用中であった OPX バッファーに対してトレースを開始すると、 前のトレースが設定していた記憶域はそのトレースによって上書きされます。

制約ブロックおよびフィルター・ブロック

制約ブロックおよびフィルター・ブロックを使用して、トレースによって収集されるデータの種類に必要に応じて、オプションの制限を設けることができます。 フィルター・オプションは、対応する制約オプションと排他的に等価です。

変更の開始統計トレースの START TRACE コマンドでは、CLASS 制約オプションのみが許可されます。 その他のトレース・タイプの START TRACE コマンドでは、任意の制約オプションまたはフィルター・オプションを使用できます。 ただし、 Db2 は、以下のIFCIDのいずれかのトレースを開始する際に指定したフィルタや制約を使用しません。変更の終わり

IFCID IFCID IFCID IFCID IFCID IFCID IFCID IFCID IFCID IFCID
1 2 4 5 104 105 107 124 129 147
148 149 150 185 186 199 202 217 225 230
254 306 316 317 365 401 402 411 412  

START TRACE コマンドには、複数の制約オプションまたは複数のフィルター・オプション、あるいはその両方の組み合わせを含めることができます。 1 つの制約オプションまたはフィルター・オプションに、複数の値を含めることができます。 ただし、それぞれに複数の値が含まれる制約オプションをコマンドに複数含めることはできません。 次のオプションでは、複数値の単一制約オプションを指定することができます。

  • それぞれが単一値を持つ、他の複数の制約オプション
  • それぞれが単一値または複数値を持つ、複数のフィルター・オプション

それぞれが複数のオプションを持つ制約オプションが 2 つ以上 START TRACE コマンドに含まれている場合は、エラー・メッセージが出されます。

各オプションの意味は、以下のとおりです。 フィルター・オプションについて、対応する制約オプションとともに説明しています。

PLAN( 計画名 , …) または XPLAN( plan-name , …)
トレース情報の収集が行われる特定プランのリストを指定します。 指定したプランにトレースを制限するには、PLAN を使用します。また、指定したプランを除外するには、XPLAN を使用します。 このオプションは STAT トレースには使用できません。
デフォルトは PLAN( * ).
( * )
すべてのプランのトレースを開始します。
計画名
アプリケーション・プランの名前です。 8 つまでの名前を使用でき、 名前ごとに別々のトレースが開始されます。 複数の名前を使用する場合、AUTHID および LOCATION に使用できる値は 1 つだけです。
PKGLOC または XPKGLOC
パッケージがバインドされるロケーション名を指定します。 指定したロケーションにトレースを制限するには、PKGLOC を使用します。また、指定したロケーションを除外するには、XPKGLOC を使用します。
PKGCOL または XPKGCOL
パッケージ・コレクション名を指定します。 指定したコレクションにトレースを制限するには、PKGCOL を使用します。また、指定したコレクションを除外するには、XPKGCOL を使用します。
PKGPROG または XPKGPROG
DBRM またはプログラム名を指定します。 指定したプログラムにトレースを制限するには、PKGPROG を使用します。また、指定したプログラムを除外するには、XPKGPROG を使用します。
AUTHID( authorization-id または , …) または XAUTHID( authorization-id , …)
トレース情報の収集が行われる特定許可 ID のリストを指定します。 指定した許可 ID にトレースを制限するには、AUTHID を使用します。また、指定した許可 ID を除外するには、XAUTHID を使用します。 指定される許可 ID は、1 次許可 ID でなければなりません。 このオプションは STAT トレースには使用できません。
デフォルトは AUTHID( * ).
( * )
すべての許可 ID のトレースを開始します。
authorization-id
許可 ID を指定します。 8 つまでの ID を使用でき、ID ごとに別々のトレースが開始されます。 複数の ID を使用する場合、PLAN および LOCATION に使用できる値は 1 つだけです。
LOCATION (location-name, …) または XLOC (場所名, …)
トレース情報が収集されるロケーション名のリストを指定します。 指定したロケーションにトレースを制限するには、LOCATION を使用します。また、指定したロケーションを除外するには、XLOC を使用します。 LOCATION または XLOC オプションを使用すると、分散データ関係のないトレース・スレッドは除かれます。 統計トレースを開始するときは、LOCATION または XLOC を指定することはできません。
location-name
Db2 のサブシステムのうち、分散スレッドをトレースしたいものを特定します。 location-name で指定するリモート TCP/IP または SNA ロケーションの Db2 トレースをアクティブにします。

ロケーションは eight つまで指定でき、 それぞれに対して別々のトレースが開始されます。 複数の計画名または許可 ID を使用する場合には、 ロケーションは 1 つだけ指定できます。

<luname>
luname に指定したリモート SNA LU 名を介して DDF に接続されているリモート・クライアントの Db2 トレースをアクティブにします。
ipaddr
リモート TCP/IP ホスト経由で DDF に接続しているリモートクライアントの Db2 トレースを有効にします。 ipaddr はIPアドレスです。

IP アドレスの形式は、TCP/IP スタックが IPv4 専用スタックとして構成されているか、または二重モード・スタックとして構成されているかによって異なります。 IPv4 スタックは、IPv4 プロトコルのみをサポートします。 二重モード・スタックは、IPv4 プロトコルと IPv6 プロトコルをサポートします。

  • IPv4 専用スタックの場合は、以下の IPv4 形式で IP アドレスを入力します。
    x.x.x.x
  • 二重モード・スタックの場合:
    • IPv6 アドレスは、以下の IPv6 形式で入力します。
      y:y:y:y:y:y
    • IPv4 アドレスは、以下の IPv6 と IPv4 の二重形式で入力し、IPv6 部分として ::FFFF: を指定します。
      ::FFFF:x.x.x.x
(*)
分散スレッド下で発生したトレース・イベントを、接続された ロケーションに関係なく、開始することを指定します。 ローカル・ロケーション名を指定することは、LOCATION(*) を指定することと同じです。
Db2 for z/OS 以外のクライアント ： Db2 for z/OS は、 Db2 for z/OS サブシステム以外のクライアントからロケーション名を受信しません。 Db2 for z/OS サブシステムではないクライアントのトレースを開始するには、そのLUNAMEまたはIPアドレスを入力します。 LUNAME を、より小 (<) 記号とより大 (>) 記号で囲んでください。 IP アドレスは、 nnn.nnn.nnn.nnn の形式で入力してください。 例えば、LUNAME が LULA であるクライアントについてトレースを開始するためには、次の コマンドを入力します。
-START TRACE (PERFM) CLASS (*) LOCATION (<LULA>)
IP アドレスが 123.34.101.98 であるクライアントについてトレースを開始するためには、 次のコマンドを入力します。
-START TRACE (PERFM) CLASS (*) LOCATION (::FFFF:123.34.101.98)
USERID または XUSERID
ユーザー ID を指定します。 使用して USERID トレースを指定のユーザーIDに限定したり、 XUSERID 指定したユーザーIDを除外します。 使用上の注意に記載されているように、複数の値とワイルドカード値を指定することができます。

USERID および XUSERID 最大16文字まで可能です。

APPNAME または XAPPNAME
アプリケーション名を指定します。 使用して APPNAME トレースを指定のアプリケーションに限定したり、 XAPPNAME 指定したアプリケーションを除外します。 使用上の注意に記載されているように、複数の値とワイルドカード値を指定することができます。

APPNAME および XAPPNAME 最大32文字まで可能です。

WRKSTN または XWRKSTN
ワークステーション名を指定します。 使用して WRKSTN トレースを指定のワークステーションに限定したり、 XWRKSTN 指定したワークステーションを除外します。 使用上の注意に記載されているように、複数の値とワイルドカード値を指定することができます。

WRKSTN および XWRKSTN 最大18文字までです。

CONNID または XCONNID
接続 ID を指定します。 指定した接続にトレースを制限するには、CONNID を使用します。また、指定した接続を除外するには、XCONNID を使用します。

CONNID 値または XCONNID 値は、次のいずれかの値です。

CONNID 値 Db2 への接続のタイプ
BATCH BATCH
TSO TSO
DB2CALL QMF
UTILITY Db2 ユーティリティー
サブシステムID Db2 内部
シックス接続名 CICS
イムス接続名 IMS
RRSAF RRSAF
connection-name リモート Db2 for z/OS リクエスタからの接続。 この値は、要求ロケーションでのスレッドの接続名です。
SERVER Db2 for z/OS ではないリモートリクエスタからの接続。
CORRID または XCORRID
相関 ID を指定します。 指定した相関 ID にトレースを制限するには、CORRID を使用します。また、指定した相関 ID を除外するには、XCORRID を使用します。
ROLE または XROLE
接続ロール を指定します。 指定したロールにトレースを制限するには、ROLE を使用します。また、指定したロールを除外するには、XROLE を使用します。
CLASS( 整数 , …)
収集されるデータのクラスのリストを指定します。 指定可能なクラスとその意味は、開始されるトレースのタイプによって異なります。

省略形: C

CLASS オプションを省略すると、トレース・タイプ内のデフォルト・クラス がアクティブになります。 デフォルト・クラスについては、以下の表の説明列で示しています。
( * )
トレース・タイプのすべてのクラスのトレースを開始します。
整数
下表にあるいずれかの番号です。 開始されるトレースのタイプに可能なクラスの任意の番号を使用することが できます。
ヒント： 変更の開始IFCID番号は、 Db2 およびその文書では、ゼロを先頭に付けた3桁または4桁の数字で表記されることが多い。 例えば、「IFCID 1」、「IFCID 001」、または「IFCID 0001」などがあります しかし、これらの参照はそれぞれ同じ意味を持つと想定できます。変更の終わり
会計追跡 (ACCTG)
表 2. Db2 会計トレースのクラス
クラス クラスの説明 アクティブ化される IFCID
1 標準アカウンティング・データ。 また、アカウンティング・トレースを開始する際に、START TRACEコマンドから CLASS キーワードを省略した場合にも、クラス1が有効になります。 3, 106, 200, 239
2 Db2 イベントシグナリングへの参加または退出。 232
3 Db2 での経過待ち時間。 6、7、8、9、32、33、44、45、117、118、127、128、170、171、174、0175、213、214、215、216、226、227、242、243、321、 322、329、378、379、382、383 変更の開始、413、414変更の終わり
4 インストール先で定義されたアカウンティング・レコード。 151
5 IFI 要求の処理に費やされた時間。 187
6 予約されています。  
7 パッケージレベルの会計をDb2 時間で。 200、232、239、240
8 Db2 におけるパッケージレベルの会計待ち時間。 6、7、8、9、32、33、44、45、117、118、127、128、170、171、174、175、213、214、215、216、226、227、239、241、242、 243、321、322、378、379、382、383 変更の開始、413、414変更の終わり
10 パッケージの詳細。

IFCID 239の記録が書き込まれる前に、以下のトレースのうちの1つもアクティブにする必要があります

  • アカウンティングのクラス 7
  • アカウンティングのクラス 8
  • モニターのクラス 7
  • モニターのクラス 8
 239
11 プラン・レベルのアカウンティング情報。 クラス11は、アカウンティング・トレースを開始する際に、START TRACEコマンドから CLASS キーワードを省略すると有効になります。 IFCID 239レコードの返却を希望しない場合は、会計クラス11のトレースを開始します。 3,200
12-29 予約されています。  
30-32 ローカル用途に使用可能。  
監査トレース (AUDIT)
表 3. Db2 監査トレース用クラス
クラス クラスの説明 アクティブ化される IFCID
1 許可が不十分なために拒否されたアクセス試行。 また、監査トレースを開始する際に、START TRACEコマンドから CLASS キーワードを省略した場合にも、クラス1が有効になります。 140
2 明示的な GRANT および REVOKE。 141
3 監査対象の表に対する CREATE、ALTER、および DROP 操作。 142
4 監査対象のオブジェクトの最初の変更。 143
5 監査対象のオブジェクトの最初の読み取り。 144
6 監査対象のオブジェクトに関係する SQL ステートメントのバインド時情報。 145
7 許可 ID の割り当てまたは変更。 55, 83, 87, 169, 319
8 ユーティリティー。 23、24、25、219、220
9 インストール先で定義された監査レコード。 変更の開始146, 392変更の終わり
10 トラステッド・コンテキスト情報。 269, 270
11 正常なアクセスの監査。 3 6 11
12月29日 予約されています。  
30–32 ローカル用途に使用可能。  
注:
  1. START TRACE から IFCID 361 を開始すると、すべての成功したアクセスがトレースされます。 監査ポリシーのカテゴリ「SYSADMIN」が有効になっているため、IFCID 361が開始された場合、SYSADMIN管理権限を使用した成功したアクセスだけが追跡されます。 監査ポリシーカテゴリ DBADMIN が有効になっているため、IFCID 361 が開始された場合、DBADMIN 管理権限を使用した成功したアクセスのみが追跡されます。
統計トレース (STAT)
表 4. Db2 統計トレースのクラス
クラス クラスの説明 アクティブ化される IFCID
1 変更の開始システムサービス、データベース統計、 データベースサービスアドレス空間（ssnmDBM1 ） の統計、接続タイプごとの集約CPUおよび待機時間統計、およびトレースが開始された際に有効であったシステムパラメータに関する情報。変更の終わり

また、統計トレースを開始する際に、START TRACEコマンドから CLASS キーワードを省略した場合にも、クラス1が有効になります。

 1, 2, 105, 106, 202, 225, 369
2 インストール先で定義された統計レコード。 152
3 デッドロック、ロック・エスカレーション、グループ・バッファー・プール、データ・セット拡張情報、長時間実行されている非コミット読み取りの表示、アクティブ・ログ・スペースの不足。 172、196、250、258、261、262、313、330、335、337
4 Db2 例外的な状況。 173, 191, 192, 193, 194, 195, 203, 204, 205, 206, 207, 208, 209, 210, 235, 236, 238, 267, 268, 334,343, 402
5 Db2 データ共有統計。 230, 254
6 Db2 サブシステムのストレージ統計。 225
7 DRDA ロケーション統計。 365
8 データ・セット入出力の統計。 199 変更の開始、389変更の終わり
9 接続タイプ別に集約された CPU 時間と待機時間の統計。 369
変更の開始10変更の終わり 変更の開始CURRENT CLIENT_APPLNAME 特殊レジスタに基づく DRDA リモートアプリケーション統計。 顧客の在庫情報。変更の終わり 変更の開始411変更の終わり
変更の開始11変更の終わり 変更の開始CURRENT CLIENT_USERID 特殊レジスタに基づく DRDA リモートユーザー統計。 顧客の在庫情報。変更の終わり 変更の開始412変更の終わり
12月29日 予約されています。  
30-32 ローカル用途に使用可能。  
パフォーマンス・トレース (PERFM)
表 5. Db2 パフォーマンストレースのためのクラス
クラス クラスの説明 アクティブ化される IFCID
1 バックグラウンド・イベント。 また、パフォーマンス・トレースを開始する際に、START TRACEコマンドから CLASS キーワードを省略した場合にも、クラス1が有効になります。 1, 2, 31, 42, 43, 76, 77, 78, 79, 102, 103, 105, 106, 107, 153
2 サブシステム・イベント。 また、パフォーマンス・トレースを開始する際に、START TRACEコマンドから CLASS キーワードを省略した場合にも、クラス2が有効になります。 3, 68-75, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 106, 174, 175
3 SQL イベント。 また、パフォーマンス・トレースを開始する際に、START TRACEコマンドから CLASS キーワードを省略した場合にも、クラス3が有効になります。 22, 53, 55, 58, 59, 60, 61, 62, 63, 64, 65, 66, 92, 95, 96, 97, 106, 112、173、177、233、237、250、272、273、325
4 バッファーおよび EDM プールとの間の読み取り/書き込み。 6、7、8、9、10、29、30、105-107、127、128、226、227、321、322、477
5 ログへの書き込み。アーカイブ・ログ。 32、33、34、35、36、37、38、39、40、41、104、106、114、115、116、117、118、119、120、228、229
6 ロック情報のサマリー。 20、44、45、105、106、107、172、196、213、214、218、337
7 ロック情報の詳細。 21、105、106、107、223
8 データ・スキャンの明細。 13-18、105、106、107、125、221、222、231、305、311、 363
9 ソートの明細。 26、27、28、95、96、106
10 BIND、コマンド、ユーティリティーの明細。 23, 24, 25, 90, 91, 0105, 106, 107, 108, 109, 110, 111, 201, 256
11 実行単位切り替えとラッチ競合。 46-52、56、57、93、94、106、113
12 ストレージ・マネージャー。 98、99、100、101、106
13 編集および妥当性検査出口。 11、12、19、105、106、107
14 アプリケーションの開始と終了。 67、106、121、122
15 インストール先で定義されたパフォーマンス・レコード。 154
16 分散処理。 157、158、159、163、167、183
17 クレームおよびドレーンの情報。 211、212、213、214、215、216
18 イベント・ベースのコンソール・メッセージ。 197
19 データ・セットのオープンおよびクローズのアクティビティー。 370, 371
20 データ共用の一貫性の要約。 249、251、256、257、261、262、267、268
21 データ共用の一貫性の明細。 255、259、263
22 許可出口パラメーター。 314
23 言語処理環境の実行時診断。 327
24 ストアード・プロシージャーの明細。 380, 499
25-29 予約されています。  
30-32 ローカル用途に使用可能。  
モニター・トレース (MONITOR)
表 6. Db2 モニターの種類別クラス
クラス クラスの説明 アクティブ化される IFCID
1 標準アカウンティング・データ。 また、モニタートレースを開始する際に、START TRACEコマンドから CLASS キーワードを省略した場合にも、クラス1が有効になります。 200
2 Db2 イベントシグナリングへの参加または退出。 232
3 Db2 I/Oの待ち時間、ロック、リソース使用状況。 6, 7, 8, 9, 32, 33, 44, 45, 117, 118, 127, 128, 170, 171, 174, 175, 213, 214, 215、216、226、227、242、243、321、322、378、379、382、383、413、414
4 インストール先で定義されたモニター・レコード。 155
5 IFI 要求の処理に費やされた時間。 187
6 DATA CAPTURE CHANGES により作成される表への変更。 185
7 Db2 イベントシグナリングによるパッケージ会計のエントリーまたはエグジット。 データは、各パッケージの処理にエージェントが Db2 で費やした時間を追跡しています。 200、232、240
8 パッケージの待機時間。 6、7、8。9, 32, 33, 44, 45, 51, 52, 56, 57, 117, 118, 127, 128, 170,171, 174, 175, 213, 214, 215, 216, 226,227, 239, 241, 242, 243, 321, 322, 378, 379, 382, 383変更の開始, 413, 414変更の終わり
9 ステートメント・レベル・アカウンティングを有効にします。 124
10 バッファー・マネージャー、ロック・マネージャー、SQL 統計についてのパッケージ明細。

IFCID 239の記録が書き込まれる前に、以下のトレースのうちの1つもアクティブにする必要があります

  • アカウンティングのクラス 7
  • アカウンティングのクラス 8
  • モニターのクラス 7
  • モニターのクラス 8
 239
11 プラン・レベルのアカウンティング情報。 モニタートレースを開始する際に、START TRACEコマンドから CLASS キーワードを省略すると、クラス11が有効になります。 3,200
12-28 予約されています。  
29 サブシステム全体での SQL ステートメントの統計収集を制御します。 316, 318, 400, 401
30-32 ローカル用途に使用可能。  
IFCID (ifcid, …)
CLASS オプションに指定されたクラスに含まれる IFCID に加えて、 開始する他の IFCID (トレース・イベント) を指定します。 IFCIDオプションで指定したIFCIDのみを開始するには、トレースクラス30、31、または32を使用します。 これらのクラスには事前定義された IFCID が ないため、 ロケーションはこれらのクラスを使用できます。 IFCIDオプションで指定したトレースイベントのみをアクティブにする例については、「リモートアクティビティのスレッドのパフォーマンストレースの例」 を参照してください。

IFCID オプション を指定しないと、 アクティブ化されたトレース・クラスに含まれる IFCID だけが開始されます。

IFCID の最大数は 156 です。 IFCIDオプションで有効な値の範囲は1～511ですが、次の例外があります。4、5、185、187、217、232、234、240、241、362。 これらの例外は IFCID オプションでは無効な値です。 IFCID の 4 および 5 は、常に自動的にアクティブになります。

ヒント： 変更の開始IFCID番号は、 Db2 およびその文書では、ゼロを先頭に付けた3桁または4桁の数字で表記されることが多い。 例えば、「IFCID 1」、「IFCID 001」、または「IFCID 0001」などがあります しかし、これらの参照はそれぞれ同じ意味を持つと想定できます。変更の終わり

AUDTPLCYオプションを指定すると、IFCID 362が自動的に起動します。 その他の無効な IFCID の中には、 特定のトレース・クラスによってのみアクティブ化できるものもあります。 トレース・クラスによってのみ開始できる IFCID オプションの無効な値については、 以下に記載します。

開始するには
開始...
IFCID 185
モニター・トレース・クラス 6
IFCID 232
モニター・トレース・クラス 2 または 7、あるいはアカウンティング・トレース・クラス 2 または 7
IFCID 240
モニター・トレース・クラス 7、あるいはアカウンティング・トレース 7
IFCID 241
モニター・トレース・クラス 8、あるいはアカウンティング・トレース 8

デフォルトは IFCID( * ).

BUFSIZE (k_bytes, …)
トレース・データを受け取る IFC 管理のバッファーのサイズを 指定します。 このオプションを指定できるのは、OP n 宛先を指定した場合だけです。

k_bytes には、256 KB から 65536 KB まで指定できます。 数は、4 で割り切れる必要があります。 この範囲外の値を指定すると、指定された値に最も近い範囲制限値が使用されます。 バッファー・サイズとして 256KB を割り振る場合は、 BUFSIZE(256) と指定します。

初期値 は BUFSIZE （ * ）であり、これは Db2 がインストールされた際に設定されたサイズです。

AUDTPLCY (ポリシー名, …)
トレース情報の収集が行われる最大 8 つの監査ポリシー名のリストを指定します。 このオプションを指定すると、リストされた監査ポリシーで指定されているカテゴリーに対応する IFCID が開始され、IFCID 0362 のトレースが開始されます。

AUDTPLCY はトレース・タイプ AUDIT に適用されます。 AUDTPLCY と CLASS または IFCID を一緒に指定することはできません。

TDATA
各トレース・レコードのプロダクト・セクションに付けられる プロダクト・セクションのヘッダーを指定します。 TDATA を指定しない場合は、トレースのタイプによって プロダクト・セクションのヘッダーが決められます。 トレース・レコードのプロダクト・セクションには、 複数のヘッダーを入れることができます。
IFC レコードには、すべて標準の IFC ヘッダーがあります。 アカウンティング、パフォーマンス、監査、およびモニターのレコードには、 相関ヘッダーが加えられます。 保守容易性レコードにはトレース・ヘッダーが追加されます。
CORRELATION
レコードに相関ヘッダーを付けます。

省略形: COR

TRACE
レコードにトレース・ヘッダーを付けます。

省略形: TRA

CPU
レコードに CPU ヘッダーを入れます。 CPUヘッダーには、実行中の z/OS TCBまたはSRBの現在のプロセッサ時間が含まれています。
DISTRIBUTED
レコードに分散ヘッダーを付けます。

省略形: DIST

使用上の注意事項 -START TRACE

トレースフィールド（IFCID）の記述の検索

トレース・レコードの説明は、IFCID フラット・ファイル (DSNWMSGS) にあります。 DSNWMSGSの最新バージョンは、 Db2 12 for z/OS ライセンスをお持ちのお客様のみご利用いただけます。 情報は PDF ファイルにあります。 この情報については、 Db2 12 for z/OS IFCID フラットファイル（DSNWMSGS） をご覧ください。

監査ポリシー

最大で 32 個の監査ポリシーを同時にアクティブにすることができます。 複数の監査ポリシーを開始することを指定すると、それらのポリシーのうちの一部は正常に開始せず、警告メッセージ DSNW196I が戻されます。 残りの監査ポリシーは開始されます。

推奨： FL 509 START TRACEコマンドで、すべての不正操作防止監査ポリシーを開始し、1つのトレース番号に割り当てる。 これにより、改ざん防止監査ポリシーを停止するために SCOPE(GROUP) オプションが使用されている場合に、データ共用メンバー間でトレース番号が不一致になる可能性を回避することができます。
トレース数

PLAN、AUTHID、LOCATIONのどれか1つまたはすべてに値を指定しない場合、START TRACEコマンドは単一のトレースを開始します。 PLAN、AUTHID、または LOCATION で使用する値が複数の場合には、 コマンドはプラン、許可 ID、またはロケーションごとにトレースを開始します。

最大 32 個のトレースを同時にアクティブにできます。

START TRACE コマンドを、コンソールまたは DB2I パネルから OP n または OPX 宛先 に対して入力すると、トレース・データが失われたことを示すメッセージ DSNW133I が出されます。

モニター・トレース・クラス 1 の開始時にオプション PLAN、AUTHID、または LOCATION を 使用しても、IFI READS 要求に戻されるデータの量には影響がありません。

アカウンティングまたはモニターのいずれかのトレース・クラス 2、5、または 7 の開始時に、 オプション PLAN、AUTHID、または LOCATION を使用しても何の影響もありません。

開始または停止する Db2

トレースを開始した後に Db2 を停止し、起動した場合、トレースは自動的には再開されません。

SCOPE (GROUP) の指定

SCOPE(GROUP)でSTART TRACEを発行すると、 Db2 はデータ共有グループの各メンバーに対してSTART TRACEコマンドを発行します。 データは、データ共用グループの各メンバーごとに定義されている宛先に送られます。 データ共用グループの全メンバーのトレース・データを 1 箇所に集めたい場合は、IFI READA または READS 呼び出しをもつモニター・プログラムを使用して、データを収集します。

変更の開始FL 509 SCOPE(GROUP)オプションを使用して開始する複数の監査ポリシーを指定した場合、監査ポリシーはデータ共有グループの全メンバーに送信されます。 ただし、指定された監査ポリシーの 1 つが改ざん防止監査ポリシーである場合、データ共用グループのすべてのメンバーに対して改ざん防止監査ポリシーがブロックされます。 SCOPE(GROUP)を使用して、改ざん防止監査ポリシーを開始することはできません。変更の終わり

SCOPE(GROUP) を指定してトレースを開始し、トレースの開始後に新規メンバーがデータ 共用グループに加わった場合、新規メンバーも START TRACE コマンドによって指定されたトレ ース・データを書き込みます。

SCOPE(GROUP) を指定してトレースを開始すると、大量のトレース・データが生成される可能 性があり、追加データを保持するためにモニター・プログラムの戻り域のサイズを増やすこと が必要になる場合があります。

名前やアドレスの一部にワイルドカード「*」を使用して、関連する情報を追跡する

名前や住所の一部を入力する際には、ワイルドカードのサフィックス「*」を使用してスレッドをフィルタリングすることができます。 例えば、「-START TRACE PLAN (A,B,C*)」と指定すると、 Db2 がトレースを行い、A、B、CDE、CDEFG、CDEFGH、...と返します。 スレッド「A」、「B」、および「C」で始まるすべてのスレッド がトレースされます。

名前またはアドレスの一部の文字と文字の間にワイルドカード文字を含めることはできません。

部分的な名前または住所における位置、(_)ワイルドカードを使用してスレッドをトレースする

名前や住所の一部を入力する場合は、文字「_」で表される位置ワイルドカードを使用して、ワイルドカードを途中に配置したい場合や、特定の長さのスレッドをトレースしたい場合にスレッドをトレースすることができます。 例えば、「-START TRACE PLAN (A_C)」と指定すると、最初の文字が「A」で、 3 番目の文字が「C」である 3 文字の名前のスレッドがすべてトレースされます。 このコマンドは、 「ABC」、「ADC」、「AEC」などを戻します。 スレッド「A_C」をトレースする場合は、 「-START TRACE PLAN (A/_C)」と指定します。 「_」の前の「/」は、 Db2 にワイルドカードとしてではなく、検索でアンダースコアをトレースするよう指示します。 「/」または「*」文字が含まれている スレッドをトレースする場合にも同じ論理が適用されます。 「/」文字はエスケープ文字なので、「/」文字が含まれるスレッドをトレースする場合、 例えば「A/C」というスレッドをトレースする場合には、「-START TRACE PLAN (A//C)」と指定します。 同様に、スレッド「A*C」をトレースする場合には「-START TRACE PLAN (A/*C)」と指定します。

ワイルドカードを使用して複数のスレッドを同時にトレースする
また、複数のトレース資格に基づいて複数のスレッドをトレースするオプションもあります。 例えば、「-START TRACE PLAN (A*, B*, C*)」と指定すると、「A」、「B」および「C」で始まる プランのすべてのスレッドを同時にトレースすることができます。 ワイルドカード文字 「*」は、すべてのスレッドをトレースします。 より複雑な組み合わせ (「-START TRACE PLAN (A_B*, C*, AND C/_D*)」など) も指定できます。この例は、以下のすべての スレッドを戻します。
  • 「A」で始まり、2 番目にワイルドカード部分に当たる任意の文字が続き、3 番目に「B」が続き、その後に任意のタイプおよび文字数の文字が続くスレッド (ADBIOP、AOBTYJDP など)
  • 「C」で始まり、その後に任意の文字の組み合わせが続くスレッド (CDE、CGHKO など)
  • 「C_D」で始まり、その後に任意のタイプの文字の組み合わせが続くスレッド (C_DEFGH、C_DLMNOP など)
上記コマンドにより、上にリストした可能なスレッドの組み合わせがすべて戻されます。
スレッドのフィルタリング条件を指定する
-START TRACE コマンドで特定のフィルタリング条件を設定することで、トレース記録が書き込まれるスレッドのセットを制御できます。 以下の規則が、すべてのトレース・フィルターに適用されます。
  • 変更の開始Db2 外部トレースレコードが書き込まれた際に、トレースフィルタを適用します。 その時点のスレッドの状態によって、スレッドが全体として書き込まれるか完全に除去されるかが決まります。 例えば、PKGPROG(ABC)オプションが指定されている場合、パッケージABCがトレースレコードの外部化を引き起こすSQLイベント中にアクティブである場合にのみ、パッケージABCを実行するスレッドのトレースレコードが書き込まれます。変更の終わり
  • トレース・フィルターによってトレース・レコードの内容が変更されることはありません。
  • 特定のトレースレコードに関連付けられていないトレースクラスまたはIFCID、例えば会計クラス2、3、7、8、10、またはIFCID 318は、フィルタリングの影響を受けません。 例えば、次のコマンドは、アカウンティング・クラス 7 または 8 によって書き込まれる外部レコードがないため、フィルタリングにつながりません。
    -START TRACE(ACCTG) CLASS(7,8) DEST(SMF) PKGPROG(ABC)
  • Db2 -START TRACEコマンドで、1つのフィルタリングオプションに複数の値を設定できるようにします。 例えば、次のコマンドは有効です。
    -START TRACE PLAN(A,B) USERID(B) WRKSTN(E)

    次のコマンドは無効です。

    -START TRACE PLAN(A,B) USERID(A,B) WRKSTN(E)
除外機能を使用してスレッドをフィルタリングする

スレッドのフィルタリング時に、XPLANなどの制約キーワードとともに「X」を指定すると、–START TRACEコマンドの除外機能を使用することになります。 トレース・コマンドを実行する場合に、 特定のタイプのスレッドを除外するオプションがあります。 トレースの実行時に、文字「X」を使用して、特定の組み合わせの文字を除外することができます。 例えば、次のコマンドを指定して、「A」を除くすべてのスレッドをトレースできます。

-START TRACE XPLAN(A)

この場合は、b、bcd、bcde、または cd などが戻されます。

複数のタイプのスレッドをトレースから除外することもできます。 例えば、次のコマンドを指定することにより、「A」で始まってその後に任意の文字の組み合わせが続くプランと「B」で始まってその文字の後に任意の文字の組み合わせが続くプランの両方のスレッドすべてを除く、すべてのスレッドのトレースを開始できます。

-START TRACE XPLAN(A*, B*)

XPLAN (*) を指定することは、検索からすべてのスレッドを除外することになるため、許可されません。 また、「-START TRACE XPLAN (A*C)」のように、排他機能を使用するトレース基準の文字と文字の間に * ワイルドカードを使用することはできません。 ただし、「A」で始まってその後に任意の 2 文字が続き、4 文字目が「C」で、任意の文字で終わるプランのスレッドを除く、すべてのスレッドを戻すようにこのコマンドを指定できます。

-START TRACE XPLAN (A_ _ C *)

トレース機能の最適化を図るために、一度に 2 つのトレースを開始することができます。 例えば、次のコマンドを指定できます。

-START TRACE XPLAN (A, B, C) USERID(D)

このコマンドは、プラン「A」、「B」、または「C」を除くすべてのプランの内、ユーザー ID が「D」の場合にのみスレッドのトレースを開始するように Db2 に指示します。

トレース修飾子の組み合わせ

Db2 に特定のスレッドをトレースするよう命令することで、トレースするスレッドをカスタマイズできます。その際、他の特定のスレッドを除外することも可能です。 例えば、「-START TRACE USERID (A,B) XPLAN (C)」のように指定することができます。 この基準は、ユーザー ID が「A」または「B」でプランが「C」でないスレッドのみをトレースします。 この例で、ユーザー ID が「A」でプランが「D」のスレッドは基準を満たすのでトレースされますが、 ユーザー ID が「A」でプランが「C」のスレッドは基準を満たさないのでトレースされません。

START TRACE コマンドに複数のワイルドカードを取り入れて、トレースをさらにカスタマイズすることができます。 例えば、「-START TRACE PLAN (C*) USERID (Z, X) XPLAN (C, D, E)」のように指定することができます。 この例で、トレースされるスレッドは、プラン名が「C」で始まり、ユーザー ID が「Z」または「X」で、 プラン「C」、「D」、「E」以外のスレッドになります。 したがって、ユーザー ID が「Z」のプラン「CB」は基準を満たすのでスレッドはトレースされますが、ユーザー ID が「X」のプラン「C」は失敗します。これは、コマンドで、プランが「C」のスレッド (C に続く文字がない) はトレースしないように指定されているためです。

トレース先優先順位

IFCIDがクラスに関連付けられており、IFCIDキーワードにそのIFCIDを指定した場合、クラスの宛先が優先されます。 この規則は、アカウンティング・クラス 2、3、5、7、8 およびモニター・クラス 1、2、3、5、7、8 の IFCID に影響します。その理由は、これらのクラスは IFCID の事前設定宛先を持つためです。

例えば、次のコマンド「-START TRACE(ACCTG) CLASS (1,2,3) IFCID(6,7) DEST SMF」は、IFCID 6 および 7 を SMF に書き込みません。その理由は、それらが、事前設定宛先を持つアカウンティング・クラス 3 の一部であるからです。 IFCID 6 および 7 を SMF に書き込むには、トレースを次のように開始する必要があります。

-START TRACE(ACCTG) CLASS(1,2,3) DEST(SMF)
-START TRACE(ACCTG) CLASS(30) IFCID(6,7) DEST(SMF)
ローカル利用のためのIFCID

変更の開始 Db2 では、IFCIDs 1000から1999は使用されておらず、ローカルでの使用が可能です。変更の終わり

例 -START TRACE

例：リモートアクティビティのあるスレッドのパフォーマンストレース

リモートアクティビティのあるスレッドのパフォーマンストレースを USIBMSTODB21 に開始します。 IFCID 0044 (ロック中断) および 0045 (ロック再開) をアクティブ化するだけです。 トレース・クラス 30 は、インストール用に使用できます。

-START TRACE (PERFM)
  DEST(GTF)
  LOCATION(USIBMSTODB21)
  CLASS(30)
  IFCID(44,45)
例：計画の会計追跡
DSN8BC81 プランの会計追跡を開始します。 レコードを SMF に書き込みます (デフォルトによって起きる)。 トレースを識別するコメントを付けます。
-START TRACE (ACCTG)
  PLAN (DSN8BC81)
  COMMENT ('ACCTG TRACE FOR DSN8BC81')
例：統計トレース
統計トレースを開始します。 レコードを SMF に書き込みます (デフォルトによる)。
-START TRACE=S
例：モニタートレースを開始する
データ共有グループ上で、通常はアプリケーションプログラムによって実行される）モニタートレースを開始します。 レコードを OPX に書き込みます (デフォルトによる)。
-START TRACE(MON) SCOPE(GROUP)
例：パッケージを実行しているスレッドのパフォーマンストレース記録
PKGPROGオプションを使用して、トレースレコードが外部化される原因となるSQLイベント中にパッケージABCを実行しているスレッドのみのパフォーマンス・トレース・レコードを書き出します。
-START TRACE(PERFM) CLASS(3) DEST(SMF) PKGPROG(ABC)
例：パッケージレベルの会計を有効にするための会計トレース
パッケージレベルの会計を有効にし、IFCID 3およびIFCID 239によって外部化されたデータを収集するために、会計追跡を開始します。 PKGPROG オプションを使用して、パッケージ ABC のアカウンティング・レコードが書き込まれるときに書き込まれるアカウンティング情報を外部化します。
-START TRACE(ACCTG) CLASS(1,2,3,7,8) DEST(SMF) PKGPROG(ABC)
外部化されたレコードには、アカウンティング・インターバル時に実行されるすべてのパッケージに関する情報が含まれます。
例：相関IDのIFC除外フィルタリングを提供
START TRACE (A) XCORRID (*)
- 10.46.05 STC00051  DSNW150I  ) EXCLUDE FOR ALL CORRID VALUES IS NOT       
-  ALLOWED                                                                  
- 10.46.05 STC00051  DSN9023I  ) DSNWVCM1 '-START TRACE' ABNORMAL COMPLETION
監査ポリシーを使用した監査トレースの例
監査ポリシーAUDITADMINを使用して監査トレースを開始します。
-STA TRACE(AUDIT) DEST(GTF) AUDTPLCY(AUDITADMIN)
グループスコープで発行されたコマンドのトレース情報
Db2 のデータ共有メンバーでグループスコープを指定するオプション付きでこのコマンドが発行された場合、他のすべてのアクティブなメンバーでも実行されます。 他のグループメンバーのIFICID 090トレースレコードでは、元のコマンドが発行されたメンバーからのトレースレコードに加えて、 016.TLPKN5F の相関IDからSYSOPR権限IDによって同じコマンドが発行されたことが示されています。 Db2 のデータ共有におけるコマンドの適用範囲を参照してください。