README - ULC UI Engine for VisualAge Smalltalk V5.5.2 - 03/30/01


Congratulations! You have just installed a ULC Client and are well on your way to thin 
client computing. Please refer to the on-line documentation for further setup 
instructions. Also, Please note, it is very important that the environment variables 
were set up properly during installation. If you cannot get the UI Engine to run 
properly, first verify the following environment variables and set them as follows if 
they are not set up properly. If you cannot get ULCUI.EXE to run correctly, trying
running the RUN.CMD file first. It will display error messages that may be hidden when
running ULCUI.EXE

ULC R3.1 has been designed to run with Java 2 (JDK1.2.2). It will NOT run with
JDK11 and Swing1.1.1. Follow the instructions below to set the environment variables. 

     Set the ULCJREROOT environment variable for the location of the JRE. 
     (eg: set ULCJREROOT to C:/jre1.2.2 or C:/jdk1.2.2/jre). 
     This variable must be set. If the variable is not set the assumption is that a JRE
     installation is available on the client machine and the system path and classpath
     variables must point to this installation. The required Swing classes are bundled
     together with the Java2 JDK and hence the ULCSWINGHOME environment
     variable is ignored. 


After the UI Engine has been installed ensure that the environment variable ULCUIHOME
is set to the directory where the UI Engine has been installed. This variable is required 
by the sample HTTP Server provided.  (eg: set ULCUIHOME=C:/ULC/R3.1/UIENGINE). 

NOTE: *** For all of these environment variables you must not have directories that have
spaces in them. This will cause it not to work.

You should check our web site - www.software.ibm.com/ad/smalltalk for the latest updates 
or fixes, and visit our news group at ibm.software.vasmalltalk for the latest information. 