IBM Integration Bus, Version 9.0.0.8 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

IMSConnect configurable service

Select the objects and properties that you want to change for the IMSConnect configurable service.

For IMSConnect configurable services, you must stop and start the integration server for a change of property value to take effect.

Supplied configurable services that are created for each broker Properties for each configurable service that is defined Description of properties

None

Hostname

The host name of the computer on which the IMS™ Connect instance is running. This property is mandatory; if you leave it blank, the node cannot connect to IMS Connect.

PortNumber

The port number on which the IMS Connect instance is listening. This value must be a positive integer. This property is mandatory; if you leave it blank, the node cannot connect to IMS Connect.

DataStoreName

The data store name against which the IMS Connect instance is running. This property is not mandatory, but if you do not set it, an exception is issued by any node that attempts to use this configurable service.

SocketTimeoutSec

The socket timeout is the maximum amount of time that the IMS Connector for Java™ waits for a response from IMS Connect before it disconnects the socket and returns an exception to the broker. If network problems or routing failures occur, this property prevents the client that is using the IMS Resource Adapter from waiting indefinitely for a response from IMS Connect. This property is based on the TCP/IP sockets that IMS Connect and the IMS Resource Adapter use to communicate; therefore, it is not applicable with the Local option. This property is optional, and the default value is 0 (zero), indicating that the socket never times out. You can enter an integer in the range 0 - 2147483.

You set the socket timeout independently of the execution timeout on the configurable service. The socket timeout is used to respond to network problems (such as a loss of connection), while the execution timeout is used to recover from a non-responsive IMS program. The socket timeout is typically longer than the execution timeout.

ExecutionTimeoutSec

The execution timeout is the maximum amount of time that the IMS Connector for Java waits for a response from a transaction. This property is not mandatory, and the default value is 60, indicating that the IMS Connector for Java waits for 60 seconds. You can enter an integer in the range 1 - 2147483.

ConnectionIdleTimeoutSec

The connection idle timeout is the maximum amount of time, in seconds, that a connection can be idle before it expires. This property is not mandatory, and the default value is 0 (zero), indicating that the connection never times out. You can enter an integer in the range 0 - 2147483. Any IMS connection that is idle for more than the value specified by this property is not reused, and it is removed from the connection pool.

UseSSL

The value that defines whether the TCP/IP connection to IMS Connect uses Secure Sockets Layer (SSL) encryption. Valid values are True or False. Both values are not case-sensitive.

If no value is specified, the default value of False is used.

SSLEncryptionType

The value of the cipher that is used for encryption. This value takes effect only when property UseSSL is set to True. Valid encryption values are Strong, Weak, or ENULL. These values are case-sensitive.

Value definition, where:

  • ENULL allows for authentication during the SSL handshaking process. When the handshaking process for a socket has completed including authentication as required, all messages then flow in plain text over that authenticated socket. This value is useful if trust assertion is required, but the additional encryption work involved is not required.
  • Weak indicates a low level of encryption that is based on the strength of the cipher that is related to the key length.
  • Strong indicates a high level of encryption that is based on the strength of the cipher that is related to the key length.

If the encryption value specified by the client and server do not match, a handshake failure occurs and an exception is thrown.

If no value is specified, the default value of Weak is used.

CodedCharSetID The Coded Character Set Identifier (CCSID). The default value is 500 (EBCDIC International). Change this value if your IMS system or IMSConnect uses a different CCSID, for example CCSID 37. See CCSID Comparisons for details of differences between EBCDIC CCSIDs.

bn28732_.htm | Last updated Friday, 21 July 2017