Redistributing the IBM 32-bit Runtime Environment for Windows, Java 2 Technology Edition, Version 1.4.2


Copyright information

Note: Before using this information and the product it supports, be sure to read the general information under Notices.

This edition of the User Guide applies to the IBM 32-bit Runtime Environment for Windows, Java 2 Technology Edition, Version 1.4.2, and to all subsequent releases and modifications until otherwise indicated in new editions.

(c) Copyright Sun Microsystems, Inc. 1997, 2003, 901 San Antonio Rd., Palo Alto, CA 94303 USA. All rights reserved.

(c) Copyright International Business Machines Corporation, 1999, 2004. All rights reserved.

U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Preface

The IBM(R) 32-bit Runtime Environment for Windows(R), Java(TM) 2 Technology Edition, Version 1.4.2 contains the Java Virtual Machine (JVM), core Sun Microsystems Java classes, and supporting files. The Runtime Environment does not contain all the classes found in the SDK package.

This guide provides general information about redistributing the Runtime Environment.

The Runtime Environment is supported on the following products:

Note that the Runtime Environment for Windows is a subset of the SDK and enables you only to run Java applications.

Contents

Copyright information
Preface
Redistributing the JRE
Version compatibility
Files included with the Runtime Environment
Runtime documentation
Redistribution requirements
Installing your application on a user's system
Adding the Runtime Environment to the registry
Adding the Plug-in to the registry
Adding fonts to the registry
Adding Web Start to the registry.
Notices
Trademarks

Redistributing the JRE

Version compatibility

There is no guarantee that 1.4.2-compiled classes work on pre-1.4.0 Runtime Environment releases.

Files included with the Runtime Environment

The Runtime Environment contains .dll files, the Java Virtual Machine (JVM), core Sun Microsystems Java classes, and supporting files. The Runtime Environment does not include any of the development tools, such as appletviewer or javac, or classes that are relevant only to a development system.


Runtime documentation

Each property file contains comments that describe what the file is useful for and how to modify it.

For more information about the Runtime Environment, see the IBM 32-bit Runtime Environment for Windows, Java 2 Technology Edition, Version 1.4.2, User Guide.

Redistribution requirements

When you redistribute the Runtime Environment, you are required to include all the files from the Runtime Environment package for redistribution, ibm-jre-n142p-win32-x86.zip.

The term required means that licensees who distribute the Runtime Environment must include those files with their program, whether or not their program ever uses those files.

The Runtime Environment includes the \bin and \lib directories and their subdirectories. These two directories and their subdirectories must reside in the same directory. The bin directory contains executable files and native libraries. The lib directory contains the classes and property files.

Note: The native code C runtime library, msvcrt.dll, is located in the Windows system directory. Ensure that file is in the Windows system directory. The location of this directory is usually:

Installing your application on a user's system

In your product, you must provide a way to:

If you redistribute the Runtime Environment, ensure that your installation procedure does not overwrite an existing installation (unless the existing Java Runtime Environment is an older version).

The preferred approach is to take the files contained in the redistributable Runtime Environment zip file, ibm-jre-n142p-win32-x86.zip, and install them in the same directory structure. Include all the files in the bin and lib directories and their subdirectories. The Runtime Environment software can be redistributed only if all these files are included. In effect, when you ship your application, it has its own copy of the Runtime Environment. If you use this approach, do not try to emulate the installation steps that are performed by the Runtime Environment installer.

When you install the Runtime Environment, you must record program information in the Windows Registry. Open the Registry Editor by typing regedit at a command prompt.

Adding the Runtime Environment to the registry

Navigate to HKEY_LOCAL_MACHINE/SOFTWARE/IBM/ and add the following Key and Value sets to the Registry to enable the IBM Runtime Environment.

Table 1. Key and Value Sets to add to registry.
Key name Key Value
Java2 Runtime Environment/1.4.2/JavaHome root dir of java\jre
Java2 Runtime Environment/1.4.2/RuntimeLib root dir of java\jre\bin\classic\jvm.dll
Java2 Runtime Environment/1.4.2/Microversion 0

Adding the Plug-in to the registry

Navigate to HKEY_LOCAL_MACHINE/SOFTWARE/IBM/ and add the following Key and Value sets to the Registry to enable the Java Plug-in to find the IBM Runtime Environment.

Table 2. Key and Value Sets to add to registry.
Key Name Key Value
Java Plug-in/1.4.2/JavaHome root dir of java\jre
Java Plug-in/1.4.2/RuntimeLib root dir of java\jre\bin\classic\jvm.dll

Adding fonts to the registry

All the font files have been removed from the IBM 32-bit Runtime Environment for Windows, Java 2 Technology Edition, Version 1.4.2, with the exception of LucidaSansRegular.ttf. If you want to add other font files to your Runtime Environment, it is legal for you to copy them from the SDK. (You can download the SDK from here.)

Add the following Key and Value sets to the Registry for fonts included in the IBM Runtime Environment where the JRE Program Files are installed:

Table 3. Key and Value Sets to add to registry for fonts.
Key name Key value
Lucida Sans Typewriter Regular (TrueType) LucidaTypewriterRegular.ttf
Lucida Bright Demibold Italic (TrueType) LucidaBrightDemiItalic.ttf
Lucida Bright Italic (TrueType) LucidaBrightItalic.ttf
Lucida Bright Regular (TrueType) LucidaBrightRegular.ttf
Lucida Sans Demibold (TrueType) LucidaSansDemiBold.ttf
Lucida Sans Demibold Oblique (TrueType) LucidaSansDemiOblique.ttf
Lucida Sans Oblique (TrueType) LucidaSansOblique.ttf
Lucida Sans Regular (TrueType) LucidaSansRegular.ttf
Lucida Sans Typewriter Bold (TrueType) LucidaTypewriterBold.ttf
Lucida Sans Typewriter Bold Oblique (TrueType) LucidaTypewriterBoldOblique.ttf
Lucida Sans Typewriter Oblique (TrueType) LucidaTypewriterOblique.ttf
Lucida Bright Demibold (TrueType) LucidaBrightDemiBold.ttf

An example of the full path for a key value is:

C:\Program Files\IBM\Java142\jre\lib\fonts\
LucidaTypewriterRegular.ttf

Adding Web Start to the registry.

Navigate to HKEY_LOCAL_MACHINE/SOFTWARE/IBM/ and add the following Key and Value sets to the Registry to enable the Java Web Start to find the IBM Runtime Environment.

Table 4. Key and Value Sets to add to registry.
Key Name Key Value
Java Web Start v1.2/1.0.1/Home root dir of java\jre\bin
Java Web Start v1.2/1.0.1_02/Home root dir of java\jre\bin
Java Web Start v1.2/1.0.1_03/Home root dir of java\jre\bin
Java Web Start v1.2/1.2/Home root dir of java\jre\bin

Notices

This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to:

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to:

The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the information. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this information at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you.

Licensees of this program who wish to have information about it for the purpose of enabling (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact:

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee.

The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products.

Trademarks

IBM is a trademark of International Business Machines Corporation in the United States, or other countries, or both.

IBM is a trademark of International Business Machines Corporation in the United States, or other countries, or both.

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both.

Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.

Intel, Intel Inside (logos), MMX and Pentium are trademarks of Intel Corporation in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.

This product includes software developed by the Apache Software Foundation http://www.apache.org/.