Agent Manager debugging information

You can specify that the Agent Manager record debugging information in these ways:

  • Specify Debug_AMgr in NOTES.INI

    Use this statement to provide debugging information about agent loading, scheduling, and performance. When you specify Debug_AMgr, you can use the tell amgr_debug command at the Notes® console to change the settings.

    Note: If you specify that the Agent Manager display all possible debugging information, agent performance can be significantly affected.
  • Specify Log_AgentManager in NOTES.INI

    Use this statement to provide a subset of the information recorded with Debug_AMgr. Log_AgentManager does not affect agent performance as much as Debug_AMgr could.

If you specify both statements, the Debug_AMgr settings take precedence.

Debug_AMgr

To specify that the Agent Manager record debug information, edit NOTES.INI and add the following statement:

Debug_AMgr=option

where option can be one or more of the following:

  • c -- list agent control parameters
  • e -- list Agent Manager event information
  • l (lower-case letter-L) -- list agent loading information
  • m -- list agent memory warnings
  • p -- list agent performance statistics
  • r -- list agent run-time reports
  • s -- list Agent Manager scheduling information
  • v (verbose) -- list more information about agent loading, scheduling, and queues
  • * -- list all of the information for all options

After you specify Debug_AMgr in NOTES.INI and you run an agent on a server, check the Notes console and Notes Log (LOG.NSF) for the debugging information. Optionally, you can redirect the debug information to be recorded in a separate file on the server. When you redirect the debugging information to a separate file, performance can be affected. To redirect information, edit NOTES.INI and add the following statement:

DEBUG_OUTFILE=<file-name>

If you run an agent on a database stored on your local workstation, you must redirect the output because the Notes console is only on the server.

Log_AgentManager

To specify that the Agent Manager record less debugging information than with Debug_AMgr, edit NOTES.INI and add the following statement:

Log_AgentManager=option

where option can be one of the following (but not more than one):

  • 0 -- do not list debugging information
  • 1 -- list partial and complete information about successful agent runs
  • 2 -- list complete information about successful agent runs