Overview

IBM MQ is enterprise messaging middleware – queues, topics, channels. The Automize IBM MQ connector covers send + receive + browse messages on queues + topics via the MQ REST API.

Regions: Self-hosted or IBM Cloud MQ.
Plans: IBM MQ Advanced + Cloud variants.

Setting up the connection

Auth type: HTTP Basic.

MQ admin → MQSC: define a CHL with REST API enabled.
In Automize → Settings → Connectors → IBM MQ. Paste base URL + queue manager + credentials.

Find your credentials at https://www.ibm.com/products/mq.

Rate limits

Bound by MQ hardware/capacity.

Data model

MQ primitives:

    Queue Manager ─┬─ Queues (FIFO + LIFO)
                   ├─ Topics + Subscriptions (pub-sub)
                   └─ Channels (network bridges)

Available operations

17 operations available. Click any row to jump to its detail.

Operation	Category	What it does
Browse Message	General	Browse a message without removing it
Create Queue	General	Create a new queue
Create Topic	General	Create a new topic
Delete Queue	General	Delete a queue
Delete Topic	General	Delete a topic
Get Channel	General	Get channel details
Get Queue	General	Get queue details
Get Queue Manager	General	Get queue manager details
Get Topic	General	Get topic details
List Channels	General	List channels
List Queue Managers	General	List all queue managers
List Queues	General	List queues in a queue manager
List Subscriptions	General	List subscriptions
List Topics	General	List topics
Publish Message	General	Publish a message to a topic
Receive Message	General	Receive and remove a message from a queue
Send Message	General	Send a message to a queue

Operations

Browse Message

Browse a message without removing it

Parameter	Required	Type	Description
Qmgr Name `qmgr_name`	Yes	text
Queue Name `queue_name`	Yes	text

Create Queue

Create a new queue

Parameter	Required	Type	Description
Qmgr Name `qmgr_name`	Yes	text

Create Topic

Create a new topic

Parameter	Required	Type	Description
Qmgr Name `qmgr_name`	Yes	text

Delete Queue

Delete a queue

Parameter	Required	Type	Description
Qmgr Name `qmgr_name`	Yes	text
Queue Name `queue_name`	Yes	text

Delete Topic

Delete a topic

Parameter	Required	Type	Description
Qmgr Name `qmgr_name`	Yes	text
Topic Name `topic_name`	Yes	text

Get Channel

Get channel details

Parameter	Required	Type	Description
Qmgr Name `qmgr_name`	Yes	text
Channel Name `channel_name`	Yes	text

Get Queue

Get queue details

Parameter	Required	Type	Description
Qmgr Name `qmgr_name`	Yes	text
Queue Name `queue_name`	Yes	text

Get Queue Manager

Get queue manager details

Parameter	Required	Type	Description
Qmgr Name `qmgr_name`	Yes	text

Get Topic

Get topic details

Parameter	Required	Type	Description
Qmgr Name `qmgr_name`	Yes	text
Topic Name `topic_name`	Yes	text

List Channels

List channels

Parameter	Required	Type	Description
Qmgr Name `qmgr_name`	Yes	text

List Queue Managers

List all queue managers

No input parameters.

List Queues

List queues in a queue manager

Parameter	Required	Type	Description
Qmgr Name `qmgr_name`	Yes	text

List Subscriptions

List subscriptions

Parameter	Required	Type	Description
Qmgr Name `qmgr_name`	Yes	text

List Topics

List topics

Parameter	Required	Type	Description
Qmgr Name `qmgr_name`	Yes	text

Publish Message

Publish a message to a topic

Parameter	Required	Type	Description
Qmgr Name `qmgr_name`	Yes	text
Topic String `topic_string`	Yes	text

Receive Message

Receive and remove a message from a queue

Parameter	Required	Type	Description
Qmgr Name `qmgr_name`	Yes	text
Queue Name `queue_name`	Yes	text

Tips

Destructive read – pops from queue.

Send Message

Send a message to a queue

Parameter	Required	Type	Description
Qmgr Name `qmgr_name`	Yes	text
Queue Name `queue_name`	Yes	text