README - ULC UI Engine for VisualAge Smalltalk V5.0.1 - 03/01/00

This exe is a self-extracting exe for installing the UI Engine client for OS/2.
You would 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.1.7 International version, and Swing version 1.0.3. 
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. 


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.exe to this directory

3) Execute as UlcOUiE /dir  (The /dir is required or it will unzip incorrectly):
      
4) You may then delete the UlcOUiE.exe 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 and Swing.
If you want it to use a different version of the Java Runtime and Swing 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 *
      Set UlcSwingHome=directory-where-swingall.jar-is-located


* 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 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
