                                           Readme
                        Compaq Run Time Environment (RTE) v 1.1.8-14
[COMPAQ]                   for the Tru64 UNIX Operating System
                                   for the Java Platform

  ------------------------------------------------------------------------

Contents

   * Introduction
   * Installing the RTE
   * Using the RTE
   * Redistributing the RTE
   * Bundling the RTE

Introduction

Thank you for downloading the Compaq Run Time Environment (RTE) v 1.1.8-14
for the Tru64 UNIX Operating System for the Java Platform (hereafter
called the Compaq RTE or, simply, the RTE). The RTE comprises the Java
virtual machine, the Java platform core classes, and supporting files. It
is the runtime part of the Compaq Software Development Kit (SDK) v 1.1.8-14
for the Tru64 UNIX Operating System for the Java Platform (hereafter called
the Compaq SDK or the SDK), but without the development tools such as
compilers and debuggers.

This Readme provides installation instructions for the RTE and information
that may be useful for developers who want to redistribute the RTE with
their software.

IMPORTANT: Please make sure you understand the Copyright (COPYRIGHT,
installed file) and License (LICENSE, installed file) information before
using this release.

Installing the RTE

Presently, this RTE v 1.1.8-14 release does not require any operating
system patches. However, the need for patches may be discovered after this
release becomes available. Therefore, we recommend that you check our patch
installation page for the latest information.

The following steps must be done as superuser. Untar the binary kit in a
scratch directory, then use the setld command to load from that directory.
This example uses /tmp/java as the scratch directory, and assumes the tar
file is in /tmp:

   cd /tmp/java
   tar xf /tmp/javajre118-14.tar
   setld -l /tmp/java

There are two subsets in this kit:

   * JAVJRE118 -- The mandatory subset, which provides support for running
     Java programs

   * JAVJREOPT118 -- The optional components, mostly font files for
     internationalization support

     Installation of the JAVJRE118 subset creates /usr/opt/jre118 and
     installs the RTE in /usr/opt/jre118/bin and /usr/opt/jre118/lib. You
     can see the files installed by the mandatory subset by means of the
     following command:

          setld -i JAVJRE118

   * The optional JAVJREOPT118 subset installs the following files in
     /usr/opt/jre118/lib:


                           JAVJREOPT118 Installed Files

                  File                              Contents

      il8n.jar                      I18N character conversion classes from
                                    sun.io

      font.properties.cs            AWT font properties for Czech locale

      font.properties.el            AWT font properties for Greek locale

      font.properties.hu            AWT font properties for Hungarian locale

      font.properties.ja            AWT font properties for Japanese locale

      font.properties.ko            AWT font properties for Korean locale

      font.properties.lt            AWT font properties for Lithuanian
                                    locale

      font.properties.lv            AWT font properties for Latvian locale

      font.properties.pl            AWT font properties for Polish locale

      font.properties.ru            AWT font properties for Russian locale

      font.properties.tr            AWT font properties for Turkish locale

      font.properties.zh_EUC_CN     AWT font properties for Simplified
                                    Chinese

      font.properties.zh_HK_Big5    AWT font properties for Traditional
                                    Chinese

      font.properties.zh_HK_EUC_TW  AWT font properties for Traditional
                                    Chinese

      font.properties.zh_TW_Big5    AWT font properties for Traditional
                                    Chinese

      font.properties.zh_TW_EUC_TW  AWT font properties for Traditional
                                    Chinese

      psfont.properties.ja          AWT font properties for Japanese
                                    Postscript

Using the RTE

The RTE can be invoked by the command-line tool jre, the Java Runtime
command, which is included in both the RTE download and the SDK download.

In many respects, the jre tool is similar to the SDK's java tool. The -cp
option of the jre tool is recommended for explicitly specifying an
application's class path.

Redistributing the RTE

If you redistribute the RTE, you must follow the terms of the RTE Binary
Code License agreement, which includes these terms:

   * Do not arbitrarily subset the RTE. You may omit only the files in the
     JAVAJREOPT118 optional subset.

   * Include in your product's license the provisions called out in the RTE
     Binary Code License.

The following SDK files may be redistributed with the RTE:

   * /usr/opt/java118/bin/alpha/native_threads/javac
   * /usr/opt/java118/bin/javac

Bundling the RTE

This release of the RTE for Compaq Tru64 UNIX is packaged as two setld
subsets, which makes it suitable for downloading by end users. Java
application developers have the option of not bundling the RTE with their
software. Instead, they can direct end users to download and install the
RTE themselves.

When bundling the RTE with application software on Tru64 UNIX, consider the
following points:

  1. You should include the RTE files under a common directory
     (<runtime-dir>). Include all the required files from
     /usr/opt/jre118/bin and /usr/opt/jre118/lib in the bin and lib
     subdirectories of <runtime-dir>, following the same directory
     hierarchy and relative placement of files. The internationalization
     files installed by the optional subset can be included for language
     localization support.

  2. You should place all application-specific classes in a directory other
     than <runtime-dir>. Application-specific classes can be individual
     .class files, .jar files, or .zip files.

  3. If native code support is required, then the native library must be
     located in LD_LIBRARY_PATH. The best way to do this is to install the
     native libraries in <app-dir>/lib/<sys>. LD_LIBRARY_PATH should then
     be set to include these directories.

  4. You can invoke the application by using the jre command-line tool with
     the -cp option to specify the application's class path. In the
     standard installation, for example, the command might look like this:

        /usr/opt/jre118/bin/jre -cp <app-dir>/lib/app.jar <classname>

  ------------------------------------------------------------------------
  2002 Compaq Information Technologies Group, L.P.
 Compaq Registered in U.S. Patent and Trademark Office.
 Java and all Java-based marks are trademarks or registered trademarks of
 Sun Microsystems, Inc. in the U.S. and other countries.
 All other product names mentioned herein may be trademarks or registered
 trademarks of their respective companies.
 Compaq shall not be liable for technical or editorial errors or omissions
 contained herein. The information in this document is subject to change
 without notice.
