Notes® server console commands

These server console commands support agent debugging:

  • 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.

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.

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.

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