--- title: "IBM MQ Message Services" slug: "ibmmq" description: "This document explains how to set up and configure IBM MQ Message Services in Decisions. By integrating with IBM MQ, Decisions is able to take in data from a message and convert it into any other type of data for use in processing. " updated: 2025-10-27T19:04:27Z published: 2025-10-27T19:04:27Z --- > ## Documentation Index > Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt > Use this file to discover all available pages before exploring further. # IBM MQ Message Services ## Overview **IBM Message Queue (IBM MQ)** is an enterprise-grade messaging system for application-to-application communication. This module allows Decisions to set up and configure a connection to the server host for the message queue. The module does not include any steps; however, the default messaging steps found under **Messaging Queues** can be used to send messages to the queue. ### Prerequisites The following is required before integration with IBM MQ can occur: - A preexisting [IBM MQ Account](https://www.ibm.com/docs/en/ibm-mq/8.0?topic=server-configure-mq-accounts). - Proper installation and setup of an IBM MQ application. - [IBM WebSphere MQ](https://www.ibm.com/docs/en/ibm-mq/8.0?topic=together-using-websphere-application-server-mq) Explorer configured - Create a [project dependency](https://documentation.decisions.com/v9/docs/project-dependencies). For more information on how to install Modules in Decisions, see: [Installing Modules.](https://documentation.decisions.com/v9/docs/installing-modules-decisions) ### Considerations Note for Third-Party Systems and SubscriptionsCustomers are responsible for securing and maintaining accounts with third-party systems and subscriptions. --- ## Installing IBM MQ Locally The following section covers the setup and configuration of a broker/message queue and is intended to serve as an example resource to integrate with Decisions. The example highlights the values needed to connect a message queue to Decisions and is meant for informational and troubleshooting purposes. Please refer to the product's official documentation for a more in-depth and detailed guide on configuring a message queue for use in production environments. IBM MQ can be hosted on the cloud, in a container, or installed locally. The following section will cover how to install IBM MQ locally and integrate a message queue with Decisions. 1. Download the [install file](https://developer.ibm.com/tutorials/mq-connect-app-queue-manager-windows/). 2. Unzip and locate Setup.exe under the MQServer folder. Run the executable.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1666720106443.png) 3. Run through the installer using default settings. Select Typical and proceed with the install.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1666720213411.png) ### Creating a queue manager Once IBM MQ has finished installing, a queue manager will need to be created. 1. In an administrative command prompt, navigate to the bin folder for MQ. ```shell cd "C:\Program Files\IBM\MQ\bin" ``` 2. Then enter the following command to create a queue manager. Substitute QueueManagerName with a name for the queue manager, for example, QM1. ```shell crtmqm [QueueManagerName] ``` 3. Enter the following to start the queue manager. ```shell strmqm [QueueManagerName] ``` ### Creating a queue To create a queue locally: 1. Enable MQSC commands by entering the following in the command prompt ```shell runmqsc [QueueManagerName] ``` 2. Enter the following command to create a queue with default IBM MQ objects, substituting QueueName with the queue's name.  ```shell define qlocal (QueueName) ``` --- ## IBM MQ Settings 1. Navigate to **System > Settings**. Right-click on **IBM MQ Settings** and select **Edit**.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-07-31_09h58_55.png) | Setting | Description | | --- | --- | | Default Host Name | The hostname or IP address for the server hosting the message broker | | Default Port | The port number used by the message broker. By default, this is port 1414 | | Default Queue Manager | Specifies the Queue Manager used by the message queue. A Queue manager ensures that the message will be routed to the correct queue. | | Default Channel | Specifies the default channel for moving messages to and from the queue. | | Default User Name | Specifies the default user login to the broker | --- ## Adding an IBM Message Queue To subscribe to an IBM Message Queue: 1. Navigate to**Jobs and Events****> Message Queues.** 2. From here, select the **ADD IBM Message Queue**action. A dialog box will appear where queue settings can be defined. The Override settings are optional and are used to specify a server configuration not defined under IBM MQ Settings.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/2024-07-31_09h59_43.png) | Setting | Description | | --- | --- | | Display Name | The name of the queue as it appears in Decisions | | Queue | The name of the IBM Message Queue that is being configured/connected to. This name will be applied to the queue in IBM. | | Override Host Name | Optional setting that overrides the specified hostname or IP address of the message broker. | | Override Port | Optional setting that overrides the port number used by the message queue. | | Override Queue Manager | Optional setting that overrides the Queue Manager used by the message queue. | | Override Channel | Optional setting that overrides the default channel used for moving messages to and from the queue. | | Override User Name | Optional setting to specify the default user name used to connect to the queue. | | Override Password | Optional setting to specify the default password for the account used to connect to the queue. | --- ## Feature Changes | Description | Version | Developer Task | | --- | --- | --- | | A hidden Module called Decisions.MessageQueues Module will be downloaded automatically when any message queue Module is installed. | 9.0 | [DT-039289] |