db2drdat - DRDA トレース・コマンド

Db2® DRDA アプリケーション・リクエスター (AR) および DRDA アプリケーション・サーバー (AS) 間で交換された DRDA データ・ストリームをキャプチャーできます。 このツールは、 アプリケーションの実行に必要な送信および受信の回数を判別することによって、 問題判別でよく使用されますが、 クライアント/サーバー環境でのパフォーマンス調整にも使用することができます。

許可

なし

コマンド構文

構文図を読む構文図をスキップするdb2drdaton-r-s-c-i-l=lengthoff-t=tracefile-p=pid-f

コマンド・パラメーター

on
AS トレース・イベント (指定しない場合はすべて) をオンにします。
off
AS トレース・イベントをオフにします。
-r
DRDA AR から受信した DRDA 要求をトレースします。
-s
DRDA AR に送信された DRDA 応答をトレースします。
-c
ホスト・システムの DRDA サーバーから受信した SQLCA をトレースします。 これは、様式化して読みやすくした非 NULL SQLCA です。
-i
トレース情報にタイム・スタンプを含めます。
-l
トレース情報を格納するために使用されるバッファーのサイズを指定します。
-p
このプロセスについてのみイベントをトレースします。 -p を指定しない場合、 サーバー上の着信 DRDA 接続をもつエージェントがすべてトレースされます。 トレースする pid は、 LIST APPLICATIONS コマンドによって戻される agent フィールドにあります。
-t
トレースの宛先を指定します。 ファイル名で、完全なパス名が指定されていない場合、 脱落情報は現行パスから取られます。 tracefile が指定されていない場合、 メッセージは現行ディレクトリーの db2drdat.dmp に送られます。
-f
通信バッファーをフォーマットします。

使用上の注意

db2drdat がアクティブな場合、 db2trc コマンドを発行しないでください。

db2drdat は、以下の情報を tracefile に書き込みます。
  1. -r
    • DRDA 要求のタイプ
    • 受信バッファー
  2. -s
    • DRDA 応答/オブジェクトのタイプ
    • 送信バッファー

コマンドは終了コードを戻します。 ゼロ値はコマンドが正常に完了したことを示します。 非ゼロ値はコマンドが正常に完了しなかったことを示します。 db2drdat が既に存在するファイルに出力を送信する場合、 ファイルの権限で古いファイルの消去が禁止されているのではない限り、 古いファイルは消去されます。 古いファイルの消去が禁止されている場合は、 オペレーティング・システムがエラーを返します。