IMS Connect policy (IMSConnect)

Attach an IMS Connect policy to an IMSRequest node to control how it accesses the IMS Connect system.

You can use IMSRequest nodes in a message flow to send requests to IMS by using IMS Connect. You can use an IMSConnect policy to control, at run time, the details of the connection to the IMS Connect service.

If you redeploy an IMS Connect policy, all message flows that are using the policy will be stopped and restarted.

Property	Property name in .policyxml file	Description of properties
Host name	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.
Port number	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.
Data store name	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 policy.
Socket timeout	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 integration node. 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 in the policy. 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.
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.
Connection idle timeout	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.
Use SSL	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.
SSL encryption type	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.
Coded Character Set Identifier	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.
LTERM name	LtermName	The LTERM name that is set on the IMS interaction. This property is not mandatory. If no value is set, or if an empty string is set as the value, no LTERM name is set on the interaction.
Security identity	securityIdentity	A unique key to identify a DSN entry, which provides the user ID and password credentials that are required to connect to the IMS system. Use the mqsisetdbparms command to create a DSN entry, as described in Preparing the environment for IMS nodes. This property is optional. If it is set and the node is configured to use a configurable service, the value of this property overrides any value set on the IMSRequest node.