Configuring CICS for the type-2 IMS Universal drivers

To run Java™ applications in a CICS® environment that access IMS databases through a type-2 IMS Universal driver, you must install the type-2 IMS Universal driver in the IBM® CICS Transaction Server for z/OS® subsystem.

1. Build the IMS Universal driver OSGi bundle. To build the bundle:
   1. Write a bundle Manifest.mf file in a text editor. The following sample file is an example of Manifest.mf:

      Manifest-Version: 1.0
      Bundle-ManifestVersion: 2
      Bundle-Name: IMS Universal driver OSGi
      Bundle-SymbolicName: com.ibm.ims.osgi.Udb
      Bundle-Version: 1.0.0
      Bundle-ClassPath: imsudb.jar
      Export-Package: com.ibm.ims.application,
      com.ibm.ims.base,
      com.ibm.ims.db,
      com.ibm.ims.db.cci,
      com.ibm.ims.db.hybrid,
      com.ibm.ims.db.spi,
      com.ibm.ims.dbd,
      com.ibm.ims.dli,
      com.ibm.ims.dli.conversion.util,
      com.ibm.ims.dli.conversion.util.bidi,
      com.ibm.ims.dli.converters,
      com.ibm.ims.dli.dm,
      com.ibm.ims.dli.logging,
      com.ibm.ims.dli.t2,
      com.ibm.ims.dli.tm,
      com.ibm.ims.dli.types,
      com.ibm.ims.dli.xa,
      com.ibm.ims.drda.base,
      com.ibm.ims.drda.converters,
      com.ibm.ims.drda.db,
      com.ibm.ims.drda.t4,
      com.ibm.ims.drda.t4.util,
      com.ibm.ims.drda.t4nativesql,
      com.ibm.ims.jdbc,
      com.ibm.ims.jdbc.batch,
      com.ibm.ims.jdbc.xa,
      com.ibm.ims.jms,
      com.ibm.ims.opendb,
      com.ibm.ims.psb,
      com.ibm.ims.smf,
      com.ibm.ims.xmldb,
      com.ibm.ims.xmldb.dm,
      com.ibm.ims.xmldb.shredder,
      com.ibm.ims.xmldb.xms
      Import-Package: com.ibm.cics.server;version="[1.300.0,2.0.0]";resolution:=optional
      Bundle-RequiredExecutionEnvironment: JavaSE-1.7
      

   2. Add both the Manifest.mf file and the IMS Universal driver imsudb.jar file to a zip archive.
   3. Rename the zip archive to com.ibm.ims.osgi.Udb_1.0.0.jar.
   4. Use the CICS explorer to deploy the created OSGi bundle.
2. Modify the CICS environment UNIX System Services file, DFHJVMPR, that contains the JVM profile.
   1. Update the OSGI_BUNDLES variable so that it contains the path to the created OSGi bundle as follows:

      OSGI_BUNDLES=pathprefix/com.ibm.ims.osgi.Udb_1.0.0.jar

   2. Update the LIBPATH variable so that it contains the path to the libT2DLI_64.so file as follows:

      LIBPATH_SUFFIX=pathprefix/usr/lpp/ims/ims15.3/imsjava/lib

3. Ensure that the CICS AIBTDLI is loaded over the IMS AIBTDLI interface.
   1. Set the CICS SDFHLOAD member above the IMS SDFSRESL member in the CICS STEPLIB.