=======================================================================
        Ardent Software's UniObjects for Java sample applications                
                                                                 
  Copyright 1998 Ardent Software, Inc. - All Rights Reserved
 These are the instructions for using the supplied sample applications.
 The sample applications are for the sole purpose of demonstrating
 product functionality.
 Ardent Software takes no responsibility for any damages of any kind
 resulting from the use of this sample application software.
=======================================================================

These instructions cover the installation and usage of the UniObjects 
for Java demo applet/application that we have included with this 
distribution.

These applications are JDK1.1.5 compatible and should work with any
development or runtime environment that is also JDK1.1.5 compatible.

CONTENTS:
A) Setup and usage of the demo applet/application
B) Setup and usage of the catalog applet/application
C) IDE, environment, browser notes
D) Other

-----------------------------------------------------------------------
A) Setup and usage of the demo applet/application.
-----------------------------------------------------------------------

 1. Include the path of the Java class files, which are stored in zip 
    file format, in the CLASSPATH environment variable of your 
    development environment or operating system.
    An example is, "CLASSPATH=c:\uvdk\uojsdk\lib\asjava.zip".
    This will allow you to build the demo applet/application and run
    it as an application. To run it as an applet see the web browser
    instructions. The reason we refer to our demo as 
    both an applet and application is because it is just that. The demo
    can be run as one or the other. From now on we will refer to the 
    demo as an applet but it can always be run as an application.

 2. To run the demo just launch it in a Java enabled environment. This 
    could be a development IDE, a browser or command line Java tool. 
    Two examples of launching the demo app. are, 
    "c:\uvdk\uojsdk\samples\demo\java FileDemo" or 
    "c:\uvdk\uojsdk\samples\demo\appletviewer FileDemo.html".

    The primary purpose of this demo is to show how UniObjects is used 
    to access UniVerse from a Java environment. When the demo is run as 
    an application or from the appletviewer, it will be able to access 
    any UniVerse server available on your network. If the demo applet 
    is run in a Web browser or some other restricted environment, only 
    an installation of UniVerse on the web browser will be accessible.

    To use the demo applet from a web browser we recommend placing the 
    demo applet classes as well as the asjava.zip package on a web server 
    in the same directory and then access the applet through the web 
    server. This will show you what a user would experience and the 
    security issues faced when the applet is accessed this way. 
    Browsers deal with local and remote java security differently.

 3. Operating the demo applet is very straight forward. The idea is to 
    click all the buttons on the left side of the applet in order. 
    After each button is clicked, the selected action is performed and 
    a detailed description of the classes and methods used to perform 
    the action as well as the results of that action are displayed in 
    the applet. When the "Connect" button is pressed, a dialog box is 
    displayed in which to enter the needed logon information. The 
    applet supports environment parameters for this information and 
    they may be specified in the included "FileDemo.html" file.

    The applet and application are slightly different in that, the 
    "Exit Demo" button only appears when the demo is run as an 
    application. This is because an applet has no concept of closing 
    its instance. The application that launched the applet controls its
    removal.

    We recommend running the demo as an application at first as this 
    should be the most trouble free and simple way to experience the 
    functionality of UniObjects.

 4. The demo applet and UniObjects was tested on Internet Explorer 4 
    ver. 4.72.2106.8 and Sun's JDK 1.1.5 and should be fully compatible.

