README - ULC UI Engine for VisualAge Smalltalk V5.5 - 03/31/00

This exe is a self-extracting exe 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. However, JRE 1.1.7 International version and 
Swing version 1.1.1 can be used also. Read the README.TXT in the UIENGINE directory 
after installing. 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.
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.

When using JDK11 and Swing 1.1.1 

      set the ULCSWINGHOME environment variable for the location of the Sun JFC Classes 
      (swingall.jar file). (eg: set ULCSWINGHOME=C:/ULC/R3.0/UIENGINE/SWING-1.1.1). 
       
      All Java sample directories and the UIEngine/bin directory have batch
      files called runWithJDK11.bat. When using JDK11 and Swing1.1.1 you must first
      rename the existing run.bat to be runJava2.bat and rename the runWithJDK11.bat to
      run.bat before starting any of the samples. The UIEngine/bin directory also contains
      the ulcui.exe and ulcuiWithJDK11.exe files. Rename the existing ulcui.exe to be
      ulcuiJava2.exe and rename the ulcuiWithJDK11.exe to be ulcui.exe. 




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
