Execution timeout

The execution timeout value for the IMS resource adapter is defined as the maximum amount of time allowed for IMS Connect to send a message to IMS™ and receive a response from IMS. For details about the execution timeout value, see Setting execution timeout values and Valid execution timeout values.

Before the introduction of the executionTimeout property, you were limited to setting a timeout value on a global level, which was specified in the IMS Connect configuration file. Every interaction between IMS Connect had the same timeout value.

With the executionTimeout property, you can set individual timeout values on a per interaction basis rather than on a global basis. If an interaction is not complete before timeout occurs, IMS Connect returns an error message to the IMS resource adapter. The IMS resource adapter returns an exception indicating that the duration of time for IMS to respond to IMS Connect has exceeded the execution timeout value.

Note: Because the connection between the IMS resource adapter and IMS Connect is persistent, when execution timeout occurs, the socket is not closed. Instead, the socket is available for reuse for subsequent interactions.

Execution timeout in conversational transactions

In a conversational transaction, the execution timeout value applies to each iteration of that conversation. An iteration consists of one input message sent to IMS and one output message received from IMS. If one iteration of the conversation times out, the entire conversation ends.

Execution timeout exceptions

If a valid execution timeout value is specified for a particular interaction and execution timeout occurs, the Java™ application submitting the interaction receives the exception javax.resource.spi.EISSystemException. If you specify an invalid execution timeout value, the exception javax.resource.NotSupportedException is thrown when execution timeout occurs.

Related concepts
Socket timeout
Related tasks
Setting execution timeout values
Setting the Socket Timeout Value
Related reference
Valid execution timeout values
Connection properties
IMSInteractionSpec properties
Terms of use | Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.