# 配置IBM MQ连接器
IBM MQ是IBM提供的一个消息队列软件，它可以在分布式系统中进行异步通信，确保数据的可靠传输。MQ是一种基于消息的中间件，它提供了一种可靠、安全的方式来传输消息，可以在不同的应用程序、平台和系统之间进行通信。MQ可以确保消息在传输过程中不会丢失、重复或失序，并且可以在不同的系统之间进行数据转换和格式化。
#### 约束与限制
使用主题模式向IBM MQ发送消息时，需要在IBM MQ上创建预定。如果发送消息的配置页面上未填写主题字符串，则创建预定时也不需要填写主题字符串；如果发送消息的配置页面上填写了主题字符串，那么在创建预定时也需要填写主题字符串。
#### 创建IBM MQ连接
1. 登录[ROMA Connect控制台](https://console.huaweicloud.com/roma3)。
2. 在左侧导航栏选择"连接器"，在连接器页面单击"新建连接"。
3. 选择"IBM MQ"连接器。
4. 在弹窗中配置连接器信息，完成后单击"确定"。
   
   | 参数      | 说明                                                                                                                                                                                                                                                                     |
   |:---|:---|
   | 连接名称       | 填写连接器实例名称。                                                                                                                                                                                                                                                             |
   | 主机IP地址   | 填写IBM MQ主机的IP地址。                                                                                                                                                                                                                                                     |
   | 端口         | 填写IBM MQ主机的端口，通常为1414。                                                                                                                                                                                                                                                |
   | 队列管理器   | 提供队列服务和API及用于管理队列的管理功能的系统管理程序。例如"QM1"。                                                                                                                                                                                                                                  |
   | 字符集标识      | IBM MQ的CCSID(Coded Character Set Identifier，编码字符集标识符)用于指定消息内容的字符编码。CCSID 是一个数字值，代表特定的字符编码方案。例如1208，表示字符编码为UTF-8。常见的 CCSID 及其对应的字符编码见[表1 IBM MQ常见的 CCSID 及其对应的字符编码](https://support.huaweicloud.com/usermanual-roma/roma_03_5091.html#roma_03_5091__table1394574823011)。 |
   | 通道名称      | 通道是MQ系统中队列管理器之间传递消息的管道。例如"DEV.ADMIN.SVRCONN"。                                                                                                                                                                                                                         |
   | 用户名      | 连接IBM MQ的用户名。                                                                                                                                                                                                                                                           |
   | 密码        | 连接IBM MQ的用户密码。                                                                                                                                                                                                                                                        |
   | 是否开启SSL认证 | 连接IBM MQ时是否使用SSL认证。 - 是  - 否          |
   | 密钥算法套件     | **仅当"是否开启SSL认证"选择"是"时需要配置**。 填写密钥算法套件。 暂不支持开启SSL认证。                                                                                                                             |
   | 公钥库文件     | **仅当"是否开启SSL认证"选择"是"时需要配置**。 填写经过base64编码的公钥库文件内容。                                                                                                                                                                         |
   | 公钥库密码     | **仅当"是否开启SSL认证"选择"是"时需要配置**。 填写公钥库密码。                                                                                                                                                                                   |
   | 描述       | 填写连接器的描述信息，用于识别不同的连接器。                                                                                                                                                                                                                                                |
      
   
 
#### 支持的动作
发送消息
#### 配置参数
表1发送消息 
| 参数             | 说明                                                                                                                                                                                      |
|:---|:---|
| 目标对象类型        | 选择目标对象类型。 - 主题  - 队列   |
| 目标对象名称       | 填写目标对象的主题/队列名称。                                                                                                                                                                       |
| 主题字符串         | 填写主题字符串。非必填项。仅支持目标对象为主题的场景。                                                                                                                                                           |
| MessageID       | 填写MessageID。非必填项。如果未填，系统会使用UUID生成MessageID。                                                                                                                                               |
| CorrelationID | 填写CorrelationID。非必填项。如果未填，系统会使用UUID生成CorrelationID。                                                                                                                                      |
| 消息内容          | 填写消息内容                                                                                                                                                                                |
   
在IBM MQ的触发器或者连接器配置完成后，后继节点在进行变量点选时支持选择IBM MQ的MessageID、CorrelationID和Payload等字段。其中，MessageID字段对应的值为当前消费的消息的message_id，CorrelationID字段对应的值为当前消费的消息的correlation_id，Payload字段对应的值为消息内容。
![](https://support.huaweicloud.com/usermanual-roma/zh-cn_image_0000002500960372.png "点击放大")
