跳转到主要内容
IBM MQ 端口通过 REST API 提供对 IBM MQ 队列的访问。

核心功能

  • 通过 IBM MQ REST API 集成实现企业级消息队列功能
  • 支持具有 TLS 加密功能的队列管理器(Queue Manager)连接
  • 支持双向消息处理,并具备可配置的身份验证功能
  • 自动重试逻辑,可配置重试间隔及最大尝试次数

概述

IBM MQ 端口配置有特定的队列,消息可以推送到该队列或从中检索消息。到达端口 交易 选项卡的文件作为消息推送到队列,而从队列中提取的消息作为文件写入 交易 选项卡。每个端口实例只能配置一个队列。

先决条件

要与 IBM MQ 建立连接,用户至少必须具备:
  • 一台 IBM MQ 服务器,以及从 知行之桥 到该服务器的清晰网络路径
  • 至少有一个活动队列的队列管理器
知行软件 不提供创建或配置 IBM MQ 服务器的设置帮助或支持。有关 IBM MQ 服务器设置的疑问,请参阅 IBM MQ 简介 文档。

端口配置

本节包含所有可配置的端口属性。

设置选项卡

设置

与端口核心配置相关的设置。

TLS 设置

与传输安全相关的设置。

客户端身份验证

与针对远程服务进行身份验证相关的设置。

其他设置

未包含在先前类别中的设置。

高级页面

消息

消息设置确定端口如何搜索消息并在处理后管理它们。

注意:以下设置已弃用,默认处于隐藏状态。只有先前已启用这些设置或将其配置为非默认值的端口才会显示它们。若要保留成功处理的文件副本,请在工作流中右键单击该端口,选择显示成功路径,然后将成功路径连接到 File 端口。

设置描述
保存到已发送文件夹(已弃用)将端口处理的文件复制到 Sent 文件夹。默认禁用。保存到 Sent 文件夹中的文件不受静态加密保护。
已发送文件夹方案(已弃用)按所选时间间隔对 Sent 文件夹中的文件进行分组。仅在启用保存到已发送文件夹时适用。

日志

用于管理日志创建和存储的设置。

设置描述
日志级别指定要记录在端口日志目录中的信息类型:
  • None - 不创建任何日志。
  • Error - 仅当端口遇到错误时才创建日志。
  • Warning - 仅当端口发出警告时才创建日志。
  • Info - 记录工作流的一般信息,包括任何错误和警告(如果适用)。
  • Debug - 记录成功和失败工作流的详细调试信息。
  • Trace - 记录成功和失败工作流的详细跟踪信息。
请注意:Debug 和 Trace 级别的日志可能会记录敏感信息,包括消息内容和 SSL 证书。尽管连接属性(例如密码)被屏蔽了,但在与您的组织外部共享它们之前,请查看此级别的日志以避免泄漏敏感信息。
日志文件夹结构指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口,使用子文件夹有助于保持日志的有序性并提高性能。
保留消息副本指示端口在日志目录中保存最新消息副本的切换。请注意,端口每个子文件夹只保留一个消息,并且端口在再次运行时会覆盖以前保存的消息。

其他设置

杂项

特殊设置适用于特定用例。

设置描述
其他设置允许在以分号分隔的列表中配置隐藏的端口设置,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。

自动化选项卡

自动化设置

与端口自动处理文件相关的设置。

性能

与端口资源分配相关的设置。

设置描述
最大工作线程数此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。
最大文件数分配给端口的每个线程发送的最大文件数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。

告警选项卡

SLA 选项卡

建立连接

建立连接需要以下设置:
  • 远程主机
  • 远程端口
  • 队列管理器
  • 队列
如果需要客户端身份验证,还必须设置以下设置:
  • 用户名
  • 密码
使用 测试连接 按钮可以验证与服务器的成功连接。

发送消息

到达端口 交易 选项卡的文件将作为消息推送到配置的队列。文件可以通过直接放置到此文件夹中,也可以从工作流中较早的另一个端口到达此文件夹。 如需将消息推送到多个队列,需要设置多个 IBM MQ 端口。可以使用 Branch 端口 等端口将文件路由到适当的 IBM MQ 端口。

接收消息

可以将 IBM MQ 端口配置为自动轮询远程队列以获取要下载的消息。使用自动化选项卡上的 接收自动化 和 接收 设置。启用后,端口会等待指定的时间间隔,然后尝试从队列中检索消息并将其推送到输出文件夹。 如果 IBM MQ 端口连接到流中的其他端口,下载的消息将自动传递到下一个端口。否则,消息将保留在输出文件夹中。

宏

示例