有什么变化？ IBM MQ 9.2.0

IBM MQ 扩展了可重新发布的 C 客户端软件包，使其包括构建应用程序所需的元素

从 IBM MQ 9.2.0 ， IBM MQ C 可重新发布的客户端软件包包括构建应用程序所需的元素，即头文件和副本。 这简化了应用程序开发过程，因为这意味着您不再需要完全安装 IBM MQ 组件就能开始开发应用程序。 不过，这些软件包中仍未包含示例源代码。

您可以使用 genmqpkg 命令来建立一个定制的软件包，其中包含应用程序所需的文件子集，该命令已得到扩展，现在可以通过编程和交互方式进行重新打包。 这意味着您可以将重建可重新发布的客户端嵌入到自动开发管道中，以便进行后续处理。

有关详细信息，请参阅可再分发客户端和可再分发客户端的安装注意事项。

当 "HOME "设置为无法访问的目录时，改进了错误报告功能

在使用未注册或未安装的 IBM MQ 版本（如可重新分发的客户端）时，队列管理器会创建 ${HOME}/.mqm 目录。 有关详细信息，请参阅可再分发客户端的限制和其他注意事项和 IBM MQ 文件系统权限应用于 /var/mqm。

从 IBM MQ 9.2.0 开始，修改了 IBM MQ 代码，以便在写入 HOME 目录时出现问题时显示更合适的错误信息。 之前导致 SEGV 故障的代码路径也已得到纠正。

减少 XMS.NET 动态链接库的数量

从 IBM MQ 9.2.0 开始， XMS.NET 动态链接库的数量大大减少，总共只有 5 个。

支持 .NET 6 应用程序，使用 IBM MQ classes for .NET Standard 和 IBM MQ classes for XMS .NET Standard

从 IBM MQ 9.2.0, Microsoft.NET Core 3.1 是运行 IBM MQ classes for .NET Standard 和 IBM MQ classes for XMS .NET Standard 所需的最低版本。

从 IBM MQ 9.2.0 Fix Pack 25 开始， IBM MQ 支持 .NET 6 应用程序，使用 IBM MQ classes for .NET Standard 和 IBM MQ classes for XMS .NET Standard。 如果您使用的是 .NET Core 3.1 应用程序，只需在 csproj 文件中稍作编辑，将 targetframeworkversion 设置为 "net6.0" ，即可运行该程序，而无需重新编译。

更多信息，请参阅安装 IBM MQ classes for .NET Standard 和安装 IBM MQ classes for XMS .NET Standard。

更改为 .NET Framework

从 IBM MQ 9.2.0 ，要运行 IBM MQ classes for .NET Framework ，必须安装 Microsoft.NET Framework V4.6.2。 更多信息，请参阅安装 IBM MQ classes for .NET Framework。

更新 IBM MQ 和 Microsoft .NET 映射表，用于 IBM MQ 管理的 .NET 客户端

从 IBM MQ 9.2.0 起， IBM MQ 和 Microsoft .NET 映射表中的 IBM MQ 管理的 .NET 客户端已更新为包括 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 和 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 CipherSpecs。 这一更新意味着客户端向服务器提出了正确的 SSL/TLS 协议版本，这样客户端就可以通过启用 TLS 的通道连接到队列管理器，使用这些 CipherSpecs。 更多信息，请参阅 CipherSpec 受管 .NET 客户端的映射。

自定义应用识别

除了在 Java 或 JMS 客户端应用程序上选择应用程序名称的现有功能外， IBM MQ 9.2.0 还将这一功能扩展到其他编程语言。 更多信息，请参阅在支持的编程语言中指定应用程序名称。

runmqsc START 和 STOP 命令新增 IGNSTATE 参数

通过 IBM MQ 9.2.0 ，可以指定 runmqsc START 和 STOP 命令在启动或停止对象已处于所需状态时的返回代码。 这样就能更轻松地编写 runmqsc 脚本，多次执行后都能得到相同的结果。 IGNSTATE 适用的对象类型有通道、监听器和服务。

有关如何使用此属性的更多信息，请参阅 START CHANNEL 和 STOP CHANNEL。

更改 DISPLAY CONN 命令中 MQCNO_RECONNECT 和 MQCNO_RECONNECT_Q_MGR 的显示值

