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.