Preface

The Java^TM Dynamic Management Kit (DMK) 5.0 provides a set of Java classes and tools for developing management solutions. This product conforms to the Java Management Extensions (JMX^TM), v1.1 Maintenance Release, which defines a three-level architecture: resource instrumentation, dynamic agents and remote management applications. The JMX architecture is applicable to network management, remote system maintenance, application provisioning, and the new management needs of the service-based network.

The Java Dynamic Management Kit 5.0 Tools Reference document presents the development tools provided with the Java DMK. This book covers proxygen for generating manager-side proxy objects, mibgen for generating MBeans and relevant classes from SNMP MIBs, the tracing and debugging mechanism and the output of the HTML protocol adaptor. These tools can help you to develop management solutions to suit your requirements.

Who Should Use This Book

This book is aimed at developers who want to use the tools provided with the Java DMK.

You should be familiar with Java programming, the JavaBeans^TM component model and the JMX specification.

This book is not intended to be an exhaustive reference. Management tutorials designed to demonstrate each of the management levels and how they interact are covered in the Java Dynamic Management Kit 5.0 Tutorial, and the complete Javadoc^TM API definitions are provided in the online documentation package.

Before You Read This Book

To use the tool commands described in this book, you must have a complete installation of the Java Dynamic Management Kit on your system. Refer to the Java Dynamic Management Kit 5.0 Installation Guide for instructions on how to install the product components and configure your environment.

Related Documentation

Management concepts and product features are covered in the other books of the product documentation set, listed in Table P–1.

Table P–1 Related Documentation

Book Title	Part Number
Getting Started with the Java Dynamic Management Kit 5.0	816–4176–10
Java Dynamic Management Kit 5.0 Tutorial	816–4178–10
Java Dynamic Management Kit 5.0 Installation Guide	816–4179–10

These books are available online after you have installed the documentation package of the Java DMK. The online documentation also includes the Javadoc API for the Java packages and classes. To access the online documentation using any web browser, open the homepage corresponding to your operating environment. Table P–2 shows the location of the home page for the Solaris^TM operating environment and Windows 2000 operating environment.

Table P–2 Accessing Online Documentation

Operating Environment	Home Page Location
Solaris environment	installDir/SUNWjdmk/jdmk5.0/index.html
Windows 2000 environment	installDir\SUNWjdmk\jdmk5.0\index.html

In these file names, installDir refers to the base directory (or folder) of your Java DMK installation. In a default installation procedure, installDir is:

• /opt on the Solaris platform

• C:\Program Files on the Windows 2000 platform

These conventions are used throughout this book whenever referring to files or directories (folders) that are part of the installation.

The Java DMK relies on the JMX architecture. The specification document, Java Management Extensions Instrumentation and Agent Specification v1.1 (Maintenance Release, March 2002), is provided in the product documentation package, under the file name jmx_instr_agent.pdf.

How This Book Is Organized

This book describes the development tools provided with the Java DMK and explains how to use them. It is divided into the following chapters:

• Chapter 1, Proxy MBean Compiler (proxygen): “Proxy MBean Compiler (proxygen)”

• Chapter 2, SNMP MIB Compiler (mibgen): “SNMP MIB Compiler (mibgen)”

• Chapter 3, The HTML Protocol Adaptor: “HTML Protocol Adaptor”

• Chapter 4, Tracing Mechanism: “Tracing Mechanism”

Accessing Sun Documentation

You can view and print a broad selection of Sun^TM documentation, including localized versions, at:

http://www.sun.com/documentation/

You can also purchase printed copies of select Sun documentation from iUniverse, the Sun documentation provider, at:

http://corppub.iuniverse.com/marketplace/sun/

Typographic Conventions

The following table describes the typographic changes used in this book.

Typeface or Symbol	Meaning	Example
AaBbCc123	The names of commands, files, and directories; on-screen computer output	Edit your .login file. Use ls -a to list all files. machine_name% you have mail.
AaBbCc123	What you type, contrasted with on-screen computer output	machine-name% su Password:
AaBbCc123	Command-line placeholder: replace with a real name or value	To delete a file, type rm filename.
AaBbCc123	Book titles, new words, or terms, or words to be emphasized.	Read Chapter 6 in User's Guide. These are called class options. You must be root to do this.

Shell Prompts in Command Examples

The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Shell	Prompt
C shell prompt	machine-name%
C shell superuser prompt	machine-name#
Bourne shell and Korn shell prompt	$
Bourne shell and Korn shell superuser prompt	#