Configuring an OSGi JVM server to support IBM MQ classes for Java

A JVM server is the runtime environment for Java™ applications. You can configure an OSGi JVM server to support applications that use WebSphere® MQ classes for Java.

About this task

To enable the OSGi JVM server to support applications that use IBM MQ classes for Java, IBM MQ for Java bundles need to be added to the set of middleware bundles that run in the OSGi framework within the JVM server. The framework must also have access to the associated set of native libraries.

Procedure

  1. Add the IBM MQ classes for Java to the JVM server as an OSGi middleware bundle. To add the classes, from IBM MQ Version 8.0, include the following lines in the JVM profile for the OSGi JVM server:
    OSGI_BUNDLES=<MQ_ROOT>/OSGi/com.ibm.mq.osgi.allclientprereqs_<VERSION>.jar,\
    <MQ_ROOT>/OSGi/com.ibm.mq.osgi.allclient_<VERSION>.jar
    For WebSphere MQ for z/OS® Version 7.1, include the following line:
    OSGI_BUNDLES=<MQ_ROOT>/OSGi/com.ibm.mq.osgi.java_<VERSION>.jar
    where:
    • MQ_ROOT is the java/lib/ directory of the IBM MQ for z/OS Unix System Services installation, for example, /usr/lpp/V8R0M0/java/lib.
    • VERSION is the version of the IBM MQ classes for Java that you are using, for example, 8.0.0.0.
  2. Add the directory containing the IBM MQ classes for Java native libraries to the LIBPATH_SUFFIX option in the JVM profile for the OSGi JVM server. For example:
    LIBPATH_SUFFIX=<MQ_ROOT>
    where MQ_ROOT is the java/lib/ directory of the IBM MQ for z/OS Unix System Services installation, for example, /usr/lpp/V8R0M0/java/lib.


dfhpj_webspheremq_javaosgi_configure.html | Timestamp icon Last updated: Monday, 5 June 2017