z/OS UNIX 環境での ODBC 診断トレース情報のキャプチャー
ODBC 診断トレースは、IBM® ソフトウェア・サポートの指示がある場合にのみ使用してください。この診断トレースは、z/OS® UNIX 環境のコマンド行からアクティブにできます。
手順
z/OS UNIX 環境で ODBC 診断トレース情報をキャプチャーするには、次のようにします。
- TSO/E コマンドの OPUTX を使用して、以下のプログラム・ロード・モジュールを z/OS
UNIX 環境の HFS ファイルに保管します。
- DSNAOTRC (非 XPLINK アプリケーション)
- DSNAOTRX (31 ビット XPLINK アプリケーション)
- DSNAO64T (64 ビット・アプリケーション)
次の例では、OPUTX コマンドを使用して、区分データ・セット prefix.SDSNLOAD のロード・モジュール DSNAOTRC を /usr/db2 ディレクトリーの HFS ファイル DSNAOTRC に保管します。OPUTX 'prefix.SDSNLOAD(DSNAOTRC)' /usr/db2/dsnaotrc次の例では、OPUTX コマンドを使用して、区分データ・セット prefix.SDSNLOD2 のロード・モジュール DSNAOTRX を /usr/db2 ディレクトリーの HFS ファイル DSNAOTRX に保管します。OPUTX 'prefix.SDSNLOD2(DSNAOTRX)' /usr/db2/dsnaotrx次の例では、OPUTX コマンドを使用して、区分データ・セット prefix.SDSNLOD2 のロード・モジュール DSNAO64T を /usr/db2 ディレクトリーの HFS ファイル DSNAO64T に保管します。OPUTX 'prefix.SDSNLOD2(DSNAO64T)' /usr/db2/dsnao64t - z/OS
UNIX シェルの共用アドレス・スペース環境変数を使用可能にします。
次の export ステートメントをコマンド行で出すか、または $HOME/.profile ファイルで
指定します。
この環境変数を設定すると、OMVS コマンドおよび z/OS UNIX シェルは、 同じ TSO アドレス・スペースで実行可能になります。export _BPX_SHAREAS=YES - DSNAOTRC、DSNAOTRX、および DSNAO64T のロード・モジュールを含んでいるディレク トリーに移動します。
- DSNAOTRC、DSNAOTRX、および DSNAO64T のロード・モジュールに対して実行許可が設定されていることを確認します。 実行許可が付与されていない場合は、chmod コマンドを使用して、それぞれのロード・モジュールごとに実行許可を設定します。
- 以下のいずれかの ODBC 診断トレース・コマンドを z/OS
UNIX 環境のコマンド行から発行して、診断トレースをアクティブにします。
診断トレースをアクティブにするためのオプション指定は任意です。オプション 説明 dsnaotrc on 非 XPLINK アプリケーションをトレースする場合、このコマンドを使用します。 dsnaotrx on 31 ビット XPLINK アプリケーションをトレースする場合、このコマンドを使用します。 dsnao64t on 64 ビット XPLINK アプリケーションをトレースする場合、このコマンドを使用します。 - ODBC アプリケーションを実行します。
- 以下のいずれかの ODBC 診断トレース・コマンドを z/OS
UNIX 環境のコマンド行から発行して、診断トレースをダンプします。
raw_trace_file 値は、Db2® が未加工の診断トレース・データを 書き込む出力ファイルの名前です。オプション 説明 dsnaotrc dmp "raw_trace_file" 非 XPLINK アプリケーションをトレースする場合、このコマンドを使用します。 dsnaotrx dmp "raw_trace_file" 31 ビット XPLINK アプリケーションをトレースする場合、このコマンドを使用します。 dsnao64t dmp "raw_trace_file" 64 ビット XPLINK アプリケーションをトレースする場合、このコマンドを使用します。 以下の各サンプル・ステートメントは、非 XPLINK 環境でトレース・データ・セットの指定をコーディングする方法を示しています。XPLINK 環境で以下のデータ・セットの指定をコーディングするには、DSNAOTRC コマンドを DSNAOTRX または DSNAO64 コマンドと置き換えてください。それぞれの環境におけるトレース・コマンドのすべての追加構文は同一です。- 現在割り振られている JCL DD ステートメント名 TRACEDD
DSNAOTRC DMP DD:TRACEDD - 順次データ・セット USER01.DIAGTRC
DSNAOTRC DMP "USER01.DIAGTRC" - /usr/db2 ディレクトリーで DIAGTRC という名前の z/OS
UNIX 環境 HFS ファイル
DSNAOTRC DMP "/usr/db2/DIAGTRC"
- 現在割り振られている JCL DD ステートメント名 TRACEDD
- 以下のいずれかの ODBC 診断トレース・コマンドを z/OS
UNIX 環境のコマンド行から発行して、診断トレースを非アクティブにします。
オプション 説明 dsnaotrc off 非 XPLINK アプリケーションをトレースする場合、このコマンドを使用します。 dsnaotrx off 31 ビット XPLINK アプリケーションをトレースする場合、このコマンドを使用します。 dsnao64t off 64 ビット XPLINK アプリケーションをトレースする場合、このコマンドを使用します。 - 以下のいずれかの ODBC 診断トレース・コマンドを z/OS
UNIX 環境のコマンド行から発行して、未加工のトレース・データ・レコードを入力ファイル raw_trace_file から出力ファイル fmt_trace_file にフォーマット設定します。
オプション 説明 dsnaotrc fmt "raw_trace_file" "fmt_trace_file" 非 XPLINK アプリケーションの詳細トレース・レポートを要求する場合、このコマンドを使用します。 dsnaotrc flw "raw_trace_file" "fmt_trace_file" 非 XPLINK アプリケーションのフロー・トレース・レポートを要求する場合、このコマンドを使用します。 dsnaotrx fmt "raw_trace_file" "fmt_trace_file" 31 ビット XPLINK アプリケーションの詳細トレース・レポートを要求する場合、このコマンドを使用します。 dsnaotrx flw "raw_trace_file" "fmt_trace_file" 31 ビット XPLINK アプリケーションのフロー・トレース・レポートを要求する場合、このコマンドを使用します。 dsnao64t fmt "raw_trace_file" "fmt_trace_file" 64 ビット XPLINK アプリケーションの詳細トレース・レポートを要求する場合、このコマンドを使用します。 dsnao64t flw "raw_trace_file" "fmt_trace_file" 64 ビット XPLINK アプリケーションのフロー・トレース・レポートを要求する場合、このコマンドを使用します。 以下のそれぞれのステートメントは、入力データ・セットの指定を コーディングする方法を示しています (非 XPLINK 環境)。XPLINK 環境で以下のデータ・セットの指定をコーディングするには、DSNAOTRC コマンドを DSNAOTRX または DSNAO64 コマンドと置き換えてください。それぞれの環境におけるトレース・コマンドのすべての追加構文は同一です。- 現在割り振られている JCL DD ステートメント名 INPDD
DSNAOTRC FLW DD:INPDD output-dataset-spec - 順次データ・セット USER01.DIAGTRC
DSNAOTRC FLW "USER01.DIAGTRC" output-dataset-spec - /usr/db2 の z/OS
UNIX 環境 HFS ファイル DIAGTRC
DSNAOTRC FLW "/usr/db2/DIAGTRC" output-dataset-spec
以下の各サンプル・ステートメントは、非 XPLINK 環境で出力データ・セットの指定をコーディングする方法を示しています。XPLINK 環境で以下のデータ・セットの指定をコーディングするには、DSNAOTRC コマンドを DSNAOTRX または DSNAO64 コマンドと置き換えてください。それぞれの環境におけるトレース・コマンドのすべての追加構文は同一です。- 現在割り振られている JCL DD ステートメント名 OUTPDD
DSNAOTRC FLW input-dataset-spec DD:OUTPDD - 順次データ・セット USER01.TRCFLOW
DSNAOTRC FLW input-dataset-spec "USER01.TRCFLOW" - /usr/db2 の z/OS
UNIX 環境 HFS ファイル TRCFLOW
DSNAOTRC FLW input-dataset-spec "/usr/db2/TRCFLOW"
- 現在割り振られている JCL DD ステートメント名 INPDD
- z/OS UNIX 環境ディレクトリーから、DSNAOTRC、DSNAOTRX、および DSNAO64T プログラム・モジュールを削除します。 これらのプログラム・モジュールの プライベート・コピーを HFS ディレクトリーで維持しないでください。