Adapter Connections
Lotus Notes Adapter uses an adapter connection to create a Lotus Domino session object (lotus.domino.Session). A session object is required before doing any work with a Domino Server. Lotus Notes Adapter provides one connection type, Lotus Notes Connection. A connection for Lotus Notes Adapter is a placeholder for connection information: user, password, host, and an HTTP/HTTPS option. More than one session object can be created with an adapter connection.
A connection does not automatically start or maintain connections to a Domino Server; it only creates session objects to a Domino Server. And because adapter connections do not store session objects created to a Domino Server, there is no connection pooling support.
Integration developers using Lotus Notes Adapter may need to create session objects for many users, sometimes hundreds. Creating an adapter connection for each of these users is a significant administrative effort. Developers can create session objects by configuring an adapter service to use a certain adapter connection and optionally override the user and password in the connection. That is, the credentials stored in the connection are the default values when no credentials are specified when the connection creates a session object. This enables one connection to create session objects for more than one user. For more information about creating Domino session objects, see the Lotus Domino Toolkit for Java/CORBA documentation. There is no transactional support for an adapter connection because the Lotus Domino Toolkit for Java/CORBA does not provide it.
Integration developers are responsible for recycling any Domino objects (especially session objects) they create locally to free local and remote resources. The adapter provides two utility services,
wm.ln.utils.garbage:recycle and
wm.ln.authentication:logout, for this purpose. For more information about these services, see
Freeing Resources After Processing.
You configure connections using the Integration Server Administrator. You must have Integration Server administrator privileges to access the Lotus Notes Adapter's administrative screens.
For instructions for configuring, viewing, editing, enabling, and disabling
Lotus Notes Adapter connections, see
Adapter Connections. For information about setting user privileges, see the
webMethods Integration Server Administrator’s Guide for your release.
For a list of tasks that you must do before you can create your connections, see
Before Configuring or Managing Adapter
Connections.