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 SearchDomino.com 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

SearchWindowsServer

Search400

  • iSeries tutorials

    Search400.com'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 ...

SearchDataCenter

SearchContentManagement

Close