03/17/98 03:46:22 PM Robert Perron/CAM/Lotus deleted Richard Adams/CAM/Lotus
01/06/98 07:45:24 AM Richard Adams/CAM/Lotus added OtherDomainServers
01/06/98 07:45:24 AM Richard Adams/CAM/Lotus added LocalDomainServers
01/06/98 07:45:24 AM Richard Adams/CAM/Lotus updated Richard Adams/CAM/Lotus
01/06/98 07:45:24 AM Richard Adams/CAM/Lotus added Richard Adams/CAM/Lotus
-Default-
LocalDomainServers
OtherDomainServers
Local!!c:\lotus\notes\data\doc\javapg.nsf
g.nsf
Local!!c:\lotus\notes\data\doc\javapg.nsf
g.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
s\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
Local!!c:\lotus\notes\data\javates
Local!!c:\lotus\notes\data\javatest.nsf
Local!!c
Local!!c:\lotus\notes\data\javatest.nsf
e%ras/CAM/No
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=
Local!!c
Local!!c:\lotus\notes\data\javatest.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
Local!!c:\lotus\notes\data\javates
Local!!c:\lotus\notes\data\javatest.nsf
Local!!c
Local!!c:\lotus\notes\data\javatest.nsf
e%ras/CAM/No
Local!!c:\lotus\notes\data\doc\javapg.nsf
g.nsf
Local!!c:\lotus\notes\data\doc\javapg.nsf
g.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
s\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
Local!!c:\lotus\notes\data\javates
Local!!c:\lotus\notes\data\javatest.nsf
Local!!c
Local!!c:\lotus\notes\data\javatest.nsf
e%ras/CAM/No
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=
Local!!c
Local!!c:\lotus\notes\data\javatest.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/
zathras/CAM/Notes!!api\api461.nsf
zathras/CAM/Notes!!api\api461.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
Local!!c:\lotus\notes\data\javates
Local!!c:\lotus\notes\data\javatest.nsf
Local!!c
Local!!c:\lotus\notes\data\javatest.nsf
e%ras/CAM/No
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=
Local!!c
Local!!c:\lotus\notes\data\javatest.nsf
Local!!c:\notes\data\problems.nsf
Local!!c:\lotus\notes\data\intro.nsf
Local!!c:\lotus\notes\data\intro.nsf
Local!!c:\lotus\notes\data\javatest.nsf
Local!!c:\lotus\notes\data\javatest.nsf
Local!!c:\lotus\notes\data\javatest.nsf
Local!!c:\lotus\notes\data\javatest.nsf
Local!!c:\lotus\notes\data\javatest.nsf
Local!!c:\lotus\notes\data\javatest.nsf
Local!!c:\lotus\notes\data\javatest.nsf
Local!!c:\lotus\notes\data\javatest.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
Local!!c:\lotus\notes\data\javates
Local!!c:\lotus\notes\data\javatest.nsf
Local!!c
Local!!c:\lotus\notes\data\javatest.nsf
zathras/CAM/No
Local!!c:\lotus\notes\data\javatest.nsf
zathras/CAM/No
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=
Local!!c
Local!!c:\lotus\notes\data\javatest.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
Local!!c:\notes\data\problems.nsf
\intro.nsf
ro.nsf
Local!!c:\lotus\notes\data\intro.nsf
ro.nsf
Local!!c:\lotus\notes\data\intro.nsf
ro.nsf
t.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
Local!!c:\lotus\notes\data\javatest.nsf
t.nsf
\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
Local!!c:\lotus\notes\data\javates
Local!!c:\lotus\notes\data\javatest.nsf
Local!!c
Local!!c:\lotus\notes\data\javatest.nsf
e%ras/CAM/No
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=
Local!!c
Local!!c:\lotus\notes\data\javatest.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/O=Notes!!api\api461.nsf
CN=zathras/OU=CAM/
CurrentAgent
(Debug AgentContext Data)"
4S6S8S9S
AgentContext'++LotusScript Development Environment:2:5:(Options):0:66
'++LotusScript Development Environment:2:5:(Forward):0:1
Declare Sub Exiting(Source As Field)
'++LotusScript Development Environment:2:5:(Declarations):0:2
'++LotusScript Development Environment:2:2:BindEvents:1:129
Private Sub BindEvents(Byval Objectname_ As String)
Static Source As FIELD
Set Source = Bind(Objectname_)
On Event Exiting From Source Call Exiting
End Sub
'++LotusScript Development Environment:2:2:Exiting:1:12
Sub Exiting(Source As Field)
End Sub
Java AgentRunner - AgentContext Data
Last Modified
Modified
Description
Description
Agent Runs On:
AgentRunsOnChange this to match generating agent
All documents in database | 0All new and modified documents since last run | 1All unread documents in view | 2All documents in view | 3Selected documents | 4Run once | 5
AgentRunsOn
AgentRunsOn
1S2S3S4R5S6S
AgentRunsOn
AgentRunsOn
AgentRunsOnView
You must supply a view name.{
4S5S6S7S8S9S11S12S13S14S16RS2E21RS2E
AgentRunsOnViewChange this to match generating agent
Search Criteria:
AgentSearchCriteriaChange this to match generating agent
Agent
CurrentAgent
CurrentAgent
You must enter a value for CurrentAgent
3S4S5S6S8S13SCurrentAgent
Database
CurrentDatabase
String
FilePath
CurrentDatabase_FilePath
You must enter a value for CurrentDatabase - FilePath
3S4S5S6S8S13SCurrentDatabase_FilePath
String
Server
CurrentDatabase_Server
CurrentDatabase_Server
3S4S9S11S15S
CurrentDatabase_Server
Document
DocumentContext
DocumentContext
DocumentContext
3S4S9S11SDocumentContext
String
EffectiveUserName
EffectiveUserName
EffectiveUserName
LastExitStatus
LastExitStatus
LastExitStatus
3S4S5S6S8S10SLastExitStatus
DateTime
LastRun
LastRun
Document
SavedData
SavedData
SavedData
3S4S9S11SSavedData
DocumentCollection
UnprocessedDocuments
AgentRunsOn
All documents in CurrentDatabase that meet Search Criteria
AgentRunsOn
All documents in CurrentDatabase minus "Processed" documents unmodified since "Processed On" that meet Search Criteria
AgentRunsOn
The intersection of all documents in View and "Selected" documents that meet Search Criteria
AgentRunsOn
All documents in View that meet Search Criteria
AgentRunsOn
All "Selected" documents that meet Search Criteria
agent context to a Java IDE. Once the context is set up, you can build, run, and debug without leaving the IDE. The code executes as it would in the Notes agent. See the Using document
Java AgentRunner
and the VisualAge for Java online help or
Getting Started
for more information.
Copyright
Under the copyright laws, neither the documentation nor the software may be copied, photocopied, reproduced, translated, or reduced to any electronic medium or machine-readable form, in whole or in part, without the prior written consent of Lotus Development Corporation, except in the manner described in the software agreement.
Copyright 1998
Lotus Development Corporation
55 Cambridge Parkway
Cambridge, MA 02142
All rights reserved. Published in the United States.
Domino, InterNotes, Notes, and Lotus Domino Toolkit for Java are trademarks and Lotus, Lotus Notes, and SmartIcons are registered trademarks of Lotus Development Corporation. cc:Mail is a trademark of cc:Mail, a wholly-owned subsidiary of Lotus Development Corporation. IBM, OS/2, and VisualAge are registered trademarks of International Business Machines Corporation.
Other product and company names mentioned herein may be the trademarks or registered trademarks of their respective owners.
International Correctspell. English licensed from Houghton Mifflin Company. Copyright
1991 by Houghton Mifflin Company. All rights reserved. Reproduction or disassembly of embodied algorithms or database prohibited. Based upon The American Heritage Dictionary.
LOTUS DEVELOPMENT CORPORATION LICENSOR(S) MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, REGARDING THE SOFTWARE. LOTUS DEVELOPMENT CORPORATION'S LICENSOR(S) DOES NOT WARRANT, GUARANTEE OR MAKE ANY REPRESENTATIONS REGARDING THE USE OR THE RESULTS OF THE USE OF THE SOFTWARE IN TERMS OF ITS CORRECTNESS, ACCURACY, RELIABILITY, CURRENTNESS OR OTHERWISE. THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THE SOFTWARE IS ASSUMED BY YOU. THE EXCLUSION OF IMPLIED WARRANTIES IS NOT PERMITTED BY SOME JURISDICTIONS. THE ABOVE EXCLUSION MAY NOT APPLY TO YOU.
IN NO EVENT WILL LOTUS DEVELOPMENT CORPORATION'S LICENSOR(S), AND THEIR DIRECTORS, OFFICERS, EMPLOYEES OR AGENTS (COLLECTIVELY LOTUS DEVELOPMENT CORPORATION'S LICENSOR(S)) BE LIABLE TO YOU FOR ANY CONSEQUENTIAL, INCIDENTAL OR INDIRECT DAMAGES (INCLUDING DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, AND THE LIKE) ARISING OUT OF THE USE OF OR INABILITY TO USE THE SOFTWARE EVEN IF LOTUS DEVELOPMENT CORPORATION'S LICENSOR(S) HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. BECAUSE SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES, THE ABOVE LIMITATIONS MAY NOT APPLY TO YOU.
v5}mH
zLZ;-
PURSAF
O=IBM
O=IBM
PURSAFO
\,9Ga_
O=IBM
OU=Toronto/O=IBM
PURSAFO
OU=Toronto/O=IBM
CN=Isai Scheinberg/OU=Toronto/O=IBM
PURSAFO
8]?ud
f@-LN
*g"]~
$Info
$Body
5Courier New
Using - AgentRunner
The Domino AgentRunner consists of the AgentRunner tool, the Domino Java class library and a set of debug classes that access Notes context information while running in the VisualAge for Java IDE, and some sample agents. To use the AgentRunner, you create an agent that extends DebugAgentBase, then initially run the program as an agent inside Notes to generate an AgentContext document in the AgentRunner.nsf. Subsequently you run the AgentRunner tool which, in turn, runs your agent code outside Notes. The AgentRunner code accesses the AgentContext document to make the program behave as though it were running as an agent. This allows you to build and run without having to switch between the IDE and Notes, and to use VisualAge for Java IDE run-time tools such as the debugger.
Create your agent
In the VisualAge for Java IDE:
Add the
Domino Java class library
from the repository to the Workbench using Quick Start.
Create an agent (see Java Programmer's Guide for instructions) that extends DebugAgentBase (instead of AgentBase).
Export the .class file to the file system.
Generate an AgentContext document
In Notes:
Add a JavaUserClasses pointer to the IVJAgentRunner.jar file in your notes.ini file. For example:
JavaUserClasses=X:\VAJava\ide\runtime\IVJAgentRunner.jar. Shut down and restart Notes so this pointer will take effect.
Set your PATH to point to Notes in your computer's systems settings.
Copy the AgentRunner.nsf file from X:\VAJava\ide\runtime to your notes\data directory.
Create a Java agent in a Notes database and import the .class file that you created in the IDE from the file system.
Run the agent. This generates an AgentContext document in AgentRunner.nsf. Note that, when run in Notes, from an agent class that extends DebugAgentBase, a call to getSession() will, after generating an AgentContext document, return null. So any use of the returned session will result in a thrown exception. But, since the purpose of running the agent is only to generate the context document (and not to run any of the agent code), you can ignore the exception.
In edit mode, change the "Agent Runs On" and "Search Criteria" fields to generate the UnprocessedDocuments collection that you would like to use for debugging purposes. You must supply this information because it cannot be determined from running the agent (Note: the "Agent Runs On" and "Search Criteria" that you specified in the agent that you ran to generate this document will produce the "Selected" document list). Save and close the document. Alternatively, you can change the "Agent Runs On" and "Search Criteria" fields in the VisualAge for Java IDE by selecting
Tools - Domino AgentRunner - Properties.
Debug your agent
In the VisualAge for Java IDE:
Set one or more breakpoints in your code in the NotesMain() method of your agent.
Save your agent
Run the agent from the
Selected
menu by highlighting your class file and selecting
Tools - Domino AgentRunner - Run.
The debugger will open.
Or, you can select a previously saved context for your agent by selecting
Tools - Domino AgentRunner - Properties
Create the production agent
In the VisualAge for Java IDE:
Change the Base class for your agent to extend AgentBase (instead of DebugAgentBase). This permits the agent to run normally rather than generate an AgentContext document.
Save your agent.
Export the .class file to the file system.
In Notes:
Open the agent and reimport the .class files from file system.