About Agent support

AppDev Pack vesion 1.0.4 adds the ability for Proton to execute agents, on demand, by applications using the domino-db client library. A domino-db based application can send a request to Proton to execute an agent in a database. The application must have access to the database and the agent.

When invoked, the agent executes with the rights of the agent signer, or the "run on behalf of" user named in the Agent configuration properties. The option to "Run as web user" is not yet supported.

Proton does not support running agents configured to run on schedule or on specific events (e.g. mail arrives, server startup, etc). Proton supports running manually trigered agents.

An agent may optionally be passes a set of documents as the target of the run. Proton does not support these targets:

• all unread documents in a view
• all documents in a view

Proton does support the following targets:

• all selected documents
• all documents in a database
• all new and modified documents
• none

Proton pre-loads the JVM and the global LotusScript instance at startup to avoid the startup cost on the first agent invocation. You can disable this pre-loading and the ability for domino-db applications to run agents by disabling the Allow agents to execute setting.