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

	"@(#)README 3.3 99/03/23 SMI"

	Copyright (c) 03/23/99, by Sun Microsystems, Inc.
	All rights reserved.

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

			Query Example
			=============


-----------------------------------------------------------------------
1. Example overview
-----------------------------------------------------------------------
This example shows how to use queries to filter objects obtained from
a remote agent.

The current directory contains the following source files:
   * Agent.java:
 	- Implements a simple agent application.
	- Initializes the framework with a volatile repository.
	- Adds the RMI and HTML adaptors to the framework.
	- Adds the filtering service to the framework. The filtering 
	  service uses the Query package.
	- Applies queries to the m-beans registered in the agent to select
	  m-beans that match certain selection criteria.
	- Instantiates ClassMB m-beans and registers them with the 
	  framework.

   * Client.java:
	- Implements a simple manager.	
	- Sets up communication using the RMI adaptor client
	  to connect to the agent.
	- Applies queries to the m-beans registered in the remote
          agent (Agent.java).

   * ClassMB.java:
	- Implements a simple m-bean.
	- Represents a Java class with all its methods defined as 
	  MethodMB m-beans.
	- Contains a read-only m-bean property.
    	- Registers all of its methods with the framework.

   * MethodMB.java:
	- Implements a simple m-bean.
	- Represents the methods of a Java class.
	- Contains a read-only m-bean property.


-----------------------------------------------------------------------
2. Building and running the example
-----------------------------------------------------------------------
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>

   javac -d . ClassMB.java MethodMB.java

   mogen ClassMB MethodMB

   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 simple agent:

   java Agent

   # Start the manager:

   java Client
