| 
 |  | 
        
        
          |  |  
          | 
              
              
                | V4R5 5769JV1 Option 5 (JDK 1.3) AS/400 
                  Install Instructions |  
              
              
                | Reference #: | 862569C3007B11CD |  
                | Modified on: | 2001/01/19 |  Product 
            Information
 
              
              
                | Product: | AS/400 Developer Kit for Java - 
                  AS/400 DEVELOPER KIT FOR JAVA (5769JV100) |  
                | Release: | V4R5M0 |  Introduction
 
 This document describes what you need to do to get JDK 1.3 
            (also known as Java 2 version 1.3) operational on your iSeries 400 
            or AS/400e server. This information is contained in 5769JV1 PTF 
            SF63319 which can be ordered from Boulder, 
            Colorado.
 
 Before You 
            Begin
 
 In order for JDK 1.3 to work on 
            your server, you must first have V4R5M0 installed with PTF CUM 
            package C0189450 or later. You must also have 5769JV1 Option *BASE 
            installed. You may then optionally install option 3 (JDK 1.2) and/or 
            option 4 (JDK 1.1.8).
 
 Since some Java 
            applications may not work with JDK 1.3, you may want to have one of 
            these options installed. For example, the current version of 
            Websphere requires JDK 1.2.
 
 Follow the 
            instructions below to install the Java group PTF and 5769JV1 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, SF99068. 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:
 
 DSPDTAARA QJAVA/SF99068
 
 Output 
            will show Group PTF#: 
            SF99068-01 or later, along with a 
            date.
 
 To install the group PTF do the 
            following:
 
 
 
              
              
                | 1 | On an OS/400 command line, type 
                  the following: 
 GO 
                  PTF
 
 Press the Enter 
                key.
 |  
                | 2 | Select option 8. |  
                | 3 | Specify PTF type 1 (all PTFs) and 
                  automatic IPL Y. |  Install 5769JV1 Option 
            5
 
 JDK 1.3 is product 5769JV1 Option 
            5. This is contained in 5769JV1 PTF SF63319. 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 the 
            following:
 
 RSTLICPGM LICPGM(5769JV1) OPTION(5) DEV(OPTxx)
 
 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')
 NEWLNK('/QIBM/UserData/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 the following:
 
 Hello 
            World
 Java program completed
 
 Press the Enter key on this screen to 
            return to the OS/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 Server
 
 In V4R5, 5769JV1 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 server has all five 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. (for example, 
            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.
 More 
            Information
 
 More information about 
            JDK 1.3 on the iSeries 400 or AS/400e server can be found here.
 
 
 AS/400 
            Technical Support
 |  
          |  |  |