README

PersonalJava(TM) Runtime 
Environment for Windows CE 
Version 1.1 



CONTENTS
--------
   * Introduction
   * Installation
   * Notes
	- Processors Supported
	- Windows CE OS Version 
	- Compatibility
	- Application Execution 
	- Command Line Options
	- Setting the CLASSPATH
	- Executable JAR files
	- Optional Packages
	- License Restrictions 
	- Sample Applications 
   * Tests
   * System Requirements
   * Sun Java(TM) Web Pages
   * Contact Email Address



INTRODUCTION
------------
Thank you for downloading this 
release of the PersonalJava(TM) 
runtime environment for Windows CE. 
This implementation became 
available in November 2000.



INSTALLATION
------------
* Handheld PC / Palm PC / Pocket PC:
1. Ensure sufficient storage (~2.5MB) 
is available on the target device 
before downloading.
2. Download the appropriate CAB file 
for your processor.
3. Copy the CAB file to the "Start 
Menu" on the target device.
4. Begin installation by selecting 
the file from the "Start" menu when 
downloaded to target device.
5. After successful installation, 
ensure sufficient memory is 
available on target device to allow 
applications to execute.

Refer to the copyright and 
license for legal terms of use.


* Installation Help
Ensure that the entire zip file has 
been downloaded. 
The CAB file runs on the device 
itself once selected - no other 
applications are necessary. 
A CAB file targeted for a specific 
processor will not run on a device 
with a different processor. 
This implementation will not run on 
Windows CE 2.0.


* Uninstallation of Beta 1 
The uninstallation of the Beta 1
implementation will result in a 
warning that the following files:

\Program Files\Java\Java Tests\
Welcome\Duke.gif

and

\Program Files\Java\README_BIN.txt

are READ-ONLY and the uninstallation 
will not proceed. Delete the 
README_BIN.txt file and remove the 
tests directory "\Program Files\
Java\Java Tests" manually. 
Rerun the uninstaller and then 
manually remove the Java(TM)
directory for a complete uninstall.

* Uninstallation of Version 1.0
The uninstallation of the Version 1.0
implementation will result in a
warning that the following 
directories:

\Program Files\Java

and

\Program Files\Java\Java Tests\

are READ-ONLY, in use or are on a
Storage Card that has been removed 
and could not be removed. The 
uninstallation will proceed but these
directories must be removed manually.



NOTES
-----
* Processors Supported
At this time, the MIPS (R4000 
Compatible), StrongARM, SH3 and SH4 processors are supported.

Please check the download page and 
FAQ for additional processor support.

You need to download and install the 
appropriate CAB file for your 
processor. 


* Windows CE OS Version
This version is not targeted for 
Windows CE 2.0 and there are no 
plans to release a version 
supporting Windows CE 2.0. We 
investigated this platform early on 
and found it was missing some of the 
I/O functions that the 
PersonalJava runtime environment 
needed. Furthermore, we saw that 
the market was moving to 2.11 and 
that the added cost in terms of 
development and support would not 
be worth it. This implementation 
should install and operate correctly
on a devices with Windows CE2.11 and
greater.


* Compatibility
This implementation of 
PersonalJava runtime environment 
is based on JDK(TM) 1.1.x. Hence, 
some code written for Java 2 
Platform Standard Edition may not 
run on this implementation.


* Application Execution 
The PersonalJava runtime 
environment is executed through 
the file "pjava.exe". All ".class" 
and ".jar" files are associated 
with the PersonalJava runtime 
environment. This implementation 
can run standard applications, 
executable JAR files and applets. 
Standard applications and 
executable jar files are executed 
by the command line or by clicking 
on the class itself. Applets 
contained in html pages are 
executed though the command line. 
Examples are given below.


* Command Line Options
Along with the standard options the
following options can be used on the
command line on the HPC:	

-file
Allows the user to enter a file of
type ".class", ".jar", or ".html"
on the command line. 
The PersonalJava runtime environment 
will execute any one of these file 
extensions :
 ".class"
 ".jar" (an application archived
         into a jar file)
 ".html" (a HTML page containing
          a Java applet)

Examples:
"\Program Files\Java\bin\pjava.exe" 
-file Test.class

This command will invoke the 
PersonalJava runtime environment 
to run the application with the 
main method residing in the class 
"Test".

"\Program Files\Java\bin\pjava.exe" 
-file Test.jar

This command will invoke the 
PersonalJava runtime environment 
to run the application, which is 
archived in the jar file "Test".

"\Program Files\Java\bin\pjava.exe" 
-file Test.html

This command will invoke the 
PersonalJava appletviewer to run 
the applet in the html page "Test".


-setcwd
Allows the user to set the "current 
working directory" by using the 
"-setcwd" option on the command 
line. This is needed, for example, 
when running an applet where the 
"current working directory" is set 
to the directory where the html and 
applet classes reside.

Example:
"\Program Files\Java\bin\pjava.exe" 
-setcwd \Temp -file test

The html page and the classes 
necessary for the applet are located 
in the directory \Temp.


The standard command line options :

