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

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

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

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

			Advanced M-Let Example
			======================


-----------------------------------------------------------------------
1. Example overview
-----------------------------------------------------------------------
The current directory contains the following source files:
   * Client.java:
	- Implements a simple manager.	
	- Sets up communication using the RMI adaptor client
	  to connect to the agent.
	- Gets a handle on an m-bean from the remote agent.
	- Instantiates and registers the m-let service in a remote
	  agent.
	- Uses the m-let service to add m-beans to the agent. The m-let
	  service uses a URL which refers to a text file containing MLET 
	  tags that define the m-beans to be added.

   * Master.java:
	- Implements a simple m-bean.
        - Uses the m-bean specific method initCmf to register an 
	  m-bean with the framework.
	- Instantiates and registers the Sub m-bean from
          within the initCmf method using a handle on the agent
	  in two different ways.
	- Contains a read-only m-bean property.

   * Sub.java:
	- Implements a simple m-bean.
	- Contains a read-only m-bean property.


-----------------------------------------------------------------------
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 Java DMK base agent:

   jaw start

   # Start the manager:

   java examples.mo.Mlet2.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 . Master.java

   mogen examples.mo.Mlet2.Master

   # Set the URL to point to the working directory:
   #   String solarisURL = "file:<WORKING_DIR>/Master.html"

   javac -d . *.java

   # Build the JAR file:

   jar cf Master.jar examples/mo/Mlet2/Master.class examples/mo/Mlet2/Sub.class


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 Java DMK base agent:

   jaw start

   # Start the manager:

   java examples.mo.Mlet2.Client
