配置队列管理器连接
要将 IBM® IoT MessageSight 连接到 IBM MQ 队列管理器，必须创建队列管理器连接。每个队列管理器连接指定了一个队列管理器的连接详细信息。
您可以使用 IBM IoT MessageSight Web UI 或 REST 管理 API 来创建、编辑或删除队列管理器连接。
创建队列管理器连接时，必须指定以下组件：
- 名称
- 该名称指定用于标识队列管理器连接的标签。
- 名称不得包含开头空格或结尾空格，并不能包含控制字符、逗号、双引号、反斜杠或等号。第一个字符不得是数字或以下任意特殊字符：
! # $ % & ' ( ) * + - . / : ; < > ? @
- 队列管理器
- 指定要连接到的一个 IBM MQ 队列管理器。
- 该名称必须匹配 IBM MQ 上的队列管理器的名称，并且区分大小写。
- 连接名称
- 连接名称指定队列管理器的连接详细信息。连接名称包含 IBM MQ 服务器的 IP 地址或主机名以及（可选）端口号。如果未指定端口号，将使用缺省值 144。对于多实例队列管理器，可以通过在逗号分隔列表中输入 IP 地址或主机名来指定多个 IBM MQ 服务器。
- 对于有端口号的连接名称，您必须在括号中指定端口号。例如：10.0.0.127(1415)
- 通道名称
- 通道名称指定用于队列管理器连接的 IBM MQ 服务器连接通道。必须在 IBM MQ 中定义服务器连接通道。
- 指定的名称必须匹配 IBM MQ 中为队列管理器连接中所使用队列管理器定义的服务器连接通道的名称。请参阅配置 IBM MQ 服务器连接通道。
您还可以指定以下组件：
- SSL 密码规范
- SSL 密码规范指定 IBM IoT MessageSight 用于连接到 IBM MQ 的 SSL 密码规范。
- 指定的密码规范必须匹配 IBM MQ 中为队列管理器连接中所使用队列管理器定义的密码规范。
- 通道用户名
- 指定为认证 IBM MQ 连接通道而提供的用户名。
- 名称的最大长度为 1024 个字符。
- 如果指定了通道用户名，那么还必须指定通道用户密码。
- 通道用户密码
- 指定为认证 IBM MQ 连接通道而提供的密码
- 密码的最大长度为 256 个字符。
- 如果指定了通道用户名，那么必须指定通道用户密码。
- MQ SSL 密钥
- 指定密钥数据库文件的名称。
- MQ 隐藏密码
- 指定密码隐藏文件的名称。
有关使用 IBM IoT MessageSight Web UI 来配置队列管理器连接的更多信息，请参阅使用 IBM IoT MessageSight Web UI 来配置队列管理器连接。
有关使用 REST 管理 API 来配置队列管理器连接的更多信息，请参阅使用 REST 管理 API 来配置队列管理器连接。
删除具有未完成的事务的队列管理器连接
IBM IoT MessageSight 使用两阶段落实事务性协议来确保消息以可靠方式传输并且无重复。因此，如果 IBM IoT MessageSight 或 IBM MQ 突然停止，那么在系统上可能存在未完成的事务。重新建立通信并完成此事务时，IBM IoT MessageSight 会自动检测此情况。
如果您尝试删除具有未完成事务的队列管理器连接，那么 IBM IoT MessageSight 会通知您存在未完成的事务。请确保相关队列管理器正在运行，以便 IBM IoT MessageSight 可以连接到该队列管理器并解决此事务。如果无法重新建立与该队列管理器的联系，那么可以强制删除该队列管理器连接。删除队列管理器连接时，会回滚未完成的事务。
