Chapter   1

Getting Started

This chapter explains what you need to do to get started with the Java Management Extensions (JMX) examples. It provides instructions that apply to all the examples described in the subsequent chapters.

1.1 Platform Information

All variable assignments and commands in the examples in this tutorial were defined using UNIX Korn shell syntax. If you are running a shell other than the Korn shell on a UNIX or Linux platform, you must adapt these commands to your preferred shell environment.

If you are running a Microsoft Windows operating environment, in the majority of cases, adapting commands will simply involve replacing forward slashes (/) with backward slashes (\) and replacing colons (:) with semi-colons (;) in the paths. A specific Microsoft Windows command is given only when it differs significantly from the UNIX/Linux command provided.

1.2 Examples Directory

The examples that form the basis of this tutorial are all accessible from the JMX page in the Java 2 Platform, Standard Edition (J2SE) documentation bundle, found in the following location:

http://java.sun.com/j2se/1.5.0/docs/guide/jmx/

The code excerpts quoted in this tutorial are taken from these example programs. However, some code excerpts might be rearranged and comments might be changed. Program listings in the tutorial usually simplify comments and omit output statements, for space considerations. Some classes or sections of code that deserve special attention have been highlighted using bold text for the purposes of this tutorial.

1.3 Working Directory

To preserve untouched copies of the original example files, create a new directory in which to compile and run the examples.

All the examples will now be contained in work_dir/jmx_examples.

Copyright © 2004 Sun Microsystems, Inc. All rights reserved.