Creating a new IBM MQ link

A IBM MQ link provides a server to server channel connection between a service integration bus and a IBM MQ queue manager or queue-sharing group, which acts as the gateway to the IBM MQ network. Use the foreign bus connection wizard to create a foreign bus and link it to the IBM MQ network through a WebSphere® MQ link.

Before you begin

Decide which method to use to configure these resources. You can create a new IBM MQ link by using the administrative console as described in this task, or you can create a new IBM MQ link by using the wsadmin tool.

The following resources must be defined in WebSphere Application Server:
  • A service integration bus that you want to connect from (known as the local bus) with at least one bus member.
The following resources must be defined in IBM MQ:
  • A queue manager or queue-sharing group, which acts as the gateway to the IBM MQ network.
  • A listener that is configured and running.
  • (optionally) A sender channel to receive messages on the local bus, a receiver channel to send messages from the local bus, or both.
  • (For publish-subscribe messaging) A topic and input queue for broker publish-subscribe flow.

About this task

You use the foreign bus connection wizard to connect a bus and a IBM MQ network. You can configure the connection for either point-to-point or publish-subscribe messaging.

Specifically, the wizard helps you configure the following resources:
  • The bus and messaging engine on which the IBM MQ link is defined.
  • The foreign bus that represents the IBM MQ network.
  • The IBM MQ link.
  • (Optionally) The sender and receiver channels and protocol. Using the wizard you can choose to define no channels (and add them afterward), or one channel if your IBM MQ link is to be one-way, or both channels.
  • (Optionally) Security for messages flowing across the link.
  • (Optionally) A publish/subscribe broker profile and associated topic mappings, to allow publication and subscription with a broker in the IBM MQ network.

The wizard does not ask you to set all possible properties of a IBM MQ link, and many of the properties are set to default values. You can fine tune these properties afterward if necessary, by modifying the IBM MQ link.

For a sample configuration showing a systems view of the setup for a IBM MQ link, see IBM MQ link sample configuration.

Procedure

  1. Use the foreign bus connection wizard to connect a bus and a IBM MQ network to use point-to-point messaging or publish-subscribe messaging.

    A IBM MQ link is created and configured as part of the action of the wizard.

    Note: You can subsequently convert a point-to-point connection to a publish/subscribe connection, by adding a publish/subscribe broker on the IBM MQ link for the connection.
  2. Optional: Modify the new IBM MQ link.
    When you create a new IBM MQ link, the following properties are set to default values:
    • Description
    • Adoptable
    • Exception destination
    • Initial state
    • Nonpersistent message speed
    You can fine tune these properties by modifying the link.
  3. Optional: Add or modify the IBM MQ receiver channel.
    If you did not choose to Enable Service integration bus to IBM MQ message flow in the foreign bus connection wizard, you have not yet defined a IBM MQ receiver channel. If you did choose this option in the wizard, you have defined the receiver channel name, host name and communication port, and the wizard has used default values for the following properties:
    • Inbound nonpersistent message reliability
    • Inbound persistent message reliability
    • Prefer queue points local to this link's messaging engine
    • Initial state
    You can fine tune these properties by modifying the channel.
  4. Optional: Add or modify the IBM MQ sender channel
    If you did not choose to Enable IBM MQ to Service integration bus message flow in the foreign bus connection wizard, you have not yet defined a IBM MQ sender channel. If you did choose this option in the wizard, you have defined the sender channel name, host name, communication port and transport chain, and the wizard has used default values for the following properties:
    • Disconnect interval
    • Short retry count
    • Short retry interval
    • Long retry count
    • Long retry interval
    • Initial state
    You can fine tune these properties by modifying the channel.

Icon that indicates the type of topic Task topic



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