Setting execution timeout values

You can set the execution timeout value in the J2C wizard in your Rational® or WebSphere® integrated development environment (IDE) or by using the Common Client Interface (CCI) API.

The execution timeout property is a property of the IMSInteractionSpec class. The execution timeout value that you set is converted to a value that IMS™ Connect uses. This conversion occurs to meet the requirements of IMS Connect.

Other timeouts, such as socket timeouts, or the interaction between your client application and WebSphere Application Server for z/OS®, can affect your interactions. If other timeout values are less than the execution timeout value you set for your IMS interaction, these other timeouts can mask the fact that IMS did not return a response.

In an IDE, you can set the execution timeout value when you initially define the IMS binding properties for a new J2C Java™ bean.

To edit the IMS binding properties that are already defined in the IDE for a new J2C Java bean, complete the following steps:
  1. Open the appropriate Java binding for IMS by using the Java Editor.
  2. Locate the doclet tag for the IMSInteractionSpec class.
  3. Modify the doclet tag to add the executionTimeout property, if it is not listed, and specify a value for the executionTimeout property. If the property is listed, modify the value.
  4. Close the editor and click Yes to save your changes.
You can also code the individual timeout values for different interactions by setting the IMSInteractionSpec executionTimeout property value. If you code an execution timeout value in your Java client application code, that value overrides any execution timeout value that you set in the IMS binding properties of your J2C Java bean.
With the second approach, use the setExecutionTimeout method to set an execution timeout value in an CCI application.
  1. First instantiate a new IMSInteractionSpec instance or obtain the IMSInteractionSpec instance from your specific interaction.
  2. Set the executionTimeout value by using the setExecutionTimeout method. For example:
    interactionSpec.setExecutionTimeout(timeoutValue);
  3. Assign this interactionSpec to the specific interaction.