Start/notes.ini Parameters/AMgr_NewMailAgentMinInterval

AMgr_NewMailAgentMinInterval

🛠️
Parameter: AMgr_NewMailAgentMinInterval
Short description: Minimum time interval (minutes) between two executions of an "On new mail" agent.

Profile

Parameter
AMgr_NewMailAgentMinInterval
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 0 (= every mail triggers immediately)

Description

AMgr_NewMailAgentMinInterval defines a throttle for mail trigger agents: at least this amount of time must elapse between two executions of any single agent. If additional mails arrive during this window, the Agent Manager collects the triggers and runs the agent exactly once when the interval elapses.
The default value 0 means every single inbox arrival triggers its own execution – ideal for reactive agents (e.g. escalations), problematic for "heavy" agents or bulk mailings.

Example configuration

AMgr_NewMailAgentMinInterval=2

Notes & pitfalls

  • Value in minutes – not seconds.
  • Effective per agent, not per mailfile.
  • Helps against "runaway" mail agents that bring servers to their knees during mail bursts.
  • Users may perceive it as delayed processing – don't set it too high if response time is important.
  • Works together with AMgr_UntriggeredMailInterval and the quotas in the Server document.
  • The change takes effect only after a restart of the Agent Manager.