Use this task to create a new queue, which is a bus destination
configured for point-to-point messaging.
Before you begin
During this task you must specify the name of a bus member
to which the bus destination is assigned. That bus member is to host
the queue point for the new bus destination, and must already have
been configured.
About this task
To define a new queue for point-to-point messaging use
the administrative console to complete the following steps. To define
a queue, you need to specify only a minimum set of properties; you
can change these and other properties after you have completed this
task.
Procedure
- In the navigation pane, click .
- In the content pane, click the name of the bus that is
to provide the message point for the queue.
- In the content pane, under Destination resources, click Destinations.
This displays a list of any existing destinations in the
content pane.
- To create a new destination, click New in
the content pane.
- On the Create New Destination page, leave the type of
destination as Queue.
- Click Next.
- In the Identifier field, type
the name that you want to give the queue destination for administrative
purposes.
- Optional: Specify the following properties
for the destination:
- Description
- An optional description of the destination, for administrative
purposes.
- Maximum reliability
- The maximum reliability of messages accepted by this destination.
- 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.
For non-transactional JMS message-driven beans
and MessageListeners that use a JMS destination configured on the
default messaging provider, best-effort nonpersistent messages are
not recoverable. In this case, if a message is unlocked because the
message-driven bean or MessageListener threw an exception, then the
message is not redelivered or sent to the exception destination because
it was deleted from the message store when it was passed to the listener.
If you require higher message reliability for non-transactional JMS
message-driven beans and MessageListeners, configure a different option
for the Maximum reliability property of the bus destination.
- 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.
- Click Next.
- On the Select Assigned Bus Member page, select the bus
member that is to provide the queue point for the destination. The
queue point is where the messages for the queue are held.
If the bus member is a server
cluster, you are choosing to create a queue that is partitioned across
the servers in the cluster. In this case, a queue point is created
for each server in the cluster.
- Click Next.
- On the Confirm Queue Creation page, review the summary
of actions.
- To create the queue, click Finish.
- If you want to change any of the properties that you have
specified, click Previous, then change the
properties on the preceding pages.
- Save your changes to the master configuration.
What to do next
If you want to change properties of the queue, see
Configuring bus destination properties.
By default,
messages that cannot be delivered to the queue are sent to the default
exception destination for the messaging engine that hosts the queue
point. If you want to use a non-default exception destination for
messages that cannot be delivered to this queue destination, you must
have already defined that exception destination. For more information
about configuring exception destinations, see Configuring an
exception bus destination.
If the queue is to be used
for JMS point-to-point messaging, specify the queue identifier on
a JMS queue as described in Configuring a JMS queue for the default messaging provider.