Use this task to create a new queue, which is a bus destination configured for point-to-point messaging.
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.
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.
- 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
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
- Reliable nonpersistent
- Reliable persistent
- Assured persistent
- 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.
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, default messaging provider.