Generating the runtime Java metadata class

To connect to an IMS database using the IMS Universal drivers, you need to include on your Java™ classpath the Java metadata class that provides the database view.

Note: If you are using the IMS catalog, an IMS Universal drivers application program can obtain the necessary metadata directly from the catalog database without a Java metadata class file.

The Java metadata class represents the application view information specified by a program specification block (PSB) and its related Program Control Blocks (PCBs). The Java metadata class provides a one-to-one mapping to the segments and fields defined in the PSB.

The Java metadata class must be compiled and made available through the classpath for any Java application attempting to access IMS data using that PSB.

During database connection setup, pass the name of this metadata class to the resource adapter or JDBC driver. The Java metadata class is used at runtime by the IMS Universal drivers to process both SQL and Java-based DL/I calls.

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.