Queue [Settings]
A queue for point-to-point messaging.
To view this page in the console, click the following path:
.
Configuration tab
The Configuration tab shows configuration properties for this object. These property values are preserved even if the runtime environment is stopped then restarted. See the information center task descriptions for information about how to apply configuration changes to the runtime environment.
General Properties
Identifier
The identifier by which this destination is known for administrative purposes.
You 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.
Information | Value |
---|---|
Required | No |
Data type | String |
UUID
The universal unique identifier assigned by the system to this destination for administrative purposes.
Information | Value |
---|---|
Required | No |
Data type | String |
Type
Whether this bus destination is for a queue, topic space, or some other type of destination.
Information | Value |
---|---|
Required | No |
Data type | String |
Description
An optional description for the bus destination, for administrative purposes.
Information | Value |
---|---|
Required | No |
Data type | Text area |
Mediation
A mediation that is associated with a bus destination to apply processing to messages on that destination.
Information | Value |
---|---|
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.
Information | Value |
---|---|
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.
Information | Value |
---|---|
Required | No |
Data type | drop-down list |
Range |
|
Maximum reliability
The maximum reliability of messages accepted by this destination.
Information | Value |
---|---|
Required | No |
Data type | drop-down list |
Range |
|
Default priority
The default priority assigned to messages sent to this destination when a priority has not been set by the producer.
Information | Value |
---|---|
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.
Information | Value |
---|---|
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.
Information | Value |
---|---|
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.
Information | Value |
---|---|
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.
Information | Value |
---|---|
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.
Information | Value |
---|---|
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.
Information | Value |
---|---|
Required | Yes, if an exception destination has been configured. |
Data type | Integer |
Default | 5 |
Range | 0 through 2147483647 |
Keep count of failed deliveries per message
This option is to keep count of failed deliveries per message into the message store.
Select this option to persist the failed delivery counts of JMS messages in the message store. This option retains the count of failed deliveries even after the messaging engine is restarted.
Information | Value |
---|---|
Required | No |
Data type | Boolean |
Default | Not selected Note: When the option is not selected, the history of the failed delivery
counts for the messages will be lost if the messaging engine is restarted.
|
Send allowed
Clear this option (setting it to false) to stop producers from being able to send messages to this destination.
Information | Value |
---|---|
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.
Information | Value |
---|---|
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.
Information | Value |
---|---|
Required | No |
Data type | Boolean |
Maintain strict message order
Enabling this option will maintain the strict ordering of messages for this destination.
Information | Value |
---|---|
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.
For more information about the use of this property, see Configuring a destination reverse routing path.
Information | Value |
---|---|
Required | No |
Data type | String |
Reply destination bus
The bus on which the reply destination exists.
For more information about the use of this property, see Configuring a destination reverse routing path.
Information | Value |
---|---|
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.
- 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.
Information | Value |
---|---|
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 IBM MQ server.