Lotus Domino Designer 8 Help - Useful agent procedures

APPLICATION DESIGN

Useful agent procedures
To view a list of agents

1. Open a database in IBM® Lotus® Domino(TM) Designer.

2. Click Shared Code - Agents in the Design pane. A list of agents appears in the Work pane.

When you view a list of agents in the Work pane, an icon may appear next to the name of a scheduled agent. The icons are:

Check mark with a 6 next to it - the scheduled agent is enabled and runs only on IBM® Lotus® Domino(TM) 6 or later (or on Lotus Notes/Domino R5.08 or later).
Check mark with a 5 next to it - the scheduled agent is disabled for Lotus Domino release 5.08 or later, but will be considered enabled on Lotus Notes Domino R5.07 or earlier which does not recognize this functionality.
Check mark - the scheduled agent is enabled and runs on any version of IBM® Lotus® Notes®.
A yellow X - the scheduled agent is disabled.

The list of agents also gives you important information about each agent. You can easily view such information as the agent name, its alias, trigger, modification date, the person who modified it last, and whether the agent works in Notes and on the Web.

To copy an agent

1. Open a database in Designer.

2. Click Shared Code - Agents in the Design pane. A list of agents appears in the Work pane.

3. Select the agent.

4. Choose Edit - Copy.

To delete an agent

1. Click Shared Code - Agents in the Design pane. A list of agents appears in the Work pane.

2. Select the agent.

3. Choose Edit - Cut.

To select multiple agents

1. Click Shared Code - Agents in the Design pane. A list of agents appears in the Work pane.

2. Click the first agent and do one of the following:

Press CTRL and hold while you click the next agent.
If selecting more than two agents, press CTRL while you click the next agent.
To select a range of consecutive agents, press SHIFT while you select the first and last agent in the range.

If you have Designer access or above, you can disable shared scheduled agents to prevent servers from running them. This is useful for debugging a problem with an agent. Designers can still run disabled agents by choosing View - Agents, selecting an agent, and choosing Actions - Run. After you re-enable them, scheduled agents resume their schedule.

To disable individual agents

1. Click Shared Code - Agents in the Design pane. A list of agents appears in the Work pane.

2. Select the agent and click the Disable button. Note that the agent is re-signed.

The check mark icon next to the agent name disappears and an X icon appears in its place.

To disable all agents in a database

1. Choose File - Database - Properties.

2. On the Database Basics tab, check "Disable background agents for this database."

Note If you disable agents through the Database Properties box, the agents are not re-signed and the Enable/Disable state of each agent is not changed. Unchecking this box does not necessarily enable all agents. It only allows those already enabled to run.

To enable a disabled agent

1. Click Shared Code - Agents in the Design pane. A list of agents appears in the Work pane.

2. Select the disabled agent. (It should have a yellow X icon next to the agent name.)

3. Click Enable.

The X icon disappears and a check mark icon appears next to the name of the agent. Note that the agent is re-signed.

By default, Web agents run under the identity of the agent author (the person who saved the agent). To run agents under the identity of the Web user, double click the name of the agent in the Work pane. On the Security tab of the Agent Properties box, check "Run as Web user."

To sign an agent

1. Select the agent.

2. Click Sign.

See Also

Creating an agent

Security for agents on servers and the Web

Glossary

Feedback on Help or Product Usability?

Help on Help

All Help Contents

Glossary