MQ Connectivity

Edit online

IBM® IoT MessageSight can receive messages that are published to IBM IoT MessageSight topics, or sent to IBM IoT MessageSight queues and can forward the messages to IBM MQ queues or topics. IBM IoT MessageSight can also receive messages that are published to IBM MQ topics, or sent to IBM MQ queues, and can forward the messages to IBM IoT MessageSight topics or queues.

To connect IBM IoT MessageSight to IBM MQ, you must set up IBM MQ, start the MQ Connectivity process on IBM IoT MessageSight, and create queue manager connections and destination mapping rules:
  1. Define a server connection channel on IBM MQ. IBM IoT MessageSight uses this server connection channel to connect to the IBM MQ queue manager.
    You can use an existing server connection channel, but a new channel provides the following benefits:
    • Active IBM IoT MessageSight channels can be easily identified on the IBM MQ queue manager.
    • The connection between IBM IoT MessageSight and IBM MQ can be explicitly secured.
    • CHLAUTH record can be created to map the user ID of the IBM IoT MessageSight requests to an appropriate user ID on the IBM MQ system.
    For more information about configuring IBM MQ server connection channels, see Configuring the IBM MQ server connection channel.
  2. Start the MQ Connectivity process on IBM IoT MessageSight.

    For more information about starting the MQ Connectivity process, see Starting, restarting, stopping, and viewing the status of MQ Connectivity.

  3. Define a queue manager connection on the IBM IoT MessageSight system.

    A queue manager connection specifies the connection details for a IBM MQ queue manager. Queue manager connections are then used in destination mapping rules to specify the location of the IBM MQ topic or queue.

    You must define a connection for each queue manager that IBM IoT MessageSight connects to.

    For more information about configuring queue manager connections, see Configuring queue manager connections.

  4. Define destination mapping rules on the IBM IoT MessageSight system.

    A destination mapping rule makes connections between queues, topics, and topic subtrees on IBM IoT MessageSight and IBM MQ. The rules can flow messages from IBM IoT MessageSight to IBM MQ, or from IBM MQ to IBM IoT MessageSight.

    You can apply multiple destination mapping rules to a queue manager connection. Each rule starts an instance of the server connection channel on the queue manager that is defined in the queue manager connection. You can apply destination mapping rules to more than one queue manager to distribute messages between the queue managers.

    For more information about configuring destination mapping rules, see Configuring destination mapping rules.

Note: When IBM IoT MessageSight connects to IBM MQ queue managers, it automatically creates queues on the queue manager. These queues have names that start with SYSTEM.IMA. Do not edit or delete these queues.

IBM IoT MessageSight can be used with all supported IBM MQ platforms from IBM MQ version 7.1 onwards. At IBM MQ version 8.0, ensure that Fix Pack 1 is applied, and that your environment is at version 8.0.0.1, or higher.