IBM MQ classes for JMS 可重新定位 JAR 檔

可再定位 JAR 檔可以移至需要執行 IBM® MQ classes for JMS的系統。

重要事項:
  • 除了 可再定位 JAR 檔中說明的可再定位 JAR 檔之外，不支援將 IBM MQ classes for JMS JAR 檔或原生程式庫複製到其他機器，或複製到已安裝 IBM MQ classes for JMS 的機器上的不同位置。
  • 在部署至 Java EE 應用程式伺服器 (例如 WebSphere® Application Server 或 WebSphere Liberty) 的應用程式內，請勿包含可重新定位的 JAR 檔。 在這些環境中，應該部署並改用 IBM MQ 資源配接器。 請注意， WebSphere Application Server 會內嵌 IBM MQ 資源配接器，因此不需要手動將它部署到這個環境中。
  • 為了避免類別載入器衝突，不建議將可重新定位的 JAR 檔組合在相同 Java 執行時期內的多個應用程式內。 在此實務範例中，讓 IBM MQ 可重新定位 JAR 檔可在 Java 執行時期的類別路徑上使用。
  • 如果您要組合應用程式內的可再定位 JAR 檔，請確保包含 可再定位 JAR 檔中說明的所有必備 JAR 檔。 在應用程式維護過程中，您也應該確保有適當的程序來更新組合 JAR 檔，以確保 IBM MQ classes for JMS 仍然是最新的，並重新調解已知問題。

可再定位 JAR 檔

在企業內，下列檔案可以移至需要執行 IBM MQ classes for JMS的系統:
  • com.ibm.mq.allclient.jar
  • com.ibm.mq.traceControl.jar
  • jms.jar
  • fscontext.jar
  • providerutil.jar
  • bcpkix-jdk15on.jar
  • bcprov-jdk15on.jar
  • [MQ 9.2.4 2021 年 11 月][MQ 9.2.0.4 2021 年 11 月]bcutil-jdk15on.jar
  • [MQ 9.2.0 2020 年 7 月]org.json.jar

jms.jar 檔案是 javax.jms.jar 的介面檔，包含非IBM JMS 類別。

如果您的應用程式使用檔案系統環境定義來執行 JNDI 查閱，則需要 fscontext.jar 和 providerutil.jar 檔案。

需要 Bouncy Castle 安全提供者和 CMS 支援 JAR 檔。 如需相關資訊，請參閱 支援非IBM 具備 AMS 的 JRE。 需要下列 JAR 檔:
  • bcpkix-jdk15on.jar
  • bcprov-jdk15on.jar
  • [MQ 9.2.4 2021 年 11 月][MQ 9.2.0.4 2021 年 11 月]bcutil-jdk15on.jar

[MQ 9.2.0 2020 年 7 月]如果 IBM MQ classes for JMS 應用程式使用 JSON 格式的 CCDT ，則需要 org.json.jar 檔案。

檔案 com.ibm.mq.allclient.jar 包含 IBM MQ classes for JMS、 IBM MQ classes for Java及 PCF 和標頭類別。 如果您將此檔案移至新位置，請確保採取步驟，以使用新的 IBM MQ 修正套件來維護此新位置。 此外，如果您取得臨時修正程式，請確定 IBM 支援中心知道這個檔案的用法。

若要判定檔案 com.ibm.mq.allclient.jar的版本，請使用下列指令:

java -jar com.ibm.mq.allclient.jar
下列範例顯示此指令的部分範例輸出:

C:\Program Files\IBM\MQ_1\java\lib>java -jar com.ibm.mq.allclient.jar
Name:       Java Message Service Client
Version:    9.2.0.0
Level:      p000-L140428.1
Build Type: Production
Location:   file:/C:/Program Files/IBM/MQ_1/java/lib/com.ibm.mq.allclient.jar

Name:       WebSphere MQ classes for Java Message Service
Version:    9.2.0.0
Level:      p000-L140428.1
Build Type: Production
Location:   file:/C:/Program Files/IBM/MQ_1/java/lib/com.ibm.mq.allclient.jar

Name:       WebSphere MQ JMS Provider
Version:    9.2.0.0
Level:      p000-L140428.1 mqjbnd=p000-L140428.1
Build Type: Production
Location:   file:/C:/Program Files/IBM/MQ_1/java/lib/com.ibm.mq.allclient.jar

Name:       Common Services for Java Platform, Standard Edition
Version:    9.2.0.0
Level:      p000-L140428.1
Build Type: Production
Location:   file:/C:/Program Files/IBM/MQ_1/java/lib/com.ibm.mq.allclient.jar

com.ibm.mq.traceControl.jar 檔用來動態控制 IBM MQ classes for JMS 應用程式的追蹤。 如需相關資訊，請參閱 使用 IBM MQ 類別及適用於 JMS 的 IBM MQ 類別來控制執行中處理程序中的追蹤。