• tell amgr schedule

  Use this command to see if the agent is scheduled to run. If it doesn’t appear in the list when it should, then you know to check its schedule, to check whether or not the agent is enabled, and to check whether or not the database has background agents disabled.

  This command does not list agents that are manually run from the Actions menu or Agents list.

• tell amgr status

  Use this command to see where your agent is running (that is, in which queue) and what parameters are in effect.

• tell amgr debug

  Use this command to display and change the debugger settings. These settings apply to the Agent Manager debugger that you enable in the NOTES.INI file.

This command lists each agent that is scheduled to run on the current day. It lists only agents that run in the background. Check the list for the following information to make sure the agent is scheduled correctly.

Display	Description	What to check for
First column: E S V	The Agent Manager queue that the agent currently is in. E: Eligible to run S: Scheduled to run V: Waiting to run	If the agent is scheduled, make sure it is listed with an E or S. If it is listed, check that the correct time is listed. If the agent is not listed, check the "When should this agent run" setting. If the agent runs when new mail arrives or a document is created or updated, it should be listed with a V. If it isn’t listed, check the "When should this agent run" setting.
Second column: S M U	The event that activates the agent. S: Daily, weekly, monthly, or more than once a day schedule M: New mail has arrived U: One or more documents have been created or updated	If the agent has an incorrect event or isn’t listed when its supposed to be, it means that you selected an incorrect "When should this agent run setting."
Time of day	If the agent is scheduled to run daily, weekly, monthly or more than once a day, the time of day the agent will run is listed.	Check and make sure the agent is listed.
Today	If the agent is scheduled to run daily, weekly, monthly, or more than once a day and the time it is supposed to run hasn’t gone by, then "Today" is listed.	Check and make sure the agent is listed.
Agent Name	The agent name that is scheduled to run.
Database Name	The name of the database that the agent works in.	Make sure you're looking at the correct copy of the agent.

tell amgr status

This command lists the number of agents in queues and other run-time statistics. Even though agent names are not listed, you can check the queue information to determine if the queues are processing the number of agents you would expect. You can also check the run-time statistics to see how the Agent Manager is set up.

For example, Agent Manager status information includes:

• The number of agents in queues waiting for events, such as New Mail and Document Update.
• The number of agents in queues waiting for a scheduled time to elapse, such as the Scheduled Task queue.
• The time period, such as Daytime or Weekend.
• The maximum amount of time that a LotusScript/Java agent is allowed to run.

This command lists the Agent Manager debugger settings you specified with the Debug_AMgr statement in NOTES.INI. Use this command to make sure the debugger settings are correct and to change them using the same options that are available for the Debug_AMgr statement, except *.

For example, to add options for the Agent Manager that you have already set up to display agent debugging information (-e option):

tell amgr debug -e, -l, -m, -p

See Also

Troubleshooting agents

Glossary