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

The zip file UlcOUiE.zip is for installing the UI Engine client for OS/2.
You install this on your OS/2 client machines, and also on your OS/2
development machine so that you can test your applications as you develop.

Please note:
ULC as shipped requires JRE 1.2. Since the available versions of the JRE and Swing are constantly changing, 
you should check our web site - www.software.ibm.com/ad/smalltalk for updates or fixes, 
and visit our news group at ibm.software.vasmalltalk for the latest information. 

The JRE 1.1.7 International version together with Swing version 1.1.1 are NOT supported in this refresh. 


-------------------------------
To install on a client machine:
-------------------------------

1) Create a directory anywhere on your client machine. Currently
   we can only handle directories with no special characters in them.

2) Copy the UlcOUiE.zip to this directory

3) Unzip UlcOUiE.zip in this directory (Make sure the directory structure is preserved).
      
4) You may then delete the UlcOUiE.zip from your client, it is no longer needed
    except to do re-installs.

5) To execute the UiEngine, you can create a Program icon on your desktop and set:
      Path and Filename: yourdirectory\UIEngine\bin\ulcui.exe
      WorkingDirectory: yourdirectory\UIEngine\bin

The default is setup to use your installed version of the Java Runtime.
If you want it to use a different version of the Java Runtime than your
default, then you can set an environment variable to point to this location. Currently
we cannot handle directories with special characters or blanks in the directory name.

      Note: Do not have a trailing backslash on these directory names.

      Set UlcJRERoot=the-root-directory-of-your-java *

* It is assumed that the jre will be in the bin subdirectory under this root directory, 
and the java class files will be in the lib subdirectory under this root.


---------------------------------------
To install on your development machine:
---------------------------------------

1) Switch to x:\vast\ulc directory    (where x:\vast is the location of your 
                                       VisualAge Smalltalk V5.0 installation).

2) Follow from step 2 in the above client instructions.
    It should be extracted there for the samples to work correctly, however if it is not 
    installed here, then you can set the following environment variable so that the 
    HttpServer example can find the uiengine:

     Set ulcuihome=yourdirectory\UIEngine