[Windows][Linux]

使用 IBM MQ classes for XMS .NET

IBM® MQ classes for XMS .NET(包括範例) 與 IBM MQ 一起安裝在 Windows 和 Linux®上。

[MQ 9.3.1 Oct 2022]IBM MQ 9.3.1 提供針對 .NET 6 建置的 XMS .NET 用戶端程式庫作為目標架構。 從 IBM MQ 9.3.1開始， Microsoft .NET 6.0 是使用 IBM MQ 程式庫 (使用 .NET 6 作為目標架構來建置) 來執行應用程式所需的最低版本。

[MQ 9.3.1 Oct 2022]從 IBM MQ 9.3.1開始，使用 .NET Standard 建置的 XMS .NET 用戶端程式庫可在新的資料夾 netstandard2.0 下使用，而使用 .NET 6 建置的 XMS .NET 用戶端程式庫可在 Windows 上的 MQ_INSTALLATION_PATH/bin 及 Linux上的 MQ_INSTALLATION_PATH/lib64 下使用。

[MQ 9.3.0 Jun 2022][MQ 9.3.0 Jun 2022]從 IBM MQ 9.3.0， IBM MQ 支援使用 IBM MQ classes for XMS .NET Standard的 .NET 6 應用程式。

從 IBM MQ 9.2.0開始， Microsoft.NET Core 3.1 是執行 IBM MQ classes for XMS .NET Standard所需的最低版本。

amqmxmsstd.dll 磁帶庫

[MQ 9.3.1 Oct 2022]從 IBM MQ 9.3.1開始， amqmxmsstd.dll 媒體庫位於下列位置
使用 .NET Standard 2.0 作為目標架構建置的程式庫
  • [Windows]在 Windows上: MQ_INSTALLATION_PATH\bin\netstandard2.0。
  • [Linux]在 Linux上: MQ_INSTALLATION_PATH\lib64\netstandard2.0。
[已淘汰]這些程式庫已淘汰， IBM 打算在未來版本中移除它們。
使用 .NET 6 作為目標架構建置的程式庫
  • [Windows]在 Windows上: MQ_INSTALLATION_PATH\bin。 範例應用程式安裝在 MQ_INSTALLATION_PATH/samp/dotnet/samples/cs/core/base中。
  • [Linux]在 Linux上: MQ_INSTALLATION_PATH\lib64。 .NET 範例位於 MQ_INSTALLATION_PATH/samp/dotnet/samples/cs/core/base中。
[MQ 9.3.1 Oct 2022]若為 IBM MQ 9.3.0 Long Term Support， IBM MQ classes for XMS .NET Standard 程式庫 amqmxmsstd.dll位於下列位置:
  • [Windows]在 Windows上: MQ_INSTALLATION_PATH\bin。 範例應用程式安裝在 MQ_INSTALLATION_PATH/samp/dotnet/samples/cs/core/xms中。
  • [Linux]在 Linux上: MQ_INSTALLATION_PATH/lib64 path。 .NET 範例位於 MQ_INSTALLATION_PATH/samp/dotnet/samples/cs/core/xms中。
如需相關資訊，請參閱 安裝 IBM MQ for .NET 類別。
注意: [已淘汰][MQ 9.3.1 Oct 2022]從 IBM MQ 9.3.1，使用 .NET Standard 2.0 作為目標架構建置的 IBM MQ .NET 用戶端程式庫已淘汰，且在編譯時期參照這些程式庫的應用程式會擲出警告 CS0618 。

[已穩定]仍會提供所有 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 儲存庫下載 IBM MQ for XMS .NET 類別。

dspmqver 指令

您可以使用 dspmqver 指令來顯示 .NET Core 元件的版本和建置資訊。

IBM MQ classes for XMS .NET Framework 與 IBM MQ classes for XMS .NET (.NET Standard 與 .NET 6 程式庫) 之間的比較

下表列出相較於 IBM MQ classes for XMS .NET (.NET Standard 及 .NET 6 程式庫) 的特性， IBM MQ classes for XMS .NET Framework 的特性。

表 1. IBM MQ classes for XMS .NET Framework 與 IBM MQ classes for XMS .NET (.NET Standard 與 .NET 6 程式庫) 之間的差異
特性 IBM MQ classes for XMS .NET Framework IBM MQ classes for XMS .NET (.NET Standard 和 .NET 6 程式庫)
類別名稱 (API) 所有類別都在每個網路中保持相同。 所有類別都在每個網路中保持相同。
作業系統 Windows
Windows
Docker 化容器
Linux
macOS
app.config 檔案（用於在可重新配送用戶端中啟用追蹤的配置檔案） app.config 檔用來啟用可重新配送套件的追蹤。 不支援 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) 安裝到廣域組合語言快取 (GAC) 中 將 Dll 作為 IBM MQ 安裝的一部分安裝在 GAC 中。 Dll 不作為 IBM MQ 安裝的一部分安裝在 GAC 中。
支援 WMQ、WPM 及 RTT 連線類型 支援 WMQ、WPM 及 RTT 連線類型 僅支援 WMQ
JNDI 受管理物件 支援 LDAP 及 FileSystem 僅支援 FileSystem

[MQ 9.3.0 Jun 2022][MQ 9.3.0 Jun 2022]從 IBM MQ 9.3.0，若要執行 IBM MQ classes for XMS .NET Framework ，您必須安裝 Microsoft.NET Framework V4.7.2 或更新版本。