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
- Start the administrative console.
- Navigate to the list of destinations for the appropriate
bus. Click bus_name
- Click New. The
create new destination panel is displayed.
- Select Queue as the destination
type, then click Next. The
create a new queue wizard is displayed.
- 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.
- 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.
- Set the WebSphere MQ
queue point attributes:
- 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.
- 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].
- 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.
- Click Next.
- Click Finish to confirm queue creation.
Results
You have created a queue-type destination with a WebSphere MQ queue point.