Configuring the connector

After using the Installer to install the connector files to your system, you must set the standard and application-specific connector configuration properties.

Setting configuration properties

Connectors have two types of configuration properties: standard configuration properties and connector-specific configuration properties. You must set the values of these properties using System Manager before running the connector.

Connector-specific configuration properties

Connector-specific configuration properties provide information needed by the connector agent at run time. Connector-specific properties also provide a way of changing static information or logic within the connector agent without having to recode and rebuild the agent.

Table 6 lists the connector-specific configuration properties. See the sections that follow for explanations of the properties. Note that some of the properties contain other properties. The + character indicates the entry's position in the property hierarchy.

Table 6. Connector-specific configuration properties

Name Possible values Default value Required
Version Version number of the adapter 1 Yes
PoolSize The maximum number of simultaneous connections held open by the Connection Pool 5 Yes
MaxMessageDataSize The maximum allowable size, in bytes, of message data 6000 Yes
ReaperSleepTime Time between checks for connections 100 Yes
MaxConnectionAge Passage of time before an unused connection is terminated 300000 Yes
DiscardIntermediateReplies Determines intermediate reply handling True Yes
+ Services Hierarchal propert. N/A No
- ServiceX Child property None; entries only exist for configured services. No
- - <EventTypeX> Child property N/A Yes, at least 1
-- <TransparentData> Child property; indicates data format of messages False Yes
ReplyTimeout Indicates maximum DTS connection wait time 0 No
ResponderConnectionsPerService Specifies the maximum number of concurrent responder connections that are handled 1 Yes

Version

Version number of the adapter. This version is reported by the adapter as part of its initialization messages. Do not change this value.

PoolSize

The maximum number of simultaneous connections held open by the Connection Pool for use in System Call Request Processing. Set this value to a multiple of the number of services to connect to and the number of concurrent conversations expected.

MaxMessageDataSize

The maximum allowable size, in bytes, of message data. Set this value to be less than or equal to the maximum message size allowed by the DTS protocol, which is 6000 bytes. Values less than 1 are invalid. For string messages, the minimum is 2 bytes, since the Java character is 2 bytes.

ReaperSleepTime

The time, in milliseconds, that the reaper sleeps between checking the connections in the connection pool.

MaxConnectionAge

The maximum age, in milliseconds, an unused connection can reach before it is terminated by the connection reaper.

DiscardIntermediateReplies

If set to true, intermediate VME replies in the conversation will be discarded. Otherwise, if false, intermediate VME replies in the conversation will be concatenated and returned in the final reply.

+ Services

This is a hierarchical property.

- ServiceX

This is a child of the Services property, and it holds the name of the service to subscribe to as a responder. X indicates an incremental number, and there is no limit to the number of services that can exist under the Services property.

- - <EventTypeX>

This is a child of the ServiceX property, and it holds a message type value of messages that the adapter will receive during polling from the particular service. A message type consists of 1-12 alphanumeric characters, and it is normally allocated by the transaction-processing service manager.

X indicates an incremental number, and there is no limit to the number of EventType elements that can exist.

-- <TransparentData>

This is a child of the ServiceX property. If this is set to true, all messages to and from a given service will be handled transparently (using binary data). If this property is set to false, message data is in text format.

ReplyTimeout

The maximum time in milliseconds that a DTS connection will be held open while waiting for a reply business object from the broker. If the value is zero, or if the property is not set, the connection will be held indefinitely.

ResponderConnectionsPerService

Specifies the maximum number of concurrent responder connections that the adapter handles. If all connections are in use, additional messages are rejected. Because additional connections claim processing resources, set the value of this parameter to the fewest number of concurrent connections sufficient for your implementation of the adapter.

Copyright IBM Corporation 2005. All Rights Reserved.