You can use the administrative console to create a queue-type destination
and assign it to a IBM MQ queue.
Select the IBM MQ
server to host the queue, then specify the IBM MQ queue
to be hosted.
Before you begin
Get the name of the
IBM MQ queue
from your administrator, and ensure that the following configuration is established:
Note: A shareable queue can be accessed by more than one service integration
application.
Decide which method to use to configure these resources. You
can create a bus destination by using the administrative console as described
in this task, or by using the createSIBDestinations command.
About this task
After you have added a
IBM MQ server as a bus member,
you can create a queue-type destination on the bus member that uses a
IBM MQ queue as a queue point.
This configuration enables service integration applications to send messages
to and receive messages from that queue.
Procedure
- Start the administrative console.
- Navigate to the list of destinations for the appropriate bus.
Click .
The Destinations [Collection] form is
displayed.
- Click New. The "Create
a 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 IBM MQ queue, and
(optionally) a description of the queue.
- Assign the queue to the bus member that is to store and process
the messages for the queue.
Select a IBM MQ server bus member from
the list of available bus members.
- Set the IBM MQ queue point attributes:
- Specify a value in the IBM MQ queue
name filter field, then click Go.
The wizard automatically discovers available IBM MQ queues. However, some IBM MQ topologies have many thousands of queues defined to a queue manager. Use this filter to limit the number of queues that are listed.
The default filter value is an asterisk (*). If this value (or no value) is set then all queues, or all queues of a specific type (based on any queue type custom property that is set), are listed. Any other value that you specify must meet the following criteria:- It must contain between 1 and 48 characters.
- It must conform to the IBM MQ queue naming rules (see the Rules for
naming IBM MQ objects topic in the IBM MQ information
center).
You can also use the wildcard character (*) with other text. For example, if you enter a value of PAYROLL*, then all available queues with names that start with PAYROLL are displayed.
- Specify a IBM MQ queue
name.
Select a queue name from the filtered 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 IBM MQ system, the properties of the queue as defined within IBM 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 levels that you require when inbound
nonpersistent and inbound persistent IBM MQ messages
are converted to service integration format messages.
Applications receive messages direct from the specified IBM MQ queue, so in general the reliability level for a message is of no interest to the receiver because the message has already been delivered successfully. However, the message is converted to a service integration format message (and typically to a JMS format service integration message) as it is received, and this option specifies the reliability level for the service integration format message. For information about the available reliability levels, see IBM MQ queue points [Settings].
- Specify whether you want IBM MQ to
include an MQRFH2 message header when sending messages to the queue.
The MQRFH2 header stores service integration messaging information that does not have a corresponding IBM MQ message header field. When a message is sent to the destination, service integration instructs IBM MQ to write the message to the queue. This option specifies whether service integration instructs IBM MQ to write the message with an MQRFH2 header.
If the consumer of the message is a JMS application running in IBM MQ or service integration, or a IBM MQ XMS application, or a IBM MQ MQI application that expects an MQRFH2 header, select this option. If the consumer is a IBM MQ MQI application that does not expect an MQRFH2 header, do not select this option.
- Click Next.
- Click Finish to confirm queue creation.
Results
You have created a queue-type destination with a
IBM MQ queue
point.