Release Notes

Contents

• » Introduction
• » Installing the JRE
• » Using the Run Time Environment
• » Using the Plug-in
  • » Installing and Running SWB and the Plug-In
  • » Placing Plug-ins
  • » The Plug-in Control Panel
• » Redistributing the JRE
• » Bundling the JRE
• » Problem Reporting

Introduction

Thank you for downloading J2SE™ Runtime Environment (JRE) 6.0-1 for the OpenVMS I64 Operating System for the Java™ Platform (hereafter called the JRE). The JRE comprises the Java virtual machine, the Java platform core classes, and supporting files. It is the runtime part of J2SE™ Development Kit (JDK) 6.0-1 for the OpenVMS I64 Operating System for the Java Platform (hereafter called the JDK), but without the development tools such as compilers and debuggers. The JRE contains Plug-in software that enables Secure Web Browser (SWB) based on Mozilla® (1.7-8 or higher) or based on SeaMonkey ( 1.1-12 or higher) to use the JRE to run Java applets. These Release Notes provide installation instructions for the JRE and information that may be useful for developers who want to redistribute the JRE with their software. Also, note that the HotSpot Virtual Machine is included with the JRE kit. For this release, Java Web Start and JVMTI are not supported. For more information about this release, refer to the JDK 6.0-1 Release Notes and the JDK 6.0x User Guide.

IMPORTANT: Please make sure you understand the Copyright (copyright.html, installed file) and License (license.html, installed file) information before using this release. On OpenVMS, the Java virtual machine has a minimum required value for PGFLQUOTA of 512000 blocks (250 MB). Please see section Setting Process Quotas for Better Performance on OpenVMS in the JDK User Guide for more information.

Installing the JRE

To install and use this kit on OpenVMS systems, you must first download and install the operating system patches. See the product page on the Web site for more information.

HP suggests that the JRE be installed in its own subdirectory (referred in Figure 1 as <JRE_RUNTIME_BASE>). This allows you to update the JRE independently of updates to your application, and vice versa.

Figure 1: Sample JRE Installation

  
              <APP-DIR>
                  |
 +---------+------+---------------------+
 |         |                            |
BIN       LIB                   <JRE_RUNTIME_BASE>
           |                            |
     APPLICATION.JAR         +----------+--------+-------+
                             |          |        |       |       
                            BIN        LIB    PLUGIN    DOC

                                   Supplied by HP

The files that make up the JRE are bundled into two OpenVMS BACKUP save sets:

JRE-V60-1_A.SAV
JRE-V60-1_A.SAV is a REQUIRED subset of files (approximately 280,000 blocks). Your licensing agreement requires that if you redistribute any part of the JRE, you must redistribute this set of files in its entirety. If you do not distribute all files, the JRE and your application may not work. To obtain a detailed list of the files in this save set, use the following command:

$ BACKUP/LIST JRE-V60-1_A.SAV/SAVE_SET

Note: The HotSpot VM files are included in this save set.

JRE-V60-1_B.SAV
The second save set, JRE-V60-1_B.SAV is an OPTIONAL subset of files (approximately 19,000 blocks). You may need some of these files to fully support your application in an international arena. This set does not need to be deployed in its entirety. To list the files in the optional save set, issue the following command:

$ BACKUP/LIST JRE-V60-1_B.SAV/SAVE

To download and unpack the REQUIRED and OPTIONAL save sets, do the following:

1. Download:
   Download HP-I64VMS-JRE-V0106-1-1.SAV_SFX_I64EXE (approximately 115,000 blocks) from our web site. Execute this file to create the JRE-V60-1_A.SAV and JRE-V60-1_B.SAV save sets:

   $ RUN HP-I64VMS-JRE-V0106-1-1.SAV_SFX_I64EXE

2. Unpack Save Sets:
   Unpack the JRE-V60-1_A.SAV and JRE-V60-1_B.SAV files into the appropriate subdirectories of your application. Continuing with the typical directory structure illustrated in Figure 1, move the save sets into the [.JRE_RUNTIME_BASE] directory, then issue the following commands (edited to match your actual disk and directory names):

   $! Position yourself to the base directory for the JRE components
