Configuring the connector

Connectors have two types of configuration properties: standard configuration properties and adapter-specific configuration properties. You must set the values of these properties before running the adapter with the Connector Configurator, a tool provided with the WebSphere Business Integration Adapters. When you have finished specifying values for the connector's configuration properties, Connector Configurator saves the values in a repository where it will be available to the adapter upon startup.

You use Connector Configurator to configure connector properties:

Standard configuration properties

Standard configuration properties provide information that all adapters use. See Appendix A. Standard configuration properties for connectors for documentation of these properties.

The connector obtains its configuration values at startup. During a run-time session, you may want to change the values of one or more connector properties.

To determine whether a property is dynamic or static, refer to the update method column in Connector Configurator.

Note that logging and tracing parameters are standard configuration properties. For more information about setting up logging and tracing, refer to Appendix A. Standard configuration properties for connectors.

Application-specific configuration properties

Application-specific connector configuration properties provide information needed by the connector at run time. They also provide a way for you to change static information or logic within the connector without having to recode and rebuild it.

To view and configure these properties, select the Connector Configurator Application Config Properties tab to add or modify configuration properties. For more information, see Appendix B. Connector Configurator.

Table 3 lists the application-specific configuration properties for the connector, along with their descriptions and possible values.

Table 3. Application-specific configuration properties for Lotus Domino
Property Description Type Default value
DominoServerName machine name of Domino server string None.
ApplicationUserName The Domino user's name. This property can be configured for bidirectional languages. string None. This property can be configured for bidirectional languages.
ApplicationPassword The Domino user's password. This property can be configured for bidirectional languages. string None.
EventDBName The Domino event database name. string BIALD_EventTable.nsf
DocumentBOName The name of the business object for Lotus Domino. string DominoDocument
ForceSave When the adapter is processing a Create or
Update request, if ForceSave is true, the
document is saved even if someone else edits
and saves the document while the adapter is
processing the request. The last version of the
document is the one that is saved; the earlier
version is discarded. If false, and someone else
edits the document while the adapter is
processing the request, the MakeResponse
property determines the outcome.
Boolean False.
MakeResponse When the adapter is processing a Create or
Update request, if ForceSave is false and
MakeResponse is true, the current document
becomes a response to the original document. If
MakeResponse is false, the save is cancelled. If
ForceSave is true, the MakeResponse property
has no effect.
Boolean True.
ForceDelete When the adapter is processing a Delete request,
if ForceDelete is true the document is removed
even if another user modifies the document after
the adapter opens it. If false, the document is
not removed if another user modifies it.
Boolean False.
InDoubtEvents The recovery options for InProgress events. Possible
values: Reprocess, FailOnStartup, LogError, or
Ignore. Refer to Table 4 for descriptions of these
options.
String Reprocess
DateFormats Possible formats of Created and LastModified
dates for incoming business objects. When a
business object is received from the integration
broker, the Domino adapter must convert its
Created and LastModified dates to the Java
format understood by the Lotus Domino server.
Multiple formats can be specified, separated by a
semicolon (;). The adapter will compare the
incoming date with the specified formats in the
order listed. If no format is specified, the date
format on the adapter's host system is used.The
date format must conform to that required
by the java.text.SimpleDateFormat API in the
Java 2 Platform, Standard Edition (J2SE) v1.3.1.
String MM/dd/yy hh:mm aaa; MM/dd/yy

You must configure DominoServerName, ApplicationUserName, and ApplicationPassword. If a server name, user name, and password are defined in the business object received from the broker, then these are used to establish the adapter's session with the Domino server. If the business object does not contain any of these items, the adapter uses the values defined for them in the configuration file.

Table 4 defines the possible values for InDoubtEvents. An in-doubt event is one that was being processed when the adapter terminates, and before the adapter could update the event status to indicate whether the event was either successfully sent or failed. When the adapter is restarted, it checks the event table for events that were in progress and take action depending upon which option has been configured for the InDoubtEvents property.

Table 4. Possible values for InDoubtEvents property
Value of InDoubtEvents Description
Reprocess Causes the event to be resubmitted for a subsequent poll call.
Note: This could cause an event to be duplicated. To avoid this, use another option.
FailOnStartup Logs a fatal error, shutting down the adapter.
LogError Logs an error without shutting down the adapter.
Ignore Ignores the in-progress event records in the event table.

Copyright IBM Corporation 1997, 2004. All Rights Reserved.