cprfed (edit and output performance analysis trace information)
- Organization of this page
Format
cprfed [-h] | [-Dump | -CSV] [-Time start-time,end-time]
[-ProcessID process-id[,process-id...]]
[-TraceFile prf-trace-file-name[,prf-trace-file-name...]
| -AllTraceFile]
Function
This command inputs PRF trace information and edits and outputs performance analysis trace information.
Arguments
- -h
-
Displays the command's usage.
- -Dump
-
Outputs detailed information in dump format.
- -CSV
-
Outputs detailed information in CSV format.
- -Time start-time,end-time
-
Specifies a start and end time when only the trace information acquired within the specified time period is to be output.
The start time and end time are each specified in the format hhmmss[MMdd[yyyy]]. MMdd and yyyy might be omitted; if omitted, the month and year in which the command is executed are assumed.
- Time character string format: hhmmss[MMdd[yyyy]]
-
hh: Hour (00-23)
mm: Minute (00-59)
ss: Second (00-59)
MM: Month (01-12)
dd: Date (01-31)
yyyy: Year (1970-20xx)
- The table below shows argument specification examples and the corresponding editing ranges when the command is executed on October 11, 2006.
-
Argument specification
Editing range
-Time 102345,
From 45 seconds past 10:23 on October 11, 2006, until the end of the trace file
-Time,102345
From the start of the trace file until 45 seconds past 10:23 on October 11, 2006
-Time 102345,102350
From 45 seconds past 10:23 on October 11, 2006, until 50 seconds past 10:23 on October 11, 2006
-Time 1023451012,1023501013
From 45 seconds past 10:23 on October 12, 2006, until 50 seconds past 10:23 on October 13, 2006
-Time 10234510122005,10235010132005
From 45 seconds past 10:23 on October 12, 2005, until 50 seconds past 10:23 on October 13, 2005
- -ProcessID process-id
-
Specifies a process ID when information for only the specified process ID is to be output. Specify the process ID as a decimal number.
- -TraceFile prf-trace-file-name
-
Specifies a PRF trace file. A maximum of 256 trace files can be specified. This option cannot be specified together with the -AllTraceFile option.
Each PRF trace file is created automatically in the PRF trace file output destination directory. The file name of a PRF trace file is prf_???, where ??? is an integer between 001 and the maximum number of trace file sectors.
- PRF trace file output destination directory:
-
-
In Windows:
%PRFSPOOL%\utt\prf\prf-identifier\dcopltrc\
-
In UNIX:
$PRFSPOOL/utt/prf/prf-identifier/dcopltrc/
-
When specifying prf-trace-file-name, either you must specify an absolute path, or you must set the PRF trace file output destination directory as the current directory and specify a file name only.
- -AllTraceFile
-
Loads all files under the current directory as input files. This option cannot be specified together with the -TraceFile option. Edit only 256 files if the current directory has more than 256 files. If the results of the cprfed command are redirected to the current directory, the redirected files are also counted as input files.
The table below shows the combinations of command options that can be specified.
|
Command option |
-h |
-Dump |
-CSV |
-Time |
-ProcessID |
-TraceFile |
-AllTraceFile |
|---|---|---|---|---|---|---|---|
|
-h |
-- |
Δ-h |
Δ-h |
Δ-h |
Δ-h |
Δ-h |
Δ-h |
|
-Dump |
Δ-h |
-- |
Δ-CSV |
Y |
Y |
Y |
Y |
|
-CSV |
Δ-h |
Δ-CSV |
-- |
Y |
Y |
Y |
Y |
|
-Time |
Δ-h |
Y |
Y |
-- |
Y |
Y |
Y |
|
-ProcessID |
Δ-h |
Y |
Y |
Y |
-- |
Y |
Y |
|
-TraceFile |
Δ-h |
Y |
Y |
Y |
Y |
-- |
N |
|
-AllTraceFile |
Δ-h |
Y |
Y |
Y |
Y |
N |
-- |
- Legend:
-
Y: Can be specified simultaneously
Δ: Valid with the option whose name follows the Δ
N: Cannot be specified simultaneously
--: Not applicable
Return values
- 0:
-
Normal termination occurred.
- Other than 0:
-
An error occurred during command processing. Take the corrective action indicated in the output message, and then re-execute the command. The error message is output to the standard error output and a log file. For acquiring data, see 2.4.3 Correspondence Between Acquisition Methods and Investigation Methods in the uCosminexus Application Server Maintenance and Migration Guide.
Output format
-
Output format 1 (dump format)
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 ReceiveSCD: 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 -
Output format 2 (CSV format)
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
Legend:
|
Symbol |
Explanation |
|---|---|
|
aa...aa |
Record status (up to 6 characters):
|
|
bb...bb |
Process ID of the process from which trace information was collected (up to 10 decimal digits) |
|
cc...cc |
Thread ID of the thread in the process from which trace information was collected (up to 20 decimal digits) |
|
dd...dd |
Trace serial number in the thread (up to 10 decimal digits) |
|
ee...ee |
Event ID (6 hexadecimal digits (including the leading 0x)) |
|
ffff |
Time at which the trace was collected (year) |
|
gg |
Time at which the trace was collected (month) |
|
hh |
Time at which the trace was collected (date) |
|
ii |
Time at which the trace was collected (hour) |
|
jj |
Time at which the trace was collected (minute) |
|
kk |
Time at which the trace was collected (second) |
|
lll |
Time at which the trace was collected (millisecond) |
|
mmm |
Time at which the trace was collected (microsecond) |
|
nnn |
Time at which the trace was collected (nanosecond) |
|
oo...oo |
Return code (10 hexadecimal digits (including the leading 0x)) |
|
pp...pp |
Client application IP address (xxx.xxx.xxx.xxx format) |
|
qq...qq |
Client application process ID (up to 10 decimal digits) |
|
rr...rr |
Client communication number (18 digits (including the leading 0x)) |
|
ss...ss |
Root application IP address (xxx.xxx.xxx.xxx format) |
|
tt...tt |
Root application process ID (up to 10 decimal digits) |
|
uu...uu |
Root communication number (18 digits (including the leading 0x)) |
|
vv...vv |
IP address of request source CTM (xxx.xxx.xxx.xxx format) |
|
ww...ww |
Process ID of request source CTM (up to 10 decimal digits) |
|
xx...xx |
IP address of request destination CTM (xxx.xxx.xxx.xxx format) |
|
yy...yy |
Process ID of request destination CTM (up to 10 decimal digits) |
|
zz...zz |
Process name (up to 32 characters) |
|
XX...XX |
Interface name (up to 33 characters)# |
|
YY...YY |
Operation name (up to 33 characters)# |
|
ZZ...ZZ |
Lookup name (up to 33 characters)# Outputs schedule group names for the systems that execute batch applications. |
|
AAAA |
Offset |
|
BB |
Hexadecimal display of one byte information acquired in each event. |
|
CC...CC |
Expresses the contents of BB as the ASCII characters. The content that cannot be expressed as an ASCII character is output as a Period (.). |
|
DD...DD |
Outputs the information acquired in each event in the hexadecimal format within 512 characters. The dump format information is output enclosed with double quotes (" "). |
|
EE...EE |
The contents of DD are output as ASCII characters (maximum 514 characters). The ASCII characters are output enclosed with double quotes (" "). The code (control code) that cannot be displayed as an ASCII character is output as a period (.). One character (") is output as two characters ("") in the ASCII characters. This information is output in CSV format. |
|
FF...FF |
Outputs the hash value (in decimal within 10 digits) of a thread. The hash value of a thread might not be output in the trace information acquired with the CTM and redirector. |
- #
-
If the interface name, operation name, and lookup name exceeds 32 characters, the name is edited in one of the following ways, with the asterisk representing the omitted characters, and output in 33 characters (including the asterisk):
first-16-characters*last-16-characters
first-32-characters*
*last-32-characters
Input/output examples
-
Input example 1
cprfed -TraceFile prf_001
-
Output example 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
-
Input example 2
cprfed -Dump -TraceFile prf_001
-
Output example 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. -
Input example 3
cprfed -CSV -TraceFile prf_001
-
Output example 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,
Notes
-
In the performance analysis trace, the exclusion control is not performed during the PRF trace output, so that the bottlenecks do not occur because of the exclusion during high load. Therefore, some of the trace information might not be output properly.
-
When a file edited in the CSV format includes Japanese reference that file with an editor that supports Unicode or with Excel 2003 or later.