Java Dynamic Management Kit 3.2 Programming Guide
[ Previous ][ Fast Back ]Chapter 8. Tools for Browsing M-Beans[ Fast Forward ][ Next ]

The M-Bean Browser Web Page

The HTML adaptor enables you to use a web browser to preview m-beans in an agent. The HTML adaptor obtains management information from m-beans and generates web pages representing this information. These web pages enable you to perform management operations on m-beans.

Limitations of the HTML Adaptor

The ability to "browse" m-beans through the HTML adaptor is intended to be a simple debugging tool. As such, it has certain limitations on the characteristics of the m-beans it can manipulate and display:


Note - In order to read a value for the abstract class Number, the HTML adaptor successively tries to convert the string to an Integer, a Long, a Float, then a Double, stopping at the first one which doesn't fail.


Connecting a Web Browser to an Agent

Before connecting a web browser to a Java Dynamic Management agent, make sure that:

To connect a web browser to a Java Dynamic Management agent, open this page in a web browser:
http://host:port

where:

If security is implemented for the HTML adaptor in the agent, you are asked to type your login and password for accessing the agent.

The m-bean browser web page is opened in the web browser. An example of its content is shown in Figure 8-1.

Figure 8-1. M-Bean Browser Web Page

fig491.epsi

Operations on an M-Bean

The m-bean browser web page enables you to preview an m-bean under development by:

To Read or Write the Properties of an M-Bean Instance

  1. In the m-bean browser web page, from the list of recorded managed objects, select the m-bean that you want to read or write the properties of.

    This takes you to the m-bean properties web page. An example of its content is shown in Figure 8-2.

  2. Specify the new values of any read-write (RW) properties that you want to change.

    The Value field for a read-write property is a different color from the web page background. The Value field for a read-only property is the same color as the web page background. The Value field for a property that is an array contains a link to a page that displays the individual elements in the array.

  3. Click Apply.

    If a reload period has been specified, it is reset to 0 when you click Apply.

Specifying the Reload Period

If you specify the reload period, the m-bean properties web page is automatically reloaded each time the reload period elapses. This updates the page with the new values of any properties that have changed since the page was last reloaded. To specify the reload period, in the Reload Period text-entry field, type the number of seconds you want between each reload and click Reload. The minimum reload period is 5 seconds. To disable reloading, specify a reload period of 0 seconds. Clicking Reload also causes the page to be updated immediately.

To Perform an Action on an M-Bean Instance

In the Actions area of the m-bean properties web page:

  1. If the action takes any arguments, type each argument into its associated text-entry field.

    The text-entry fields are arranged in the order in which the arguments are declared in the method prototype. The type of each argument is stated next to the field.

  1. Click the button for the action that you want to perform.

    A message is added to the bottom of the page indicating the return value of the action.

To Instantiate or Delete an M-Bean Instance

  1. In the m-bean browser web page, click Admin.

    This takes you to the Agent Administration page. Its content is shown in Figure 8-3.

  2. In the M-Bean area, fill in the required information.

    For more information, refer to Information for Instantiating an M-Bean.

  3. Use the Action option button to select what you want to do:

    • Instantiate to instantiate the m-bean

    • Instantiate in DB to instantiate the m-bean in persistent storage (available only if the agent supports persistent m-beans)

    • Delete to delete the m-bean

  4. Click Send Request.

    A message is added to the bottom of this page indicating whether the request was processed. To confirm that the m-bean has been instantiated or deleted, follow the List of M-Beans link.

Shortcut for Deleting an M-Bean Instance

In the m-bean properties web page, click Delete. The m-bean properties web page is shown in Figure 8-2.


[ Previous ][ Home ][ Next ]
Tools Provided[ Up ]The job Tool