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") に書き込まれます。
