Maximum Number of Concurrent Agents (maxcagents)

Configuration Type
Database manager

Applies to

Parameter Type
Configurable

Default [Range]
-1 (max_coordagents) [-1; 1 - max_coordagents ]

Unit of Measure
Counter

Related Parameters

The maximum number of database manager coordinator agents that can be concurrently executing a database manager transaction. This parameter is used to control the load on the system during periods of high simultaneous application activity. For example, you may have a system requiring a large number of connections but with a limited amount of memory to serve those connections. Adjusting this parameter can be useful in such an environment, where a period of high simultaneous activity could cause excessive operating system paging.

This parameter does not limit the number of applications that can have connections to a database. It only limits the number of database manager agents that can be processed concurrently by the database manager at any one time, thereby limiting the usage of system resources during times of peak processing.

A value of -1 indicates that the limit is max_coordagents.

Recommendation: In most cases the default value for this parameter will be acceptable. In cases where the high concurrency of applications is causing problems, you can use benchmark testing to tune this parameter to optimize your performance.