GTF トレース・データの記録

パフォーマンス・トレース・クラスのデフォルト宛先は、汎用トレース機能 (GTF) です。GTF にデータを送信するには、その前に z/OS® オペレーターが GTF を開始しておかなければなりません。

始める前に

プログラム固有のプログラミング・インターフェース情報の開始
SYS1 に GTF メンバーが存在していないことを確認してください。

このタスクについて

GTF 始動時に、特定のジョブについて書き込まれたトレース・レコードだけを 取得するために JOBNAMEP オプションが使用されている場合は、他の エージェントについて書き込まれたトレース・レコードは、GTF データ・セットには 書き込まれません。これは、JOBNAMEP オプションが使用されると、関連エージェントの処理を 実行しているシステム・エージェントによって書き込まれたトレース・レコードは、 廃棄されることを意味します。例えば、Db2® システム・エージェントが関連エージェントに 対する IDENTIFY 要求を実行すると、IFCID レコードが書き込まれます。しかし、特定のジョブに関するトレース・データを収集するため の JOBNAMEP キーワードが使用された場合、この IDENTIFY 要求に関する レコードは、IDENTIFY 要求が JOBNAMEP キーワードに指定されたジョブに 対して実行された場合でも、GTF に書き込まれません。

GTF イベント ID の X'FB9' を使用して、Db2 トレース・データを GTF に記録することができます。

GTF の限界値である 256 バイトを超えているトレース・レコードは、Db2 に よりこの境界をまたがります。

手順

GTF を開始するには、次のようにします。

オフセットが正しくマップされるようにする ためには、次の表に示されているとおりに GTF を開始してください。 GTF を始動するときは、TIME=YES を指定した後、TRACE=USRP を 指定してください。
表 1. GTF トレース・データの記録
入力値 システムの応答
S GTF,,,(TIME=YES) AHL100A SPECIFY TRACE OPTIONS
TRACE=USRP AHL101A SPECIFY TRACE EVENT KEYWORDS --USR=
USR=(FB9) AHL102A CONTINUE TRACE DEFINITION OR REPLY END
END AHL125A RESPECIFY TRACE OPTIONS OR REPLY U
U AHL031I GTF INITIALIZATION COMPLETE
GTF セッションを開始するときに名前を付けておけば、GTF を容易に停止 することができます。 例えば、S GTF.GTF,,,(TIME=YES) と指定することができます。

タスクの結果

GTF メンバーが SYS1.PARMLIB に存在すると、GTF の トレース・オプション USR が有効にならない場合があります。 SYS1.PARMLIB に他のメンバーが含まれていない場合は、USR オプション だけが有効になり、他のオプションは有効になりません。 したがって、GTF トレースに不要なデータが追加されることはありません。

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