7.3.10 change
This subcommand changes the value set for the number of concurrently executable threads, as specified by the arguments. A J2EE server must be specified by the -t option.
The following table lists and describes the argument that can be specified for the change subcommand.
Argument |
Explanation |
Target specification |
|
---|---|---|---|
Logical server |
Host |
||
webAppThreadCtrl webApplicationContextRoot,maxThreads,exclusiveThreads,queueSize |
Manages dynamically the number of threads that can be executed concurrently by the Web applications specified in the J2EE server specified by the -t option. This argument cannot be omitted. |
Y |
-- |
When webAppThreadCtrl is specified for the argument, the subcommand manages dynamically the number of threads that can be executed concurrently by the Web applications belonging to the J2EE server specified by the -t option.
For the argument webApplicationContextRoot, specify a Web application (J2EE application WAR) context root and the number of concurrently executable threads. You can use the get webApps subcommand to obtain the Web application context root value. If no context root has been set, specify a forward slash (/).
For the number of concurrently executing threads, specify the maximum number of threads, the number of dedicated threads, and the size of the pending queue for Web applications, in that order, delimited by a comma (,).
If any of the values for the arguments maxThreads (maximum number of threads), exclusiveThreads (number of dedicated threads), and queueSize (size of the pending queue for Web applications) is not to be changed, its specification might be omitted. However, you cannot omit all three items.
Example: To change only the number of dedicated threads: ,20,
Specify the various concurrent thread values within the ranges described below.
-
maxThreads (maximum number of threads)#:
Specify a value that is equal to or less than the number of requests processed concurrently by the Web container, in the range from 1 to 1024.
-
exclusiveThreads (number of dedicated threads)#:
Specify a value in the range 0 to 1024.
-
queueSize (size of the pending queue for Web applications):
Specify a value in the range 0 to 2147483647.
#: Maximum-number-of-threads ≥ Number-of-dedicated-threads
Note that a number of concurrently executable threads that has been set dynamically is valid only during execution of that J2EE application.