Notes server console commands: tell amgr
Tell Amgr Cancel
Cancels the scheduled agent that is currently running.
Note Tell Amgr Cancel does not cancel agents executed by other processes, such as HTTP or router; however, you can use the remote debugger to cancel agents executed by any process. If a third-party application hangs and does not return control back to IBM® Lotus® Notes®, the agent cannot be canceled.
Specify the agent to be canceled by entering these arguments:
“db name” ‘agent name’
Example: Tell Amgr Cancel “DatabaseName.nsf” ‘AgentName’
Note You can use the Tell Amgr Schedule command to determine which agents can be canceled.
Tell Amgr Debug
Displays either the current debug settings for the Agent Manager or lets you set new ones. When using this command to set debug values, you can use the same flags used by the Debug_AMgr command in the NOTES.INI file. These settings take effect immediately; you do not need to restart the Agent Manager or the server.
The following are Tell Amgr Debug parameters:
c — To output agent control parameters
e — To output information about Agent Manager events
l — To output loading reports
m — To output agent memory warnings
p — To output agent performance statistics
r — To output agent execution reports
s — To output information bout AMGR scheduling
v — Verbose mode, outputs more messages regarding agent loading, scheduling and queues
* — To output all of the above information
Tell Amgr Run
Runs the agents that you designate with these arguments:
“db name” ‘agent name’
Example: Tell Amgr Run “DatabaseName.nsf” ‘AgentName’
Tell Amgr Pause
Pauses scheduling of agents
Tell Amgr Quit
Stops the Agent Manager on a server.
Tell Amgr Resume
Resumes scheduling of agents.
Tell Amgr Schedule
Shows the schedule for all agents scheduled to run for the current day. In addition, the command shows the agent trigger type, the time the agent is scheduled to run, the name of the agent, and the name of the database on which the database runs. Checking the Agent Manager schedule lets you see if an agent is waiting in one of the Agent Manager queues.
Agent Manager queues:
E – Agents eligible to run
S – Agents scheduled to run
V – Event-triggered agents waiting for their events to occur
S – Agent is scheduled to run
M – Agent is a new mail-triggered agent
U – Agent is a new/updated document-triggered agent
Tell Amgr Status
This command shows a snapshot of the Agent Manager queues and displays the Agent Manager settings in the Server document.
Leave a Reply