Welcome to
		 ObjectStore PSE and PSE Pro for Java
			      Release 1.1


CONTENTS
--------
The contents of this directory are:

README.htm      This file.

LICENSE.htm     Contains the licensing agreement. You must read this 
                file before proceeding with the installation.

pse.zip	        The ObjectStore PSE for Java classes (do not unzip this).
  or
pro.zip         The ObjectStore PSE Pro for Java classes (do not unzip this).

tools.zip       The ObjectStore PSE/PSE Pro for Java Class File Postprocessor
		class files (do not unzip this).

lib             Signed .cab file.

bin             Directory of executables.

doc             The documentation hierarchy, viewable with a WWW Browser.

COM/odi         A demo hierarchy that contains examples of PSE/PSE Pro 
                programs.

Whether pse.zip or pro.zip is in the release depends on whether you
loaded ObjectStore PSE or PSE Pro for Java.  Note that this document
and other README files use pse.zip and pro.zip interchangeably.


PREREQUISITES
-------------
- Sun SPARC platform running Solaris 2.4 or 2.5 
  or Windows NT 4.0 or Windows 95.
- Sun Java Development Kit (JDK) 1.1 or 1.1.1 installed. PSE 1.1 does
  not work with JDK 1.0.2.


BUG FIXES AND NEW FEATURES
--------------------------
See the release notes for a list of bug fixes and new features.


VIEWING THE DOCUMENTATION
-------------------------
The documentation for PSE and PSE Pro is distributed only in
machine-readable HTML format. To view the documentation from a
browser, look in the Documentation Index. This contains a linked list of the
the documentation components.


CLASSPATH 
---------
To use PSE/PSE Pro you must add several entries to your CLASSPATH
environment variable. Be sure to follow the instructions in the
release notes under Required Additions to CLASSPATH Variable 
before you try to use PSE/PSE Pro.


PATH
----
Update your PATH environment variable to contain the bin directory
from the distribution. This allows you to use the Class File
Postprocessor (osjcfp) and other tools.

For example, under Windows NT you might set PATH to be something like
this:

PATH=c:\windows\system32;c:\windows;c:\jdk11\bin;C:\ODI\PSEPROJ\BIN

Under UNIX, you might set it to something like this:

PATH=/home/mydir:/usr/local/jdk11/bin:/usr/local/psepro/bin


UNIX CONSIDERATION
------------------
There is a known problem with the Class File Postprocessor in dealing
with CLASSPATH interpretation on UNIX platforms. See the information
in the release notes under Considerations, UNIX Symbolic Links Not
Always Expanded. 


COMMENTS AND SUPPORT
--------------------
A majordomo list for general discussions of PSE and PSE Pro is
available at pse-java-discussion@odi.com. To subscribe to this list,
send a mail message to majordomo@odi.com. Put the following line in
the body of the message:

subscribe pse-java-discussion your_email_address

You can purchase support for PSE Pro on a per-event, quarterly, or
yearly basis. Send electronic mail to pse-pro-java-support@odi.com.


REQUIREMENT FOR RUNNING THE POSTPROCESSOR
-----------------------------------------
You must run the PSE/PSE Pro Class File Postprocessor on all class 
files in an application in one execution of the postprocessor.
Failure to postprocess all classes together can result in problem 
situations that appear when you try to run the application and that 
are hard to diagnose. The postprocessor must be able to examine all
class files in an application when it makes any class in the application 
persistence-capable. See Automatically Generating Persistence-Capable 
Classes. There are postprocessor options that allow you to determine 
which classes are made persistence-capable. If it is inconvenient or 
impossible to postprocess together all classes in your application, 
you can postprocess separate batches of files.


UNINSTALLING 
------------ 
To uninstall a UNIX distribution of PSE or PSE Pro, delete the
hierarchy where you untar'd or unzip'd it.

To uninstall a Windows distribution of PSE or PSE Pro, use the
standard uninstall tool by selecting Control Panel | Add/Remove
Programs | ObjectStore PSE/PSE Pro for Java | Add/Remove.

Be sure to manually remove any settings of CLASSPATH and PATH.