OpenTP1 Version 7 Operation
rpcdump (Output RPC trace information)
Format
rpcdump [{-r|-m}] [{-c|-f}] [-d text-length] [-t begin-date-and-time] [,end-date-and-time]] [-s service-group-name [,service-name]...] [-b node-identifier [,node-identifier]...] [-v server-name [,server-name]...] [-p process-ID [,process-ID]...] [-x xid [,xid]...] [-n [begin-trace-number] [,end-trace-number]] [RPC-trace-file-name] |
Function
The rpcdump command edits trace information of RPC trace files and output it to the standard output.
Options
-r
Outputs the result of editing in the form of an RPC trace file.
-m
Outputs outline RPC trace information. When this option is specified, specification of the -c, -f, and -d options becomes invalid.
-c
Extracts and edits the relationship between the call source and the call destination, and output it in units of call/called trace information and in chronological order according to other options' output conditions. The trace information involved with a call/called relationship to the trace information extracted through other options is output even if not meeting other options' output conditions.
-f
Extracts and edits a series of RPC flow and outputs it in units of nest/nested trace information and in chronological order according to other options' output conditions. The trace information involved in the same flow as the trace information extracted through other options is output even if not meeting other options' output conditions.
When neither the -c option nor the -f option is specified, RPC trace information is displayed chronologically.
-d text-length~((0~4096))
Outputs the contents of a text with the specified length. When this option is omitted, the contents of all texts are output.
-t [begin-date-and-time][,end-date-and-time]
Specifies the output range of trace information by the date and time of trace acquisition.
The times must be specified in the range from 00:00:00 on January 1, 1970 to the current date and time.
The start time and end time cannot both be omitted. When the start time is omitted, the output range is from the beginning of the RPC trace file to the specified end time. When the end time is omitted, the output range is from the specified start time to the end of the RPC trace file.
The begin and end times are expressed in the format hhmmss[MMDD[YYYY]]:
hh: Hour (00 hh 23); cannot be omitted
mm: Minute (00 mm 59); cannot be omitted
ss: Second (00 ss 59); cannot be omitted
MM: Month (01 MM 12); can be omitted#
DD: Day (01 DD 31); can be omitted#
YYYY: Year (4-digit year from 1970); can be omitted#
If the -t option is omitted, all information in the specified file is edited and output.
-s service-group-name [,service-name]~<1-31 character identifier>
Specifies a service group name and a service name to edit and output trace information including the call destination trace information for a particular service. More than one service name can be specified for a service group, with a comma (,) placed between names. When no service name is specified, the trace information for all services in the specified service group is edited and output. A service name alone cannot be specified.
When the XATMI request/response type communication service is specified, the service group name must be a name specified in the service definition of SPP. No XATMI conversational communication service name cannot be specified.
-b node-identifier~<4-character identifier>
Outputs the trace information collected at an OpenTP1 node with the specified node identifier. It must be the same as the node identifier specified in the system common definition. More than one node identifier can be specified, with a comma (,) placed between identifiers.
-v server-name~<1-8 character identifier>
Outputs trace information collected by the specified server. More than one server name can be specified, with a comma (,) placed between names.
-p process-ID~((0-2147483647))
Outputs trace information collected by the specified process. More than one process IDs can be specified, with a comma (,) placed between IDs.
-x xid~<1-8 hexadecimal digits> ((0-ffffffff))
Outputs trace information with the sequential number of the specified global transaction identifier. More than one xid can be specified, with a comma (,) placed between xids.
-n [begin-trace-number][,end-trace-number] ((1-2147483647))
Outputs trace information ranging from the begin trace number to the end trace number. A trace number is a sequential number assigned to trace information in an RPC trace file.
When the begin trace number is omitted, the output range is from the beginning of the RPC trace file to the end trace number.
When the end trace number is omitted, the output range is from the specified begin trace number to the end of the RPC trace file.
Either the begin or end trace number must be specified.
Command arguments
RPC-trace-file-name~<path name>
Specifies the name of the RPC trace file in which trace information is to be edited. One of the following three names can be used:
When this command argument is omitted, information is dumped from $DCDIR/spool/rpctr.
The name of the RPC trace file (default: rpctr) included in the path can be a maximum of 13 characters.
Output format
(1)-m option specified
(2) Neither -r nor -m option specified
Wed Jan 1 12:34:56 2003 789:012 |
Output messages
Message ID | Description | Output destination |
---|---|---|
KFCA00308-E | RPC trace file contains no data. | Standard error output |
KFCA00310-E | Specified RPC trace file was not found. | Standard error output |
KFCA00312-E | Access error occurred in RPC trace file. | Standard error output |
KFCA00314-I | Help message | Standard output |
KFCA00352-E | RPC trace file data is incorrect. | Standard error output |
Notes
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.