Copyright (C) BULL S.A. 1998-2002.


There are 4 kind of examples:

 - examples with enterprise java beans accessed from a simple client which
   is a java program, (these examples are all on examples/src);

 - examples with enterprise java beans accessed from a servlet
	or JSP and packaged in .ear file:
	examples/earsample, examples/cmp2, examples/alarm.

 - examples of AXIS use in JOnAS : examples/webservices

 - 1 example of JOnAS application generation via xdoclet.

There is also the well-known Java Pet Store application. (petstore1.3)

Before compiling and running these examples, the installation and configuration
of JOnAS have to be done:

 - initialization of the JONAS_ROOT environment variable,
 - optionally, initialization of the JONAS_BASE environment variable,
 - update of your PATH,
 - update of the JOnAS config_env script,
 - configuration of JNDI environment via the carol.properties file
 - configuration of the database access:
	- update of the JOnAS config_env script,
	- configuration of JOnAS environment via the jonas.properties file,
	- update of the <datasource_name>.properties file.
 - configuration of Tomcat for JOnAS.

Refer to install documentation for more information.



Compiling these examples:
------------------------
 Use the Ant 1.5 build tool in one of the directories where there is a build.xml file.

 You may have to modify $JONAS_ROOT/examples/build.properties

 The default "install" target allows to build the examples and copy the built ejb-jar 
 file in your JOnAS_BASE/ejbjars directory.

 Example:
	export JONAS_ROOT=<your install path>
	cd $JONAS_ROOT/examples; ant install
