JMS message header: The TimeToLive property reference

The range of permitted values for the TimeToLive property of a JMS message that WSIF puts onto a queue.

The JMS message header property JMSTimeToLive is of type long. It sets the time to live of a message put onto a queue, in milliseconds. A value of 0 means live indefinitely.

The factors that determine the time to live of a JMS message are as follows:
  • For a one-way (input only) operation, the default time to live is 0, so the message remains on the queue indefinitely or until the server end-processes the message. The JMSTimeToLive value, if specified in the service endpoint URL or the JMS Address, is used for one-way messages. The client never waits for a response to a one-way operation and so it never times out. During a one-way operation, the client fails only if the queue itself is unavailable.
  • For a two-way (request and response) operation the JMSTimeToLive value, if specified in the service endpoint URL or the JMS Address, is used for two-way messages. When the time to live is not specified, the default value is determined by the client response timeout setting.