Start/notes.ini Parameters/AMgr_DocUpdateAgentMinInterval

AMgr_DocUpdateAgentMinInterval

🛠️
Parameter: AMgr_DocUpdateAgentMinInterval
Short description: Minimum time interval (minutes) between two executions of an "On document update" agent by the Agent Manager.

Profile

Parameter
AMgr_DocUpdateAgentMinInterval
Category
Performance / Memory
Component
Server
Available since
R4.6
Supported versions
9.0.1, 10.0, 11.0, 12.0, 14.0, 14.5
GUI equivalent
Server document (Server Tasks → Agent Manager)
Possible values
Integer in minutes, default 30

Description

Analogous to AMgr_NewMailAgentMinInterval, this parameter controls how often an "On document update" agent may at most be executed. The Agent Manager collects all document updates within the interval and then invokes the agent exactly once with the accumulated set of updates.
This prevents, for example, a workflow application from overloading the server with constant agent calls under heavy write loads.

Example configuration

AMgr_DocUpdateAgentMinInterval=10

Notes & pitfalls

  • The default of 30 is fairly conservative – applications with real-time requirements must lower the value.
  • 0 is possible, but can lead to "runaway" agents.
  • Effective per agent, not per database.
  • Can be configured analogously in the Configuration and Server document.
  • Works together with quotas (AMgr_DocUpdateEventDelay, Time Limits).
  • The change takes effect only after a restart of the Agent Manager.