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...]]

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

-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-2 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.

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 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 start 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. For a system that executes batch applications, request information for each method is invalid.