ctmstsed (edit and output statistics)
- Organization of this page
Format
ctmstsed [-h] [-CTMEdit edit-and-output-format[,edit-and-output-format...]]
[-CTMInterval time-interval] [-CTMTime [start-time][,end-time]]
[-CTMQueueName queue-name[,queue-name...]]
[-CTMMethod method-name[,method-name...]]
[-CTMCsv] [-CTMStdout]
[statistics-file-name[ statistics-file-name...]]
Function
This command edits and outputs statistics acquired in a statistics file. The default is text format.
The following three types of information can be output:
-
Summary information for the entire CTM node
-
Schedule queue information for each queue
-
Request information for each method
Arguments
- -h
-
Displays how to use the command.
- -CTMEdit edit-and-output-format[,edit-and-output-format...]
-
Specifies the type of statistics to be edited and output.
-
nod: Summary information for the entire CTM node is edited and output.
-
que: Schedule queue information for each queue is edited and output.
-
mtd: Request information for each method is edited and output.
If this argument is omitted, nod, que, and mtd are set.
-
- -CTMInterval time-interval
-
Specifies the time interval (in minutes) for editing and outputting statistics. You can specify an integer in the range from 1 to 1440. Specify an integer multiple of the time interval specified for the -CTMInterval option of the ctmstsstart command. If an integer multiple is not specified, the editing results are not output correctly.
If this argument is omitted, 10 is set.
- -CTMTime [start-time][,end-time]
-
Specifies the range of statistics to be edited and output, by using the start time and end time of data acquisition.
Specify the hour, minute, month, day, and year in hhmm[MMDD[YYYY]] format. If the month (MM), day (DD), and year (YYYY) are omitted, the current date is set.
The following table shows the range of specifiable values.
Symbol
Meaning
Range of values
Required or optional
hh
Hour
00 ≤ hh ≤ 23
Required
mm
Minute
00 ≤ mm ≤ 59
Required
MM
Month
01 ≤ MM ≤ 12
Optional
DD
Day
01 ≤ DD ≤ 31
Optional
YYYY
Year
1970 ≤ YYYY
Optional
If the start time is omitted, the output range is from the beginning of the file to the end time. If the end time is omitted, the output range is from the start time to the end of the file. If both the start time and end time are omitted, all information in the statistics file will be edited and output.
- -CTMQueueName queue-name[,queue-name...]
-
Specifies a queue name for which to edit and output statistics. You can specify 1 to 63 alphanumeric characters and underscores (_).
This option can be specified if que is specified for the -CTMEdit option or if the -CTMEdit option is omitted.
For a system that executes batch applications, specify a schedule group name as the queue name.
- -CTMMethod method-name[,method-name...]
-
Specifies a method name for which to edit and output statistics.
This option can be specified if mtd is specified for the -CTMEdit option or if the -CTMEdit option is omitted.
- -CTMCsv
-
Outputs the editing results in CSV (comma-separated text) format.
- -CTMStdout
-
Outputs the editing results to the standard output.
Table 6‒4: Argument (command option) combination list (ctmstsed command) Command option
-h
-CTMEdit
-CTMInterval
-CTMTime
-CTMQueueName
-CTMMethod
-CTMCsv
-CTMStdout
nod
que
mtd
-h
--
Δ-h
Δ-h
Δ-h
Δ-h
Δ-h
Δ-h
Δ-h
Δ-h
Δ-h
-CTMEdit
nod
Δ-h
--
Y
Y
Y
Y
N
N
Y
Y
que
Δ-h
Y
--
Y
Y
Y
Y
N
Y
Y
mtd
Δ-h
Y
Y
--
Y
Y
N
Y
Y
Y
-CTMInterval
Δ-h
Y
Y
Y
--
Y
Y
Y
Y
Y
-CTMTime
Δ-h
Y
Y
Y
Y
--
Y
Y
Y
Y
-CTMQueueName
Δ-h
N
Y
N
Y
Y
--
Y
Y
Y
-CTMMethod
Δ-h
N
N
Y
Y
Y
Y
--
Y
Y
-CTMCsv
Δ-h
Y
Y
Y
Y
Y
Y
Y
--
Y
-CTMStdout
Δ-h
Y
Y
Y
Y
Y
Y
Y
Y
--
- Legend:
-
Y: Can be specified simultaneously
Δ: Valid with the option whose name follows Δ
N: Cannot be specified simultaneously
--: Not applicable
- Note
-
If the -h option and other options are specified, the -h option takes priority.
- statistics-file-name[statistics-file-name...]
-
Specifies the name of a statistics file from which information is to be edited and output. You can specify a maximum of 256 file names by delimiting them with one-byte spaces. If this argument is omitted, statistics will be input from the standard input.
Return values
- 0:
-
The command is terminated normally.
- Other than 0:
-
The command terminated abnormally because an error occurred during command processing. Take the corrective action indicated in the output message, and then re-execute the command.
Output format
-
Output format of the summary information for the entire CTM node (nod is specified for the -CTMEdit option)
*** Statistics Information by CTMNode *** CTMDomain :aa..aa CTMID :bb..bb -------------------------------------------------------------------------------- ** Edit time cc..cc - dd..dd ** statistical data : ee..ee - ee..ee no data : ff..ff - ff..ff -------------------------------------------------------------------------------- Event Count Maximum Minimum Average (unit) Request Response Time(Reg) gg..gg gg..gg gg..gg gg..gg (usec) Request Time Out(Reg) hh..hh - - - (count) Request Error(Reg) ii..ii - - - (count) Request Response Time(OTM) jj..jj jj..jj jj..jj jj..jj (usec) Request Time Out(OTM) kk..kk - - - (count) Request Error(OTM) ll..ll - - - (count) Schedule Wait Count mm..mm mm..mm mm..mm mm..mm (count) Schedule Wait Time nn..nn nn..nn nn..nn nn..nn (usec) Request Overflow oo..oo - - - (count) Regulator down pp..pp - - - (count) OTMGateway down qq..qq - - - (count) Regulator-Client - rr..rr rr..rr rr..rr (count) OTMGateway-Client - ss..ss ss..ss ss..ss (count) CTMDaemon-J2EEServer(Ctr) - tt..tt tt..tt tt..tt (count) CTMDaemon-J2EEServer(Req) - uu..uu uu..uu uu..uu (count) CTMDaemon-Regulator - vv..vv vv..vv vv..vv (count) CTMDaemon-OTMGateway - ww..ww ww..ww ww..ww (count)
- Legend:
-
Symbol
Description
aa..aa
CTM domain name (1 to 31 alphanumeric characters)
bb..bb
CTM identifier (1 to 31 alphanumeric characters)
cc..cc
Editing start time
dd..dd
Editing end time
ee..ee
Time period in which statistics were collected in the editing time
ff..ff
Time period in which statistics were not collected in the editing time
gg..gg
CTM regulator response time (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
hh..hh
CTM regulator request timeout (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
ii..ii
CTM regulator request error (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
jj..jj
OTM gateway response time (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
kk..kk
OTM gateway request timeout (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
ll..ll
OTM gateway request error (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
mm..mm
Number of requests waiting to be scheduled (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
nn..nn
Scheduling wait time (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
oo..oo
Number of requests that could not be scheduled (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
pp..pp
Number of CTM regulators that terminated abnormally (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
qq..qq
Number of OTM gateways that terminated abnormally (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
rr..rr
Number of connections between CTM regulator and the client (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
ss..ss
Number of connections between OTM gateway and the OTM client (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
tt..tt
Number of control connections between CTM daemons and J2EE servers# (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
uu..uu
Number of request connections between CTM daemons and J2EE servers (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
vv..vv
Number of connections between CTM daemons and CTM regulators (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
ww..ww
Number of connections between CTM daemons and OTM gateways. A value equal to or greater than 100000000000 is output as ***********.
- #
-
The number of control connections between CTM daemons and J2EE servers (or batch servers if the system executes batch applications) is the sum of the number of J2EE servers and the number of queues generated for each J2EE server.
-
CSV output format of summary information for the entire CTM node (nod is specified for the -CTMEdit option, and the -CTMCsv option is specified)
*** Statistics Information by CTMNode *** CTMDomain, CTMID, start, end, Event, Count, Maximum, Minimum, Average, unit aa..aa, bb..bb, cc..cc, dd..dd, ee..ee, ff..ff, gg..gg, hh..hh, ii..ii, jj..jj aa..aa, bb..bb, cc..cc, dd..dd, ee..ee, ff..ff, gg..gg, hh..hh, ii..ii, jj..jj
- Legend:
-
Symbol
Description
aa..aa
CTM domain name (1 to 31 alphanumeric characters)
bb..bb
CTM identifier (1 to 31 alphanumeric characters)
cc..cc
Editing start time
dd..dd
Editing end time
ee..ee
Event contents
ff..ff
Number of events that occurred (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
gg..gg
Maximum value (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
hh..hh
Minimum value (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
ii..ii
Average value (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
jj..jj
Unit
- Note
-
If the -CTMCsv option is specified, the editing time period in which statistical informations were collected and the editing time period in which no statistics were collected are not output.
-
Output format of schedule queue information for each queue (que is specified for the -CTMEdit option)
*** Statistics Information by Queue *** CTMDomain :aa..aa CTMID :bb..bb -------------------------------------------------------------------------------- QueueName : cc..cc -------------------------------------------------------------------------------- ** Edit time dd..dd - ee..ee ** statistical data : ff..ff - ff..ff no data : gg..gg - gg..gg -------------------------------------------------------------------------------- Event Count Maximum Minimum Average(unit) Schedule Wait Count hh..hh hh..hh hh..hh hh..hh(count) Schedule Wait Time ii..ii ii..ii ii..ii ii..ii(usec) Request Overflow jj..jj - - -(count) CTMDaemon-J2EEServer(Req) - kk..kk kk..kk kk..kk(count)
- Legend:
-
Symbol
Description
aa..aa
CTM domain name (1 to 31 alphanumeric characters)
bb..bb
CTM identifier (1 to 31 alphanumeric characters)
cc..cc
For J2EE applications, a queue name (1 to 63 characters) is output.
For batch applications, a schedule group name is output.
dd..dd
Editing start time
ee..ee
Editing end time
ff..ff
Time period in which statistics were collected in the editing time
gg..gg
Time period in which statistics were not collected in the editing time
hh..hh
Number of requests waiting to be scheduled (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
ii..ii
Scheduling wait time (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
jj..jj
Number of requests that could not be scheduled (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
kk..kk
Number of request connections between CTM daemons and J2EE servers (or batch servers in a system that executes batch applications) (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
- Note
-
Information following QueueName: cc..cc is repeatedly output for each queue.
-
CSV output format of schedule queue information for each queue (que is specified for the -CTMEdit option, and the -CTMCsv option is specified)
*** Statistics Information by CTMQueue *** CTMDomain, CTMID, start, end, Event, Count, Maximum, Minimum, Average, unit aa..aa, bb..bb, cc..cc, dd..dd, ee..ee, ff..ff, gg..gg, hh..hh, ii..ii, jj..jj aa..aa, bb..bb, cc..cc, dd..dd, ee..ee, ff..ff, gg..gg, hh..hh, ii..ii, jj..jj : :
- Legend:
-
Symbol
Description
aa..aa
CTM domain name (1 to 31 alphanumeric characters)
bb..bb
CTM identifier (1 to 31 alphanumeric characters)
cc..cc
Editing start time
dd..dd
Editing end time
ee..ee
Event contents
ff..ff
Number of events that occurred (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
gg..gg
Maximum value (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
hh..hh
Minimum value (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
ii..ii
Average value (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
jj..jj
Unit
- Note
-
If the -CTMCsv option is specified, the editing time period in which statistical informations were collected and the editing time period in which no statistics were collected are not output.
-
Output format of request information for each method (mtd is specified for the -CTMEdit option)
*** Statistics Information by Method *** CTMDomain :aa..aa CTMID :bb..bb -------------------------------------------------------------------------------- ** Edit time cc..cc - dd..dd ** statistical data : ee..ee - ee..ee no data : ff..ff - ff..ff -------------------------------------------------------------------------------- Interface : gg..gg Method : hh..hh -------------------------------------------------------------------------------- Event Count Maximum Minimum Average (unit) Request Response Time(Reg) ii..ii ii..ii ii..ii ii..ii (usec) Request Time Out(Reg) jj..jj - - - (count) Request Error(Reg) kk..kk - - - (count) Request Response Time(OTM) ll..ll ll..ll ll..ll ll..ll (usec) Request Time Out(OTM) mm..mm - - - (count) Request Error(OTM) nn..nn - - - (count)
- Legend:
-
Symbol
Description
aa..aa
CTM domain name (1 to 31 alphanumeric characters)
bb..bb
CTM identifier (1 to 31 alphanumeric characters)
cc..cc
Editing start time
dd..dd
Editing end time
ee..ee
Time period in which statistics were collected in the editing time
ff..ff
Time period in which statistics were collected in the editing time
gg..gg
Interface name (1 to 31 alphanumeric characters). An interface exceeding 31 characters is output in first-15-characters*last-15-characters format.
hh..hh
Method name (1 to 31 alphanumeric characters). A method name exceeding 31 characters is output in first-15-characters*last-15-characters format.
ii..ii
CTM regulator response time (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
jj..jj
CTM regulator request timeout (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
kk..kk
CTM regulator request error (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
ll..ll
OTM gateway response time (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
mm..mm
OTM gateway request timeout (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
nn..nn
OTM gateway request error (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
- Note
-
Information following Interface is repeatedly output for each method of the J2EE server.
-
CSV output format of request information for each method (mtd is specified for the -CTMEdit option, and the -CTMCsv option is specified)
*** Statistics Information by Method *** CTMDomain, CTMID, start, end, Event, Count, Maximum, Minimum, Average, unit aa..aa, bb..bb, cc..cc, dd..dd, ee..ee, ff..ff, gg..gg, hh..hh, ii..ii, jj..jj aa..aa, bb..bb, cc..cc, dd..dd, ee..ee, ff..ff, gg..gg, hh..hh, ii..ii, jj..jj :
- Legend:
-
Symbol
Description
aa..aa
CTM domain name (1 to 31 alphanumeric characters)
bb..bb
CTM identifier (1 to 31 alphanumeric characters)
cc..cc
Editing start time
dd..dd
Editing end time
ee..ee
Event contents
ff..ff
Number of events that occurred (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
gg..gg
Maximum value (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
hh..hh
Minimum value (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
ii..ii
Average value (11 decimal digits). A value equal to or greater than 100000000000 is output as ***********.
jj..jj
Unit
- Note
-
If the -CTMCsv option is specified, the editing time period in which statistical information were collected and the editing time period in which no statistics were collected are not output. For a system that executes batch applications, request information for each method is invalid.