The connector component of the adapter has two types of configuration properties: standard configuration properties, which apply to most adapters, and connector-specific configuration properties, which apply only to your adapter and provide a way for you to change static information or logic within the connector without having to recode and rebuild it. A connector obtains its configuration values at startup. You must set the values of these properties before running the connector.
To configure connector properties, use the Connector Configurator tool. Details are given in Appendix B, "Connector Configurator". This tool provides a graphical user interface for configuring the connector.
When you have finished specifying values for the connector's configuration properties, Connector Configurator saves the values in the adapter repository (for ICS) or generates a configuration file and places it in the adapter's local repository (for WebSphere MQ Integrator Broker and WebSphere Application Server).
In this section, the steps required to specify properties are described. The project name for the folder used in these procedures is CES.
To specify properties, start the WebSphere Business Integration System Manager and do the following steps:
Refer to Appendix A, Standard configuration properties for connectors for descriptions of these properties.
Accept the defaults for the remainder of the configuration for standard properties.
In the next few steps, you define the connector-specific properties for the transport.
The following properties are required:
Table 4. Connector-specific configuration properties for CES Centricity Gateway MQ transport
Property / Parameter | Description | Value | Default value |
---|---|---|---|
locationOfObjectType | An XPath
statement describing the location of business object type within
the XML.
XMLReceiver only. |
N/A | |
hostname | The host name of the MQ queue manager. | N/A | |
port | The port of the queue manager listener. | 1414 | |
channel | The channel used for communications with the queue manager. | None | |
qmanager | The name of the queue manager. | N/A | |
queue | The name of the queue or the queue URI. | N/A | |
pollinterval | The interval
with which to check the queue for new messages (in milliseconds).
XMLReceiver only. |
10000 | |
extraintegrity | Determines
the method with which the receiver gets messages off the queue. If
this parameter is true, then the receiver peeks at the queue and
only removes the message once it has been successfully added to the
event store for processing by the adapter core. This ensures
persistence throughout the adapter but suffers a minor performance
penalty. If this parameter is set to false, then messages are
removed from the queue upon receipt, but may be lost if the adapter
fails before the event was added to the event store.
XMLReceiver only. |
True | |
expectReplyOnVerb | The verb for
which to expect a synchronous reply. This causes the sender to make
an entry in its correlation table between the message ID and the
broker ID. The sender then waits until the receiver has processed a
message whose correlation ID matches the message ID entry within
the correlation table. The results are then sent to the broker and
the service call completed. Multiple verbs can be specified by
separating each verb with a comma.
XMLSender only. |
N/A | |
replyTimeout | The time to
wait, in milliseconds, before giving up while waiting on a reply.
This returns an APPRESPONSE_TIMEOUT to the broker.
XMLSender only. |
30000 |
Table 5. Connector-specific configuration properties for CES Centricity Gateway JMS transport
Property / Parameter | Description | Value | Default value |
---|---|---|---|
locationOfObjectType | An XPath
statement describing the location of business object type within
the XML.
XMLReceiver only. |
N/A | |
PROVIDERL_URL | The URL of the JNDI provider. | N/A | |
INITIAL_CONTEXT_FACTORY | The JNDI initial context factory class. | N/A | |
SECURITY_PROTOCOL | The JNDI security protocol to use. | N/A | |
SECURITY_PRINCIPAL | The JNDI security principal. | N/A | |
SECURITY_CREDENTIALS | The JNDI security credentials. | N/A | |
queueConnectionFactory | The queue connection factory JNDI name. | N/A | |
queue | The queue JNDI name. | N/A | |
expectReplyOnVerb | The verb for
which to expect a synchronous reply. This causes the sender to make
an entry in its correlation table between the message ID and the
broker ID. The sender then waits until the receiver has processed a
message whose correlation ID matches the message ID entry within
the correlation table. The results are then sent to the broker and
the service call completed. Multiple verbs can be specified by
separating each verb with a comma.
XMLSender only. |
N/A | |
replyTimeout | The time to
wait, in milliseconds, before giving up while waiting on a reply.
This returns an APPRESPONSE_TIMEOUT to the broker.
XMLSender only. |
30000 |
The following properties are required:
The adapter uses the XSLT logic module as the primary transformation mechanism for translating between the adapter's XML messages and the WBI XML. Translations between XML formats are direct, there is no chaining. To configure the logic module with properties other than the defaults, specify values for the properties listed in Table 6.
Property / Parameter | Description | Value | Default value |
---|---|---|---|
schemaConfig | Used internally for configuring the adapter translation component. | repository_dir\schemaTypes.xml | translations \schemaTypes.xml |
repository | The xslt subdirectory is specified as the root for name resolution within the repository, versus the top-level translations directory. | repository_dir\xslt | translations\xslt |
CES | Used to configure routing path. | CW | |
CW | Used to configure routing path. | This value must match the routing paths. | CES |