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



  • Favorite iSeries cheat sheets

    Here you'll find a collection of valuable cheat sheets gathered from across the iSeries/ community. These cheat ...

  • HTML cheat sheet

    This is a really cool cheat sheet if you're looking to learn more about HTML. You'll find just about everything you every wanted ...

  • Carol Woodbury: Security

    Carol Woodbury