z/OS UNIX 環境での ODBC 診断トレース情報のキャプチャー

ODBC 診断トレースは、IBM® ソフトウェア・サポートの指示がある場合にのみ使用してください。この診断トレースは、z/OS® UNIX 環境のコマンド行からアクティブにできます。

手順

z/OS UNIX 環境で ODBC 診断トレース情報をキャプチャーするには、次のようにします。

  1. 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
  2. z/OS UNIX シェルの共用アドレス・スペース環境変数を使用可能にします。 次の export ステートメントをコマンド行で出すか、または $HOME/.profile ファイルで 指定します。
    export _BPX_SHAREAS=YES
    この環境変数を設定すると、OMVS コマンドおよび z/OS UNIX シェルは、 同じ TSO アドレス・スペースで実行可能になります。
  3. DSNAOTRC、DSNAOTRX、および DSNAO64T のロード・モジュールを含んでいるディレク トリーに移動します。
  4. DSNAOTRC、DSNAOTRX、および DSNAO64T のロード・モジュールに対して実行許可が設定されていることを確認します。 実行許可が付与されていない場合は、chmod コマンドを使用して、それぞれのロード・モジュールごとに実行許可を設定します。
  5. 以下のいずれかの ODBC 診断トレース・コマンドを z/OS UNIX 環境のコマンド行から発行して、診断トレースをアクティブにします。
    オプション 説明
    dsnaotrc on 非 XPLINK アプリケーションをトレースする場合、このコマンドを使用します。
    dsnaotrx on 31 ビット XPLINK アプリケーションをトレースする場合、このコマンドを使用します。
    dsnao64t on 64 ビット XPLINK アプリケーションをトレースする場合、このコマンドを使用します。
    診断トレースをアクティブにするためのオプション指定は任意です。
  6. ODBC アプリケーションを実行します。
  7. 以下のいずれかの ODBC 診断トレース・コマンドを z/OS UNIX 環境のコマンド行から発行して、診断トレースをダンプします。
    オプション 説明
    dsnaotrc dmp "raw_trace_file" 非 XPLINK アプリケーションをトレースする場合、このコマンドを使用します。
    dsnaotrx dmp "raw_trace_file" 31 ビット XPLINK アプリケーションをトレースする場合、このコマンドを使用します。
    dsnao64t dmp "raw_trace_file" 64 ビット XPLINK アプリケーションをトレースする場合、このコマンドを使用します。
    raw_trace_file 値は、Db2® が未加工の診断トレース・データを 書き込む出力ファイルの名前です。
    以下の各サンプル・ステートメントは、非 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"
  8. 以下のいずれかの ODBC 診断トレース・コマンドを z/OS UNIX 環境のコマンド行から発行して、診断トレースを非アクティブにします。
    オプション 説明
    dsnaotrc off 非 XPLINK アプリケーションをトレースする場合、このコマンドを使用します。
    dsnaotrx off 31 ビット XPLINK アプリケーションをトレースする場合、このコマンドを使用します。
    dsnao64t off 64 ビット XPLINK アプリケーションをトレースする場合、このコマンドを使用します。
  9. 以下のいずれかの 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"
  10. z/OS UNIX 環境ディレクトリーから、DSNAOTRC、DSNAOTRX、および DSNAO64T プログラム・モジュールを削除します。 これらのプログラム・モジュールの プライベート・コピーを HFS ディレクトリーで維持しないでください。