DISPLAY CONN 命令显示连接到队列管理器的应用程序的连接信息。 显示两个 CONNOPTS 参数选项是 MQCNO_RECONNECT 和 MQCNO_RECONNECT_Q_MGR。

如果使用的是 IBM MQ 9.2.0 或更高版本的客户端，显示的 MQCNO_RECONNECT 和 MQCNO_RECONNECT_Q_MGR 值就是有效的重新连接选项。 如果您使用的是较早版本的客户端，则显示的值将是应用程序指定的值，无论其当前是否生效。

更多信息，请参阅 DISPLAY CONN。

DISPLAY APSTATUS 命令中 APPLNAMECHG 值的名称更改

从 IBM MQ 9.2.0， APPLNAMECHG 的值 IMMREASN 的参数 DISPLAY APSTATUS 命令已重命名为 APPNAMECHG。

DISPLAY APSTATUS 命令中增加了 TYPE 响应

从 IBM MQ 9.2.0 ，MQSC 命令 DISPLAY APSTATUS 显示响应的 TYPE ，其中包括应用程序 (APPL)、本地 (LOCAL) 或队列管理器 (QMGR)。 更多信息，请参阅监控应用程序平衡。

PCF 命令 "查询应用程序状态" (MQCMD_INQUIRE_APPL_STATUS) 也会显示响应类型。 更多信息，请参阅查询申请状态（响应）。

对 DISPLAY CONN 命令的修改

从 IBM MQ 9.2.0 开始， DISPLAY CONN 命令以及相应的 PCF、 REST API 和 IBM MQ Explorer 输出的行为发生了变化。

取消 AMQP 信道上 MCAUSER 用户 ID 的 12 个字符限制 Windows

AMQP 信道有一个 MCAUSER 属性，您可以用它来设置 IBM MQ 用户 ID，所有到该信道的连接都在此 ID 下授权（请参阅信道上的 MCAUSER 设置 ）。 在 Windows 上，在 IBM MQ 9.2.0 之前，MCAUSER 用户 ID 设置只支持长度不超过 12 个字符的用户 ID。 从 IBM MQ 9.2.0 起，取消了 12 个字符的限制。

支持在 CCSID 37 和 500 之间转换

从 IBM MQ 9.2.0 开始，在 IBM MQ Appliance、 Windows、 Linux® 和 macOS 上增加了在 CCSID 37 和 500 之间转换的支持。

统一组群的变化

在 IBM MQ 9.2.0 中，当使用统一群集时，可以防止使用 MQCNO_RECONNECT 连接的应用程序使用动态队列。 某些消息传递模式，尤其是涉及使用动态队列的消息传递模式，可能会在统一群集中造成问题，因为应用程序可能会被要求随时重新连接。 要防止在统一群集中使用动态队列，可为每个队列管理器设置环境变量 AMQ_BLOCK_RECONN_DYN_QUEUES。

在 IBM MQ 9.2.0 中，当使用的绑定类型为 MQOO_BIND_ON_OPEN ，且应用程序已使用连接选项 MQCNO_RECONNECT 或 MQCNO_RECONNECT_Q_MGR 进行连接时，无法在统一集群中打开集群队列进行输出。 在某些情况下，应用程序可能会使用 MQOO_BIND_ON_OPEN，因为它是集群队列的默认选项，但这些应用程序可能并不需要它。 如果是这种情况，而且不需要 MQOO_BIND_ON_OPEN 的消息语义，则应将绑定类型更改为其他绑定选项之一。 通过在应用程序可以连接的所有队列管理器上设置环境变量 AMQ_BIND_ON_OPEN_W_RECONNECT=NEVER，可以为常规集群启用相同的行为。 如果希望将 BIND_ON_OPEN 与 MQCNO_RECONNECT 或 MQCNO_RECONNECT_Q_MGR 选项结合使用，请在所有队列管理器上设置环境变量 AMQ_BIND_ON_OPEN_W_RECONNECT=ALLOW

更改为抑制因初始通信流出错而产生的 FFST

从 IBM MQ 9.2.0 开始，在初始通信流上报告错误信息时捕获 FFST AMQ9207E 默认情况下，在初始通信流上报告错误信息时会抑制捕获 FFST。 更多信息，请参阅环境变量说明。

将 Eclipse 改为 IBM MQ Explorer

从 IBM MQ 9.2.0, IBM MQ Explorer 建立在 Eclipse 4.15 上。

