Help Center/ ROMA Connect/ User Guide/ Data Source Management/ Connecting to an IBM MQ Data Source
Updated on 2024-05-07 GMT+08:00

Connecting to an IBM MQ Data Source

Overview

ROMA Connect can use IBM MQ as a data source for data integration tasks. Before using the IBM MQ data source, you need to connect it to ROMA Connect.

Prerequisites

Each connected data source must belong to an integration application. Ensure that an integration application is available before connecting a data source, or create one first.

Procedure

  1. Log in to the ROMA Connect console. On the Instances page, click View Console of an instance.
  2. In the navigation pane on the left, choose Data Sources. In the upper right corner of the page, click Access Data Source.
  3. On the Default tab page, select IBM MQ and click Next.
  4. Configure the data source connection information.
    Table 1 Data source connection information

    Parameter

    Description

    Name

    Enter a data source name. Using naming rules facilitates future search.

    Encoding Format

    Default: utf-8

    Integration Application

    Select the integration application to which the data source belongs.

    Description

    Enter a brief description of the data source.

    Connection Address

    Enter the IP address and port number for connecting the IBM MQ.

    Queue Mananger

    Enter the name of the IBM MQ manager.

    CCSID

    Enter the CCSID of the IBM MQ manager.

    Stream Name

    Enter the stream name for connecting to the IBM MQ manager.

    Username

    Enter the username for connecting to IBM MQ.

    Password

    Enter the password for connecting to IBM MQ.

    SSL Authentication

    Determine whether to use SSL authentication for the connection between ROMA Connect and IBM MQ.

    Cipher Suite

    This parameter is mandatory only if SSL Authentication is set to Enable.

    Enter the name of the cipher suite used in the queue manager stream specified by Stream Name.

    Trust Store

    This parameter is mandatory only if SSL Authentication is set to Enable.

    Enter the trust store used by the client (ROMA Connect) during SSL authentication. It must match the private key used by the server (IBM MQ).

    Trust Store Password

    This parameter is mandatory only if SSL Authentication is set to Enable.

    Enter the password of the trust store.

    The following figure shows an example of data source connection configuration when SSL is enabled. A trust store file needs to be uploaded.

    Figure 1 Example of IBM MQ data source connection configuration
  5. Click Check Connectivity to check the connectivity between ROMA Connect and the data source.
    • If the test result is Data source connected successfully, go to the next step.
    • If the test result is Failed to connect to the data source, check the data source status and connection parameters, and click Recheck until the connection is successful.
  6. Click Create.