ctmlsque (output schedule queue information)
- Organization of this page
Format
ctmlsque [-h] [-CTMDomain CTM-domain-name] [-CTMID CTM-identifier]
[-CTMMyHost host-name-or-IP-address]
[-CTMQueue schedule-queue-registration-name]
[-CTMInterface [interface-name]] [-CSV]
[-CTMAppInfo]
Function
This command outputs scheduling information for a schedule queue.
Arguments
- -h
-
Displays how to use the command.
- -CTMDomain CTM-domain-name
-
Specifies the CTM domain name of the CTM daemon for which schedule queue information is to be output. You can specify 1 to 31 alphanumeric characters and underscores (_). Do not specify a character string that begins with CTM or ctm. If this argument is omitted, CTMDOMAIN is set.
- -CTMID CTM-identifier
-
Specifies the identifier of the CTM daemon for which schedule queue information is to be output. You can specify 1 to 31 alphanumeric characters, periods (.), and underscores (_). Do not specify a CTM identifier that begins with CTM or ctm. Period (.) can only be specified in IP addresses. If this argument is omitted, an IP address is set to the CTM identifier.
For example, if the IP address of the host is 172.17.112.43, the character string 172.17.112.43 is assumed as the CTM identifier.
- -CTMMyHost host-name-or-IP-address
-
Specifies the host name or IP address used by CTM in a node switching environment where a multi-homed host or IP address is inherited. You can specify a character string of 1 to 64 characters. If this argument is omitted, the host name acquired by the hostname command is set.
- -CTMQueue schedule-queue-registration-name
-
Specifies the registration name of the schedule queue to be output. You can specify 1 to 63 alphanumeric characters and underscores (_).
For a system that executes batch applications, specify a schedule group name as the registration name of the schedule queue.
- -CTMInterface interface-name
-
Specifies an EJB interface name to be output. You can specify a character string of at least one character. If you specify an interface name, the specified interface name and the INS registration information for EJB are output.
If you specify only the -CTMInterface option, all interface names and INS registration names are output.
- -CSV
-
Outputs standard output information in CSV format.
- -CTMAppInfo
-
Outputs information about applications that share the schedule queue.
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
-
Standard output format
*** ctmd Information *** CTMDomain aa...aa CTMID bb...bb -------------------------------------------------------------------- *** CTMQueue Information *** QueueName cc...cc Status d ApplicationCount ee...ee RequestCount ff...ff RequestMax gg...gg QueueLength hh...hh ParallelCount ii...ii TotalThreadCount jj...jj *** Application Information *** [1]J2EEServerName kk...kk [1]StartParallelCount ll...ll [1]ResidentThreadCount mm...mm [2]J2EEServerName kk...kk [2]StartParallelCount ll...ll [2]ResidentThreadCount mm...mm *** LookupName and Interface Information *** [1]LookupName nn...nn [1]InterfaceName oo...oo [2]LookupName nn...nn [2]InterfaceName oo...oo [3]LookupName nn...nn [3]InterfaceName oo...oo -------------------------------------------------------------------- *** CTMQueue Information *** QueueName cc...cc Status d ApplicationCount ee...ee RequestCount ff...ff RequestMax gg...gg QueueLength hh...hh ParallelCount ii...ii TotalThreadCount jj...jj *** LookupName and Interface Information *** : : -
CSV output format
CTMDomain,CTMID aa...aa,bb...bb QueueName,Status,ApplicationCount,RequestCount,RequestMax,QueueLength,ParallelCount,TotalThreadCount,J2EEServerName,StartParallelCount,ResidentThreadCount,LookupName,InterfaceName cc...cc,dd...dd,ee...ee,ff...ff,gg...gg,hh...hh,ii...ii,jj...jj,kk...kk,ll...ll,mm...mm,nn...nn,oo...oo ,,,,,,,,kk...kk,ll...ll,mm...mm,nn...nn,oo...oo ,,,,,,,,,,,nn...nn,oo...oo : : QueueName,Status,ApplicationCount,RequestCount,RequestMax,QueueLength,ParallelCount,TotalThreadCount,J2EEServerName,StartParallelCount,ResidentThreadCount,LookupName,InterfaceName cc...cc,dd..dd,ee...ee,ff...ff,gg...gg,hh...hh,ii...ii,jj...jj,kk...kk,ll...ll,mm...mm,nn...nn,oo...oo ,,,,,,,,kk...kk,ll...ll,mm...mm,nn...nn,oo...oo ,,,,,,,,,,,nn...nn,oo...oo : :Legend:
Symbol
Description
Type
aa...aa
Specified CTM domain name (1 to 31 alphanumeric characters)
CTM daemon information
bb...bb
Specified CTM identifier (1 to 31 alphanumeric characters)
cc...cc
Schedule queue name that matches the specified condition (1 to 63 alphanumeric characters)
Schedule queue information 1
d
One of the following values indicating the schedule queue status that matches the specified condition:
-
S: Schedule queue is being prepared.
-
A: Scheduling is possible.
-
E: Schedule queue is being terminated.
-
H: Schedule queue is locked.
-
C: Locked but queuing is possible.
ee...ee
Number of J2EE applications that share the schedule queue (5 decimal digits)
ff...ff
Number of requests retained in the schedule queue (10 decimal digits)
gg...gg
Maximum number of requests that have been retained in the schedule queue (10 decimal digits)
hh...hh
Number of requests that can be registered concurrently (5 decimal digits)
ii...ii
Number of concurrent executions managed by the schedule queue (3 decimal digits)
jj...jj
Total number of resident threads managed by the schedule queue (3 decimal digits)
kk...kk
Name of the J2EE server to which the schedule queue is connected (alphanumeric characters)
Schedule queue information 2
ll...ll
Number of concurrent executions at startup of the J2EE application displayed by kk...kk (3 decimal digits)
mm...mm
Number of currently resident threads for the J2EE application displayed by kk...kk (3 decimal digits)
nn...nn
INS registration name managed by the queue (alphanumeric characters)
Schedule queue information 3
oo...oo
Interface name managed by the queue (alphanumeric characters)
Notes
-
If multiple schedule queues match the specified condition, entries of schedule queue information 1 to 3 are repeatedly output for the number of those schedule queues.
-
If the -CTMInterface option is specified, after schedule queue information 1 is output, entries of schedule queue information 3 are repeatedly output until all INS registration names and interface names managed by the schedule queue are output.
-
If the -CTMAppInfo option is specified, after schedule queue information 1 is output, entries of schedule queue information 2 are repeatedly output until all the following information items are output: Name of the J2EE server to which the schedule queue is connected, number of threads at startup of the J2EE application, and the number of threads for the J2EE application.
-
If both the -CTMInterface and -CTMAppInfo options are specified, after schedule queue information 1 is output, entries of schedule queue information 2 and 3 are repeatedly output.
-
For systems that execute batch applications, the description of Legend for Output format is different. For such systems, replace J2EE application with batch application, and J2EE server with batch server. In addition, a schedule group name is output for the schedule queue name and INS registration name.
-