IBM VisualAge Smalltalk Goodie:  Ultra Light Client
===================================================

Description

Ultra Light Client (ULC) supports the deployment of applications with very
lightweight clients. It enables centralization of system maintenance and
administration, decreasing the cost of desktop management.

ULC is designed to run applications on a centrally controlled application server.
Only the presentation portion of an application is run on the end-user’s desktop.
Presentation is implemented as a universal user interface engine (UI Engine).
Because no application-specific code is run on the client, there is no need for
application-specific administration of the desktop machine.

Supported Platforms

Windows NT, Windows 2000, OS/2


Installation Instructions

1. Unzip the distribution package file, "Goodie-UltraLightClient.zip" into your
   VisualAge Smalltalk Client root directory (for example, c:\vast600).  
   Note that Your unzip program must honor (not flatten) the directory structure when it unzips the
   package. 
2. Make <vast-root>\goodies\UltraLightClient\setup (Windows or OS/2) your current directory.
3. Run the setup script appropriate to your platform (for example, setup_w.bat for Windows) to copy 
   files to their final location.
4. Start your VisualAge Smalltalk development image and setup the library tools to import all 
    required maps by swiping and executing this expression: 
    EtTools moveAllRequiredMapsToo: true.
5. Import the 'Goodies - Ultra Light Client' configuration map from 
    <vast-root>\goodies\UltraLightClient\manager\ULClient.dat (Windows or OS/2). 
6. From the System Transcript, select Tools ->Load/Unload features and load
    ST:Server, SST. (Server Smalltalk)
    ST:Performance Workbench
7. To load the ULC Smalltalk server code, load (with required maps) the 'Goodies - UltraLightClient' 
   configuration map.
8. To install the ULC Client, see the UlCWUiE.txt or UlcOUiE.txt file in the <vast-root>\ulc directory 
   for instructions to install on the Window or OS/2 platform.



Package Contents

This package consists of a single zip file containing:

