CLI トレースをオンにするには、 db2cli.ini ファイルで一連の CLI 構成キーワードを有効にします。
このタスクについて
db2cli.ini ファイルでは、以下の
CLI トレース・キーワードを指定できます。
プロシージャー
CLI トレースを取得するには、以下のようにします。
- CLI 構成キーワードを使用して db2cli.ini ファイルを更新します。
db2cli.ini ファイルの更新は、db2cli.ini ファイルを手動で編集するか、あるいは UPDATE CLI CFG コマンドを発行することによって行えます。
- db2cli.ini ファイルを手動で編集するには、以下を行います。
- db2cli.ini ファイルを見つけます。 db2cli.ini ファイルの場所について詳しくは、 db2cli.ini 初期設定ファイルを参照してください。
- プレーン・テキスト・エディターで、db2cli.ini ファイルを開きます。
- 以下のセクションを db2cli.ini ファイルに追加します。
[COMMON]
セクションが存在する場合は、以下の例の CLI トレース・キーワードを追加します。[COMMON]
Trace=1
TracePathName=path
TraceComm=1
TraceFlush=1
TraceTimeStamp=1
TracePathName キーワードを使用する場合、指定する path が存在すること、およびグローバル読み取り権限およびグローバル書き込み権限があることを確認してください。注:
- CLI トレース・キーワードは db2cli.ini ファイルの
[COMMON]
セクションにあるため、それらの値は CLI ドライバーを介して行われるすべてのデータベース接続に適用されます。
- CLI トレース・キーワードには大/小文字の区別はありません。 ただし、UNIX オペレーティング・システムなどの一部のオペレーティング・システムでは、パスおよびファイル名のキーワード値に大/小文字の区別がある場合があります。
- db2cli.ini ファイル内の CLI トレース・キーワードが無効な場合、 CLI トレース・ユーティリティーは CLI トレース・キーワードを無視します。 有効な CLI キーワードに無効値を指定すると、そのトレース・キーワードのデフォルト値が代わりに使用されます。
- TraceRefreshInterval キーワードを設定しない限り、 CLI トレース・キーワードは、アプリケーションの初期化時に db2cli.ini ファイルから一度だけ読み取られます。 TraceRefreshInterval キーワードを設定した場合、Trace キーワードと TracePIDList キーワードが指定された間隔で db2cli.ini ファイルから再読み取りされ、必要に応じて、現在実行されているアプリケーションに適用されます。
- ファイルの最後にブランク行を少なくとも 1 行追加します。 構文解析エラーによっては、ブランク行を追加することで回避できるものがあります。
- ファイルを保存します。
- UPDATE CLI CFG コマンドを使用して CLI 構成キーワードを更新するには、以下のようにします。
- 以下のコマンドを実行します。
db2 UPDATE CLI CFG FOR SECTION COMMON USING Trace 1
db2 UPDATE CLI CFG FOR SECTION COMMON USING TracePathName path
db2 UPDATE CLI CFG FOR SECTION COMMON USING TraceComm 1
db2 UPDATE CLI CFG FOR SECTION COMMON USING TraceFlush 1
db2 UPDATE CLI CFG FOR SECTION COMMON USING TraceTimeStamp 3
TracePathName キーワードを使用する場合、指定する path が存在すること、およびグローバル読み取り権限およびグローバル書き込み権限があることを確認してください。
- 以下のコマンドを発行して、 db2cli.ini 構成ファイル内の CLI トレース・キーワードを確認します。
db2 GET CLI CFG FOR SECTION COMMON
注:
- IBM® Data Server Driver Package および IBM Data Server Driver for ODBC and CLI のインストール済み環境には、 Db2® コマンド行プロセッサーは含まれていません。 トレース構成キーワードの設定を変更するときには、db2cli.ini ファイルを手動で変更できます。
- CLI トレースを有効にするには、アプリケーションを再始動します。 CLI ストアード・プロシージャーをトレースする場合は、 Db2 インスタンスを再始動します。
db2cli.ini ファイルは、 TraceRefreshInterval キーワードが設定されていない限り、アプリケーションの初期化時に読み取り専用になります。
- 以下のようにエラーをキャプチャーします。
- エラーが生成されるまでアプリケーションを実行します。 トレース・サイズを縮小するには、問題の再現に必要なアプリケーションだけを実行します (可能な場合)。
- アプリケーションを終了する。
- 以下のいずれかの方法で、 CLI トレース設定を無効にします。
- トレースを無効にするために、アプリケーションを再始動します。
結果:
CLI トレース・ファイルは、 TracePathName キーワードに指定したパスに書き込まれます。 ファイル名の形式は、ppidttid.cli です。 pid 値は、オペレーティング・システムによって割り当てられるプロセス ID で、tid 値は、アプリケーション・プロセスによって生成される各スレッドの数値カウンター (0 から始まる) です。 例えば、ファイル名は、p1234t1.cli のようになります。
次の作業
CLI トレース機能は、インスタンス上で現在実行されているすべてのアプリケーションのパフォーマンスに大きな影響を与えます。 したがって、必要な情報を収集した後に、 CLI トレースをオフにすることが重要です。
IBM サービスで問題を診断する場合は、トレース・パスに存在するすべてのファイルを収集します。