Consumer Specific Runtime Configuration

The JMS consumer configuration allows you to specify two runtime behaviors:

the number of milliseconds the consumer will wait for a response.
the number of milliseconds a request will exist before the JMS broker can remove it.

Configuration element

You configure consumer runtime behavior using the jms:clientConfig element. The jms:clientConfig element is a child of the jms:conduit element. It has two attributes that are used to specify the configurable runtime properties of a consumer endpoint.

Configuring the response timeout interval

You specify the interval, in milliseconds, a consumer endpoint will wait for a response before timing out using the jms:clientConfig element's clientReceiveTimeout attribute. The default timeout interval is 2000.

Configure the request time to live

You specify the interval, in milliseconds, that a request can remain unreceived before the JMS broker can delete it using the jms:clientConfig element's messageTimeToLive attribute. The default time to live interval is 0 which specifies that the request has an infinite time to live.

Example

Example 3.2, “JMS Consumer Endpoint Runtime Configuration” shows a configuration fragment that sets the consumer endpoint's request lifetime to 500 milliseconds and its timeout value to 500 milliseconds.

Example 3.2. JMS Consumer Endpoint Runtime Configuration

...
<jms:conduit id="{http://cxf.apache.org/jms_endpt}HelloWorldJMSPort.jms-conduit">
  <jms:address ... >
    ...
  </jms:address>
  ...
  <jms:clientConfig clientReceiveTimeout="500"
                    messageTimeToLive="500" />
  ...
</jms:conduit>
...