Queue [Settings]

A queue for point-to-point messaging.

To view this pane in the console, click the following path:

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

Configuration tab

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.

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

You can use a naming convention to suggest a hierarchical structure for destinations; for example, 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 Text

UUID

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

Required No
Data type Text

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 Text

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 Text

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 Check box

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 may also be discarded if a connection used to send them becomes unavailable and as a result of constrained system resources.

Express nonpersistent
Messages are discarded when a messaging engine stops or fails. Messages may 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 may 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 may also be discarded if a connection used to send them becomes unavailable and as a result of constrained system resources.

Express nonpersistent
Messages are discarded when a messaging engine stops or fails. Messages may 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 may 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 (lowest) through 9 (high)

Exception destination

The destination to which a message is forwarded by the system when it cannot be delivered to this destination.

Use this property to define what happens to any messages that cannot be delivered to this destination. By default, such messages are routed to the system default exception destination of the messaging engine that discovers the problem; _SYSTEM.Exception.Destination.engine_name.

If you want to messages to be sent to another exception destination, select Specify then type its name on this property. The exception destination must be a queue, on the same bus or a foreign bus, and must exist when the destination is created.

If you do not want undeliverable messages to be routed to an exception destination, select None.

Required No
Data type Text and Check box
Default System
Range
System
Default system exception destination.
None
No exception destination is configured.
Specify
Specify a named destination.

Maximum failed deliveries

The maximum number of failed attempts to process a message before the message is forwarded to the exception destination for the destination.

Required No
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 Check box
Range
Selected
Producers can send messages to this destination.

Cleared
Producers cannot send messages to this destination.
  • For a queue point of a non-mediated destination, or a mediation point of a mediated destination, new messages (from attached producers or forwarded from another destination) are redirected to any available message point. If no message points are available, then messages that have already been accepted onto the bus, and new messages from attached producers, are preserved by the bus until a message point becomes available. The only exception to this is the case of a destination with only one message point (queue point or mediation point depending on whether the destination is mediated or non-mediated), where the producer is attached to the same messaging engine. In this case, an exception is thrown on each send call. The exception message indicates that the reason for the exception is that the only extant localization has been disabled for send. The producer remains open as normal, and any more send calls succeed if the Send allowed property of the localization is reselected (reset to true).
  • For a queue point of a mediated destination, clearing this Send allowed property alters the behavior of the mediation instances that are sending to the destination in the same way as setting it to false on a non-mediated destination affects producing applications: Messages are sent instead to any alternative message point. If no localizations are available, are preserved by the bus until a message point becomes available. For any mediation instance (that is, on any server that has a mediation point), if the same server hosts a queue point, and that queue point is the only queue point for the destination, then the mediation changes to the "stopped on error" state.

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 Check box
Range
Selected
Consumers can get messages from this destination.

Cleared
Consumers cannot get messages from this destination.

For the queue point, any open consumers change state and an exception is thrown if the consumer requests a message. Messages can continue to be sent, and accumulate on the message store.

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 Check box

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 Configuring a destination reverse routing path.

Required No
Data type Text

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 Configuring a destination reverse routing path.

Required No
Data type Text

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, in the format, bus:name or :name.

If you want 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

Additional properties

Context properties
Context information passed to the mediation.

Message points

Queue points
A queue point is created on each messaging engine to which a point-to-point destination is assigned. It is used to hold messages pending delivery to receiving applications.
Mediation points
A mediation point is a location in a messaging engine at which messages are mediated. A mediation point is created when a mediation is associated with a bus destination.



Reference topic    

Terms of Use | Feedback

Last updated: Sep 20, 2010 9:00:59 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=vela&product=was-nd-dist&topic=SIBQueue_DetailForm
File name: SIBQueue_DetailForm.html