-----------------------------------------------------------------
goodies
    UltraLightClient
        common_all
            bitmaps
                a1.gif
                a5.gif
                alert.gif
                ascending.gif
                blue-ball.gif
                BrowserContext.ico
                carrental.gif
                copy.gif
                cut.gif
                descending.gif
                FormModel.ico
                green-ball.gif
                HtmlPane.ico
                ibmotiulc.gif
                new.gif
                open.gif
                PageBook.ico
                paste.gif
                ProgressBar.ico
                RadioButtonGroup.ico
                red-ball.gif
                rtpm.gif
                save.gif
                SplitPane.ico
                TableModel.ico
                Toolbar.ico
                TreeModel.ico
                UlcAward.gif
                UlcAwardAnimation.gif
                UlcBox.ico
                UlcCarRental.gif
                Ulcfiller1.ico
                ulcfold5.ico
                ulcfold6.ico
                Ulchbox.ico
                Ulcpart2.ico
                ULCRADIO.ico
                Ulcvbox.ico
                yellow-ball.gif
            nls
                ulccae40.cat
                ulcdse40.mpr
                ulcewe40.mpr
                ulcmoe40.mpr
                ulcree31.mpr
                ulcwie40.mpr
                Ulcwij40.mpr
                Ulcwip40.mpr
                ulxape40.mpr
                ulxcre50.mpr
                ulxcse40.mpr
                ulxdoe40.mpr
                ulxehe40.mpr
                ulxexe40.mpr
                ulxmle40.mpr
                Ulxmlj40.mpr
                Ulxmlp40.mpr
                ulxmoe31.mpr
                ulxtce30.mpr
                ulxtte30.mpr
            ulc
                UlcOUiE.txt
                UlcOUiE.zip
                UlcWUiE.txt
                UlcWUiE.zip
                Source
                    ulcSource.jar  (UIEngine Java source)
                ULCSamples
                    AppController.ini
                    AppCtrl.ini
                    browser.gif
                    Browser.ini
                    carrental.gif
                    CarRental.ini
                    customersample.gif
                    CustomerSample.ini
                    dossier.gif
                    Dossier.ini
                    ExError.ini
                    Hello.ini
                    NlsDemo.ini
                    ulcidl.swp
                    bitmaps
                        a1.gif
                        a5.gif
                        alert.gif
                        ascending.gif
                        blue-ball.gif
                        carrental.gif
                        copy.gif
                        cut.gif
                        descending.gif
                        green-ball.gif
                        ibmotiulc.gif
                        new.gif
                        open.gif
                        paste.gif
                        red-ball.gif
                        rtpm.gif
                        save.gif
                        UlcAward.gif
                        UlcAwardAnimation.gif
                        UlcCarRental.gif
                        yellow-ball.gif
                    HttpServer
                        lib
                            httpserver.jar
                            HttpServer.properties
                    pie
                        com
                            ibm
                                ulc
                                    examples
                                        pieExtension
                                            PieChart.class
                                            UIPieChart.class
                        src
                            com
                                ibm
                                    ulc
                                        examples
                                            pieExtension
                                                PieChart.java
                                                UIPieChart.java
        doc
            ulc55.pdf
        license
            license.txt
        manager
            ULClient.dat
        os2
            ulc
                testenv.cmd
                ULCSamples
                    AppController.exe
                    appcontroller.icx
                    AppController2222.cmd
                    AppCtrl.exe
                    appctrl.icx
                    appctrl2222.cmd
                    Browser.exe
                    browser.icx
                    browser8102.cmd
                    browserIIOP.cmd
                    CarRental.exe
                    carrental.icx
                    CarRental8106.cmd
                    CarRentalIIOP.cmd
                    CustomerSample.exe
                    customersample.icx
                    CustomerSample8101.cmd
                    CustomerSampleIIOP.cmd
                    Dossier.exe
                    dossier.icx
                    dossier8100.cmd
                    dossierIIOP.cmd
                    ExError.exe
                    exerror.icx
                    exerror8333.cmd
                    Hello.exe
                    hello.icx
                    hello8900.cmd
                    NlsDemo.exe
                    nlsdemo.icx
                    nlsDemo8222.cmd
                    HttpServer
                        bin
                            httpserver.cmd
                            httpserverWithJDK11.cmd
        readme
            readme.txt  (this file)
        setup
            setup_o.cmd
            setup_w.bat
        win
            ulc
                testenv.bat
                ULCSamples
                    AppController.exe
                    AppController.icx
                    AppController2222.cmd
                    AppCtrl.exe
                    appctrl.icx
                    appctrl2222.bat
                    Browser.exe
                    browser.icx
                    browser8102.bat
                    browserIIOP.bat
                    CarRental.exe
                    CarRental.icx
                    CarRental8106.bat
                    CarRentalIIOP.bat
                    CustomerSample.exe
                    customerSample.icx
                    CustomerSample8101.bat
                    CustomerSampleIIOP.bat
                    Dossier.exe
                    dossier.icx
                    dossier8100.bat
                    dossierIIOP.bat
                    ExError.exe
                    exerror.icx
                    exerror8333.bat
                    Hello.exe
                    hello.icx
                    hello8900.bat
                    NlsDemo.exe
                    nlsdemo.icx
                    nlsDemo8222.bat
                    smalltalk.AppController.iiop.ulc
                    smalltalk.browser.iiop.ulc
                    smalltalk.browser.ulc
                    smalltalk.CarRental.iiop.ulc
                    smalltalk.CarRental.ulc
                    smalltalk.custsamp.iiop.ulc
                    smalltalk.custsamp.ulc
                    smalltalk.dossier.iiop.ulc
                    smalltalk.dossier.ulc
                    HttpServer
                        bin
                            httpserver.bat
                            httpserverJDK11.bat

-------------------------------------------------------------


Version History

Version 4.5   - Initial release 
Version G600  - Updated for v5.0, and 5.5.2


Reporting Errors and Suggesting Enhancements

Your thoughts, comments, suggestions, and criticisms are much appreciated. Please use the VisualAge Smalltalk newsgroup (news://news.software.ibm.com/ibm.software.vasmalltalk) to provide this feedback.


Disclaimer

THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT.  BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. 

(C) Copyright IBM Corporation 2002. All rights reserved. 
