HOWTO: Installation Instructions for SDK for Java

ID: Q183712

The information in this article applies to:

SDK for Java, versions 2.0, 2.01, 2.02, 3.0, 3.1
Microsoft SDK for Java, versions 2.0, 2.01, 2.02, 3.0, 3.1
Microsoft Visual J++, versions 1.0, 1.1

SUMMARY

This article provides details on how to install the SDK for Java and how to use the Clspack, Classd.exe, and Javasrc.exe utilities.

See the following article in the Microsoft Knowledge Base for instructions on installing the SDK Versions 3.2 and later on Visual J++ 6.0 and later.

Q234919 Installation Instructions for Version 3.2 and later of the SDK for Java

MORE INFORMATION

Following is a checklist of items that provides direction on how to install the SDK for Java and to use its utilities.

Requirements

The SDK for Java requires Microsoft[ASCII 174] Windows 95, Windows 98, or Windows NT 4.0, and the latest retail version of Internet Explorer. If you have Internet Explorer 3.02, then make sure you have Authenticode 2.0 and that the Security Settings are enabled to allow downloading of active content. To do this, from the browser's View menu, click Options, and then select "Allow downloading of Active Content" in the Security tab).

Installation

There are two ways to install the SDK for Java. You can choose either of the following methods:

SDKSetupWizard. This is the ActiveSetup that provides step-by-step instructions to install all the SDK components including the Virtual Machine for Java. NOTE: The ActiveSetup requires a network connection, so if you attempt to use this setup to install SDK for Java on a machine that does not have a network or modem connection, it will not install.

Self-Extracting Executable. You can download the SDK for Java using the SDK-JAVA.EXE file. For example, if you are experiencing network problems or if you want to install on a machine after terminating your network connection, you can run the previously downloaded SDK-JAVA.EXE. Note that the Microsoft VM will not be installed via this distributable and will need to be installed separately. Additional SDK components may also be required per your installation needs. You can proceed with the download from the following location:
http://www.microsoft.com/java/download.htm

What is CLSPACK?

Clspack is a tool that is used to create a new Classes.zip file in the \%Windir%\Java\Classes directory. This tool converts packages that are currently installed via the package manager and writes their contents into a ZIP file. You can find this tool in <sdk-dir>\Bin directory and in the \%Windir%\ directory.

The typical command to run Clspack is as follows:


Clspack -auto

This will create a Classes.zip file and place all the Java packages in %Windir%\Java\Classes\Classes.zip. It contains all system classes stored in the JPM. The Microsoft compiler for Java (jvc) checks this location by default, so there is no need to set your classpath environment variable. If you use another Java compiler that does not check this location, set your class path variable as follows:


C:\&gt;set CLASSPATH=%WINDIR%\java\classes\classes.zip;%classpath%

NOTE: If you have used SDKSetupWizard for installing SDK for Java, then this tool is automatically run as soon as you reboot your machine after installation. If, on the other hand, you have used the self-extracting file for installation, then make sure you run Clspack-auto manually after installing all the components.

What Are Classd.exe and Classr.exe and Javasrc.exe?

Microsoft Visual J++ users can also experience the benefits of the SDK for Java with these updated versions of system classes that contain class debug information as well as Java source for most system classes. These classes should be used with the corresponding VM release. The Javasrc.exe tool, provided with Visual J++ and the SDK, should be used to remove extract the source files onto the local machine.

Classd.exe is a utility that installs debug versions of system classes and many Java source files for the system classes to the package manager and onto the CLASSPATH. You can find this file in <sdk-dir>\Bin directory. You can also download it separately from http://www.microsoft.com/java/download.htm. After running Classd.exe, make sure to reboot your machine.

Javasrc.exe is a utility that extracts source code out of the debugging version of the system classes (Classes.zip that got created via Classd.exe) on to the local drive. You can find this file in <sdk-dir>\Bin directory. The typical command to run JavaSrc is as follows:
```
JavaSrc classes.zip 
```
This will now enable you to debug Java applications and step into the code of some of the Java system classes. NOTE: If you run Classd.exe from the <sdk-dir>\Bin directory and then run Javasrc.exe from the same folder, the error message, "Unable to open file Classes.zip" may appear. Run JavaSrc from within the %Windir%\Java\Classes directory (you can copy the Javasrc.exe from the <sdk-dir>\Bin directory to %Windir%\Java\Classes directory), or run it with a command line that includes the path to Classes.zip:
```
C:\..\&gt;javasrc %windir%\java\classes\classes.zip 
```

