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コマンドの結果をカレントディレクトリにリダイレクトする場合は，リダイレクト先のファイルも入力ファイルとして数えます。

指定できるコマンドオプションの組み合わせの一覧を次に示します。

表4-2　引数（コマンドオプション）の組み合わせ一覧（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以降で参照してください。