Background

Destination Options are a way to provide extended configuration options to a JMS consumer without having to extend the JMS API. The options are encoded using URL query syntax in the destination name that the consumer is created on.

Consumer Options

Option Name

Default Value

Description

consumer.dispatchAsync

true

Should the broker dispatch messages asynchronously to the consumer.

consumer.exclusive

false

Is this an Exclusive Consumer.

consumer.maximumPendingMessageLimit

0

Use to control if messages for non-durable topics are dropped if a slow consumer situation exists.

consumer.noLocal

false

Same as the noLocal flag on a Topic consumer. Exposed here so that it can be used with a queue.

consumer.prefetchSize

n/a

The number of message the consumer will prefetch.

consumer.priority

0

Allows you to configure a Consumer Priority.

consumer.retroactive

false

Is this a Retroactive Consumer.

consumer.selector

null

JMS Selector used with the consumer.

Example

queue = new ActiveMQQueue("TEST.QUEUE?consumer.dispatchAsync=false&consumer.prefetchSize=10");
consumer = session.createConsumer(queue);
© 2004-2011 The Apache Software Foundation.
Apache ActiveMQ, ActiveMQ, Apache, the Apache feather logo, and the Apache ActiveMQ project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
Graphic Design By Hiram