CONTENTS
********
    This archive contains the following files:
    - MiniServer.java
    - GoThenBack.java
    - launch
    - readme (this file)

    MiniServer.java
    ---------------
    It is the code for a minimal standalone Aglets server. The server
    implemented here only gives a track of all the actions performed
    by the Aglets it hosts (creation, dispatch, disposal).


    GoThenBack
    ----------
    It is an example Aglet which is created locally, dispatches to a
    given target platform, then goes back home. It may be used to test
    if a remote platform is alive.


    launch
    ------
    It is a unix zsh script which can be used to start 2 configurations:
    -(1) A single standalone server on a given port;
    -(2) A single standalone server on a given port, with a GoThenBack
    Aglet started at boot on this server.


HOW TO USE
**********
    A possible application is to create (1) then (2), giving the GoThenBack
    aglet the first platform (1) as a target. In this case, the GoThenBack
    aglet is created on (2), goes to (1) and then comes back to (2).
    To launch this scenario, in a first shell terminal, on a machine
    named "mach1" in the DNS type:
    		launch 9000
    This command starts a standalone server on the port 9000.

    In a second shell terminal, possibly on another machine, type:
    		launch 8000 atp://mach1:8000
    This second command starts a server on the port 8000, and then creates
    a GoThenBack aglet, which will dispatch itself to atp://mach1:8000
    (i.e. the first platform).

    NB: 8000 and 9000 are only indicative port numbers.

    
NON-UNIX USERS [still existing? ;) ]
**************
    1. Compile the sources. The server class should be in your CLASSPATH,
    whereas the GoThenBack class should not, but should appear in
    your CLASSPATH. For this you may compile GoThenBack in a distinct
    directory (e.g. .\aglet)
		javac MiniServer.java
		mkdir aglet
		javac -d aglet GoThenBack.java
		set CLASSPATH=.;%CLASSPATH%
		set AGLET_PATH=.\aglet

    2. Launch the server with:
		java -Daglets.class.path=%AGLET_PATH% MiniServer -port 9000
    You can obtain a usage with
		java MiniServer -help


DISCLAIMER
**********
    All the information included in this archive should be used
    and distributed freely. The author cannot be liable for anything
    (bad in particular) that may occur by the use of this package,
    in any circumstance.

----------------------------------------------------------------------------
Ronnie Taib. 10/08/99