Network Deployment (Distributed operating systems), v8.0 > Reference > Sets


Queue [Settings]

A queue for point-to-point messaging.

Service integration -> Buses -> bus_name -> [Destination resources] Destinations -> queue_name .


Configuration tab

These property values are preserved even if the runtime environment is stopped then restarted.


General Properties



Identifier

The identifier by which this destination is known for administrative purposes.

Do not use an underscore character "_" as the first character, because this naming convention is reserved for system use.

We can use a naming convention to suggest a hierarchical structure for destinations; for example, by using dotted notation for a destination name Library.Shelf.Book1A. Such structure can be useful for organizing queues into logical groups for ease of association, and to permit the use of wildcard notation in filters; for example, Library.Shelf.* or *.Queue.accountXYZ.

Required No
Data type String


UUID

The universal unique identifier assigned by the system to this destination for administrative purposes.

Required No
Data type String


Type

Whether this bus destination is for a queue, topic space, or some other type of destination.

A queue for point-to-point messaging.

Required No
Data type String


Description

An optional description for the bus destination, for administrative purposes.

Required No
Data type Text area


Mediation

The name of the mediation that mediates this destination.

Required No
Data type String


Enable producers to override default reliability

Select this option to enable producers to override the default reliability that is set on the destination.

Required No
Data type Boolean


Default reliability

The reliability assigned to a message produced to this destination when an explicit reliability has not been set by the producer.

Required No
Data type drop-down list
Range

Best effort nonpersistent

Messages are discarded when a messaging engine stops or fails. Messages might also be discarded if a connection used to send them becomes unavailable or as a result of constrained system resources.

Express nonpersistent

Messages are discarded when a messaging engine stops or fails. Messages might also be discarded if a connection used to send them becomes unavailable.

Reliable nonpersistent

Messages are discarded when a messaging engine stops or fails.

Reliable persistent

Messages might be discarded when a messaging engine fails.

Assured persistent

Messages are not discarded.



Maximum reliability

The maximum reliability of messages accepted by this destination.

Required No
Data type drop-down list
Range

Best effort nonpersistent

Messages are discarded when a messaging engine stops or fails. Messages might also be discarded if a connection used to send them becomes unavailable or as a result of constrained system resources.

Express nonpersistent

Messages are discarded when a messaging engine stops or fails. Messages might also be discarded if a connection used to send them becomes unavailable.

Reliable nonpersistent

Messages are discarded when a messaging engine stops or fails.

Reliable persistent

Messages might be discarded when a messaging engine fails.

Assured persistent

Messages are not discarded.



Default priority

The default priority assigned to messages sent to this destination when a priority has not been set by the producer.

Required No
Data type Integer
Range 0 through 9



Exception destination

Use these properties to define what happens to any messages that cannot be delivered to this destination.


None

The bus destination does not use an exception destination and undeliverable messages are not rerouted to an exception destination.

Attempts to redeliver the message continue, up to the maximum failed deliveries limit set for the bus destination. Then, attempts to redeliver the message continue with a time interval between retry attempts. This interval is either the Default blocked destination retry interval of the messaging engine that is associated with this destination, or the Blocked retry timeout that is set for this destination. The Default blocked destination retry interval value can be used by all queue and topic destinations associated with this messaging engine.

To set a time interval specifically for this destination, select Override messaging engine blocked retry timeout default , then enter a blocked retry timeout value for this destination.

Required No
Data type Radio button
Default Not selected


Override messaging engine blocked retry timeout default

Override the blocked queue retry interval configured on the messaging engine owning the destination.

Select this property to set the blocked retry timeout for this destination. This property is available only when None is selected for the exception destination.

Required Yes, if None is selected.
Data type Boolean
Default Unchecked. The Default blocked destination retry interval value of the associated messaging engine is used.


Blocked retry timeout in milliseconds

When no exception destination is configured, the time interval to apply between retry attempts, after the maximum failed deliveries limit is reached, for this destination.

This property is available only when Override messaging engine blocked retry timeout default is selected in the exception destination properties.

Required Yes, if Override messaging engine blocked retry timeout default is checked.
Data type Integer


System

The bus destination uses the system default exception destination.

Undeliverable messages are routed to the system default exception destination of the messaging engine that detects the problem: _SYSTEM.Exception.Destination.messaging_engine_name.

Required No
Data type Radio button
Default Selected


Specify

The bus destination uses the exception destination specified in this field.

The exception destination must be a queue, on the same bus or a foreign bus, and must exist when the exception destination processing is configured.

Required No
Data type Radio button
Default Not selected


Maximum failed deliveries per message

The maximum number of failed attempts to process a message. After this number of failed attempts, if an exception destination is configured, the message is forwarded from the intended destination to its exception destination. If an exception destination is not configured, a time interval between retry attempts is applied.

This interval is either the Default blocked destination retry interval of the messaging engine that is associated with this destination, or the Blocked retry timeout that is set for this destination.

Required Yes, if an exception destination has been configured.
Data type Integer
Default 5
Range 0 through 2147483647


Send allowed

Clear this option (setting it to false) to stop producers from being able to send messages to this destination.

Required No
Data type Boolean


Receive allowed

Clear this option (setting it to false) to prevent consumers from being able to receive messages from this destination.

Required No
Data type Boolean


Receive exclusive

Select this option to allow only one consumer to attach to each message point. If this option is not selected multiple consumers will be allowed to attach and receive messages from each message point.

Required No
Data type Boolean


Maintain strict message order

Enabling this option will maintain the strict ordering of messages for this destination.

Required No
Data type Boolean


Reply destination

The name of a destination to be appended to any non-empty reverse routing path of messages sent to this destination.

This property is intended for use with mediations on reply messages.

For more information about the use of this property, see Configure a destination reverse routing path.

Required No
Data type String


Reply destination bus

The bus on which the reply destination exists.

This property is intended for use with mediations on reply messages.

For more information about the use of this property, see Configure a destination reverse routing path.

Required No
Data type String


Default forward routing path

The value to which a message's forward routing path will be set if the message contains no forward routing path. This identifies a sequential list of intermediary bus destinations that messages must pass through to reach a target bus destination. The format of the field is a list of line-delimited bus destinations specified as bus:name.

To forward messages to one or more bus destinations, type a list of bus destinations. Type each destination entry on a separate line, and in the form bus_name:destination_name or :destination_name

Where

bus_name

Is the name of the service integration bus on which the destination is configured. If you do not specify a bus name, the destination is assumed to be on the same bus as the destination for which you are setting this property.

destination_name

is the name of a bus destination.

Required No
Data type Text area


Message points

Queue points

Displays a list of queue points used to hold messages pending delivery to receiving applications.

Mediation points

Displays a list of mediation points created when a mediation is associated with a bus destination.


Additional Properties

Context properties

Context information passed to the mediation.

Mediation execution points

Mediation execution points for the processing of messages from mediation message points that are on a WebSphere MQ server.


Related Items

Application resources for this destination

This pane provides an expandable tree view of all the applications and messaging resources that reference the current destination, both directly and indirectly. As many of the references as possible are resolved to links to the associated configuration panel for the referenced object.

Use this panel to inspect the configuration from the queue or topic space (destination) to the application or other JMS resources to ensure that the configuration is correct.


Create a queue for point-to-point messaging
Configure bus destination properties
Configure a destination reverse routing path
Application resources for this destination
Messaging engines [Settings]
Administrative console buttons
Administrative console preferences

+

Search Tips   |   Advanced Search