1. Configuration Reference for Oracle Essbase
  2. Essbase Configuration Settings
  3. Config Settings List
  4. AGENTTHREADS

AGENTTHREADS

The AGENTTHREADS 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

where n specifies the number of threads that Essbase can spawn. The value of n can be a number from 5 to 500, inclusive.

The default value is 50 threads.

Notes

  • Although the maximum AGENTTHREADS 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 an AGENTTHREADS value 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 Agent thread is required for each initial connection to an Essbase 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. The WebLogic Server total thread count 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.