###############################################################################
Advanced RTI System, ARTÌS			http://pads.cs.unibo.it
###############################################################################

The goal of this directory is to show that it is possible to use ARTÌS/GAIA
using the JAVA programming language. 
In detail, 3 very simple examples are provided:
1) JTS_ring.java
2) HelloGaia.java
3) HelloByteGaia.java

The example 1 is to show the usage of the ARTÌS APIs. It is simulated a set 
of nodes in a ring. The nodes send and receive interactions from other nodes 
in the ring. 2 and 3 are "HelloWorld examples" of using GAIA with Java. In 
these last examples, many functionalities are missing. The goals is to 
demonstrate that the GAIA APIs are usable with Java.

-------------------------------------------------------------------------------
SOURCE CODE COMPILATION:

Fist of all, it is necessary to compile the example source code, this can
be done using the provided Makefile (execute the "make" command in the 
JAVA directory). In case of errors, please check carefully the missing
libraries or version incompatibilities.
Given that the examples are written in JAVA, it is necessary to correctly
set the CLASSPATH environment variable. The Makefile ("make help" command)
provides some help to set the CLASSPATH.
-------------------------------------------------------------------------------

EXECUTION:

Some scripts are provided to execute the various examples:

run.ring	executes the JTS_ring example

run.gaia	executes the HelloGaia example

run.gaiabyte	executes the HelloByteGaia

in all examples it is necessary to provide one parameter: the number of
LPs that compose the parallel simulation.
