Skip to main content

IBM Systems  >  System z  >  Software  >  

Readme File - Java for OS/390, Java 2 Technology Edition, SDK 1.3.1
(last updated September, 2007)

  

Note: End of Service for the IBM Developer Kit for OS/390, Java 2 Technology Edition is September 30, 2007. The SDK 1.3.1 product information will move to archive by year end.

Getting the code:

You can download the latest version of the code to your workstation by choosing the IBM SDK 1.3.1 file UK29539.PAX.Z for a non-SMP/E install or UK29539.PTF.Z for an SMP/E install.

If you are a first time SMP/E user, you must first download and install HJVA130.PAXBALL.Z prior to installing the SMP/E PTF.

To assist you with the download, a link to Download Director is available. Download Director is a highly reliable tool designed to resume an interrupted download connection, access files through the firewall, and download large files.

To verify that the download was complete you should determine if the file sizes of the files downloaded match the file sizes on the IBM server.

The current size of the files on the IBM server are as follows:

Non-SMP/E File:      
    UK29539.PAX.Z           108182 KB       108182187 bytes
  
SMP/E Files:   
    UK29539.PTF.Z           113658 KB       113657840 bytes 
      
    HJVA130.PAXBALL.Z        85571 KB        85571460 bytes

Once the file has been downloaded to your workstation, you will need to use a binary transfer to move the file to an HFS directory on your OS/390 or z/OS system with an adequate amount of space. An HFS directory with at least 600 MB of space is recommended.

For SMP/E installs after download, see Getting the Product.

NOTE: Prior to installing the code, be sure that you have fixes for the following prerequisite APARS on your OS/390 or z/OS system:

You must apply the fixes for the following APARs in order to use this product:

  • PQ40047
  • PQ40048
  • OW45508
  • OW45580
  • OW48160
  • PQ37095
  • PQ39287

IBM recommends that you also apply the fixes for the following APARs for this product:

  • PQ26125
  • PQ26525
  • PQ36944
  • PQ39622
  • PQ39940
  • PQ40027
  • OW47432

IBM recommends that you apply the following apars if you are running R10 and higher and are running highly threaded applications:

  • OW54362 or OW55013
  • PQ60748

Java will NOT function without these APARs.

Non-SMP/E: Uncompress and install the code:

Once you have the code in your HFS directory you will need to uncompress the file to complete the installation.

  1. Download the compressed PAX package to the directory where you would like to keep the image. The recommended directory is:
    2.    /usr/lpp/java/IBM/
  2. Use the PAX command to restore the code archive, as follows:
    3. 		
   pax -ppx -rvzf UK29539.PAX.Z
    Note: SDK 1.3.1 comes packaged with the +p bit already set for the files in the "J1.3/bin" and "J1.3/bin/classic" directories, replacing the "mvs/native_threads" directory.

  3. The command will create and expand the code in directory J1.3

    4. If you are not able to restore the code archive with this command, it may be because you do not have the necessary authority (see "Required authorization") to restore the program control bit. In this case, you can issue the following command. Please note, certain applications may require that the program control bit be set.

       pax -pp -rvzf UK29539.PAX.Z

Required authorization:

To restore the files with the proper permission bits, you must have the following authority:

  • - UID(0) or access to BPX.SUPERUSER.FACILITY class
  • - Access to BPX.FILEATTR.APF
  • - Access to BPX.FILEATTR.PROGCTL
  • - Access to BPX.FILEATTR.SHARELIB

Note: Access to BPX.FILEATTR.* could be used instead.

This is the typical authority you require to install z/OS.

Please note, certain applications may require that the program control bit be set.

Verification:

Post Installation Information

If you were successful in downloading and uncompressing all the files, there should be a file titled "JDK_INSTALL_OK" in the directory J1.3.

Set the Environment

The installation below assumes you installed the code into the following directory:

   /usr/lpp/java/IBM

Set the following environment variables:

   export PATH=/usr/lpp/java/IBM/J1.3/bin:$PATH
   export DISPLAY=hostname.of.my.machine:0.0  
      (if running with an Xserver)

Verify the Install

To verify that the install process completed successfully, issue the following command:

   java -version

You will see the following message showing the java version level and other information:

   java version "1.3.1"
 Java(TM) 2 Runtime Environment, Standard Edition
                                 (build 1.3.1)
 Classic VM (build 1.3.1, J2RE 1.3.1 IBM OS/390
             Persistent Reusable 
 VM build cm131s-20070913 (SR28) (JIT enabled: jitc))

The CLASSPATH environment variable can be updated. For example, issue the following command to set the CLASSPATH variable:

    export CLASSPATH=.:/path/to/my/classes:$CLASSPATH

In this example, the JVM will first look for the required classes in the current directory. If the required classes are not found there, the JVM will look in the /path/to/my/classes directory.

NOTE: It is no longer necessary to add system classes (classes.zip in JDK1.1.8) to CLASSPATH.