ctmchpara (change the number of concurrent executions for schedule queues)
- Organization of this page
Format
ctmchpara [-h] [-CTMDomain CTM-domain-name] [-CTMID CTM-identifier] [-CTMMyHost host-name-or-IP-address] [-CTMTimeOut timeout-value] -CTMQueue schedule-queue-name -CTMChangeCount number-of-concurrent-executions
Function
This command changes the number of concurrent executions for each schedule queue by increasing and reducing the number of threads.
The completion of the command is processed as follows depending on whether threads are increased or decreased:
-
When increasing threads, the system waits for the threads to be generated.
-
When decreasing threads, the system waits for the completion of a request and then aborts threads, but does not wait for the completion of the command.
You can change the number of threads when one of the following is displayed as the schedule queue status for Status by the ctmlsque command:
-
A: Scheduling is possible.
-
H: Schedule queue is locked.
-
C: Locked but scheduling is possible.
If you change the number of concurrent executions, the number of threads for applications that shares the CTM queue is averaged.
Arguments
- -h
-
Displays how to use the command.
- -CTMDomain CTM-domain-name
-
Specifies the CTM domain name of the CTM daemon for which the number of concurrent executions is to be changed. 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 CTM identifier of the CTM daemon for which the number of concurrent executions is to be changed. 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 an IP address. If this argument is omitted, the 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.
- -CTMTimeOut timeout-value
-
Specifies the amount of time (in seconds) to wait for the number of concurrent executions for the schedule queue to change. You can specify an integer in the range from 0 to 2147483647. If 0 is specified, there is no limit on the wait time. If this argument is omitted, 180 (seconds) is set.
- -CTMQueue schedule-queue-name
-
Specifies the registration name of the schedule queue for which the number of concurrent executions is to be changed. You can specify 1 to 63 alphanumeric characters and underscores (_).
- -CTMChangeCount number-of-concurrent-executions
-
Specifies the new number of concurrent executions. You can specify an integer in the range from 1 to the number-of-applications-sharing-the-queue x 127. You cannot specify a value greater than the value of the -CTMDispatchParallelCount option specified during startup of the CTM daemon. If the -CTMDispatchParallelCount option was omitted during startup of the CTM daemon, you cannot specify a value greater than 255. For example, if you want to change the number of concurrent executions from 30 to 10, specify 10.
Return values
- 0:
-
The command is terminated normally.
- Other than 0:
-
An error occurred during command processing. Take the corrective action indicated in the output message, and then re-execute the command.
Notes
-
Do not use this command in a system that executes batch applications. If you use this command in such as system, operation will be unstable.
-
If the specified number of concurrent executions is smaller than the number of J2EE servers that share the schedule queue, the number of threads that send requests to each J2EE server is set to 1.
-
To execute this command, set the number of instances in a Session Bean pool to unlimited or to a value equal to or greater than 127 (the maximum specifiable number of concurrent executions).
-
If you stop a J2EE application, or if the J2EE server terminates abnormally, the number of concurrent executions is handled as follows:
- Before the command is executed:
-
The number of concurrent executions for the relevant J2EE application is reduced.
- After the command is executed:
-
The number of concurrent executions set for the schedule queue is not changed.
-
To check the number of concurrent executions set by the command and whether the command is executed successfully, see the CTM log after the change. Alternatively, check the value of ParallelCount (displayed by executing the ctmlsque command).