The enablejvm command allows you to configure your
application server or a specific profile to use the IBM Technology
for Java Virtual Machine instead of the classic JVM. The IBM Technology
for Java Virtual Machine is available in both 32-bit and 64-bit versions
(options 8 and 9 of IBM Developer Kit for Java).
For more information about where to run this command, see the Using command line tools article.
Before you can run the
enablejvm command, ensure that you
meet all the following criteria as it applies to your system:
- i5/OS® release V5R4M0
- You have i5/OS release V5R4M0 installed.
- You have installed the Portable Application Solution Environment
(PASE) product. If it is not already installed, install the PASE product,
which is option 33 of the i5/OS operating system and is
included with the media for i5/OS V5R4M0 and higher.
- You have installed the IBM® J2SE 5.0 32-bit Java Developers Kit option. This is option 8
of product 5722JV1 (IBM Developer Kit for Java) and is included with the media for i5/OS V5R4M0
and higher.
- You have installed the latest group PTF for Java.
The group PTF number is SF99291. If SF99291 is already installed,
but you installed PASE or 5722JV1 option 8 afterwards, load and apply
the group PTF again to ensure you have all necessary PTFs.
- i5/OS release V6R1M0 (32-bit)
- You have i5/OS release V6R1M0 installed.
- You have installed the Portable Application Solution Environment
(PASE) product. If it is not already installed, install the PASE product,
which is option 33 of the i5/OS operating system and is
included with the media for i5/OS V6R1M0 and higher.
- You have installed the IBM J2SE 5.0 32-bit Java Developers Kit option. This is option 8
of product 5761JV1 (IBM Developer Kit for Java) and is included with the media for i5/OS V6R1M0
and higher.
- You have installed the latest group PTF for Java.
If the latest group PTF is already installed, but you installed PASE
or 5761JV1 option 8 afterwards, load and apply the group PTF again
to ensure you have all necessary PTFs.
- i5/OS release V6R1M0 (64-bit)
- You have i5/OS release V6R1M0 installed.
- You have installed the Portable Application Solution Environment
(PASE) product. If it is not already installed, install the PASE product,
which is option 33 of the i5/OS operating system and is
included with the media for i5/OS V6R1M0 and higher.
- You have installed the IBM J2SE 5.0 64-bit Java Developers Kit option. This is option 9
of product 5761JV1 (IBM Developer Kit for Java) and is included with the media for i5/OS V6R1M0
and higher.
- You have installed the latest group PTF for Java.
If the latest group PTF is already installed, but you installed PASE
or 5761JV1 option 9 afterwards, load and apply the group PTF again
to ensure you have all necessary PTFs.
By default, the application server is configured to use the i5/OS Java Developer Kit 5.0 JVM (also known as the
"classic" JVM). The enablejvm command only operates in 32-bit
mode in this case.
Syntax
The command syntax is as follows:
enablejvm [options]
Parameters
The following options are available
for the enablejvm command:
- -jvm jvm_version
- This is a required parameter. jvm_version must
be one of the following:
- std32. This specifies the application server to use the IBM J2SE
5.0 32-bit JVM.
- std64. This specifies the application server to use the IBM J2SE
5.0 64-bit JVM.
- classic. This specifies the application server to use the i5/OS Java Developer Kit 5.0 JVM.
- -profile profile_name
- This is an optional parameter. If you do not specify the -profile
parameter, the script enables the product to use the J2SE 5.0 JVM
and also updates any existing profiles to use the JVM.
Usage scenario
The following examples demonstrate
correct syntax:
i5/OS release V5R4M0 enablejvm -jvm std32 [-profile profilename]
enablejvm -jvm classic [-profile profilename]
i5/OS release V6R1M0 (32-bit)enablejvm -jvm std32 [-profile profilename]
i5/OS release V6R1M0 (64-bit)enablejvm -jvm std64 [-profile profilename]
Note: 64-bit use of the enablejvm command only applies
to i5/OS release V6R1M0 or higher.
If
you did not specify the -profile parameter on the enablejvm invocation,
restart any servers which
are running. If you did specify the -profile parameter on the enablejvm invocation,
restart any servers which belong to the profile that was changed.