对单机版更新交付机制的修改 IBM MQ Explorer

从 IBM MQ 9.2.0 ，单机版 IBM MQ Explorer ，以前称为 SupportPac MS0T ，可作为单机版应用程序从 Fix Central. SupportPac MS0T 已无法从 IBM 下载。 有关如何安装单机版 IBM MQ Explorer 的信息，请参阅 Linux 和 Windows 上的作为单机版应用程序安装和卸载 IBM MQ Explorer 。

减少默认对象的数量

从 IBM MQ 9.2.0 开始，默认对象的数量减少了一个，从 84 个减至 83 个。 这是因为 MQ Light 网络控制台删除了以前使用的 SYSTEM.MESSAGE.ASSOCIATION.QUEUE。 IBM MQ 中不再提供控制台，因此默认对象已被删除。

将统一集群迁移到 IBM MQ 9.1.5 或更高版本

当您将统一群集从 IBM MQ 9.1.4 迁移到 IBM MQ 9.1.5 或更高版本时，需要注意某些限制。 更多信息，请参阅统一群集的限制和注意事项。

crtmqpkg 命令的附加 InstallPATH 选项

从 IBM MQ 9.2.0 ，使用 crtmqpkg 命令安装维护更新时，可以使用附加选项 InstallPATH。 更新会直接安装到 InstallPATH 指定的目录中。 更多信息，请参阅多重 IBM MQ 安装。

在 IBM MQ 9.2.0 Fix Pack 2 中， InstallPATH 选项也可与 crtmqfp 命令一起使用。 更多信息，请参阅使用 RPM 在 Linux 上应用维护级别更新。

复制数据队列管理器 (RDQM) 安装包的更改

IBM MQ 9.2.0 引入了 支持以及 RDQM 的 支持。 RHEL8 RHEL7 RHEL8 版本安装 Pacemaker 2， RHEL7 版本安装 Pacemaker 1。 现在，您可以手动安装 RDQM 和相关软件包，而无需运行安装脚本。 请参阅安装 RDQM（复制数据队列管理器）。

更多信息，请参阅 Linux 系统的硬件和软件要求。

fteStartAgent 命令返回的新返回代码

在 IBM MQ 9.2.0 之前， fteStartAgent 命令成功返回 0，失败返回 1。 从 IBM MQ 9.2.0 开始， fteStartAgent 命令可返回四个附加代码，用于指示故障的性质。 更多信息，请参阅 fteStartAgent: 启动 MFT 代理。

RecoveryTimedOut MFT 代理的新转移状态

从 IBM MQ 9.2.0 ，如果为传输设置了传输恢复超时，则源代理会在传输恢复超时时将传输转入 RecoveryTimedOut 状态。 传输重新同步后，目的地代理会删除传输过程中创建的任何部件文件，并向源代理发送完成信息。

更多信息，请参阅传输恢复超时概念和 MFT 代理传输状态。

更改 MFT 资源监控器启动轮询的方式

在 IBM MQ 9.2.0 之前，如果资源监视器执行的轮询时间超过轮询时间间隔，则当前轮询结束后立即开始下一次轮询，中间没有间隔。 如果第一次轮询时发现的项目在第二次轮询时仍然存在，这可能会导致性能问题，因为这可能会影响资源监控程序向代理提交工作的速度。

从 IBM MQ 9.2.0 开始，资源监视器启动轮询的方式发生了变化，现在资源监视器使用 ScheduledExecutorService ，只有在上一次轮询结束加上配置的轮询间隔时间后才启动下一次轮询。 这就意味着，如果轮询时间长于轮询间隔，轮询间隔之间将始终有一个间隙，而不是在上一次轮询后直接开始另一次轮询。

更多信息，请参阅 MFT 资源监控概念。

Java EE 数据库记录仪使用 WebSphere Application Server 9.0

从 IBM MQ 9.2.0 开始， Java EE 数据库记录器使用 WebSphere® Application Server 9.0。

更多信息，请参阅安装 Java EE 数据库日志程序 MFT 。

改善队列管理器关闭时间的性能

更改触发监控器关闭代码

从 IBM MQ 9.2.0 开始，当队列管理器结束时，触发器监控器或客户端触发器监控器的正常关闭会返回 0 而不是 10 的代码。

更多信息，请参阅 runmqtmc 和 runmqtrm。

