Server Tasks - Agent Manager tab

The Agent Manager controls when agents run on a server. Every time an agent runs, it uses server resources. To control when scheduled and event-triggered agents run, you specify settings in the Server document and in the NOTES.INI file. Customizing when agents run may conserve server resources, but it may also delay when agents run. If you allocate more resources to the Agent Manager, fewer will be available to run other server tasks.

Table 1. Basics and Daytime Parameters
Field	Description
Refresh agent cache	Specifies when Domino® performs the daily rebuild of the Agent manager's agent cache. The default time is 12:00 a.m. The agent cache provides the Agent Manager with quick access to the agents that can run during the next 24-hour period. Because the refresh operation is very time consuming, schedule it for times when the server is less busy.
Daytime/Nightime Parameters	These fields define how agents run during daytime and nighttime hours. Agents run during each period are subject to the settings in the parameter fields for that period. Use the nighttime settings to enable agents greater freedom to run during off-peak hours when system demand is usually low.
Start time	Specifies when the daytime or nighttime schedules begin. Default start times are 8:00 AM for daytime and 8:00 PM for nighttime. To ensure that agents can run throughout the day, the start times for each portion of the day should coincide with the end time of the other portion. If there is a gap between the end of one portion of the day and the start of the other, the Agent Manager will not run during that period. For example, if the daytime parameters specify a start time of 8:00 AM and the nighttime parameters specify an end time of 5:00 AM, Agent Manager will not run any agents between 5:00 AM and 8:00 AM.
End time	Specifies when the daytime or nighttime agent schedules are over. Default end times are 8:00 PM for daytime and 8:00 AM for nighttime. To ensure that agents can run throughout the day, the end times for each portion of the day should coincide with the start time of the other portion. If there is a gap between the end of one portion of the day and the start of the other, the Agent Manager will not run during that period. For example, if the daytime parameters specify an end time of 5 PM and the nighttime parameters specify a start time of 8 PM, Agent Manager will not run any agents between 5 PM and 8 PM.
Max concurrent agents	Specifies the number of agents allowed to run concurrently. Valid values are 1 through 10. Default values are 1 for daytime and 2 for nighttime. Enabling a higher number of concurrent agents can relieve a heavily loaded Agent Manager, but also reduces the resources available to run other server tasks.
Max LotusScript/Java execution time	Specifies how the maximum number of minutes a LotusScript® or Java™ agent has to complete execution during this portion of the day. If the agent exceeds this maximum, the agent doesn't finish, and the Agent Log records the termination. Defaults are 10 minutes for daytime and 15 minutes for nighttime. Increase the execution time limits to enable complex agents sufficient time to complete. Setting the value of this field excessively high may impact system performance, because the Agent Manager runs for a longer time to accommodate this agent. Note: An agent that requires an unusually long execution time may include an infinite loop. Before increasing the execution time, review the agent code to make sure it functions correctly.
Max % busy before delay	This field applies to servers running Domino® Release 4.6 and earlier only. Specifies the maximum percentage of time the Agent Manager can spend to run agents. When this limit is exceeded, the Agent Manager delays agent execution of the next agent. Default values are 50% for daytime and 70% for nighttime.