Monday, May 30, 2011

Agent Manager in Lotus Domino

Agents can be categorized into two primary categories : foreground and background
Foreground Agent: when a user starts it from the Action menu or selects it from the Agents list. Domino does not check security restrictions. Personal and shared agents are examples of foreground agents.
Background Agent: When agent is scheduled or it is triggered by an event

Agent manager has three different queues , event-triggered agents that are waiting for their event to occur (V), another queue for agents that are scheduled to run (S), and a third (final queue) for agents that are eligible to run (E).
Users with at least Reader access to a database can run agents, but the agents they run or create can only update documents to which they have at least Editor access. The rights of the creator of the agent are used to determine what the agent can do.
Simple agents and formula agents have no restrictions on who can run them.

Personal, or private, agents can be seen and run only by the agent creator. If users have Designer or higher to a DB, they can create shared agents; otherwise they can create only personal agents.
Personal agents cannot be accessed through the Web client.
The user or server who last saved the agent is called the signer


Parameters related to queuing of agents & Execution of agents
AMgr_SchedulingInterval =value           
Amgr_UntriggeredMailInterval = value       
AMgr_DocUpdateAgentMinInterval = value
AMgr_NewMailAgentMinInterval=value

Amgr_DocUpdateEventDelay = value
AMgr_NewMailEventDelay =value 

Debugging Parameters

Debug_AMgr = flag
Log_AgentManager=value

What is the purpose of the TELL AMGR SCHED Server Console command?
http://www-1.ibm.com/support/docview.wss?rs=899&uid=swg21097473

Note that the agents take about a minute or so to appear in queues, or to move from one queue to another.

Agent console commands
tell amgr status   --> shows a snapshot of the Agent Manager status
Tell amgr debug     --> to either display the current debug settings for the Agent manager or to set new ones.
Show statistics agent.* --> to see all statistical information related to agents.