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 64-bit SDK for Windows AMD64/EM64T architecture, Java 2 Technology Edition, Version 1.4.2 and IBM 64-bit Runtime Environment for Windows AMD64/EM64T architecture, Java 2 Technology Edition, Version 1.4.2, and to all subsequent releases, modifications, and service refreshes, 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, 2007. 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) 64-bit SDK for Windows(R) AMD64/EM64T architecture, Java(TM) 2 Technology Edition, Version 1.4.2 and IBM 64-bit Runtime Environment for Windows AMD64/EM64T architecture, Java 2 Technology Edition, Version 1.4.2.
All packages in this SDK are supported on Microsoft(R) Windows(R) XP 64-Bit Edition and Windows Server 2003 64-bit edition.
Before you begin to install, ensure that there is enough space in your C:\WINDOWS\TEMP directory to use during installation. The amount of temporary space required in the TEMP directory during installation is:
If you do not have enough temporary space, the installation program generates an error and terminates the installation. If you do have enough temporary space but 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:
Other packages are provided as zip files:
To install the packages:
If you downloaded the SDK installable package, you can choose whether to install:
You can install them either individually or a combination of them.
In the installation wizard, you are presented with the following options:
If you select Typical, the Runtime Environment is also installed. The Runtime Environment is installed by default in the directory C:\Program Files\IBM\Java142\jre.
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(R) Version" registry key is set to match this installation.
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-amd64-142 /r
or
ibm-java2-jre-amd64-142 /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 directory. After you have copied the file, type the following at a command prompt:
ibm-java2-sdk-amd64-142 /s /f1c:\Windows\setup.iss /f2c:\setup.log ibm-java2-jre-amd64-142 /s /f1c:\Windows\setup.iss /f2c:\setup.log
If the installation is successful, the log file contains ResultCode=0.
The following sections provide basic information about using the SDK.
To obtain the IBM(R) build and version number, at a command prompt type:
java -version
The Just-In-Time (JIT) compiler (j9jit22.dll) dynamically generates machine code for frequently used bytecode sequences in Java applications and applets while they are running.
The SDK for Windows includes the JIT, 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.
To disable the JIT, use the -Xint option. At the command prompt window where you run the application, type:
java -Xint class
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)
If the JIT is not in use, a message is displayed that includes:
(JIT disabled)
For more information about the JIT, see the Diagnostics Guide.
The current version of the Install Shield does not support adding the IBM JVM to the Windows system and making it the System JVM. To make the IBM JVM the System JVM:
to the Windows system directory in either C:\Windows\System32 or C:\Winnt\System32, where C: is the boot drive.
For the Java 2 Runtime Environment:
HKEY_LOCAL_MACHINE\SOFTWARE\IBM\Java2 Runtime Environment
For the Java 2 SDK:
HKEY_LOCAL_MACHINE\SOFTWARE\IBM\Java Development Kit
If you want to keep the IBM JVM but want to make another JVM the System JVM:
HKEY_LOCAL_MACHINE\SOFTWARE\IBM\Java2 Runtime Environment
HKEY_LOCAL_MACHINE\SOFTWARE\IBM\Java Development Kit
To run a Java application, type 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 this sdk or jre 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;%path%
where javadir is the directory where you installed the sdk or jre.
If you are developing Java applications, see the SDK User Guide for more detailed information about setting the PATH and the CLASSPATH.
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, developerWorks, iSeries, pSeries, AS/400, and PowerPC are trademarks or registered trademarks of International Business Machines Corporation in the United States, or other countries, or both.
Java and all Java-based trademarks are 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 is also based in part on the work of the FreeType Project. For more information about Freetype, see http://www.freetype.org.
This product includes software developed by the Apache Software Foundation http://www.apache.org/.