Classr.exe is a utility that installs retail version of the system classes to the package manager and onto the CLASSPATH.

How to Use the JDK 1.1 Features with Visual J++?

In order to be able to use the JDK1.1 language features with Visual J++, you need to use the Jvc.exe that comes with the SDK for Java version 2.0x or newer. This Jvc.exe also includes the ability to compile code with the following features:

Uncompressed JAR File Support

Support @COM syntax for JActiveX users

Support @DLL syntax for JDirect

In order to use the new JVC from Visual J++:

Back up your current Visual J++'s copy of Jvc.exe, Jps.dll, and Msjvc.dll. You can locate these files in the DevStudio\SharedIDE\bin directory.

Then copy the following files from your <sdk-dir>\Bin directory to the DevStudio\SharedIDE\Bin directory:
```
Jvc.exe
Jps.dll
Msjvc.dll 
```

How to Use the Other Tools Provided with the SDK For Java

In order to be able to use the other tools in the SDK, make sure you point to the <sdk-dir>\Bin directory. Most of the SDK tools are under this directory. Note, however, that the CABAndSIGN tools are located in the <sdk-dir>\Bin\PackSign directory.

NOTE 1: Jactivex.exe is a new tool that replaces JAVATLB that ships with Visual J++ 1.x. This tool can be found in the <sdk-dir>\Bin directory and is extensively used for creating wrapper classes for ActiveX objects in Java.

Here is the command to run this tool:


jactivex filename

"Filename" is the file name of the type library (*.tlb, *.olb, *.ocx, *.dll or *.exe). This generates java source code (.java) rather than the .class files that JAVATLB generates. The generated Java source requires new functionality not present in older versions of the compiler in Microsoft Visual J++ 1.x. So you need to compile the generated .java files with the Jvc.exe that ships with the SDK for Java versions 2.0x or newer.

NOTE 2: Also note that the SDK for Java versions 2.0x or newer provides a new version of JavaReg.exe (version 2.0; the original version is JavaReg 1.0 that ships with Visual J++ 1.x). This tool is used for registering Java classes as COM objects. JavaReg.exe can also be found under the <sdk- dir>\Bin directory.

REFERENCES

To download the latest retail version of Internet Explorer, see the following Web site:

http://www.microsoft.com/ie/

To download the SDK for Java, visit the following Web site:

http://www.microsoft.com/java/

For more information on how to use Javasrc.exe, please see the following articles in the Microsoft Knowledge Base:

Q167938 INFO: How Do I run JavaSrc After Installing Classes.zip

For more information on the CLSPACK utility, please refer to the SDK for Java documentation available at the following Web site:

http://www.microsoft.com/java/sdk/32/pg/pg_tools_pkgmgr_1.htm

For more information on how to use the new JDK1.1 features with Visual J++ 1.1, please see the following article in the Knowledge Base:

Q177165 INFO: Use New Java 1.1 Language Features with Visual J++ 1.1

For more information on the tools available in the SDK, please refer to the following Web site:

http://www.microsoft.com/java/sdk/32/pg/pg_tools_cmpdbg.htm

For more information on Debugging Visual J++ Applets with Internet Explorer 4.0x, please see the following article in the Knowledge Base:

Q167998 FIX: Cannot Debug Visual J++ Programs on IE 4.0

For more information on how to CABAndSIGN using the SDK tools, please refer to the following Web site:

http://www.microsoft.com/java/sdk/32/pg/pg_pkgdist_o.htm

For more information on Component Download, please see the following article in the Knowledge Base:

Q181374 INFO: Related Component Download Articles

Additional query words: sdk clspack classd.exe install tools classr javasrc jdk


Keywords          : kbsetup kbSDKJava300 kbSDKJava310 
Version           : WINDOWS:1.0,1.1,2.0,2.01,2.02,3.0,3.1
Platform          : WINDOWS 
Issue type        : kbhowto

Last Reviewed: July 13, 1999