クライアント・アプリケーションとストアード・プロシージャーの診断トレースの取得

アプリケーションおよびストアード・プロシージャーの両方が ODBC アプリケーション・プログラムである場合、ODBC 診断トレースを使用してストアード・プロシージャーおよびその呼び出しアプリケーションをトレースできます。ODBC 診断トレースは、IBM® ソフトウェア・サポートの指示がある場合にのみ使用してください。

手順

クライアント・アプリケーションとストアード・プロシージャーの診断トレースの取得

  1. Db2® ODBC 初期化ファイルの共通セクション で、DIAGTRACE=1、DIAGTRACE_BUFFER_SIZE=nnnnnnn、 および DIAGTRACE_NO_WRAP=0 または 1 を設定します。nnnnnnn は、診断トレース・バッファー用に割り当てられるバイト数です。 例えば、次のとおりです。
    [COMMON]
    DIAGTRACE=1
    DIAGTRACE_BUFFER_SIZE=2000000
    DIAGTRACE_NO_WRAP=1
    推奨: 64 ビット・アプリケーションをトレースする場合、31 ビット・アプリケーションに指定するサイズよりも最大で 10% 上回る診断トレース・バッファー・サイズを指定してください。
  2. z/OS® DSNAOINI DD ステートメントを、ストアード・プロシージャー・アドレス・スペースの JCL に指定します。この DD ステートメントは、次の例に示すように Db2 ODBC 初期化ファイルを参照します。
    //DSNAOINI DD DISP=SHR,DSN=CLI.DSNAOINI
    //DSNAOINI DD PATH='/u/cli/dsnaoini'
  3. DSNAOTRC DD ステートメントを、クライアント・アプリケーション・ジョブの JCL で指定します。DD ステートメントは、次の例で示すように、不定形式の診断データを 入れるために、DCB 属性 RECFM=FB,LRECL=80 を持つ 事前割り振りの順次データ・セット、または z/OS UNIX 環境 HFS ファイルを参照します。
    //DSNAOTRC DD DISP=SHR,DSN=CLI.DIAGTRC.CLIENT
    //DSNAOTRC DD PATH='/u/cli/diagtrc.client'
  4. DSNAOTRC DD ステートメントを、ストアード・プロシージャー・アドレス・スペース の JCL で指定します。DD ステートメントは、次の例で示すように、ストアード・プロシージャーの不定形式の診断データを入れるために、DCB 属性 RECFM=FB,LRECL=80 を持つ事前割り振りの順次データ・セット、または z/OS UNIX 環境 HFS ファイルを参照します。
    //DSNAOTRC DD DISP=SHR,DSN=CLI.DIAGTRC.SPROC
    //DSNAOTRC DD PATH='/u/cli/diagtrc.sproc'
  5. ストアード・プロシージャーを呼び出すクライアント・アプリケーションを実行します。
  6. Db2 ODBC ストアード・プロシージャーの実行後、以下の z/OS コマンドを使用してストアード・プロシージャー・アドレス・スペースを停止します。
    VARY WLM,APPLENV=name,QUIESCE
    name は、WLM アプリケーション環境名です。
  7. 定様式または不定形式の診断トレース・データのいずれかを IBM ソフトウェア・サポートに処理依頼することができます。 ユーザーのサイトで未加工のトレース・データをフォーマット設定する場合は、クライアント・アプリケーションの診断トレース・データ・セット、およびストアード・プロシージャーの診断トレース・データ・セットに対して、DSNAOTRC コマンド (あるいは、XPLINK 環境では DSNAOTRX コマンド、64 ビット環境では DSNAO64T コマンド) を FMT オプションまたは FLW オプションを付けて実行してください。