APPLICATION DESIGN


Notes server console commands
These server console commands support agent debugging:
Tell amgr schedule

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.

DisplayDescriptionWhat 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 UThe 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 dayIf 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.
TodayIf 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 NameThe agent name that is scheduled to run.
Database NameThe 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:


tell amgr debug

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