Setting up for the AgentRunner

Follow these steps to set up your Notes 4.6 environment to support the AgentRunner:

1. Add the IVJAgentRunner.jar file to the JavaUserClasses statement in your notes.ini file.  If you do not have a JavaUserClasses statement in your notes.ini file already, you can cut and paste the following statement to the end of your notes.ini file:

JavaUserClasses=X:\VAJava\ide\runtime\IVJAgentRunner.jar

where X is the drive on which you installed VisualAge for Java.

Because you have edited the notes.ini file you must shut down and restart Notes so that your changes take effect.

2. Set your PATH to point to your Notes directory by entering

set path=%path%X:/path/Notes

on a command line.  X is the drive on which Notes is installed. path is the path to your Notes directory.  Your Notes directory will be temporarily added to your path.  When you close your command window, this setting will be erased.  Do not close the command window on which you set your path until you have finished using the AgentRunner.

If you want to permanently add this pointer, set the path to Notes in your computer's systems settings.

3. Copy the AgentRunner.nsf file from X:\VAJava\ide\runtime (where X is the drive on which you installed VisualAge for Java) to your notes\data directory.

Your Notes environment is now set to support the AgentRunner.  Next, you have to set up your VisualAge for Java Environment.

Add the Domino Java Classes to the Workbench

To set up your VisualAge for Java IDE to use the AgentRunner you have to add the Domino Java class library to the Workspace.

  1. From the Workbench, select the File menu, then Quick Start.
  2. Select Features from the list of categories on the left side of the window.
  3. Select Add Feature from the list of tasks on the right side of the window.
  4. Click OK.
  5. In the Selection Required window, select Domino Java class library.
  6. Click OK.

A new project will appear on the All Projects view of the Workbench called Domino Java class library.  This project contains a lotus.notes package with all the Java Classes for Notes Objet Interface/Domino 4.6 and additional Debug classes that support the AgentRunner tool.  You can now use these classes when running or debugging an agent in the IDE.

Now you are ready to write or import an agent.

ngrelc.gif (533 bytes)
The Domino AgentRunner

ngrelt.gif (466 bytes)
Write or Import an Agent
Generating an AgentContext Document
Running and Debugging your Agent
Creating the Production Agent