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 list box. 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.