Creating a queue for point-to-point messaging

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

  1. In the navigation pane, click Service integration > Buses.
  2. In the content pane, click the name of the bus that is to provide the message point for the queue.
  3. In the content pane, under Destination resources, click Destinations. This displays a list of any existing destinations in the content pane.
  4. To create a new destination, click New in the content pane.
    1. On the Create New Destination page, leave the type of destination as Queue.
    2. Click Next.
    3. In the Identifier field, type the name that you want to give the queue destination for administrative purposes.
  5. 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.
  6. Click Next.
  7. 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.

    [z/OS] 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.

  8. Click Next.
  9. 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.
  10. 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.




In this information ...


IBM Redbooks, demos, education, and more

(Index)

Use IBM Suggests to retrieve related content from ibm.com and beyond, identified for your convenience.

This feature requires Internet access.

Task topic    

Terms of Use | Feedback

Last updated: Feb 19, 2011 5:25:36 AM CST
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=v610web&product=was-nd-mp&topic=tjo0001_
File name: tjo0001_.html