WSIFOperation - Synchronous and asynchronous timeouts reference

When you use the Web Services Invocation Framework (WSIF) with the Java Messaging Service (JMS) you can set timeouts for synchronous and asynchronous operations.

Default values for these timeouts are defined in the WSIF properties file...

# maximum number of milliseconds to wait for a response to a synchronous request.
# Default value if not defined is to wait forever.

# maximum number of seconds to wait for a response to an async request.
# if not defined on invalid defaults to no timeout

If you use these default values, a synchronous request (such as a WSIFOperation interface executeRequestResponseOperation method call) times out after ten seconds, and an asynchronous request (such as a WSIFOperation interface executeRequestResponseAsync method call) times out after sixty seconds.

Note that

The code that processes both of these timeout values uses milliseconds as its unit of time. The WSIFProperties class getAsyncTimeout method multiplies the wsif.asyncrequest.timeout value by 1000, to convert the value from seconds to milliseconds.

You can override these default values for a given request by setting a JMS property on the operation request with the <jms:property> and <jms:propertyValue> WSDL elements. Set the name of the property to be the name of the timeout from the WSIF properties file.

The following example sets synchronous requests to time out after two minutes (120 seconds)

<jms:propertyValue name="wsif.syncrequest.timeout" type="xsd:string" value="120000"/>
and the following example disables asynchronous timeouts (a value of zero means wait forever)

<jms:propertyValue name="wsif.asyncrequest.timeout" type="xsd:string" value="0"/>

When an asynchronous timeout expires, no listener or message data base waiting for the response is notified. The asynchronous timeout is only used to tell the correlation service that the stored WSIFOperation can be deleted.


See Also

WSIF system management and administration
The JMS providers - Configuring the client and server
WSIFOperation interface
WSIFOperation - Context
WSIFOperation - Asynchronous interactions reference