Stop an agent without shutting down the Amgr task

This admin console command will shut down a scheduled agent that is locked in a loop or taking much longer than anticipated to run.

This admin console command is not documented in either the admin help or when issuing the console command "tell Amgr /?," but it is invaluable for shutting down a scheduled agent locked in a loop or taking much longer than anticipated to run.

To shut down an individual agent, from the admin console, type:

tell amgr cancel "db name" 'agent name'

Note that the database name is in double quotes and the agent name in single quotes.

Caveats: This will not stop an agent started with the "tell amgr run" command, which is a shame, nor will it stop agents initiated from a browser or third-party application. Apart from that, it's very useful.

Do you have comments on this tip? Let us know.

This tip was submitted to the tip exchange by member Tony Campbell-Cooke. Please let others know how useful it is via the rating scale below. Do you have a useful Notes/Domino tip or code to share? Submit it to our bimonthly tip contest and you could win a prize and a spot in our Hall of Fame.

Dig Deeper on Lotus Notes Domino Agents



  • iSeries tutorials's tutorials provide in-depth information on the iSeries. Our iSeries tutorials address areas you need to know about...

  • V6R1 upgrade planning checklist

    When upgrading to V6R1, make sure your software will be supported, your programs will function and the correct PTFs have been ...

  • Connecting multiple iSeries systems through DDM

    Working with databases over multiple iSeries systems can be simple when remotely connecting logical partitions with distributed ...