安装 IBM MQ classes for XMS .NET Standard

从 IBM® MQ 9.2.0开始， IBM MQ classes for XMS .NET Standard(包括样本) 随 IBM MQ 一起安装在 Windows 和 Linux®上。对于 IBM MQ classes for XMS .NET Standard，存在 Microsoft.NET Core 的先决条件。

[MQ 9.2.0 2020 年 7 月] 从 IBM MQ 9.2.0开始， Microsoft.NET Core 3.1 是运行 IBM MQ classes for XMS .NET Standard所需的最低版本。 [MQ 9.2.0.25 2025 年 4 月] 从 IBM MQ 9.2.0 Fix Pack 25开始， IBM MQ 支持 .NET 6 应用程序使用 IBM MQ classes for XMS .NET Standard。如果您正在使用 .NET Core 3.1 应用程序，那么可以通过在 csproj 文件中进行小编辑来运行此应用程序，将 targetframeworkversion 设置为 "net6.0"，而无需进行任何重新编译。

amqmxmsstd.dll库

从 IBM MQ 9.2.0 起，IBM MQ classes for XMS .NET Standard 库 amqmxmsstd.dll 可用于 Windows 和 Linux 上的 XMS .NET Standard 支持。

XMS .NET 样本位于 &MQINSTALL_PATH&/samp/dotnet/samples/cs/core/xms 中。

[Linux] 在 Linux上安装 IBM MQ 客户机时，库将安装到 /&MQINSTALL_PATH&/lib64 path 中。

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

注意: 仍提供所有 IBM.XMS.* 库，但这些库已稳定; 即，不会在其中引入任何新功能部件。

对于任何最新功能，必须将其迁移到 amqmxmsstd.dll 库。但是，您可以继续使用 IBM MQ 9.1 Long Term Support 或 Continuous Delivery 发行版上的现有库。

从 IBM MQ 9.2.0开始，可从 NuGet 存储库下载 IBM MQ classes for XMS .NET Standard 。 NuGet 包同时包含 amqmxmsstd.dll 库和 amqmdnetstd.dll 库。 amqmxmsstd.dll 依赖于 amqmdnetstd.dll ，并且在打包 XMS .NET Core 应用程序时，应该将 amqmxmsstd.dll 和 amqmdnetstd.dll 与 XMS .NET Core 应用程序一起打包。有关更多信息，请参阅从 NuGet 存储库下载 XMS .NET Standard 的 IBM MQ 类。

dspmqver 命令

您可以使用 dspmqver 命令来显示 .NET Core 组件的版本和构建信息。

IBM MQ classes for XMS .NET Framework 和 IBM MQ classes for XMS .NET Standard 功能部件

下表列出了与 IBM MQ classes for XMS .NET Standard的功能部件相比， IBM MQ classes for XMS .NET Framework 的功能部件。

表 1. IBM MQ classes for XMS .NET Framework 和 IBM MQ classes for XMS .NET Standard 功能部件之间的差异
功能部件	IBM MQ classes for XMS .NET Framework	IBM MQ classes for XMS .NET Standard
类名 (API)	所有类在每个网络中都保持不变。	所有类在每个网络中都保持不变。
操作系统	Windows	Windows Dockerized 容器 Linux macOS
app.config 文件（用于在可再分发客户机中启用跟踪的配置文件）	app.config 文件用于对可重新分发的软件包启用跟踪。	app.config 在 .NET Standard 中不受支持。您必须使用环境变量来代替 app.config。
跟踪	要跟踪 XMS .NET 客户机，可以使用现有环境变量，例如用于启用跟踪的环境变量 XMS_TRACE_ON 。有关更多信息，请参阅使用 XMS 环境变量配置 XMS .NET 跟踪。对于可再分发的客户机，可以使用 app.config 文件来启用跟踪。	要跟踪 XMS .NET 客户机，可以使用现有环境变量，例如用于启用跟踪的环境变量 XMS_TRACE_ON 。有关更多信息，请参阅使用 XMS 环境变量配置 XMS .NET 跟踪。
传输方式	受管、非受管和绑定	受管
TLS	Windows 密钥库用于存储证书。	在 Windows 上，必须使用密钥库来存储证书。允许的值为 USER 或 SYSTEM。根据输入，IBM MQ .NET 客户机将查看当前用户或系统范围内的 Windows 密钥库。在 Linux 上，建议使用 X509Store 类来安装证书，.NET Core 会将证书安装到以下位置：".dotnet/corefx/cryptography/x509stores"。
CCDT	支持	支持，并且 CCDT 路径的设置对与 .NET Framework 类的相同。
客户机自动重新连接	支持	支持
分布式事务	支持	不支持
将动态链接库 (dll's) 安装到全局组合件高速缓存 (GAC) 中	Dll 's 作为 IBM MQ 安装的一部分安装到 GAC 中。	Dll 未作为 IBM MQ 安装的一部分安装到 GAC 中。
支持 WMQ、WPM 和 RTT 连接类型	支持 WMQ、WPM 和 RTT 连接类型	仅支持 WMQ
JNDI 受管对象	支持 LDAP 和 FileSystem	仅支持 FileSystem