为 IBM MQ classes for JMS 安装的内容

安装 IBM® MQ classes for JMS时，将创建许多文件和目录。 在 Windows上，通过自动设置环境变量在安装期间执行某些配置。 在其他平台上以及在某些 Windows 环境中，必须先设置环境变量，然后才能运行 IBM MQ classes for JMS 应用程序。

对于大多数操作系统，安装 IBM MQ时，会将 IBM MQ classes for JMS 作为可选组件进行安装。

有关安装 IBM MQ的更多信息，请参阅:
重要信息: 除了 IBM MQ classes for JMS/Jakarta Messaging 可重定位 JAR 文件中描述的可重定位 JAR 文件外，不支持将 IBM MQ classes for JMS JAR 文件或本机库复制到其他机器，或者复制到已安装 IBM MQ classes for JMS 的机器上的其他位置。

安装目录

表 1 显示了 IBM MQ classes for JMS 文件在每个平台上的安装位置。
表 1. IBM MQ classes for JMS 安装目录
平台 目录
[AIX][Linux]AIX® and Linux® MQ_INSTALLATION_PATH/java
[Windows]Windows MQ_INSTALLATION_PATH\java
[IBM i]IBM i /QIBM/ProdData/mqm/java
[z/OS]z/OS MQ_INSTALLATION_PATH/java

MQ_INSTALLATION_PATH 表示安装了 IBM MQ 的高级目录。

安装目录包含以下内容：
  • IBM MQ classes for JMS JAR 文件，包括位于 MQ_INSTALLATION_PATH\java\lib 目录中的可再定位的 JAR 文件。
  • IBM MQ 本机库，由使用 Java 本机接口的应用程序使用。

    32 位本机库安装在 MQ_INSTALLATION_PATH\java\lib 目录中，而 64 位本机库安装在 MQ_INSTALLATION_PATH\java\lib64 目录中。

    有关 IBM MQ 本机库的更多信息，请参阅 配置 Java 本机接口 (JNI) 库。

  • 随 IBM MQ classes for JMS/Jakarta Messaging 提供的脚本中描述的其他脚本。 这些脚本位于 MQ_INSTALLATION_PATH\java\bin 目录中。
  • IBM MQ classes for JMS API 的规范。 Javadoc 工具已用于生成包含 API 规范的 HTML 页面。
    这些 HTML 页面位于 MQ_INSTALLATION_PATH\java\doc\WMQJMSClasses 目录中：
    • [AIX、Linux 和 Windows]在 AIX, Linux, and Windows上，此子目录包含各个 HTML 页面。
    • [IBM i]在 IBM i上， HTML 页面位于名为 wmqjms_javadoc.jar的文件中。
    • [z/OS]在 z/OS上， HTML 页面位于名为 wmqjms_javadoc.jar的文件中。
  • 对 OGSi 的支持。 OSGi 捆绑软件安装在 java\lib\OSGi 目录中，在 Support for OSGi with IBM MQ classes for JMS中进行了描述。
  • IBM MQ 资源适配器，可部署到任何符合 Java Platform, Enterprise Edition 7 ( Java EE 7) 或 Jakarta EE 的应用程序服务器中。

    IBM MQ 资源适配器位于 MQ_INSTALLATION_PATH\java\lib\jca 目录中；更多信息，请参阅使用 IBM MQ 资源适配器

  • [Windows]在 Windows上，可用于调试的符号安装在 MQ_INSTALLATION_PATH\java\lib\symbols 目录中。

安装目录还包含属于其他 IBM MQ 组件的一些文件。

样本应用程序

[JMS 2.0 ] IBM MQ classes for JMS随附了一些样本应用程序。 表 2 显示了样本应用程序在每个平台上的安装位置。

[Jakarta Messaging 3.0 ]对于 IBM MQ classes for Jakarta Messaging，正在准备新的样本。

[JMS 2.0 ]
表 2. IBM MQ classes for JMS 的样本目录
平台 目录
[AIX][Linux]AIX and Linux MQ_INSTALLATION_PATH/samp/jms
[Windows]Windows MQ_INSTALLATION_PATH\tools\jms
[IBM i]IBM i /QIBM/ProdData/mqm/java/samples/jms
[z/OS]z/OS MQ_INSTALLATION_PATH/java/samples/jms

在此表中， MQ_INSTALLATION_PATH 表示安装了 IBM MQ 的高级目录。

在安装后，可能需要执行一些配置任务以编译和运行应用程序。

为 IBM MQ classes for JMS/Jakarta Messaging 设置环境变量 描述了运行样本 IBM MQ classes for JMS 应用程序所需的类路径。 本主题还描述了在特殊情况下需要引用的其他 JAR 文件以及运行 IBM MQ classes for JMS随附的脚本时必须设置的环境变量。

要控制属性（例如应用程序的跟踪和日志记录），需要提供配置属性文件。 IBM MQ classes for JMS/Jakarta Messaging 配置文件中描述了 IBM MQ classes for JMS 配置属性文件。