$ SET DEFAULT USER1$:[APP-DIR.JRE_RUNTIME_BASE]
$!
$! To unpack the JRE-V60-1_A.SAV save set,
$ BACKUP JRE-V60-1_A.SAV/SAVE [...]*.*
$!
$! To optionally unpack the JRE-V60-1_B.SAV save set,
$ BACKUP JRE-V60-1_B.SAV/SAVE [...]*.*

For information on bundling the JRE with application software for redistribution, refer to Bundling the JRE.

Using the Run Time Environment

After installing the JRE, a number of symbols and logicals need to be set up to enable you to use the JRE. A JRE setup command file, JAVA$60_JRE_SETUP.COM, is deposited into the [.LIB] directory, resulting from restoring JRE-V60-1_A.SAV. Select the HotSpot VM as your virtual machine using this command file. Run this command file as follows:

$ @USER1$:[APP-DIR.JRE_RUNTIME_BASE.LIB]JAVA$60_JRE_SETUP

where USER1$:[APP-DIR.JRE_RUNTIME_BASE. denotes the actual disk and directory name where you installed the JRE.

The Java command-line tool can then be used to launch your Java application using the JRE.

Using the Plug-in

The Java Plug-in enables users to run Java applets and JavaBeans™ components on web pages using the JRE as an alternative to using the default virtual machine for Java 2 that comes with the web browser. It is based on the Java Plug-in provided by Sun Microsystems and contains similar functionality.

For additional information on topics such as Java Plug-in Security, using Signed Applets, JNI and the Java Plug-in, using the Java Plug-in in Intranet Environments, and how Proxy Configuration works in the Java Plug-in, see the Sun Microsystems Java Plug-in Technology web site.

Note: The minimum version of Secure Web Browser (SWB) that supports JDK 6.x is SWB 1.7-8 based on Mozilla®, or SWB 1.1-12 based on SeaMonkey.

Note: For simplicity, this document assumes you installed the JDK using the default location and therefore references SYS$COMMON:[JAVA$6x] throughout the text. However, if you specified a destination and installed the kit in that alternate location, substitute that location for the default while reading this document.

Installing and Running SWB and the Plug-In

Note: These instructions are written for SWB based on Mozilla, but the instructions for SWB based on SeaMonkey are similar.

To install Mozilla:

1. Download SWB.
2. Refer to the HP Secure Web Browser for OpenVMS I64 (based on Mozilla) Installation Guide and Release Notes to install Mozilla on your system.

To run SWB:

$ @SYS$COMMON:[CSWB]MOZILLA

Note: We strongly recommend that you run SWB as an interactive job as indicated above.

If you spawn it off as a subprocess:

$ spawn/nowait @SYS$COMMON:[CSWB]MOZILLA

you will likely exhaust some resources if you attempt to use the plug-ins for anything non-trivial.

To enable the JRE within your browser:

1. Set preference:

   Edit->Preferences
   Click on Advanced.
   Check button labeled Enable Java.

2. Exit SWB.
   
   
3. When both JRE 6.x and CSWB have been installed in the standard areas, perform a one-time file copy to install the Plug-in:

   $ copy /prot=W:RE -
SYS$COMMON:[JAVA$6x.JRE.PLUGIN.IA64.NS7]LIBJAVAPLUGIN_OJI.SO -
SYS$COMMON:[CSWB.PLUGINS]


   where x is the specific version number of the release you are using. Thereafter, you can set up for Java operation:

   $ @SYS$COMMON:[JAVA$6x.COM]JAVA$6x_JRE_SETUP.COM

   where x is the specific version number of the release you are using.



4. Then run SWB:

   $ @sys$common:[CSWB]mozilla

   SWB will notice that new plug-ins are available and will then initialize those plug-ins for the current invocation.

To verify that Mozilla has found the plug-ins refer to:

Help->About Plug-ins

SWB will display the plug-ins it has initialized.

Placing Plug-ins

As of Mozilla 1.1 and Secure Web Browser (SWB) 1.0, you can choose where to place plug-ins.

For "system wide" use, the location would be (as before) in the Mozilla/SWB installation tree:

SYS$COMMON:[MOZILLA.PLUGINS]
SYS$COMMON:[CSWB.PLUGINS]

For example, for SWB, use the following command to place the plug-in in the "system-wide" location:

$ copy /PROT=W:RE -
SYS$COMMON:[JAVA$6x.JRE.PLUGIN.IA64.NS7]LIBJAVAPLUGIN_OJI.SO -
SYS$COMMON:[CSWB.PLUGINS]

where x is the specific version number of the release you are using.

You can also set up "private" plug-ins by creating a [.PLUGINS] directory in your _MOZILLA directory (which resides in SYS$LOGIN). For example:

USERS:[FLINTSTONE._MOZILLA.PLUGINS]

To use this "private" plug-ins area:

$ copy /PROT=W:RE -
SYS$COMMON:[JAVA$6x.JRE.PLUGIN.IA64.NS7]LIBJAVAPLUGIN_OJI.SO -
USERS:[FLINTSTONE._MOZILLA.PLUGINS]

Essentially, if you place a LIBJAVAPLUGIN_OJI.SO into USERS:[FLINTSTONE._MOZILLA.PLUGINS], it will be used by Mozilla and override what is in SYS$COMMON:[CSWB.PLUGINS].

The Plug-in Control Panel

A Plug-in Control Panel (available for 1.4.x and later) lets you change Plug-in options such as proxies and enabling of the Java console window. It also allows you to switch the JRE version you want to run with your Plug-in. To run the Control Panel, enter the following command:

$ ControlPanel

Please refer to Sun's Java Control Panel web page for information about additional features and uses of the Java Plug-in Control Panel.

Redistributing the JRE

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

• Do not arbitrarily subset the JRE. You may omit only the files in the JRE-V60-1_B.SAV optional subset.
  
  
• Include in your product's license the provisions called out in the JRE Binary Code License.

The following JDK files may be redistributed with the JRE:

• SYS$COMMON:[JAVA$60.BIN]JAVAC.
• SYS$COMMON:[JAVA$60.BIN]JAVA$JAVAC.EXE
• SYS$COMMON:[JAVA$60.LIB]TOOLS.JAR
  

These files include Java 2 JDK tools classes, including the classes for the javac compiler.

Bundling the JRE

For your end users to run your software, they'll need a Java runtime environment installed on their systems. The JDK contains a runtime environment, of course, so your customers could use that if they happen to have it installed. However, a better bet for most of your end users will be the JRE, for several reasons:

• The JRE is redistributable, unlike the JDK. The JRE Binary Code License agreement allows you to package it with your software. By distributing the JRE with your application, you can ensure that your customers will have the correct version of the runtime environment for running your software. In other words, your customers will be running the exact code you've tested.
  
  
• The JRE is smaller than the JDK. The JRE contains everything your users will need to run your software, but it leaves out the development tools, demo applets, and applications that are part of the JDK. Because the JRE is relatively small, it's easier for you to package with your software or for your users to download themselves from our web site.

Table 1 below lists the notable differences between the JRE and the JDK:

Table 1: Notable Differences Between the JRE and the JDK

For more information on bundling an application in a Java Archive (JAR) file, refer to Packaging Your Application in a JAR File on Sun's site.

When bundling the JRE with application software on the OpenVMS I64 platform, the following points should be considered:

1. Software vendors should bundle the JRE files and an installer with the Java software they supply to end-users. HP suggests that the JRE be installed in its own subdirectory (called <JRE_RUNTIME_BASE> in Figure 1). This allows you to update the JRE independently of updates to your application, and vice versa.
   
2. In addition to unpacking the files in the JRE, a number of symbols and logicals need to be set up to make your application run within the JRE. When you deploy your application, you will have to include your own .COM files that accomplish these setups. An JRE setup command file, JAVA$60_JRE_SETUP.COM, is deposited into the [.LIB] directory, resulting from restoring JRE-V60-1_A.SAV. This file contains the key commands you will need to merge into your application setup command file.
   
3. The JRE operates with a special set of class libraries — RT.JAR. Your application must function with just these libraries.
   
4. You are not allowed to redistribute any class files from the JDK, and your application should have no dependencies on these files. You can redistribute the jar files that are part of the JRE.
   
5. HP recommends that you not rely on the CLASSPATH logical that might be on the target system, but explicitly identify the classpath by specifying the -cp option on the Java command line that invokes the JRE. (For more information on using the -cp option of the Java command, refer to Sun's Tools and Utilities documentation.)
   Hence, a typical Java command line when using the JRE will look like:
   $ JAVA -cp "/USER1$/APP-DIR/LIB/APPLICATION.JAR:." "Application"

Problem Reporting

To report problems, refer to our Software Support web page.