-----------------------------------------------------------------------
B) Using the included catalog applet/application
-----------------------------------------------------------------------

 1. Include the path of the Java class files, which are stored in zip 
    file format, in the CLASSPATH environment variable of your 
    development environment or operating system. An example
    is, "CLASSPATH=c:\uvdk\uojsdk\lib\asjava.zip". This will allow
    you to build the catalog demo applet/application and run
    it as an application. To run it as an applet see the web browser
    instructions. The reason we refer to our catalog demo as both an
    applet and application is because it is just that. The catalog demo
    can be run as one or the other. From now on we will refer to the 
    catalog demo as an applet but it can always be run as an application.

 2. The catalog demo requires some server side setup before it can be
    used. First pick an existing UniVerse account or create one. Next
    create a UniVerse file named "MUSIC_CAT" in the account. The
    command to do this at the TCL prompt will look like "CREATE.FILE
    MUSIC_CAT 25". Next
    use the UniVerse tool "loadfile.exe" to load the catalog data file
    into the "MUSIC_CAT" file. You need to load the data
    file and it's dictionary. The data file is named "MUSIC_CAT" and
    the dictionary is named "D_MUSIC_CAT". The two raw data files are
    located in the catalog directory with the names, "music_catalog.u"
    and "d_music_catalog.u". The two commands should
    look something like this;
      "C:\Ardent\UV\bin\loadfile music_catalog.u MUSIC_CAT" 
      "C:\Ardent\UV\bin\loadfile d_music_catalog.u D_MUSIC_CAT" 
    You are now ready to run the catalog demo.

 3. To run the catalog demo just launch it in a Java enabled environment.
    This could be a development IDE, a browser or command line Java tool. 
    Two examples of launching the catalog demo app. are, 
    "c:\uvdk\uojsdk\samples\catalog\java CatalogDemo" or 
    "c:\uvdk\uojsdk\samples\catalog\appletviewer CatalogDemo.html".
    If you are going to launch it with the appletviewer, you must fill in
    all the param values for the applet HTML tag or it will not work 
    correctly.

    The primary purpose of the catalog demo is to demonstrate how a
    web based catalog viewing applet/application could be developed
    using the UniObjects for Java Software Development Kit.

    To use the catalog demo applet from a web browser we recommend placing
    the CatalogDemo applet classes as well as the asjava.zip package on
    a web server in the same directory and then access the applet through
    the web server. This will show you what a user would experience and
    the security issues faced when the applet is accessed this way. 
    Browsers deal with local and remote java security differently.
    Currently there is a bug in the catalog demo applet which prevents
    the "Selection Details" button from displaying the details of a
    musical selection.
    

 3. Operating the catalog demo applet is very straight forward. When the
    the applet/application first is launched, it will ask you to logon
    to a UniVerse server. After you fill in the appropriate information
    you can click the "OK" button. The proxy server information will
    not be used unless you have un commented the proxy server related
    code and recompiled the CatalogDemo.java file. The application 
    will login to UniVerse and retrieve all the music catalog 
    information that is needed to fill the display. The user can then
    adjust what artists are displayed in the text are by using the list 
    boxes on the left to choose different music categories and artists.
    This version of the demo application does not support the "CD" & "CS"
    designations. You may select one or more musical selections and 
    press the "Selection Details" button to display more detailed
    information about those selections. For all selections we display
    a UniVerse GIF image. If you like you can specify different images
    for each selection in the "MUSIC_CAT" file and place corresponding
    files in the images subdirectory of the catalog demo directory.

 4. The catalog demo applet and UniObjects was tested on Internet Explorer 4 
    ver. 4.72.2106.8 and Sun's JDK 1.1.5 and should be fully compatible.

-----------------------------------------------------------------------
C) Browser and IDE specific information and issues.
-----------------------------------------------------------------------

 1. Internet Explore Version 4 in its default configuration can not 
    launch the demo applet from the local file system without getting a 
    security violation. There is no problem when the demo applet is 
    accessed from a web server.
    
    UniObjects and the demo applet have both been verified with
    Internet Explorer 4 ver. 4.72.2106.8.

    BUGS: Internet Explorer 4 included with WindowsNT 5.0 beta will not
    run this demo applet. It crashes when you try.

 2. Netscape Navigator Version 4 may also display security violations 
    in the same instances. Depending on your installation of Navigator, 
    you may have issues with JDK 1.1 support as well. This is only an 
    issue with our demo applet, not our asjava package.

    BUGS: Navigator 4 on SGI-IRIX that supports JDK1.1.2 will not run 
    this demo applet. It appears to have a JDK compatibility problem. 

-----------------------------------------------------------------------
D) Other
-----------------------------------------------------------------------

 1. Please forward all bugs or other observed issues with this product 
    to Ardent Software. This will enable us to improve the stability of 
    the product and address any issues with it before the first 
    release. 

    We can be reached at:
        Ardent Software, Inc.
        50 Washington Street
        Westboro, MA 01581
        PHONE:  (508)366-3888
        FAX:    (508)366-3669
        WEB:    http://www.ardentsoftware.com/
        EMAIL:  support@ardentsoftware.com

 2. This product is developed with and is compatible with Sun's Java 
    Development Kit(JDK), version 1.1.5. We have only tested our product 
    with other products that also support JDK1.1.5 or higher. UniObjects
    is tested and verified with Sun's version of the JDK1.1.5 for 
    Microsoft Windows.

-----------------------------------------------------------------------
The End
-----------------------------------------------------------------------