Help Center/ ROMA Connect/ User Guide(new)/ Connectors/ Message Systems/ IBM MQ
Updated on 2025-05-08 GMT+08:00
View PDF
Share

IBM MQ

IBM MQ is a message queue software for asynchronous communication in a distributed system to secure reliable data transmission between applications, platforms, and systems. It serves as a middleware and prevents message loss, duplication, or disorder during transmission, and converts and formats data between different systems.

Constraints

When sending messages to IBM MQ in topic mode, create a subscription accordingly. If no topic string is specified in the message sending configuration, the subscription can be created without a topic string. However, if a topic string is provided in the configuration, it must also be specified when creating the subscription.

Creating an IBM MQ Connection

  1. Log in to the new ROMA Connect console.
  2. In the navigation pane on the left, choose Connector. On the page displayed, click New Connection.
  3. Select the IBM MQ connector.
  4. In the dialog box displayed, configure the connector and click OK.

    Parameter

    Description

    Name

    Enter the connector instance name.

    IP Address

    Enter the IP address of the IBM MQ host.

    Port

    Enter the IBM MQ host port number, typically 1414.

    Queue Mananger

    A system management program that provides queue services, APIs, and queue management services. For example, QM1.

    CCSID

    The CCSID in IBM MQ specifies the character encoding of message content. It is a numeric value representing a specific encoding scheme—for example, CCSID 1208 denotes UTF-8 encoding. CCSIDs ensure proper interpretation and conversion of character data across systems. For common CCSIDs and their corresponding encodings, see Table 1

    Channel Name

    Channel for transferring messages between queue managers in the MQ system. For example, DEV.ADMIN.SVRCONN.

    Username

    User name for connecting to the IBM MQ.

    Password

    User password for connecting to the IBM MQ.

    SSL Enable

    Whether to use SSL authentication when connecting to the IBM MQ.

    • True
    • False

    Cipher Suite

    Mandatory when SSL Enable is set to True.

    Enter the cipher suite.

    Currently, SSL authentication cannot be enabled.

    Trust Store

    Mandatory when SSL Enable is set to True.

    Enter the Base64-encoded trust store file.

    Trust Store Password

    Mandatory when SSL Enable is set to True.

    Enter the password of the trust store.

    Description

    Enter the description of the connector to identify it.

Action

Sending messages

Configuration Parameters

Table 1 Sending messages

Parameter

Description

Destination Object Type

Select the destination object type.

  • Topic
  • Queue

Destination Object Name

Enter the topic/queue name of the destination object.

Topic String

Enter a topic string (required only when the destination is a topic).

MessageID

(Optional) Enter a message ID. If this parameter is not specified, the system generates one using a UUID.

CorrelationID

(Optional) Enter a correlation ID. If this parameter is not specified, the system generates one using a UUID.

Content

Enter the message content.

After configuring the IBM MQ trigger or connector, you can select the MessageID, CorrelationID, and Payload fields from IBM MQ as variables in subsequent nodes. MessageID corresponds to the consumed message's message_id, CorrelationID to its correlation_id, and Payload to the message content.

Parent topic: Message Systems