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 IBM 32-bit Runtime Environment for Windows, Java 2 Technology Edition, Version 1.4.1, and to all subsequent releases and modifications until otherwise indicated in new editions.
(c) Copyright Sun Microsystems, Inc. 1997, 2002, 901 San Antonio Rd., Palo Alto, CA 94303 USA. All rights reserved.
(c) Copyright International Business Machines Corporation, 1999, 2003. All rights reserved.
U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
This User Guide provides information about installing and configuring the IBM(R) 32-bit SDK for Windows(R), Java(TM) 2 Technology Edition, Version 1.4.1 and the IBM 32-bit Runtime Environment for Windows, Java 2 Technology Edition, Version 1.4.1.
The Runtime Environment is supported on the following products:
Technical changes for this 1.4.1 User Guide, other than minor or obvious ones such as updating "1.4.0" to "1.4.1", are indicated in red when viewing in HTML or in a color-printed copy and by vertical bars to the left of the changes.
Attended (interactive) installation
Enabling the IBM Accessibility Bridge
Information for European language users
Any comments on this User Guide?
Before you can install either the IBM 32-bit SDK for Java 2 v1.4.1 or the IBM 32-bit Runtime Environment for Java 2 v1.4.1 package, you must download the relevant installation package.
You have the option to download large packages in parts. If you do this, you must also download the Merge utility to combine the parts into one file.
Download all packages to the same directory. (The packages and their file names are listed in Attended (interactive) installation. If you download split packages, download all the parts. Do not change the file names of the files you download.
Before you begin to install, make sure that there is enough space in your TEMP directory to use during installation. By default, this directory is C:\WINDOWS\TEMP.
The amount of temporary space required in the TEMP directory during installation is:
SDK installable package only: 130 MB
Runtime Environment installable package only: 85 MB
If you do not have enough temporary space, the installation program generates an error and terminates the installation. If you believe that you do have enough temporary space available but you still see this message, verify that the packages you are attempting to install were downloaded completely. You can do this by comparing the file sizes of your packages to the file sizes shown on the Web pages from which you downloaded the packages.
The packages you can install are:
In addition, there is another package you can install:
This package is provided as a zip file. See the section Installing Java Communications API for installation instructions.
Other packages are provided as zip files:
If you downloaded any of the installation packages in parts, you must use the Merge utility to put the parts back together. Otherwise, ignore this section.
To merge split packages:
Alternatively, you can type the following at a command prompt in the directory where you downloaded the Merge utility:
mergeutility
This extracts the Merge utility and its required data file.
Alternatively, you can type the following at a command prompt in the directory where you downloaded the Merge utility:
merge
This recreates any packages that are split into multiple files.
To recreate packages manually, at a command prompt type:
copy /b ibm-java2-sdk-141.ex1 + ibm-java2-sdk-141.ex2 + ibm-java2-sdk-141.ex3 ... ibm-java2-sdk-141.exe
Be sure to specify all the file names; if you changed the file names when you downloaded, specify the file names you used when you downloaded the parts.
To install the packages you have downloaded:
Alternatively, type at a command prompt in the directory where you downloaded the packages:
ibm-java2-sdk-141
or
ibm-java2-jre-141
If you downloaded the SDK installable package, the following selections are displayed on the custom installation panel:
If you select SDK, the Runtime Environment is also installed.
The Runtime Environment is always installed, by default, in the C:\Program Files\IBM\Java141\jre directory.
The Java Plug-in is installed by default when you install the Runtime Environment package or select SDK while installing the SDK package.
After installation, you can select IBM Java Plug-in Control Panel 1.4.1 from the Start Programs menu to set the IBM JVM as the default for Internet Explorer.
When you install the Runtime Environment (either as part of the SDK installable package or from the Runtime Environment installable package), you are asked whether you want to install the Runtime Environment as the system Java Virtual Machine (JVM). If you do install it as the system JVM, the installation program copies the java.exe and javaw.exe files into the Windows system directory. If a version of java.exe or javaw.exe currently exists in the Windows system directory, you are prompted to overwrite the existing version with the current version. Installing these files into the Windows system directory makes this Runtime Environment the default JVM for the system. In addition, the "Current Version" registry key is set to match this installation.
Note: Installing the Runtime Environment as the system JVM copies ONLY java.exe and javaw.exe into the Windows system directory. No other executables (such as javac.exe or appletviewer.exe) are copied.
Before you install the Java Communications API package, install the Runtime Environment, either as part of the SDK package or from the Runtime Environment package.
To install the Java Communications API:
For example, if you accepted the default directory when you installed the Runtime Environment, the comm.jar file is in the C:\Program Files\IBM\Java141\jre\lib\ext directory.
If you unzip the file in another directory, the files are placed in the same directory structure, but C:\Program Files\IBM\Java141\ is replaced by the directory where you unzipped the file.
To complete an unattended installation, you must first complete an attended installation and create a response file (setup.iss) that records the choices you made during installation. To work properly, the response file you create must be correct for the computers on which you plan to use it. If necessary, create several response files to use for installing the packages on computers that have different configurations.
To create a response file while running the installation, type the following at a command prompt:
ibm-java2-sdk-141 /r
or
ibm-java2-jre-141 /r
Depending on your Windows product, a response file (setup.iss) is created in either the C:\Windows or C:\Winnt directory, where C: is the boot drive.
The following message might occur during an interactive installation:
Another Java Runtime Environment is currently installed as the System JVM. Select Yes to overwrite this version or No to exit this installation.
If this message is displayed, select No and exit from the installation. Go to the Windows system directory and delete the following two files:
After you have deleted the files, restart the interactive installation using the command shown at the beginning of this section.
On the system on which you will run the unattended installation, copy the setup.iss response file to either the C:\Windows or the C:\Winnt directory. After you have copied the file to the correct directory, type the following at a command prompt:
ibm-java2-sdk-141 /s /f1c:\Windows\setup.iss /f2c:\setup.log ibm-java2-jre-141 /s /f1c:\Windows\setup.iss /f2c:\setup.log
Notes:
If the installation is successful, the log file contains ResultCode=0.
IBM Accessibility Bridge includes four files that are placed in the proper
directories during the default JRE 1.4.1 installation.
These files and their directories are:
Table 1. IBM Accesibility Bridge files.
File | Directory |
---|---|
JawBridge.jar | jre\lib\ext |
JawBridge.dll | jre\bin |
Accessibility.properties | jre\lib |
jaccess.jar | jre\lib\ext |
IBM Accessibility Bridge is installed but disabled by default. To enable IBM Accessibility Bridge, delete the number sign from the beginning of the following line in the Accessibility.properties file:
#assistive_technologies=JawBridge
This Web site tells you more about the Accessibility Utilities:
http://java.sun.com/products/jfc/accessibility.html
To uninstall the SDK, whether you installed using attended or unattended installation:
This removes all of the packages that are installed with the Installer. It does not remove the Java Communications API package or any additional files that have been extracted from the zip packages.
Note: Warning messages might be displayed notifying you that not all files, or registry entries, or both, were removed. This is because Windows believes that certain files are still in use; these files, or registry entries, or both, will be removed during the next reboot.
When you maintain multiple installations between the IBM 32-bit SDK for
Windows, v1.4.1, and previous versions, if you uninstall the
1.3.1 version or earlier while a version 1.4.1 is
still installed on the system, the 1.3.1 uninstaller removes the
following registry keys, and all the subkeys, that are required by the
1.4.1 version:
HKEY_LOCAL_MACHINE/Software/IBM/Java2 Runtime Environment
HKEY_LOCAL_MACHINE/Software/IBM/Java Development Kit
The workaround is to uninstall the earlier version of the IBM 32-bit SDK for Windows, v1.4.1 before installing the 1.4.1 version. Reinstalling the 1.4.1 version will also reinstate the required registry keys. This restriction has been fixed for 1.4.1 and any subsequent release.
To uninstall the Java Communications API package, delete the following files from the directory where you installed the Runtime Environment:
By default, the Runtime Environment is installed in the C:\Program Files\IBM\Java141\ directory.
When uninstalling Web Start, any Windows desktop icons that were created for icons downloaded using Web Start will not be removed.
The following sections provide basic information about using IBM 32-bit SDK for Windows, v1.4.1.
The User Guides are made available as separate downloads in zip file format as ibm-docs-n141p-win32-x86.zip.
Place the zip file in the directory where the Runtime Environment is installed. If you installed to the default directory, this is the C:\Program Files\IBM\Java141\ directory.
To obtain the IBM build and version number, at a command prompt type:
java -version
You can disable or enable Java Accessibility support using the JAVA_ASSISTIVE environment variable. To prevent the JVM from loading Java Accessibility support, set the JAVA_ASSISTIVE environment variable to OFF. Disabling the JAVA_ASSISTIVE environment variable is a good idea if you are running the JVM through network access and you have no need for the Java Accessibility support that the JVM loads by default. Disabling the JAVA_ASSISTIVE environment variable increases the JVM loading performance of Java applications that do not provide Java assistive technology support.
The just-in-time (JIT) compiler (jitc.dll) dynamically generates machine code for frequently-used bytecode sequences in Java applications and applets while they are running.
The Runtime Environment for Windows includes the JIT compiler (jitc.dll), which is enabled by default. You can disable the JIT to help isolate a problem with a Java application, an applet, or the compiler itself.
There are two ways to disable the JIT:
set JAVA_COMPILER=NONE
On Windows NT, Windows 2000, and Windows XP, and Windows Server 2003 you
can also permanently set JAVA_COMPILER from the Environment
settings of the System properties. (For Windows NT, select the Control
Panel, and select System and then select
Environment. For Windows 2000 and Windows XP, and Windows
Server 2003 select the Control Panel and System, and on the
Advanced tab select Environment Variables).
java -Djava.compiler=NONE myapp
To enable the JIT, type at a command prompt:
set JAVA_COMPILER=jitc
To verify whether or not the JIT is enabled, type at a command prompt:
java -version
If the JIT is in use, a message is displayed that includes:
(JIT enabled: jitc)
If the JIT is not in use, a message is displayed that includes:
(JIT disabled)
To run a Java application, type the following at a command prompt:
java classname
where classname is the name of the Java class file (Java application) that you want to run.
Note: If you did not install the Runtime Environment as the system JVM, you must first set the path to include the appropriate directories. To update the path, type the following at a command prompt:
set path=javadir\bin;javadir\jre\bin
where javadir is the directory where you installed the Runtime Environment. By default, this directory is C:\Program Files\IBM\Java141\.
If you are developing Java applications, see the SDK User Guide for more detailed information about setting the PATH and the CLASSPATH. The SDK User Guide is available in the ibm-docs-n141p-win32-x86.zip file. The file name is sdkguide.win32.htm.
In Windows, a process has two codepages: the Ansi (or Windows) codepage and the OEM (or DOS) codepage.
The command window normally uses the OEM codepage. Java converts console output to the codepage of the command window from which Java is started. The javaw command always uses the Ansi codepage. You specify the codepage to use for console output with the -Dconsole.encoding option on the java command. For example, -Dconsole.encoding=Cp1252 causes all console output to be in the Windows Ansi Latin1 codepage (1252).
If you have any comments about the usefulness, or otherwise, of this User Guide, we would be pleased to hear from you through one of these channels. Please note that these channels are not set up to answer technical queries, but are for comments about the documentation only. Send your comments:
The fine print. By choosing to send a message to IBM, you acknowledge that all information contained in your message, including feedback data, such as questions, comments, suggestions, or the like, shall be deemed to be non-confidential and IBM shall have no obligation of any kind with respect to such information and shall be free to reproduce, use, disclose, and distribute the information to others without limitation. Further, IBM shall be free to use any ideas, concepts, know-how or techniques contained in such information for any purpose whatsoever, including, but not limited to, developing, manufacturing and marketing products incorporating such information.
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.
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.
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/.