cprfed（性能解析トレース情報の編集出力）
形式
cprfed [-h] | [-Dump | -CSV] [-Time <開始時刻>,<終了時刻>]
[-ProcessID <プロセスID>[,<プロセスID>...]]
[-TraceFile <PRFトレースファイル名> [,<PRFトレースファイル名>...]
| -AllTraceFile ]
機能
PRFトレース情報を入力して，性能解析トレース情報を編集出力します。
引数
- -h
-
コマンドの使用方法が表示されます。
- -Dump
-
詳細情報をダンプ形式で出力します。
- -CSV
-
詳細情報をCSV形式で出力します。
- -Time <開始時刻>，<終了時刻>
-
指定された時刻内に取得されたトレース情報だけを出力します。
開始時刻，終了時刻は，hhmmss[MMdd[yyyy]]形式で指定します。MMdd，yyyyは省略できます。省略した場合は，コマンドを実行した月日年が指定されます。
- 時刻の文字列の形式：hhmmss[MMdd[yyyy]]
-
hh：時（00〜23）
mm：分（00〜59）
ss：秒（00〜59）
MM：月（01〜12）
dd：日（01〜31）
yyyy：年（1970〜20xx）
- 2003年10月11日にコマンドを実行した場合の引数の指定例とその編集範囲の例を次に示します。
-
引数の指定
編集範囲
-Time 102345,
2003年10月11日10時23分45秒からトレースファイルの最後まで。
-Time ,102345
トレースファイルの最初から2003年10月11日10時23分45秒まで。
-Time 102345,102350
2003年10月11日10時23分45秒から2003年10月11日10時23分50秒まで。
-Time 1023451012,1023501013
2003年10月12日10時23分45秒から2003年10月13日10時23分50秒まで。
-Time 10234510122002,10235010132002
2002年10月12日10時23分45秒から2002年10月13日10時23分50秒まで。
- -ProcessID <プロセスID>
-
指定されたプロセスIDの情報だけを編集出力します。プロセスIDは10進数で指定してください。
- -TraceFile <PRFトレースファイル名>
-
PRFトレースファイルを指定します。トレースファイルは最大256個指定できます。このオプションは，-AllTraceFileオプションと同時に指定できません。
PRFトレースファイルは，PRFトレースファイル出力先ディレクトリに自動的に作成され，ファイル名はprf_???になります。???は，001からトレースファイルの面数を最大値とした整数です。
- PRFトレースファイル出力先ディレクトリ
-
-
Windowsの場合
%PRFSPOOL%\utt\prf\PRF識別子\dcopltrc\
-
UNIXの場合
$PRFSPOOL/utt/prf/PRF識別子/dcopltrc/
-
また，<PRFトレースファイル名>を指定する場合は，絶対パスを指定するか，PRFトレースファイル出力先ディレクトリに移動してから，ファイル名だけを指定します。
- -AllTraceFile
-
カレントディレクトリ下のすべてのファイルを入力ファイルとして読み込みます。このオプションは，-TraceFileオプションと同時に指定できません。カレントディレクトリに256を超える数のファイルがある場合は256ファイルだけ編集します。なお，cprfedコマンドの結果をカレントディレクトリにリダイレクトする場合は，リダイレクト先のファイルも入力ファイルとして数えます。
指定できるコマンドオプションの組み合わせの一覧を次に示します。
|
コマンド オプション |
-h |
-Dump |
-CSV |
-Time |
-ProcessID |
-TraceFile |
-AllTraceFile |
|---|---|---|---|---|---|---|---|
|
-h |
− |
△-h |
△-h |
△-h |
△-h |
△-h |
△-h |
|
-Dump |
△-h |
− |
△-CSV |
○ |
○ |
○ |
○ |
|
-CSV |
△-h |
△-CSV |
− |
○ |
○ |
○ |
○ |
|
-Time |
△-h |
○ |
○ |
− |
○ |
○ |
○ |
|
-ProcessID |
△-h |
○ |
○ |
○ |
− |
○ |
○ |
|
-TraceFile |
△-h |
○ |
○ |
○ |
○ |
− |
× |
|
-AllTraceFile |
△-h |
○ |
○ |
○ |
○ |
× |
− |
- （凡例）
-
○：同時に指定できます。
△：△のあとに続くオプション名のオプションが有効になります。
×：同時に指定できません。
−：該当しません。
戻り値
- 0：
-
正常終了しました。
- 0以外：
-
コマンド処理中にエラーが発生しました。出力されたメッセージに従って対策したあと，再度コマンドを実行してください。エラーメッセージは標準エラー出力，ログファイルに出力されます。資料の取得方法については，マニュアル「アプリケーションサーバ 機能解説 保守／移行編」の「2.4.3 取得方法および調査方法との対応」を参照してください。
出力形式
-
出力形式1（ダンプ形式）
PRF: aa…aa Process: bb…bb Thread: cc…cc(FF…FF) Trace: dd…dd ProcessName: zz.zz Event: eeeee Time: ffff/gg/hh ii:jj:kk lll/mmm/nnn Rc: oo…oo ClientAP:pp…pp qq…qq - rr…rr RootAP: ss…ss tt…tt - uu…uu SendSCD:vv…vv ww…ww RecieveSCD:xx…xx yy…yy INT: XX…XX OPR: YY…YY LookupName:ZZ..ZZ Offset +0 +1 +2 +3 +4 +5 +6 +7 +8 +9 +a +b +c +d +e +f 0123456789abcdef AAAA BB BB BB BB BB BB BB BB BB BB BB BB BB BB BB BB CC…CC AAAA BB BB BB BB BB BB BB BB BB BB BB BB BB BB BB BB CC…CC ： AAAA BB BB BB BB BB BB BB BB BB BB BB BB BB BB BB BB CC…CC -
出力形式2（CSV形式）
PRF,Process,Thread,Trace,ProcessName,Event,Date,Time,Time(msec/usec/nsec),Rc,ClientAP IP,ClientAP PID, ClientAP CommNo.,RootAP IP,RootAP PID,RootAP CommNo.,SendSCD IP,SendSCD PID,ReceiveSCD IP,ReceiveSCD PID,INT,OPR,LookupName,OPT,ASCII aa…aa,bb…bb,cc…cc(CC…CC),dd…dd,zz…zz,ee…ee,ffff/gg/hh,ii:jj:kk，lll/mmm/nnn,oo…oo,pp…pp,qq…qq,rr…rr,ss…ss,tt…tt,uu…uu,vv…vv,ww…ww,xx…xx,yy…yy,XX…XX,YY…YY,ZZ…ZZ,DD…DD,EE…EE
- （凡例）
-
記号
説明
aa…aa
レコード状態（６文字以内）
-
Rec：レコードの状態は正常です。
-
ErrRec：レコードの状態は異常です。
bb…bb
トレース情報を取得したプロセスのプロセスID（10進数で10けた以内）
cc…cc
トレース情報を取得したプロセス内スレッドのスレッドID（10進数で20けた以内）
dd…dd
該当スレッドでのトレース通番（10進数で進10けた以内）
ee…ee
イベントID（16進6けた（先頭の0x含む））
ffff
トレースを取得した時刻（年）
gg
トレースを取得した時刻（月）
hh
トレースを取得した時刻（日）
ii
トレースを取得した時刻（時）
jj
トレースを取得した時刻（分）
kk
トレースを取得した時刻（秒）
lll
トレースを取得した時刻（ミリ秒）
mmm
トレースを取得した時刻（マイクロ秒）
nnn
トレースを取得した時刻（ナノ秒）
oo…oo
リターンコード（16進数で10けた（先頭の0x含む））
pp…pp
クライアントアプリケーションのIPアドレス（xxx.xxx.xxx.xxxの形式）
qq…qq
クライアントアプリケーションのプロセスID（10進10けた以内）
rr…rr
クライアントの通信番号（18けた（先頭の0x含む））
ss…ss
ルートアプリケーションのIPアドレス（xxx.xxx.xxx.xxxの形式）
tt…tt
ルートアプリケーションのプロセスID（10進数で10けた以内）
uu…uu
ルートの通信番号（18けた（先頭の0x含む））
vv…vv
リクエスト要求元CTMのIPアドレス（xxx.xxx.xxx.xxxの形式）
ww…ww
リクエスト要求元CTMのプロセスID（10進数で10けた以内）
xx…xx
リクエスト要求先CTMのIPアドレス（xxx.xxx.xxx.xxxの形式）
yy…yy
リクエスト要求先CTMのプロセスID（10進数で10けた以内）
zz…zz
プロセス名称（32文字以内）
XX…XX
インタフェース名（33文字以内）※
YY…YY
オペレーション名（33文字以内）※
ZZ…ZZ
ルックアップ名（33文字以内）※
バッチアプリケーションを実行するシステムの場合，スケジュールグループ名を出力します。
AAAA
オフセット
BB
各イベントで取得した情報の1バイト分の16進数表示。
CC…CC
BBの内容をASCII文字で表現します。ASCII文字で表現できない内容は「.」（ピリオド）で出力します。
DD…DD
各イベントで取得した情報を512文字以内の16進数形式で出力します。
ダンプ形式の情報は，""で囲んで出力します。
EE…EE
DDの内容をASCII文字で出力（最大514文字）します。
ASCII文字は，""で囲んで出力します。
ASCII文字で表示できないコード（制御コード）は「.」（ピリオド）で出力し，ASCII文字で"（1文字）は""（2文字）で出力します。
CSV形式の場合に出力される情報です。
FF…FF
スレッドのハッシュ値を出力（10進数で10けた以内）します。CTMおよびリダイレクタで取得したトレース情報には，スレッドのハッシュ値が出力されない場合があります。
-
- 注※
-
インタフェース名，オペレーション名，ルックアップ名が32文字を超える場合は，次のように編集され33文字で出力されます。
「前16文字」+「＊」＋「後ろ16文字」
「前32文字」+「＊」
「＊」+「後ろ32文字」
入力例・出力例
-
入力例1
cprfed -TraceFile prf_001
-
出力例1
PRF: Rec Process: 516 Thread: 2204 Trace: 10 ProcessName: ctmd.exe Event: 0x1406 Time: 2004/02/05 16:46:55 576/000/000 Rc: 0 ClientAP: 10.209.13.123 2148 - 0000000000000107 RootAP: 10.209.13.123 2200 - 0000000000000104 SendSCD: 10.209.13.122 516 ReceiveSCD: **** **** INT: com/abcd/BookShop OPR: orderBook LookupName: BookShop
-
入力例2
cprfed -Dump -TraceFile prf_001
-
出力例2
PRF: Rec Process: 516 Thread: 2204 Trace: 10 ProcessName: ctmd.exe Event: 0x1406 Time: 2004/02/05 16:46:55 576/000/000 Rc: 0 ClientAP: 10.209.13.123 2148 - 0000000000000107 RootAP: 10.209.13.123 2200 - 0000000000000104 SendSCD: 10.209.13.122 516 ReceiveSCD: **** **** INT: com/abcd/BookShop OPR: orderBook LookupName: BookShop Offset +0 +1 +2 +3 +4 +5 +6 +7 +8 +9 +a +b +c +d +e +f 0123456789abcdef +0000 0a d1 0d 7a 04 02 00 00 0a d1 0d 7b 64 08 00 00 ...z.......{d... +0010 00 00 00 00 07 01 00 00 0a d1 0d 7b 98 08 00 00 ...........{.... +0020 00 00 00 00 04 01 00 00 00 00 00 00 63 6f 6d 2f ............com/ +0030 61 6d 61 7a 6f 73 6f 2f 42 6f 6f 6b 53 68 6f 70 abcd/BookShop +0040 00 6f 72 64 65 72 42 6f 6f 6b 00 42 6f 6f 6b 53 .orderBook.BookS +0050 68 6f 70 00 hop. -
入力例3
cprfed -CSV -TraceFile prf_001
-
出力例3
PRF,Process,Thread,Trace,ProcessName,Event,Date,Time,Time(msec/usec/nsec),Rc,ClientAP IP,ClientAP PID, ClientAP CommNo.,RootAP IP,RootAP PID,RootAP CommNo.,SendSCD IP,SendSCD PID,ReceiveSCD IP,ReceiveSCD PID,INT,OPR,LookupName,OPT,ASCII Rec,516,2204,10,ctmd.exe,0x1406,2004/02/05,16:46:55,576/000/000,0,10.209.13.123,2148,0x0000000000000107,10.209.13.123,2200,0x0000000000000104,10.209.13.122,516,****,****,com/abcd/BookShop,orderBook,BookShop,
注意事項
-
性能解析トレースでは高負荷時に排他によるボトルネックが生じないように，PRFトレース出力時に排他制御をしていません。そのため，一部トレース情報が正しく出力されない場合があります。
-
CSV形式に編集したファイルに日本語を含む場合は，Unicodeをサポートしたエディタ，またはExcel 2003以降で参照してください。