set-thread-pool-prop

Syntax

tadm set-thread-pool-prop common_options --config=config_name (property_name=property_value)+

Description

Use this command to set the thread-pool properties for a configuration. The thread-pool element configures the threads used to process HTTP requests. You can use thread pools to allocate a certain number of threads to a specific service. By defining a pool with the maximum number of threads as 1, only one request is allowed to the specified service function.

Options

For information about common_options, run the help command.

--config|-c: Specify the name of the configuration for which you want to set thread-pool properties.

Operands

property-name=property-value

Specify name=value pairs for one or more properties that you want to define. The name=value pairs should be separated by spaces.

You can set the following thread-pool properties:

queue-size: Specifies the maximum number of concurrent HTTP connections that can be queued for processing.
Values: 1 to 1048576.

Note:

The property queue-size can accept auto-tuned as a value. Auto-tuned implies that the server will compute the value of this property at runtime.

min-threads: Specifies the minimum number of HTTP request processing threads.
Values: 1 to 4096.

Note:

The property min-threads can accept auto-tuned as a value. Auto-tuned implies that the server will compute the value of this property at runtime.

max-threads: Specifies the maximum number of HTTP request processing threads.
Values: 1 to 4096.

Note:

The property max-threads can accept auto-tuned as a value. Auto-tuned implies that the server will compute the value of this property at runtime.

stack-size: Specifies the stack size (in bytes) for HTTP request processing threads.
Values: 8192 to 67108864.

To reset a property to its default value, do not provide a property value.
For example, property-name=<empty_string>

Example

tadm set-thread-pool-prop --user=admin --host=admin.example.com 
--password-file=./admin.passwd --port=8989 
--no-prompt --config=www.example.org queue-size=238 max-threads=789

Exit Codes

The following exit values are returned:

0: command executed successfully

>0: error in executing the command

For more information about exit codes and syntax notations, run the help command.