Skip to main content

Setup Guide

This guide walks you through setting up an IBM MQ queue manager and creating the queues and topics required to use the IBM MQ connector.

Prerequisites​

Step 1: Start an IBM MQ queue manager​

If using Docker, start a queue manager with the following command:

docker run --env LICENSE=accept --env MQ_QMGR_NAME=QM1 \
  --publish 1414:1414 --publish 9443:9443 \
  icr.io/ibm-messaging/mq:latest

This starts a queue manager named QM1 with the default developer configuration, which pre-creates a server connection channel (DEV.APP.SVRCONN), queues (DEV.QUEUE.1, DEV.QUEUE.2, DEV.QUEUE.3), and a topic (DEV.BASE.TOPIC).

warning

The default developer configuration creates a user app with password password for application connections. These credentials are publicly known — rotate them before using this instance in any shared or non-local environment.

Step 2: Create a queue​

  1. Access the IBM MQ console at https://localhost:9443/ibmmq/console in your browser.

  2. Select the Create a queue link.

    Create a queue

  3. Choose your desired queue type.

    Select queue type

Step 3: Create a topic​

  1. Select the Manage link in the sidebar.

    Select manage

  2. Navigate to the Events tab.

    Navigate to events tab

  3. Select Create and fill in the topic details.

    Create topic

Step 4: Note your connection details​

Collect the following details for configuring the connector:

FieldDefault value
Queue manager nameQM1
Hostlocalhost
Port1414
ChannelDEV.APP.SVRCONN
User IDapp
Passwordpassword