cprfed (edit and output performance analysis trace information)

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 specificationEditing range
-Time 102345,From 45 seconds past 10:23 on October 11, 2006, until the end of the trace file
-Time,102345From the start of the trace file until 45 seconds past 10:23 on October 11, 2006
-Time 102345,102350From 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.

Table 4-2 List of argument (command option) combinations (cprfed command)

Command
option
-h-Dump-CSV-Time-ProcessID-TraceFile-AllTraceFile
-h--[Figure]-h[Figure]-h[Figure]-h[Figure]-h[Figure]-h[Figure]-h
-Dump[Figure]-h--[Figure]-CSVYYYY
-CSV[Figure]-h[Figure]-CSV--YYYY
-Time[Figure]-hYY--YYY
-ProcessID[Figure]-hYYY--YY
-TraceFile[Figure]-hYYYY--N
-AllTraceFile[Figure]-hYYYYN--
Legend:
Y: Can be specified simultaneously
[Figure]: Valid with the option whose name follows the [Figure]
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 the collection and checking methods in the uCosminexus Application Server Maintenance and Migration Guide.

Output format

Legend:

SymbolExplanation
aa....aaRecord status (up to 6 characters):
  • Rec: Record status is normal
  • ErrRec: Record status is abnormal
bb....bbProcess ID of the process from which trace information was collected (up to 10 decimal digits)
cc....ccThread ID of the thread in the process from which trace information was collected (up to 20 decimal digits)
dd....ddTrace serial number in the thread (up to 10 decimal digits)
ee....eeEvent ID (6 hexadecimal digits (including the leading 0x))
ffffTime at which the trace was collected (year)
ggTime at which the trace was collected (month)
hhTime at which the trace was collected (date)
iiTime at which the trace was collected (hour)
jjTime at which the trace was collected (minute)
kkTime at which the trace was collected (second)
lllTime at which the trace was collected (millisecond)
mmmTime at which the trace was collected (microsecond)
nnnTime at which the trace was collected (nanosecond)
oo....ooReturn code (10 hexadecimal digits (including the leading 0x))
pp....ppClient application IP address (xxx.xxx.xxx.xxx format)
qq....qqClient application process ID (up to 10 decimal digits)
rr....rrClient communication number (18 digits (including the leading 0x))
ss....ssRoot application IP address (xxx.xxx.xxx.xxx format)
tt....ttRoot application process ID (up to 10 decimal digits)
uu....uuRoot communication number (18 digits (including the leading 0x))
vv...vvIP address of request source CTM (xxx.xxx.xxx.xxx format)
ww...wwProcess ID of request source CTM (up to 10 decimal digits)
xx...xxIP address of request destination CTM (xxx.xxx.xxx.xxx format)
yy...yyProcess ID of request destination CTM (up to 10 decimal digits)
zz....zzProcess name (up to 32 characters)
XX....XXInterface name (up to 33 characters)#
YY....YYOperation name (up to 33 characters)#
ZZ....ZZLookup name (up to 33 characters)#
Outputs schedule group names for the systems that execute batch applications.
AAAAOffset
BBHexadecimal display of one byte information acquired in each event
CC...CCExpresses the contents of BB as the ASCII characters. The content that cannot be expressed as an ASCII character is output as a Period (.).
DD...DDOutputs the information acquired in each event in the hexadecimal format within 512 characters.
The dump format information is output enclosed with double quotes (" ").
EE...EEThe 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...FFOutputs 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

Notes