Learn how to install IBM MQ for Developers for use with IBM App Connect Enterprise V11, to be able to exploit features of IBM MQ: download and then install IBM MQ, through to testing use of MQ features, all in minutes. This tutorial is based on the use of IBM App Connect Enterprise for Developers.

  • Background: IBM MQ is not a prerequisite for IBM App Connect Enterprise

    On distributed systems, IBM MQ is not a prerequisite for using IBM App Connect Enterprise, which means that you can develop and deploy applications with IBM App Connect Enterprise without needing IBM MQ. However, some IBM App Connect Enterprise features require access to IBM MQ, including the MQ nodes and the event-driven processing nodes that are used for aggregation and timeout flows, message collections, and message sequences. For more information about features that require access to IBM MQ, see Enhanced flexibility in interactions with IBM MQ in the IBM Integration Bus Version 10 product documentation.

    If you choose to use the App Connect Enterprise features that require access to IBM MQ, you can install and use IBM MQ within the terms of the license for IBM App Connect Enterprise.

If you want to try IBM App Connect Enterprise for Developers with self-study labs that require access to IBM MQ, you can install and use IBM MQ Advanced for Developers without charge; for example:

  1. Install IBM MQ Advanced for Developers on the same machine as your integration node/server
  2. Create a queue manager for use with IBM Integration Bus
  3. Create the set of IBM App Connect Enterprise queues on your queue manager
  4. Associate the queue manager with your integration node/server

This tutorial assumes that you have already installed IBM App Connect Enterprise for Developers on Windows, and want to add IBM MQ Advanced for Developers onto the same Windows computer.

Prepare: Download IBM MQ Advanced for Developers

Downloading IBM MQ Advanced for Developers is straightforward, and only needs you to agree to the license and then save the ZIP file (~794 MB) to your computer.

(For the IBM MQ download options, see IBM MQ downloads in the IBM Messaging developer center.)

Result: The software is on your computer, and you are ready to install IBM MQ Advanced for Developers

Step 1: Install IBM MQ Advanced for Developers

Installing IBM MQ Advanced for Developers is little more than to unpack the software.

  • Read a description of installing on Windows

    1. Extract the ZIP file that you downloaded to a directory of your choice

      This creates the subdirectory, \MQServer; for example, C:\AppConnect\MQServer

    2. To start the installation process, run the Setup.exe file in the \MQServer subdirectory.

      For detail about the steps to follow, see Installing and configuring using the graphical user interface in the IBM MQ version 9 product documentation.

      The installation programs contain links to further information if you require it during the installation process. The installation process has five parts:

      1. Use the Launchpad to check and install software requirements, specify network information, and start the IBM MQ installation wizard.
      2. Use the installation wizard to install the software.
      3. Restart your computer for the MQ configuration changes to take effect. On restart, the Prepare IBM MQ wizard is opened to help you configure IBM MQ and perform initial tests.
      4. Use the Prepare IBM MQ wizard to start the IBM MQ service.

Result: You’ve successfully installed IBM MQ for Developers for use with IBM App Connect Enterprise.

Next: You can create a queue manager and define MQ queues. This page describes use of the IBM MQ Explorer, but you can choose to use commands instead. For more information about the different ways to install and configure IBM MQ, see Implementing the solution in the IBM MQ product documentation.

Step 2: Create a queue manager for use with IBM App Connect Enterprise

This step assumes that you want to create a queue manager name with the name QM1. If you choose a different name, remember to use that name for the queue manager if needed in any self-study labs that you try.

  1. Start IBM MQ Explorer as an administrator. For example, right-click the IBM MQ icon in the system tray and then in the context menu click IBM MQ Explorer.
    IBM MQ icon and options on the Windows 10 system tray
  2. In the Navigator view, right-click the Queue Managers folder, then click New > Queue Manager. The Create Queue Manager wizard starts.
  3. In the Queue Manager name field, type QM1.
  4. Select the Make this the default queue manager check box.
  5. In the Dead-letter queue field type SYSTEM.DEAD.LETTER.QUEUE. This is the name of the dead-letter queue that is automatically created when you create the queue manager.
  6. Leave the other fields empty and click Finish, or if that button is disabled, click Next. The Finish button is disabled if the port number conflicts with an existing queue manager. You must continue through the wizard to change the default port number.
  7. If you clicked Next, continue to accept the defaults and click Next on each page until you get to the final page of the wizard, when the Finish button becomes available. Change the specified port number, for example to 1415, and click Finish.

    IBM MQ displays a Creating Queue Manager dialog window while the queue manager is created and started.

