Configuring the Adapter for Lotus Notes

How to:

Reference:

x

Configuring the adapter consists of specifying connection and authentication information for each of the connections you want to establish.

In order to connect to Lotus Notes, the adapter requires connection information. You supply this information using the SET CONNECTION_ATTRIBUTES command. You can:

Procedure: How to Configure an Adapter

  1. From the Web Console sidebar, click Connect to Data.

    or

    From the Data Management Console, expand the Adapters folder.

    In the DMC, the Adapters folder opens. In the Web Console, the Adapters page opens showing your configured adapters.

  2. In the Web Console, click the New Datasource button on the menu bar and find the adapter on the drop-down list or, in the DMC, expand the Available folder if it is not already expanded.
    On the Web Console, you can select a category of adapter from the drop-down list or use the search option (magnifying glass) to search for specific characters.
  3. In the DMC, expand the appropriate group folder and the specific adapter folder. The group folder is described in the connection attributes reference.
  4. Right-click the adapter name and/or version and select Configure.

    The Add Adapter to Configuration pane opens.

  5. Enter values for the parameters required by the adapter, as described in the chapter for the specific adapter you want to configure.
  6. Click Configure. The configured adapter is added to the Adapters list in the DMC resources tree or the Configured list in the Web Console.
    In the Web Console, the adapter remains on the Available Adapters list with a check mark to indicate that at least one connection has been configured. You can configure additional connections from either the Configured or Available list by right-clicking the adapter and clicking Add Connection.

Reference: Connection Attributes for Lotus Notes

The Lotus Notes adapter is under the DBMS group folder.

The following list describes the connection attributes for which you can supply values. To complete the attribute declaration, click the Configure button.

Connection name

Logical name used to identify this particular set of connection attributes. The default is CON01.

Note: For a local database connection, this is the only required entry.

Domino Server host

The remote server name.

Port

Domino Server port for remote (IIOP) calls.

Security

There are two methods by which a user can be authenticated when connecting to a database server:

  • Explicit. The user ID and password are explicitly specified for each connection and passed to the database, at connection time, for authentication.
  • Password Passthru. The user ID and password received from the client application are passed to the database, at connection time, for authentication.
User

Primary authorization ID by which you are known to the data source.

Password

Password associated with the primary authorization ID.

IBI_CLASSPATH

Defines the additional Java Class directories or full-path jar names which will be available for Java Services. Value may be set by editing the communications file or in the Web Console. Using the Web Console, you can enter one reference per line in the input field. When the file is saved, the entries are converted to a single string using colon (:) delimiters for all platforms. OpenVMS platforms must use UNIX-style conventions for values (for example, /mydisk/myhome/myclasses.jar, rather than mydisk:[myhome]myclasses.jar) when setting values. When editing the file manually, you must maintain the colon delimiter.

Select profile

Select a profile from the drop-down menu to indicate the level of profile in which to store the CONNECTION_ATTRIBUTES command. The global profile, edasprof.prf, is the default.

If you wish to create a new profile, either a user profile (user.prf) or a group profile if available on your platform (using the appropriate naming convention), choose New Profile from the drop-down menu and enter a name in the Profile Name field (the extension is added automatically).

Store the connection attributes in the server profile (edasprof).

Syntax: How to Declare Connection Attributes Manually

Connection string for local database:

ENGINE LOTUS SET CONNECTION_ATTRIBUTES connection_name

Connection string for remote database:

ENGINE LOTUS SET CONNECTION_ATTRIBUTES connection_name 
 Domino_server/user_ID,password: 'PORT port'

where:

connection_name

Is the logical name used to identify a particular set of attributes.

Note: For a local database connection, this is the only required entry.

Domino_server

Is the remote server name.

port

Is the Domino Server port for remote (IIOP) calls.

user_ID

Primary authorization ID by which you are known to Lotus Notes.

password

Password associated with the primary authorization ID.

Example: Declaring Connection Attributes

Connection string for local database:

ENGINE LOTUS SET CONNECTION_ATTRIBUTES CON2

Connection string for remote database:

ENGINE LOTUS SET CONNECTION_ATTRIBUTES CON1 
ibilotus/SYSTEM,FEE21945C4B7942A:'PORT 63148'

WebFOCUS

Feedback