Creating the queue-type destination and assigning it to a WebSphere MQ queue

You can use the administrative console to create a queue-type destination and assign it to a WebSphere® MQ queue. Select the WebSphere MQ server to host the queue, then specify the WebSphere MQ queue to be hosted.

Before you begin

You can create a bus destination through the administrative console as described in this task, or you can create a bus destination using the wsadmin tool.

Before performing this task, obtain the name of the WebSphere MQ queue from your administrator. Also ensure that the WebSphere MQ server has been added as a bus member, and that the WebSphere MQ queue for the queue point exists. You should also ensure the queues on the WebSphere MQ network have their shareability attribute set to 'shareable'. Shareable queues allow multiple service integration application instances to get messages from them.

Note: A destination that is defined with a WebSphere MQ queue point is only visible to the messaging engine in WebSphere Application Server Version 6.1 or later.

About this task

You can create a queue-type destination that uses a WebSphere MQ queue as a queue point. This allows service integration applications to send messages to and receive messages from that queue. To create a destination with a WebSphere MQ queue point, complete the following steps:

Procedure

  1. Start the administrative console.
  2. Navigate to the list of destinations for the appropriate bus. Click Service integration > Buses > [Content Pane] bus_name > [Destination resources] Destinations
  3. Click New. The create new destination panel is displayed.
  4. Select Queue as the destination type, then click Next. The create a new queue wizard is displayed.
  5. Set the queue attributes. Enter the name that you want WebSphere Application Server to use to refer to the associated WebSphere MQ queue, and (optionally) a description of the queue.
  6. Assign the queue to a bus member that will store and process the messages for the queue. Select a WebSphere MQ server bus member from the list of available bus members.
  7. Set the WebSphere MQ queue point attributes:
    1. Specify a WebSphere MQ queue name.

      Select a queue name from the list. If the list does not include the queue that you want, select the last entry in the list labeled "other, please specify". A text entry box is displayed next to the drop-down list. Type the queue name into the text entry box.

      If the queue is found on the remote WebSphere MQ system, the properties of the queue as defined within WebSphere MQ are displayed as read-only fields. This should help you to confirm that you have found the queue that you want, and that it is configured as you intend. If the queue is not found, these read-only fields are removed from view.

    2. Specify the reliability level that you require for inbound nonpersistent and inbound persistent messages. Specify the level of reliability to apply when a nonpersistent WebSphere MQ message is received, and when a persistent WebSphere MQ message is received. For information about the available reliability levels, see WebSphere MQ queue points [Settings].
    3. Specify whether you want to include an RFH2 message header when sending messages to WebSphere MQ. The RFH2 header stores messaging information that does not have a corresponding WebSphere MQ message header field. Enable this if messages being sent to WebSphere MQ might reenter the bus.
  8. Click Next.
  9. Click Finish to confirm queue creation.

Results

You have created a queue-type destination with a WebSphere MQ queue point.

What to do next

You are now ready to (optionally) mediate the new destination using the WebSphere MQ queue as the mediation point.



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 Task topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 30, 2013 8:21:57 PM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-express-iseries&topic=tjfp0006_
File name: tjfp0006_.html