#
# @(#)file      README
# @(#)author    Sun Microsystems, Inc.
# @(#)version   1.2
# @(#)lastedit  04/07/21
#
# Copyright 2004 Sun Microsystems, Inc. All rights reserved.
# Use is subject to license terms.

# ==============================================================================
#
#  JMX Tutorial Introductory Example : Instrumenting Your Own Applications.
#
#  The aim of this introductory example is to show the basic features of
#  the JMX technology first by instrumenting a simple resource and second
#  by performing operations on it using the jconsole tool. This example
#  shows the implementation of a standard MBean, how to register it in the
#  platform's MBean Server and how to perform remote operations on it by
#  connecting to the RMI connector server using the jconsole tool. Besides
#  monitoring the application, jconsole will also allow you to observe the
#  built-in JVM instrumentation as the JVM's MBeans are also registered in
#  the platform's MBean Server. This examples also shows how the existing
#  platform's MBean Server can be shared between the JVM and the application
#  itself to register the application MBeans, thus avoiding the creation of
#  multiple MBean Server instances on the same JVM.
#
# ==============================================================================
#
# In order to compile and run the example, make a copy of this README file, and
# then simply cut and paste all the commands as needed into a terminal window.
#
# This README makes the assumption that you are running under J2SE 5.0 on Unix,
# you are familiar with the JMX technology, and with the bourne shell or korn
# shell syntax.
#
# All the commands below are defined using Unix korn shell syntax.
#
# If you are not running Unix and korn shell you are expected to be able to
# adapt these commands to your favorite OS and shell environment.
#

# Compile Java classes
#
# The Java classes used in this example are contained in the com.example.mbeans
# Java package.
#
# * Main.java: gets the Platform MBean Server, and creates
#              and registers the Hello World MBean on it.
#
# * Hello.java: implements the Hello World standard MBean.
#
# * HelloMBean.java: the management interface exposed by
#                    the Hello World standard MBean.
#

javac com/example/mbeans/*.java

# Start the Main application and allow local monitoring on the same host
#

java -Dcom.sun.management.jmxremote com.example.mbeans.Main

# Start jconsole on a different shell window on the same machine
#
# JConsole is located in $(J2SE_HOME)/bin/jconsole
#

jconsole

# ==============================================================================