How do I get and install JDK 1.3?

Joe Sam Shirah

For V4R5, see V4R5 5769-JV1 Option 5 (JDK 1.3) AS/400 Install Instructions. This is off of the Java Deployment page. There should also be instructions 'soon', presumably off the same page, for V4R4. For those who can't wait, here was the response from Jeff Lee of the AS/400 Toolbox for Java team:

V4R4 5769-JV1 Option 5 (JDK 1.3) AS/400 Install Instructions


This document describes what you need to do to get JDK 1.3 (also known as Java 2 version 1.3) operational on your AS/400. This is contained in PTF 5769-JV1 SF63322.

Before You Begin

In order for JDK 1.3 to work on your AS/400, you must first have V4R4M0 installed with PTF CUM package C0147440 or later. You must also have 5769-JV1 Option *BASE installed. You may then optionally install option 1 (JDK 1.1.6) and/or option 2 (JDK 1.1.7).

Since some Java applications may not work with JDK 1.3, you may want to have one of these options installed. For example, a version of WebSphere requires JDK 1.1.7.

Follow the instructions below to install the Java group PTF and 5769-JV1 Option 5.

It is very important that you install the Java group PTF before you install option 5. Do not install option 5 until you have the correct level of the Java group PTF installed.

Java Group PTF

Order and install the Java group PTF, SF99067. Follow the instructions included with the group PTF. Use the following command to verify that the correct level of the group PTF has been installed:


Output will show 'Group PTF#: SF99067-06' along with a date. If you have '-05' or less displayed, you need to reorder the PTF to get the most updated version.

To install the group PTF do the following:

on the AS/400 command line enter GO PTF

select option 8

specify PTF type 1 (all PTF's) and automatic IPL Y.

Install 5769-JV1 Option 5

JDK 1.3 is product 5769-JV1 Option 5. This is contained in PTF 5769-JV1 SF63322. You will need to order this PTF. It will be sent to you on a CD. Read the cover letter; it contains additional information.

Load the CD containing the PTF in the drive and enter:


where OPTxx is the ID of your CD drive.

Set up Symbolic Links

In JDK 1.3, functions like JDBC, SSL, and JNDI are JDK extensions. To use a JDK extension, first find the ".jar" file in the '/QIBM/ProdData/Java400/ext/' directory. Then, a symbolic link needs to be established once to make the files a part of the '/QIBM/UserData/Java400/ext/' directory. This is so that the class loader can find them. For example, to establish the symbolic link for JDBC, use the following command:

ADDLNK OBJ('/QIBM/ProdData/Java400/ext/db2_classes.jar')


Other non-IBM provided extensions (in ".jar" files) can be loaded directly into the '/QIBM/UserData/Java400/ext/' directory.

Verify the Functionality of JDK 1.3

Use the following command to verify that JDK 1.3 is working on your system:

JAVA CLASS(com.ibm.as400.system.Hello) PROP((java.version 1.3))

A screen should be displayed that shows:

Hello World

Java program completed

Press enter on this screen to return to the AS/400 command entry screen.

If this command does not work, then you need to contact your service representative for help in getting JDK 1.3 to work on your system.

Using JDK 1.3 on Your AS/400

In V4R4, 5769-JV1 supports Options 1-5. The default JDK used on the system is listed by order of preference below.

1.Option 3 (JDK 1.2)

2.Option 5 (JDK 1.3)

3.Option 4 (JDK 1.1.8)

4.Option 2 (JDK 1.1.7)

5.Option 1 (JDK 1.1.6)

For example, if the AS/400 has all 5 supported options installed, Option 3 (JDK 1.2) is the default.

To force the use of JDK 1.3 when using JAVA, you will need to specify the 'java.version=1.3' property as in the Verify example above.

To make JDK 1.3 the default when JDK 1.2 is installed, set the java.version property to 1.3 in the SystemDefault.properties file. (ie. Specify "java.version=1.3" inside the file) The SystemDefault.properties file is not shipped as part of the JDK 1.3 LPP; it is a text file that is created by the user. There are two places the file can be placed:

User Home : /home/userid/SystemDefault.properties

Java Home : /QIBM/UserData/Java400/SystemDefault.properties

The priority in which properties are used is:

1.User specifies on the JAVA command

2.User Home

3.Java Home

4.environment variable

It is advised to place the SystemDefault.properties only in your User Home, as placing it in Java Home will cause ALL users on the systems to pick up the values in this file, whether they want to or not.

The JV1 product has a separate option for each level of the JDK. JDK 1.3 pushes the number of options to 5. In general, you should only load the levels of JDK required by the applications you use. Loading additional options will just take up extra disk space on your AS/400. For example, if you run an application and it requires JDK 1.3 then I would load only *BASE and option 5. If you get another app and it requires another level of the JDK then load it at that time.