APPLICATION DESIGN

Useful agent procedures
To view a list of agents

1. In the Applications Navigator, double-click Agents under Code.

2. 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:


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. In the Applications Navigator, double-click Agents under Code.

2. Select the agent.

3. Choose Edit - Copy.

To delete an agent

1. In the Applications Navigator, double-click Agents under Code.

2. Select the agent.

3. Choose Edit - Cut.

To select multiple agents

1. In the Applications Navigator, double-click Agents under Code.

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

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. In the Applications Navigator, double-click Agents under Code.

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


To disable all agents in a database

1. In the Applications Navigator, double-click Application Properties.

2. On the 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. In the Applications Navigator, double-click Agents under Code.

2. Select the disabled agent.

3. Click Enable.


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. In the Applications Navigator, double-click Agents under Code.

2. Click Sign.

See Also