-help             
print out these options

-version          
print out the build version

-v -verbose       
turn on verbose mode

-verbosegc        
print a message when garbage 
collection occurs

-noclassgc        
disable class garbage collection

-ss<number>       
set the maximum native stack size 
for any thread

-oss<number>      
set the maximum stack size 
for any thread

-ms<number>       
set the initial heap size

-mx<number>       
set the maximum heap size

-classpath <directories separated by 
semicolons>
list directories in which to look 
for classes


* Setting the CLASSPATH
For the Handheld PC Pro:
The classpath can be set on the 
command line as follows:

"\Program Files\Java\pjava.exe" 
-classpath "\Temp\OtherClasses.jar;
\Classes" -file Test

The classpath is set to include the 
Java class files necessary for the 
application. Here, the 
OtherClasses.jar file is located in 
the directory \Temp and the 
directory \Classes is included in 
the classpath also.

Note: The quotes are necessary.

For the Palm PC / Pocket PC:

A remote registry editor is required 
(one comes with the MS Windows CE 
Toolkit for Visual C++ 6.0).

Change the following:

 HKEY_CLASSES_ROOT
  Java Class File
   Shell
    Open
     Command
      "\Program Files\Java\bin\
        pjava.exe" -file "%1"

to

"\Program Files\Java\bin\pjava.exe" 
-classpath "\Temp\OtherClasses.jar;
\Classes" -file "%1"

The classpath is set to include the 
Java class files necessary for the 
application. Here, the 
OtherClasses.jar file is located in 
the directory \Temp and the 
directory \Classes is included in 
the classpath also.


* Executable JAR files
The jar files manifest file requires 
a Main-Class header, indicating 
which class is the application's 
entry point. The executable JAR file 
is then started in the standard 
manner as with other applications.

Further information on modifying the 
manifest file:

JAR Files as Applications - 1.2 
platform only
http://java.sun.com/docs/books/
tutorial/jar/basics/run.html 

If the application is contained 
within one jar file, no other 
changes are needed.

If the application is contained 
within more than one jar file, the 
classpath needs to be modified to 
include all the jar files required 
for the application (see above).


* Optional Packages
The following packages are fully 
implemented as specified in the 
1.1.3 PersonalJava specification 
(http://java.sun.com/products/personaljava)
in this version:
	java.awt
	java.io
	java.math
	java.rmi
	java.sql
	java.util.zip

The optional package java.security 
is not implemented.

Java Native Interface support is 
included.

This implementation includes java.sql,
hence JDBC(TM) API will work.


* License Restrictions 
Please contact the feedback alias 
personaljava-wince@Sun.COM for 
further details regarding license 
restrictions on deployment of this 
implementation.


* Sample Applications 
As this port supports most of the 
AWT many simple 'hello world' 
examples should work. Try some of 
the examples from the online 
tutorials.



TESTS
-----
Two test directories (\Program Files\
Java\GUIWindow and \Program Files\
Java\Welcome) are included in this 
software bundle with a number of 
examples to demonstrate correct 
installation and operation of the 
PersonalJava runtime environment 
on the device. These tests can be 
accessed through the "Start Menu" 
under "Programs -> Java".



SYSTEM REQUIREMENTS
-------------------
The PersonalJava runtime environment 
for Windows CE software is available 
on these platforms:

* Windows CE Version 2.11/3.0 on 
Handheld PC / Palm PC / Pocket PC.
* Supported Processor 
  (MIPS, SH3, SH4, StrongARM).
* 16 megabytes RAM recommended 
minimum - with ~6MB free to install 
and run the PersonalJava runtime 
environment.
* The device should have at a 
minimum a 16 color or grayscale 
display for this implementation to 
operate correctly.



SUN JAVA WEB PAGES
------------------

For additional information, refer to 
these Sun Microsystems pages on the 
World Wide Web:

http://java.sun.com/products/
personaljava/
 PersonalJava Technology including 
 the 1.1.3 PersonalJava(TM) 
 Specification.

http://java.sun.com/products/
personaljava/javacheck.html
 JavaCheck(TM) - Platform 
 Compatibility Insurance for your 
 Applications and Applets

http://java.sun.com/
 The Java Software web site, with 
 the latest information on Java 
 technology, product information, 
 news, and features.

http://java.sun.com/docs
 Java Platform Documentation 
 provides access to white papers, 
 the Java Tutorial and other 
 documents.
     
http://developer.java.sun.com/
 The Java Developer Connection(SM) 
 web site. (Free registration 
 required.) Additional technical
 information, news, and features; 
 user forums; support information, 
 and much more.
     
http://java.sun.com/products/
 Java Technology Products & API
     


CONTACT EMAIL ADDRESS
---------------------
* Please send comments and feedback
to:
	personaljava-wince@sun.com

The PersonalJava(TM) Runtime 
Environment for Windows CE is a 
product of Sun Microsystems, Inc.

Copyright (c) 1997-2000, 
Sun Microsystems, Inc.
901 San Antonio Road, Palo Alto, 
California 94303-4900 USA.
All rights reserved.