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

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

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

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

			SNMP Manager Example
			====================


-----------------------------------------------------------------------
1. Example overview
-----------------------------------------------------------------------
The current directory contains the following source files:
   * AsyncManager.java:
	- Uses the MibStore object generated by mibgen.
	- Deals with asynchronous requests.

   * AsyncRspHandler.java:
	- Implements the SnmpHandlerIf for receiving asynchronous responses.

   * SimpleManager.java:
	- Initializes the SNMP manager API.
	- Uses services provided by the SNMP manager API to query an
	  SNMP agent.

   * RFC1213_MIBStore.java:
	- Is generated by mibgen. 
	- Implements a MibStore object with information on all the
	  variables defined in MIB II.

   * TrapListenerImpl.java:
	- Receives valid PDU traps sent from the Snmp Agent
	  (implements the SnmpTrapListener interface)

-----------------------------------------------------------------------
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 an 
   # SNMP agent. You can use the SNMP agent provided in the examples
   # It binds to port 8085:

   java examples.snmp.agent.Agent

   # Start the manager, specifying the host and the port:

   java examples.snmp.manager.SimpleManager <host> <port>
   or
   java examples.snmp.manager.AsyncManager <host> <port>	


-----------------------------------------------------------------------
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

   # Copy the MIB files from the <JAW_HOME>/examples/src/snmp/agent directory
   # to your working directory and start mibgen:

   mibgen -mo -tp examples.snmp.manager -d . mib_II.txt mib_core.txt

   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 an 
   # SNMP agent. You can use the SNMP agent provided in the examples
   # It binds to port 8085:

   java examples.snmp.agent.Agent

   # Start the manager, specifying the host and the port:

   java examples.snmp.manager.SimpleManager <host> <port>
   or
   java examples.snmp.manager.AsyncManager <host> <port> 
