After using the Installer to install the connector files to your system, you must set the standard and application-specific connector 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 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 number of the adapter. This version is reported by the adapter as part of its initialization messages. Do not change this value.
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.
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.
The time, in milliseconds, that the reaper sleeps between checking the connections in the connection pool.
The maximum age, in milliseconds, an unused connection can reach before it is terminated by the connection reaper.
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.
This is a hierarchical property.
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.
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.
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.
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.
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.