endmqm 命令的目标关机时间选项

从 IBM MQ 9.2.0 ，您可以选择在指定的目标时间（秒数）内结束队列管理器。

更多信息，请参阅停止队列管理器和 endmqm。

从 ibm-mq-total-browse-size 响应头中移除 messaging REST API

从 IBM MQ 9.2.0 开始，使用 messaging REST API 浏览队列中的信息列表时，不再返回响应标头 ibm-mq-total-browse-size 。 也就是说，当您向 /messaging/qmgr/{qmgrName}/queue/{queueName}/messagelist URL 发送 GET 请求时，响应不再包含 ibm-mq-total-browse-size 标头。

有关 GET /messaging/qmgr/{qmgrName}/queue/{queueName}/messagelist 的更多信息，请参阅 GET /messaging/qmgr/{qmgrName}/queue/{queueName}/messagelist。

Java 不再在 REST JSON 错误响应中返回异常

以前，当 REST API 返回错误响应且该错误是 Java 错误时，JSON 响应会包含 Java 异常的详细信息。 从 IBM MQ 9.2.0 开始，不再返回此信息。 有关 REST API 错误响应的更多信息，请参阅 REST API 错误处理。

在 jvm.options 文件中为 mqweb 服务器添加文件编码变量

从 IBM MQ 9.2.0 开始，用于存储 IBM MQ Console 的用户仪表盘信息的文件编码设置为 UTF-8。 此设置可确保正确显示双字节字符集的用户仪表盘信息。

只有新安装 IBM MQ 且 IBM MQ 数据目录不存在时，才会自动更新。 如果升级 IBM MQ 版本，或使用现有的 IBM MQ 数据目录重新安装 IBM MQ ，如果在显示用户仪表板信息时遇到问题，则必须手动设置文件编码。

文件编码在 jvm.options 文件中设置。 更多信息，请参阅调整 mqweb 服务器 JVM。

CipherSpec 订单

