AGENTTHREADS

This configuration setting specifies the maximum number of threads that Essbase can spawn for operations such as logging in and out of Essbase Server and starting and stopping an application.

Syntax

AGENTTHREADS n

n—Specifies the number of threads that Essbase can spawn, where n can be 5 to 500, inclusive.

The default value is 50.

Notes

  • While the actual maximum value you can set is 500, the maximum number of threads an operating system can handle might be much lower. Before specifying a value greater than the default value, check with your system administrator, as higher values can significantly consume system resources.

  • If you specify a number that is less than 5, over the maximum, or a decimal value, Essbase overrides the value with a closely approximate value of its own.

  • One thread is required for each initial connection to an application and database.

  • The AGENTTHREADS configuration setting does not apply to Essbase Java Agent, which uses the WebLogic Server thread pool configuration for the total number of threads that can be spawned at the server and domain levels. This total thread count is limited to 500 and is specified in the config.xml file. If the value of AGENTTHREADS is less than the value of the WebLogic Server total thread count, Essbase uses the value specified in AGENTTHREADS; if the value of AGENTTHREADS is more than the WebLogic Server total thread count, Essbase uses the value specified in the config.xml file.

Example

AGENTTHREADS 100

Sets the maximum number of threads that Essbase can spawn to 100, assuming that the total thread count specified in the config.xml file is 100 or more.