Creating a queue for point-to-point messaging

You can create a queue, which is a bus destination that represents a message queue and that is used 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, you specify only a minimum set of properties. You can change these properties and configure further properties after you complete this task.

To define a queue, use the administrative console to complete the following steps.

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. A list of any existing bus destinations is displayed.
  4. To create a destination, click New.
    1. On the Create new destination page, ensure that Queue is selected.
    2. Click Next.
    3. In the Identifier field, type the name that you want to give the queue destination for administrative purposes. Restrict the name to 48 characters or less, and restrict its character set to: numerics (0-9), period (.), forward slash (⁄), underscore (_), percent sign (%), uppercase A-Z, lowercase a-z (but there are restrictions on the use of lowercase letters for z/OS® console support). On systems that use EBCDIC Katakana, you cannot use lowercase characters.
  5. Optional: In the Description field, type a description of the destination, for administrative purposes.
  6. Click Next.
  7. On the Assign the queue to a 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.

    If you select a bus member that is a server cluster, you create a queue that is partitioned across the servers in the cluster. In this situation, a queue point is created for each server in the cluster.

  8. Click Next.
  9. Optional: If the bus member is a WebSphere® MQ server, set the WebSphere MQ queue point attributes:
    1. Specify a value in the WebSphere 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.

    2. 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.

    3. 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].
    4. 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.

    5. Click Next.
  10. 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.
  11. Save your changes to the master configuration.

What to do next

You can configure further properties of the queue, for example message reliability settings. See Configuring bus destination properties. If you configure message reliability settings, remember that higher levels of reliability have a greater impact on performance.

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 specific exception destination for messages that cannot be delivered to this queue destination, that exception destination must be defined already. 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 queue for the default messaging provider.


Icon that indicates the type of topic Task topic



Timestamp icon Last updated: March 5, 2017 17:27
File name: tjo0001_.html