Start/notes.ini Parameters/DominoAsynchronizeAgents

DominoAsynchronizeAgents

Parameter: DominoAsynchronizeAgents
Short description: Controls whether web agents triggered by browser clients may run simultaneously (0 = sequential, 1 = asynchronous).

Profile

Parameter
DominoAsynchronizeAgents
Category
HTTP / Web (web agents)
Available since
At least 9.0.1 (HCL documentation)
GUI equivalent
Server document → Internet Protocols → Domino Web Engine → Web Agents → Run Web agents concurrently?
Possible values
0 = sequential (default) · 1 = asynchronous / parallel
Default
0

Description

According to HCL product documentation:
This setting specifies whether Web agents triggered by browser clients can run at the same time (asynchronously). The default is zero (only one agent can run at a time). Set this to 1 to allow multiple agents to run simultaneously. This can result in faster execution of agents. However, a high number of agents executing at the same time can slow overall system performance.
With DominoAsynchronizeAgents, the Domino server controls whether web agents triggered by browser clients are executed serially or in parallel. With 1, requests that trigger a web agent are no longer serialized — this improves response times under load, but can impair overall performance with many concurrent agents.
The switch is identical to the web engine option Run Web agents concurrently? in the server document. Additionally, there is a Web agent time-out (in seconds) (default 0 = no timeout).

Example configuration

DominoAsynchronizeAgents=1

Notes & pitfalls

  • Should only be enabled if the application agents are really parallelizable (no write conflict on shared documents).
  • With the option enabled, urgently set a sensible web agent timeout to limit hanging agents.
  • With many active web users and many web agents, too high a degree of parallelism can degrade HTTP performance.

Sources (HCL Product Documentation)