IBM® MQ classes for JMS 和 IBM MQ classes for Jakarta Messaging 使用与其他编程语言相同的 IBM MQ-IMS 适配器。 此适配器使用 IMS 外部子系统连接设施 (ESAF)。
开始之前
在完成以下过程之前,必须为相关队列管理器以及
IMS 控制区域和从属区域配置
IMS 适配器,如
设置 IMS 适配器中所述。
注意: 您不需要执行描述构建动态存根的步骤,除非您需要动态存根用于其他目的。
配置 IMS 适配器后,执行以下过程。
过程
- 更新从属区域 JCL (例如 DFSJVMEV) 中的环境 ON 参数所引用的 IMS PROCLIB 成员中的 LIBPATH 变量,以使其包含 IBM MQ classes for JMS 本机库。
即,包含
libmqjims.so 的
zFS 目录。 例如, DFSJVMEV 可能类似于以下内容,其中最后一行是包含
IBM MQ classes for JMS 或
IBM MQ classes for Jakarta Messaging 本机库的目录:
LIBPATH=>
/java/latest/bin/j9vm:>
/java/latest/bin:>
/ims/latest/dbdc/imsjava/lib:>
/mqm/latest/java/lib
- 通过更新 java.class.path 选项,将 IBM MQ classes for JMS 或 IBM MQ classes for Jakarta Messaging 添加到 IMS 从属区域所使用的 JVM 的类路径。
通过遵循
IMS PROCLIB 数据集的 DFSJVMMS 成员中的指示信息执行此操作。
例如,您可以使用以下内容,其中粗体行指示更新:
![[Jakarta Messaging 3.0 ]](ngjm30.gif)
-Djava.class.path=/ims/latest/dbdc/imsjava/imsutm.jar:/ims/latest/dbdc/imsjava/imsudb.jar:
/mqm/latest/java/lib/com.ibm.mq.jakarta.client.jar
![[JMS 2.0 ]](ngjms20.gif)
-Djava.class.path=/ims/latest/dbdc/imsjava/imsutm.jar:/ims/latest/dbdc/imsjava/imsudb.jar:
/mqm/latest/java/lib/com.ibm.mq.allclient.jar
注意: 虽然包含
IBM MQ classes for JMS 或
IBM MQ classes for Jakarta Messaging 的目录中有许多不同的 jar 文件,但您只需要
com.ibm.mq.allclient.jar (
JMS 2.0) 或
com.ibm.mq.jakarta.client.jar (Jakarta Messaging 3.0)。
- 停止并重新启动将使用 IBM MQ classes for JMS 或 IBM MQ classes for Jakarta Messaging的任何 IMS 从属区域。
后续操作
创建和配置连接工厂和目标。
有三种可能的方法用于实例化连接工厂和目标的 IBM MQ 实现。 有关详情,请参阅创建和配置连接工厂和目的地。
请注意,这三种方法都在 IMS 环境中有效。