Programming with the IMS Java dependent region resource adapter

IMS provides a set of Java APIs called the IMS Java dependent region resource adapter to develop Java applications to run on the IMS Java dependent regions.

The IMS Java dependent region resource adapter provides Java application programs running in JMP or JBP regions with similar DL/I functionality to that provided in message processing program (MPP) and non-message driven BMP regions, such as:
  • Accessing IMS message queues to read and write messages
  • Performing program switches
  • Commit and rollback processing
  • Accessing GSAM databases
  • Database recovery (CHKP/XRST)

Use the IMS Java dependent region resource adapter together with the type-2 IMS Universal JDBC driver or type-2 IMS Universal DL/I driver to perform database operations, including GSAM database access.

The following figure shows a Java application that is running in a JMP or JBP region. Database access and message processing requests are passed to the IMS Java dependent region resource adapter and type-2 IMS Universal drivers, which converts the calls to DL/I calls.

Figure 1. JMP or JBP application that is using the IMS Java dependent region resource adapter
Begin figure description. The Java application runs in a JMP or JBP IMS dependent region. The application uses the IMS Java dependent region resource adapter to convert the database access and message processing requests to DL/I and access IMS. End figure description.

Preparing to write a Java application with the IMS Java dependent region resource adapter

The IMS Java dependent region resource adapter is available as an SMP/E-installable driver (imsutm.jar through the Java on Demand Feature FMID).

Java application programs that use the IMS Java dependent region resource adapter require the Java Development Kit (JDK) 7.0 or later. They also require a way to generate the IMS database metadata, such as using the IMS Enterprise Suite Explorer for Development. The default segment encoding of the database metadata class produced by the IMS Explorer for Development is cp1047. To change the segment encoding, use the com.ibm.ims.base.DLIBaseSegment.setDefaultEncoding method.