コマンド解説書

db2trc - トレース

DB2 トレース機能のトレースを活動化します。 DB2 は独自のトレース機能を使用して、事象をトレースし、 トレース・データをファイルにダンプし、 トレース・データを読み取り可能な形式にフォーマットします。 DB2 顧客サービスが指示した場合、 または技術サポート担当者が指示した場合にのみ、トレース機能を使用します。

許可

UNIX ベースのシステムでは、次のどれかが必要です。

OS/2 または Windows オペレーティング・システムでは、許可は必要ありません。

必須接続

なし

コマンド構文

>>-db2trc--+----------------------------------------------------+->
           |     .- ------------------------------------------. |
           |     V                                            | |
           +-on-----+--------------------------------------+--+-+
           |        |     .-.----------------------------. |    |
           |        |     V                              | |    |
           |        +--m----+-*-----------------------+--+-+    |
           |        |       |  .-,------------------. |    |    |
           |        |       |  V                    | |    |    |
           |        |       '------num--+------+----+-'    |    |
           |        |                   '--num-'           |    |
           |        +--e--max_sys_errors-------------------+    |
           |        +--r--max_record_size------------------+    |
           |        +--f--filename-------------------------+    |
           |        +-+--l--+--------------+-+-------------+    |
           |        | |     '-buffer_size--' |             |    |
           |        | '--i--+--------------+-'             |    |
           |        |       '-buffer_size--'               |    |
           |        '--t-----------------------------------'    |
           +-off------------------------------------------------+
           +-dump--filename-------------------------------------+
           +-flw--dump_file--output_file------------------------+
           '-fmt--dump_file--output_file------------------------'
 
>--------------------------------------------------------------><
 

コマンド・パラメーター

on
DB2 トレース機能を開始するには、このパラメーターを使用します。 このパラメーターのオプションについては、次の項を参照してください。

dump
エラーを複製した後で、トレース情報をファイルにダンプします。 次のコマンドは、 トレース情報を現行ディレクトリーの db2trc.dmp というファイルに入れます。

   db2trc dump db2trc.dmp

このパラメーターでファイル名を指定します。 明示的にパスが指定されていない場合、 そのファイルは現行ディレクトリーに保管されます。

off
トレースをファイルにダンプした後、次のように入力してトレースをオフにします。

   db2trc off

flw | fmt
トレースをバイナリー・ファイルにダンプした後、 それが ASCII ファイルにフォーマットされたことを確認します。 flw オプション (プロセスまたはスレッドで分類する)、 または fmt オプション (事象が起きた順にリストする) のどちらかを使用します。 どちらのオプションの場合でも、 ダンプ・ファイル名および生成される出力ファイルの名前を指定します。 たとえば、次のようにします。

   db2trc flw db2trc.dmp db2trc.flw

DB2 トレースの開始

トレース機能を使用するには、 まず db2trc on を使用してトレース機能をオンにします。 DB2 顧客サービスからは他の指示がない場合、 オプションを指定せずにこのコマンドを使用します。 省略時のトレース・オプション値は、以下のとおりです。

オプションを指定してトレースを調整するように指示された場合、 DB2 顧客サービスの指示通りに以下のオプションを使用します。

-m mask
トレース・レコード・タイプを指定して、探索をフォーカスします。 mask 変数は、 ピリオドで区切られた 4 つの 1 バイト・マスクからなっています。 バイト・マスクは、それ自体の ID に基づいて 事象ごとに DB2 が送信するトレース・レコードを受け入れたり、 拒否したりするフィルターとして動作します。 4 つの 1 バイト・マスクは、製品、事象タイプ、 構成要素および関数にそれぞれ対応しています。

-e max_sys_errors
トレースが max_sys_errors に保持する DB2 内部システム・エラーの数を制限します。

-r max_record_size
トレース・レコードのサイズを max_record_size バイトに制限します。 長いトレース・レコードは切り捨てられます。

-f filename
共用メモリーまたはファイル中の追跡バッファーのロケーションを指定します。

-l [ buffer_size] | -i [buffer_size]
'-l' ("lucky" の "l") は、 最後のトレース・レコードを保存することを指定します (つまり、 バッファーが満杯になると最初のレコードが重ね書きされます)。 -i' は、最初のトレース・レコードを保存することを指定します (つまり、 バッファーがいったん満杯になると、レコードの書き込みはそれ以上行われません)。 これらのオプションのどちらかを使用して、バッファー・サイズを指定してください。

-t
タイム・スタンプを含めます。 これは UNIX 環境でのみ適用できます。 タイム・スタンプのログを記録するとパフォーマンスに影響を与えます。

トレース例を含め、db2trc についての追加情報は、 問題判別の手引き を参照してください。

使用上の注意

db2trc コマンドは、トレースをオンにする時、 ダンプ・ファイルを生成する時、ダンプ・ファイルをフォーマットする時、 トレースを再びオフにする時など、何回か発行する必要があります。 パラメーターのリストは、そのパラメーターを使用する順序になっています。


[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]