Question & Answer
Question
CLI トレースの取得方法について教えてください。
Answer
CLI トレース・ユーティリティーによって CLI ドライバーによって行われるすべての関数呼び出しをトレース・ファイルに記録できます。記録されたトレース・ファイルは、CLI ドライバーにアクセスするアプリケーションの問題判別に役立ちます。
以下の場所で問題が発生する場合に有効です。
以下の場所で問題が発生する場合に有効です。
- CLI アプリケーション
- ODBC アプリケーション ( ODBC アプリケーションが CLI インターフェースを使用して Db2 にアクセスした後 )
- CLI ストアード・プロシージャー
CLI トレースは次の手順 A もしくは手順 B で取得してください。
手順A (推奨):
手順A (推奨):
- CLI アプリケーションを実行するホストにインスタンス・オーナー (Linux/UNIX)、または管理者 (Windows) としてログインします。
- CLI トレースを有効化します。
db2trc on -cli -f clitrc.dmp -t
- 問題を再現します。
注:アプリケーションの再起動は不要です。 - CLI トレースを停止してフォーマットします。
db2trc off db2trc fmt -cli clitrc.dmp clitrc.fmt
サポートをご利用の場合、生成されたファイル (clitrc.*) をサポートにお送りください。
手順B (旧式の手順):
- CLI アプリケーションを実行するホストにインスタンス・オーナー (Linux/UNIX)、または管理者 (Windows) としてログインします。
- CLI トレースを有効化します。
db2 update cli cfg for section common using tracepathname <pathname> ※1 db2 update cli cfg for section common using traceflush 1 db2 update cli cfg for section common using tracecomm 1 db2 update cli cfg for section common using tracetimestamp 1 db2 update cli cfg for section common using trace 1
設定値が正しく反映されているか、次の手順で確認してください。 - CLI トレースの設定を確認します。
以下のコマンドを実行してください。
db2 get cli cfg for section common
セクション: common ------------------------------------------------- trace=1 tracetimestamp=1 tracecomm=1 traceflush=1 tracepathname=/test/db2/output
各パラメーターが指定通りの値になっているか、確認してください。CLI トレースの設定をした後、次の新規コネクションから、CLI トレースが有効になります。既存の接続に対しては有効ではありません。そのため、稼動中のアプリケーションは一度停止し再起動する必要があります。 - 問題を再現します。
注:アプリケーションを再起動しないとトレースは有効になりません。
指定したパスに cli という拡張子のファイルが生成されていることを確認します。例: p7798888t2057.cli - CLI トレースを停止します。
以下のように、trace=0 を設定すると CLI トレースは停止します。
db2 update cli cfg for section common using trace 0
db2 get cli cfg for section common
セクション: common ------------------------------------------------- trace=0 tracetimestamp=1 tracecomm=1 traceflush=1 tracepathname=/test/db2/output
サポートをご利用の場合、生成されたファイル (拡張子 *.cli) をサポートにお送りください。
注意事項:
- この手順は、ODBC アプリケーションなどを使用しての障害の場合に必要となる CLI トレースの取得方法です。
- 特に旧式の手順で CLI トレースを有効にすると、アプリケーションのパフォーマンスに大きな影響があります。
- CLI トレースはアプリケーションを実行しているホスト上で取得してください。
[{"Type":"MASTER","Line of Business":{"code":"LOB10","label":"Data and AI"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSEPGG","label":"Db2 for Linux, UNIX and Windows"},"ARM Category":[{"code":"a8m500000008PljAAE","label":"DB2 Tools-\u003Edb2trace"},{"code":"a8m500000008PmSAAU","label":"Programming Interface-\u003ECLI"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]
Was this topic helpful?
Document Information
Modified date:
26 October 2023
UID
swg21618585