If you want an easy way to see which agents you have in your database and what each agent's status is, use the methods described in this tip to implement a simple solution. To check the database agents, you can use any one of these three solutions:
-
Agent Status Query allows you to select the agent from which to get last run date and time and the agent signer. The following screen shows the names of the agents in the database when you click the Agent Status Query button.
Figure 1. Database agents dialog box
When you select an agent in the previous screen and click OK, agent status is shown as follows:
Figure 2. Agent status dialog box
-
All Agent Status Report shows a report that lists all agents in the database, their last run date and time, and the name of the agent signer. The following screen shows the result of clicking the All Agent Status Report button. The results display the agent name, last date and time the agent ran, and the agent signer.
Figure 3. Database agents dialog box
-
Specified Agent shows where the agent name is coded. The following screen shows the resulting message prompt when you click the Specified Agent button.
Figure 4. Database agent dialog box
You can implement these solutions as LotusScript buttons. They require a minimum of Reader access in the database ACL. The LotusScript code for each button can be added to action bar buttons in a form or view or to an RTF field on a Notes form. You can even place the LotusScript buttons in the RTF body field of a mail memo or any document in a Notes database!
You do not need Designer or Manager access to the database to implement this code. You don't even need Domino Designer to see the results! Download a sample application containing the buttons from the Sandbox.
To view the LotusScript code for each button, click the following links:
- See the code examples for this tip:
- Download the sample application for this tip.
- Download a trial version of Lotus Notes/Domino from the developerWorks: Lotus Downloads page.
- Find more resources for Notes application developers on the Notes and Domino product page.
- Get involved in the developerWorks community by participating in
developerWorks blogs.
- Browse for books on these and other technical topics.
Donald Russell is an Advisory QA Engineer for Lotus Education and has been working in IBM's Lotus Software division since 1996. Prior to his current position, Donald was an advisory IS application developer and a senior Premium Notes Support Analyst. He holds a Bachelor of Science in Electrical Engineering and is a Certified Novell Administrator. Donald has written over 500 technical documents and white papers for the IBM DCF and Lotus Knowledge Base and has published technical articles for The View magazine. Outside of work, Donald was a Cub Scout Den leader and now an Assistant ScoutMaster for the Boy Scouts .




