The maximum number of times that the listener tries to deliver
a message before the listener is stopped, in the range 0 through 2147483647.
Every message has a delivery count associated with it, which is incremented
if the message cannot be delivered, or is delivered successfully to a message-driven
bean instance and then rolled back. When the delivery count of a message equals
the value of this property, the listener is stopped.
Note: When the listener's Maximum sessions property is set to a value greater
than 1, it is possible that a message which cannot be delivered or has been
rolled back might be processed more than the value of Maximum retries before
the listener is shut down. If WebSphere MQ is being used as the JMS provider,
this can be prevented by ensuring the WebSphere MQ queue properties Backout
threshold (BOTHRESH) and Backout requeue queue (BOQUEUE) have been defined,
and that the Backout threshold is less than Maximum retries. For more information
on how WebSphere MQ handles messages that cannot be delivered or processed,
see the
WebSphere MQ Using Java book, which is available from
the WebSphere MQ library at
http://www.ibm.com/software/integration/wmq/library.
Data type |
Integer |
Units |
Retry attempts |
Default |
0 (no retries) |
Range Recommended
|
0 (no retries) through 2147483647. When using WebSphere MQ as
the JMS provider, this property should be greater than the value of the WebSphere
MQ queue property Backout threshold (BOTHRESH). This allows WebSphere MQ to
remove the message from the queue without the need to shut down the listener.
|