Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 3 Preparing Lotus Notes : Configuring Agents

Configuring Agents
 
Agents are used to trigger the Publication Service and Request-Response Invocation Service.
Creating and Configuring Agents
To configure agents for the adapter services, complete the following tasks.
 
Task A Create an Agent
1.
2.
Select Design > Agent from the Create menu.
3.
In the Agent dialog, enter a name for the agent. For example, agentForReview1. Specify values according to the requirements.
Figure 6 Create an Agent
4.
Click the Security tab, set the runtime security level if necessary.
If you selected the Log to file checkbox or the Log to Database checkbox in the Setup Document of the database, you must set the runtime security level to 3. Allow restricted operations with full administration.
Figure 7 Set Runtime Security Level
Task B Import Agent Classes Files
1.
In the tab of the newly created agent, select Imported Java from the drop-down list.
2.
Click the Import Class Files button.
3.
Agent class files are maintained in the ADLN_HOME/lib/agents directory:
   ADLN_HOME/lib/agents/HTTP
   ADLN_HOME/lib/agents/POLLING
   ADLN_HOME/lib/agents/RV/RV_agents
See TIBCO ActiveMatrix Adapter Service Engine for Lotus Notes Concepts for more information about the Lotus Notes Agents class files.
4.
Click the Add/Replace File(s) button or double-click the class file to add it.
Include one class file for each agent.
Figure 8 Import Agent Class File
5.
6.
Task C Set Document Selection Condition
To improve the efficiency of agents, you can add conditions to filter the documents. This task is optional.
1.
2.
In the Add Condition dialog, select a condition from the Condition drop-down list, and then specify more detailed terms to find documents.
There are several kinds of conditions that you can select from the drop-down list, such as By author, By date, By field, By form, etc. Multiple conditions can be added for one agent.
For an HTTP agent that is created for Request-Response Invocation Service to process documents with their Status fields marked as UnProcessed, you need to add the following conditions:
field Status contains ’UnProcessed" AND uses ’Request Response Invocation Form’ form
If you want the HTTP agent to process all documents in the Request Response Invocation View regardless of their status fields, you need only to add the following condition:
uses ’Request Response Invocation Form’ form
Figure 9 Add Condition by Field
Figure 10 Add Condition by Form
Setting Up RV Agents
 
1.
Create a folder named rv_agents inside Notes_Installation_Home.
2.
Copy the SendRvMsgPub.class and SendRvMsgInitClient.class from ADLN_HOME/lib/agents/RV/rv_agents to Notes_Installation_Home/rv_agents.
3.
Copy the Windows batch files RvPub.bat and RvInitClient.bat from ADLN_HOME/lib/agents/RV/rv_batchfiles to Notes_Installation_Home.
 
The batch files and rv_agents directory can be in other locations. Ensure that the batch files are in the same folder with the rv_agents directory.
Rename the batch files only when the full path and file names are specified to for RV Batch File for Publish or RV Batch File for RPC in the Setup document. The directory name rv_agents cannot be changed.
4.
In the batch files, specify the values for NOTES_INSTALLATION_HOME, TIBCO_HOME, and for the connection parameters NOTES_JAR_LOCATION, NCSO_JAR_LOCATION, DOMINO_HOST, DB_NAME, DB_USERNAME, and DB_PASSWORD.
The arguments that are passed to the Java command in the Windows batch files are for remote connections to the Lotus Notes database. For a local connection, the -database argument is sufficient.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved