ODBC 診断トレース・コマンド

ODBC 診断トレース・コマンドを使用して、トレースの開始と停止、トレース状況の照会、トレース・テーブルのキャプチャー、およびトレース情報のフォーマット設定を行います。 ODBC 診断トレースは、IBM® ソフトウェア・サポートの指示がある場合にのみ使用してください。

以下のトレース・コマンドは同じトレース・タスクを実行し、同じ構文を使用します。
DSNAOTRC
非 XPLINK ODBC アプリケーションでは、このトレース・コマンドを使用します。
DSNAOTRX
31 ビット XPLINK ODBC アプリケーションでは、このトレース・コマンドを使用します。
DSNAO64T
64 ビット ODBC アプリケーションでは、このトレース・コマンドを使用します。
これらのトレース・コマンドは、以下のトレース・タスクを実行します。
  • メモリー常駐の診断トレース・レコードの記録を手動で開始または停止する。
  • 診断トレースの現行状況を照会する。
  • メモリー常駐のトレース・テーブルを z/OS® データ・セット または z/OS UNIX 環境 HFS ファイルに取り込む。
  • Db2® ODBC 診断トレースをフォーマット設定する。

DSNAOTRC、DSNAOTRX、および DSNAO64T の構文

構文図を読む
>>-+-DSNAOTRC-+------------------------------------------------->
   +-DSNAOTRX-+   
   '-DSNAO64T-'   

>--+-ON-+------------------+-+-----------+------------------+--><
   |    +- -L -buffer size-+ '- -M -mask-'                  |   
   |    '- -I -buffer size-'                                |   
   +-OFF----------------------------------------------------+   
   +-INF----------------------------------------------------+   
   +-DMP--trace data set spec-------------------------------+   
   +-FMT--+-----------------------------------------------+-+   
   |      '-input data set spec--+----------------------+-' |   
   |                             '-output data set spec-'   |   
   '-FLW--input data set spec--+----------------------+-----'   
                               '-output data set spec-'         

DSNAOTRC、DSNAOTRX、および DSNAO64T のオプションの説明

ON
Db2 ODBC 診断トレースを開始します。
-L buffer size
L = 最新。トレースは循環し、その時点での最新のトレース・レコードをキャプチャーします。

buffer size は、トレース・バッファー用として割り当てる バイト数です。この値は必須です。バッファー・サイズは、65536 (64K) の倍数に丸められます。

-I buffer size
I = 初期。トレースは循環せず、ラップしない初期のトレース・レコードをキャプチャーします。

buffer size は、トレース・バッファー用として割り当てる バイト数です。この値は必須です。バッファー・サイズは、65536 (64K) の倍数に丸められます。

OFF
Db2 ODBC 診断トレースを停止します。
INF
現在アクティブな Db2 ODBC 診断トレースに関する情報を表示します。
DMP
現在アクティブな Db2 ODBC 診断トレースをダンプします。
trace data set spec
Db2 が未加工の Db2 ODBC 診断トレース・データを書き込む z/OS データ・セット または z/OS UNIX 環境 HFS ファイルを指定します。データ・セットの指定は、z/OS データ・セット名、z/OS UNIX 環境 HFS ファイル名、 または現在割り当てられている JCL DD ステートメント名のいずれでも構いません。
FMT
定様式の Db2 ODBC 診断トレース内容の詳細報告書を生成します。

DSNAO64T でキャプチャーされるトレース・データは、DSNAO64T コマンドでフォーマット設定する必要があります。 そうしない場合、トレース・データが破損する可能性があります。

FLW
定様式の Db2 ODBC 診断トレース内容の流れ報告書を生成します。
input data set spec
DSNAO64T フォーマット設定される未加工の Db2 ODBC 診断トレース・データが入っているデータ・セット。 このデータ・セットは、DSNAOTRC DMP コマンド、DSNAOTRX DMP コマンド、または DSNAO64T DMP コマンドの結果として生成されました。あるいは、DIAGTRACE 初期化キーワードがトレースを使用可能にしている場合に、DSNAOTRC DD ステートメントによって生成されました。 データ・セットの指定は、z/OS データ・セット名、z/OS UNIX 環境 HFS ファイル名、 または現在割り当てられている JCL DD ステートメント名のいずれでも構いません。このパラメーターが指定されていない場合、DSNAOTRC コマンド、DSNAOTRX コマンド、または DSNAO64T コマンドは、現在アクティブなメモリー常駐の DSNAOTRC のフォーマット設定を試行します。
output data set spec
フォーマット設定された Db2 ODBC 診断トレース・レコードが書き込まれるデータ・セット。データ・セットの指定は、z/OS データ・セット名、z/OS UNIX 環境 HFS ファイル名、 または現在割り当てられている JCL DD ステートメント名のいずれでも構いません。 存在していない z/OS データ・セットまたは z/OS UNIX 環境 HFS ファイルを指定すると、Db2 はそれを 動的に割り振ります。 このパラメーターが指定されていない場合、出力は、 標準出力 ("STDOUT") に書き込まれます。