These instructions are taken from Create a queue manager, called QM1 by using the IBM MQ Explorer in the IBM MQ product documentation

Result: In IBM MQ, you have created a queue manager, QM1, for use with IBM App Connect Enterprise.

Step 3: (Optional – To use some enterprise capabilities) Create the set of IBM App Connect Enterprise system queues on your queue manager

To use some App Connect Enterprise capabilities that require IBM MQ, you need to create the set of IBM App Connect Enterprise queues on your queue manager. These capabilities include: flow control, aggregation, advanced message processing, and accounting and statistics. For details of the capabilities that require the default system queues, see Installing IBM MQ in the IBM App Connect Enterprise product documentation.

If you want to use some capabilities that require the default system queues, create the set of IBM App Connect Enterprise system queues on your queue manager:

  1. Open the App Connect Enterprise Console; for example, click Start > IBM App Connect Enterprise… > IBM App Connect Enterprise Console…
  2. In the Console window, navigate to the /sample/wmq/ subdirectory of the IBM App Connect Enterprise installation; for example:
    C:\Program Files\IBM\ACE\11.0.0.3\server\sample\wmq
    
  3. Run the following command:
    iib_createqueues.cmd QM1
  4. Optional: If you want to verify that the queues have been created in IBM MQ, you can use the IBM MQ Explorer or runmqsc command (as follows):
    In the App Connect Enterprise Console, run the following commands (responses are shown after each command):

    1. runmqsc
      5724-H72 (C) Copyright IBM Corp. 1994, 2014.
      Starting MQSC for queue manager QM1.
      
    2. display queue(SYSTEM.BROKER*)
           3 : display queue(SYSTEM.BROKER*)
      AMQ8409: Display Queue details.
         QUEUE(SYSTEM.BROKER.ADAPTER.PROCESSED)
         TYPE(QLOCAL)
      AMQ8409: Display Queue details.
         QUEUE(SYSTEM.BROKER.ADMIN.STREAM)       TYPE(QLOCAL)
      ...
      AMQ8409: Display Queue details.
         QUEUE(SYSTEM.BROKER.WS.REPLY)           TYPE(QLOCAL)
      

See Creating the default system queues on a WebSphere MQ queue manager in the IBM App Connect Enterprise product documentation.

Result: You have created the system queues for App Connect Enterprise.

Step 4: (Optional – To use some enterprise capabilities) Associate the queue manager with an integration server or integration node

To use some App Connect Enterprise capabilities that require IBM MQ, you must associate a queue manager with your integration server or integration node. For details of the capabilities that require the default system queues, see Installing IBM MQ in the IBM App Connect Enterprise product documentation.

If you want to use some capabilities that require that you associate a queue manager with your integration server or integration node, set the defaultQueueManager property for the integration server or integration node. For example, using the node.conf.yaml file for an integration node:

  1. Use a YAML editor to open the node.conf.yaml file for the integration node that you want to modify.

    If you do not have access to a YAML editor, you can edit the file by using a plain text editor; however, you must ensure that you do not include any tab characters, which are not accepted in YAML and will cause your integration node configuration to fail. If you choose to use a plain text editor, ensure that you use a YAML validation tool to validate the content of your file.

    For more information about working with YAML, see http://www.yaml.org/start.html.

  2. Set the defaultQueueManager property to the name of the queue manager; for example:
    defaultQueueManager: 'QM1'          # Set non-empty string to specify a default queue manager
    #mqTrustedQueueManager: 'no'        # Set to yes to enable MQ communication as a trusted (fastpath) application
    
  3. Save the node.conf.yaml file.
  4. Restart the integration node. The properties that you set in the node.conf.yaml file take effect when the integration node is started. If you modify these properties again, you must start the integration node again for the latest changes to take effect. For example, in the App Connect Enterprise Console enter commands to stop then start the integration node:
    mqsistop NODEIPL101
    mqsistart NODEIPL101
    

Result: You have associated the queue manager with the integration node.

Join The Discussion

Your email address will not be published. Required fields are marked *