CipherSpecs 的顺序用于在多个可能的 CipherSpecs, 之间进行选择，例如在使用 ANY* CipherSpecs 时。 (有关 ANY* CipherSpecs, 的更多信息，请参阅启用 CipherSpecs ，有关这些 CipherSpecs, 的列表，请参阅表 1 中的别名 CipherSpecs 部分） 因此，队列管理器、C 客户端和非托管 .NET 客户端在 TLS 握手过程中提交 CipherSpecs 的顺序已经更改，以符合公认的首选顺序，确保尽可能选择更安全的 CipherSpec。 与 IBM MQ 以前的版本相比，这可能会改变 TLS 握手过程中选择 CipherSpec 的方式。

受管 .NET 客户端和 DataPower 客户端不指定单个 CipherSpec ，而是向 IBM MQ 提交自己的有序 CipherSpec 列表。 在 IBM MQ 支持别名 CipherSpecs, 之前，必须配置 IBM MQ 频道，以便根据客户端的 CipherSpec 排序指定单个 CipherSpec。 CipherSpec 排序的这一更改，可能会导致以这种方式配置的现有客户端连接失败，并在队列管理器上报告一个 AMQ9631 在队列管理器上报告错误。 建议不再计算通道配置的具体 CipherSpec ，而是指定一个别名 CipherSpec, ，例如 ANY_TLS12_OR_HIGHER。 然后，客户端和服务器将协商最安全的可用 CipherSpec。

有关 IBM MQ 从 IBM MQ 9.2.0 使用 CipherSpecs 的顺序以及如何更改的更多信息，请参阅 CipherSpec 在 TLS 握手中的顺序。

GCM 密码更新

根据 IBM Global Security Kit (GSKit) 的建议，现在 GCM 密码中的 TLS 记录限制为 2^ 24.5。 使用 GCM 密码的 TLS 通信，如果在达到 TLS 记录限制之前没有重置 SSL 密钥，就会被终止。 更多信息，请参阅启用 CipherSpecs。

mqm.gskit.rte 图书馆更新

队列管理器和客户端内部使用其他 GSKit 库，而 mqm.gskit.rte 文件集则是这两个组件的依赖项。 在安装过程中， IBM MQ 会自动安装 mqm.gskit.rte 库。

对 AMQR 和 MQXR 服务跟踪的更改

从 IBM MQ 9.2.0 ，您可以跟踪 AMQR 和 MQXR 服务的选定关注区域以及整个服务。

有关详细信息，请参阅跟踪高级消息队列协议 (AMQP) 服务和跟踪遥测 (MQXR) 服务。

更改跟踪时间戳的格式

从 IBM MQ 9.2.0 开始， Windows 跟踪时间戳的格式发生了变化。 有关修订格式的示例，请参见 Windows 的跟踪数据示例。

Managed File Transfer for z/OS FMID 移至 产品安装的一部分 IBM MQ for z/OS

这些更改同时适用于 IBM MQ Advanced for z/OS 和 IBM MQ Advanced for z/OS Value Unit Edition。

在 IBM MQ for z/OS 9.2 之前，有权使用 IBM MQ Advanced for z/OS、 IBM MQ for z/OS Value Unit Edition (VUE) 或 IBM MQ for z/OS Managed File Transfer for z/OS (MFT) 的 z/OS 用户必须执行单独的 SMP/E 安装，才能使用 FMID HMF9110 获取 MFT 二进制文件。

更多信息，请参阅安装 IBM MQ Advanced for z/OS 。

有关如何迁移到最新版本 MFT 的信息，请参阅： 将 Managed File Transfer for z/OS 安装迁移到产品的下一个版本。

删除 IBM MQ for z/OS 启用模块

从 IBM MQ for z/OS 9.2.0 开始，不再提供 Advanced Message Security for z/OS、 IBM MQ Advanced for z/OS Value Unit Edition 和 IBM MQ for z/OS Value Unit Edition 的启用模块。

对于 Continuous Delivery ，从 IBM MQ for z/OS 9.1.3 开始，启用模块不再发货。

更多信息，请参阅 z/OS 安装概述和使用 IBM MQ for z/OS 产品记录产品使用情况。

对安全出口样本的修改 CSQ4BCX3

更多信息，请参阅 IBM MQ for z/OS 服务器连接通道。

CONNSWAP 参数

CONNSWAP 参数的值将被 CSQ6SYSP 宏忽略，因为在调用 IBM MQ API 时，应用程序总是不可交换的。

更多信息，请参阅使用 CSQ6SYP。

此外， DISPLAY SYSTEM MQSC 命令和查询系统 PCF 命令不再返回 CONNSWAP 信息。

MQIPT Java security manager 政策变化

从 IBM MQ 9.2.0 开始，如果使用 Java security manager 和 MQIPT ，则必须在策略文件中包含额外的 javax.management.MBeanServerPermission、 javax.management.MBeanPermission 和 javax.management.MBeanTrustPermission 权限。 有关 Java security manager 与 MQIPT 一起使用所需的全部权限列表，请参阅 Java security manager.

在 MQIPT 配置中容忍无效的全局属性值

如果在启动过程中或刷新 MQIPT 时检测到 mqipt.conf 配置文件全局部分的某个属性值无效， MQIPT 以前的版本会立即终止。 从 IBM MQ 9.2.0 开始，在刷新 MQIPT 配置时，全局部分大多数属性的无效值是可以容忍的。 如果在刷新 MQIPT 时，全局部分的属性值无效，则会发出警告信息，但属性的有效值保持不变。 这可以防止无效的属性值导致 MQIPT 的活动实例在刷新时关闭。

拆除 IPT Administration Client

IPT Administration Client 图形用户界面已被删除。 以前版本的 IPT Administration Client 不能与 IBM MQ 9.2.0 中的 MQIPT 一起使用。 要配置和管理 MQIPT ，请编辑 mqipt.conf 配置文件并使用 mqiptAdmin 命令，如《 使用命令行管理 MQIPT 》中所述。

JMS 应用程序共享连接的更改

如果应用程序配置为 reconnectable ，通道实例只能在相关的 JMS 对象（即 JMS 连接及其相关的 JMS 会话）之间共享。 这可能需要配置其他通道实例才能支持此类应用程序。

例如，如果应用程序使用单个 JMS 连接和单个 JMS 会话，且所使用的 SHARECNV 通道等于 10，那么以前最多可有五个应用程序实例共享一个通道实例。 如果应用程序未配置为 reconnectable ，情况仍然如此，但如果应用程序配置为 reconnectable ，则每个应用程序实例都需要自己的通道实例，因此总共需要五个通道实例。

更多信息，请参阅 IBM MQ classes for JMS 中的共享 TCP/IP 连接。