Java i5/OS PASE environment variables

The Java™ virtual machine (JVM) uses the following variables to start i5/OS™ PASE environments. You need to set the QIBM_JAVA_PASE_STARTUP variable in order to run the IBM^® i5/OS PASE native method for Java example.

For information about setting environment variables for the example, see the following topic:

Environment variables for the IBM i5/OS PASE example.

QIBM_JAVA_PASE_STARTUP

You need to set this environment variable when both of the following conditions occur:

• You are using i5/OS PASE native methods
• You are starting Java from an iSeries™ command prompt or Qshell command prompt

The JVM uses this environment variable to start a PASE environment. The value of the variable identifies an i5/OS PASE startup program. Your iSeries server includes two i5/OS PASE startup programs:

• /usr/lib/start32: Starts a 32-bit i5/OS PASE environment
• /usr/lib/start64: Starts a 64-bit i5/OS PASE environment

The bit format of all shared library objects used by an i5/OS PASE environment must match the bit format of the i5/OS PASE environment.

You cannot use this variable when starting Java from an i5/OS PASE terminal session. An i5/OS PASE terminal session always uses a 32-bit i5/OS PASE environment. Any JVMs started from an i5/OS PASE terminal session use the same type of PASE environment as the terminal session.

QIBM_JAVA_PASE_CHILD_STARTUP

Set this optional environment variable when the i5/OS PASE environment for a secondary JVM must be different than the i5/OS PASE environment the primary JVM. A call to Runtime.exec() in Java starts a secondary (or child) JVM.

For more information, see Using QIBM_JAVA_PASE_CHILD_STARTUP.

QIBM_JAVA_PASE_ALLOW_PREV

Set this optional environment variable when you want to use the current i5/OS PASE environment, if one exists. In certain situations, it is difficult to determine whether an i5/OS PASE environment already exists. Using QIBM_JAVA_PASE_ALLOW_PREV and QIBM_JAVA_PASE_STARTUP in combination enables the JVM to either use an existing i5/OS PASE environment or start a new i5/OS PASE environment.

For more information, see Using QIBM_JAVA_PASE_ALLOW_PREV.

• Examples: Environment variables for the IBM i5/OS PASE example
  To use the IBM i5/OS PASE native methods for Java example, you need to set environment variables.
• Using QIBM_JAVA_PASE_CHILD_STARTUP
  The QIBM_JAVA_PASE_CHILD_STARTUP environment variable indicates the i5/OS PASE startup program for any secondary JVMs.
• Using QIBM_JAVA_PASE_ALLOW_PREV
  Sometimes it is difficult to determine whether an i5/OS PASE environment already exists. Using the optional environment variable QIBM_JAVA_PASE_ALLOW_PREV in combination with QIBM_JAVA_PASE_STARTUP enables the JVM to determine whether to use the current i5/OS PASE environment (if one exists) or start a new i5/OS PASE environment.