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

        "@(#)README 3.1 98/09/29 SMI"

        Copyright (c) 09/29/98, by Sun Microsystems, Inc.
        All rights reserved.

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

			Exception Example
			=================


-----------------------------------------------------------------------
1. Example overview
-----------------------------------------------------------------------
The current directory contains the following source files:
   * Agent.java:
 	- Implements a basic agent application.
	- Initializes the framework.
	- Adds RMI, HTTP and HTML adaptors to the framework.
	
   * Client.java:
	- Implements a simple manager.	
	- Sets up communication using the RMI adaptor client
	  to connect to the agent.
	- Instantiates an m-bean in the remote agent and registers it  
	  with the framework.
	- Gets a handle on the m-bean from the remote agent.
	- Gets and sets m-bean properties through a c-bean
          by using a handle on the m-bean.
	- Implements Java DMK exception handling.

   * SimpleBean.java:
	- Implements a simple m-bean.
	- Contains a read-write m-bean property and a read-only 
	  m-bean property.
	- Implements an action.


-----------------------------------------------------------------------
2. Running the precompiled version
-----------------------------------------------------------------------
To run the precompiled version of the example, type the following 
commands:

   setenv CLASSPATH /opt/SUNWconn/jaw/examples/classes:/opt/SUNWconn/jaw/classes/jawco.jar:/opt/SUNWconn/jaw/classes/jawag.jar:/opt/SUNWconn/jaw/classes/jawcl.jar:/opt/SUNWconn/jaw/classes/jawcs.jar:/opt/SUNWconn/jaw/classes/jawtk.jar

   # Make sure that no agents are already running 
   # and start the agent:

   java examples.exception.Agent

   # Start the manager:

   java examples.exception.Client


-----------------------------------------------------------------------
3. Building and running your own version
-----------------------------------------------------------------------
To build your own version of the example, copy the example source files
to your working directory and type the following commands:

   cd <WORKING_DIR>

   setenv CLASSPATH .:/opt/SUNWconn/jaw/examples/classes:/opt/SUNWconn/jaw/classes/jawco.jar:/opt/SUNWconn/jaw/classes/jawag.jar:/opt/SUNWconn/jaw/classes/jawcl.jar:/opt/SUNWconn/jaw/classes/jawcs.jar:/opt/SUNWconn/jaw/classes/jawtk.jar

   javac -d . SimpleBean.java

   mogen examples.exception.SimpleBean

   javac -d . *.java


To run the version of the example you have just built, type the 
following commands:

   # Make sure that no agents are already running 
   # and start the agent:

   java examples.exception.Agent

   # Start the manager:

   java examples.exception.Client
