Setting up the environment

About this task

Before the caller can begin generating OSRs, some environment variables must be set. The following lists the environment variables that must be set along with their appropriate values.
Note:
  1. The caller should use the proper 31/64-bit versions of the binaries listed below. Mixing versions of different binaries will result in unpredictable results.
  2. The OSR generator is only supported with IBM® 31-bit SDK for z/OS®, Java™ 2 Technology Edition, V5 and above.
LIBPATH
must include paths to the following:
  • For C API callers only (gxlcosr1.dll for 31-bit, gxlcosr4.dll for 64-bit) - /usr/lib
  • For 31-bit callers - /usr/lib/java_runtime
  • For 64-bit callers - /usr/lib/java_runtime64
  • Java binaries and JVM
    • For 31-bit callers -
      • /usr/lpp/java/J5.0/bin
      • /usr/lpp/java/J5.0/bin/j9vm
    • For 64-bit callers -
      • /usr/lpp/java/J5.0_64/bin
      • /usr/lpp/java/J5.0_64/bin/j9vm
CLASSPATH
must include paths to the following:
  • The Java API callers only (gxljapi.jar) - /usr/include/java_classes
    Note:
    1. Do not include gxljosrgimpl.jar. It will be loaded from /usr/include/java_classes
    2. Callers of the Java API must choose the 31- or 64-bit version of Java that they intend to use. They may either specify the explicit path to the required executable (/usr/lpp/java/J5.0/bin/java for 31-bit, /usr/lpp/java/J5.0_64/bin/java for 64-bit), or include the path to the required Java version in their PATH variable. Users of the C API and command interfaces do not need to be concerned with this.