Sun Microsystems, Inc  JMX Reference Implementation
Tutorial

[ Previous ]
The MBean View
[ Contents ]
Contents
[ Next ]
Instantiating and Managing MBeans

Agent Administration

Action:  Click on the "Admin" button in the agent view to bring up the agent administration page in your browser window.

From this page, you can create or unregister any MBean. In order to instantiate an MBean, its class must be available in the agent application's classpath. Optionally, you may specify a different class loader in the appropriate field, but this is not covered in this tutorial--please refer to the chapter in the JMX specification on class loading.

The first two fields are mandatory for all administrative actions. The "Domain" and "Keys" fields define the object name, whether for a new MBean to be created or the name of an existing MBean to unregister. Object names are described in the next paragraph. The "Java Class" is the full class name of the object to be instantiated as a new MBean. This field is ignored when unregistering an MBean.

Object Names

As defined in the JMX specification, all registered MBeans must have a unique object name given by:
DomainName:property=value[,property2=value2]*

The elements of the object name string can contain any characters except : , = * ?. The DomainName is used to group MBeans that might be related since the MBean server makes it simple to query or filter MBeans using the domain. Property-value pairs in the keys usually identify individual MBeans, for example with a serial number or a name.

In all cases, it is up to the developer to assign a semantic meaning to the domain, property and value strings. The MBean server only checks that a given name is unique inside an agent.

Adminstrative Actions

You may select one of three actions on this page:

You click the "Send Request" button once you have filled in the required fields and selected the desired action. The HTML adaptor will process the request and update the page with the action results appended to the end. The text fields are not cleared after an action to let you modify them for another action, for example to do multiple creations. The "Reset" button will return the fields to their last posted value after you have modified them.


[ Previous ]
The MBean View
[ Contents ]
Contents
[ Next ]
Instantiating and Managing MBeans

Java coffee cup logo

Copyright © 2000 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, CA  94303, USA.
All rights reserved.