• Tools Provided -- page 101
• The M-Bean Browser Web Page -- page 102
• The job Tool -- page 107
• Information for Instantiating an M-Bean -- page 116

• M-bean browser web page
• The job tool

The job Tool

Connecting a Web Browser to an Agent

• The agent contains an instance of the HTML adaptor.
• The agent is running on a machine that you can access using the HTTP protocol.
• The compiled m-bean classes are stored at a location specified in the CLASSPATH environment variable of the agent.

where:

• host is the host name of the machine on which the agent is running.
• port is the port number used by the HTML adaptor in the agent. By default it is 8082.

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

• Reading or writing the properties of an m-bean instance
• Performing an action on an m-bean instance
• Instantiating an m-bean
• Deleting an m-bean instance

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.

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. In the example shown in FIGURE 8-3, the action takes a String argument and an int argument.

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-4.

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

For more information, refer to "Information for Instantiating an M-Bean" on page 116.

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

Starting and Connecting the job Tool

• The agent contains an instance of an adaptor that communicates through an adaptor client. These adaptors are listed in "Supported Protocols" on page 82.
• The agent is running on a machine that the job tool can access using the protocol of the adaptor in the agent.
• The compiled m-bean classes are stored at a location specified in the CLASSPATH environment variable of the agent.
• The compiled c-bean classes are stored at a location specified in the CLASSPATH environment variable of the job tool.

To Start the job Tool

Type the command for your operating environment:

• In a Solaris operating environment:
  

  ---

  prompt% /opt/SUNWconn/bin/job

  ---

• In a Windows NT operating environment:
  

  ---

  C:\> "c:\Program Files\SUNWconn\jaw\bin\job"

  ---

To Connect the job Tool to an Agent

1. Before attempting to connect the job tool to a Java Dynamic Management agent, ensure that the agent is running.

2. Type the name of the agent that you want to connect to, into the job tool text-entry field.

If the adaptor in your agent uses the default settings, all you need to specify is the host name of the machine on which the agent is running. The default settings are RMI protocol and port 1099. If the adaptor in your agent does not use the default settings, you have to specify the protocol, host name and port in full as follows:

---

protocol:hostname:port

---

3. Click Connect.

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

To Connect to an Agent by Using the Discovery Option

1. Click the button adjacent to the Connect button.

The Discovery window is opened as shown in FIGURE 8-5.

2. In the Discovery window, click Discover.

A list of agents with a discovery responder listening on port 9000 that are running on your network is added to the main area of the Discovery window.

3. From the list of agents, select the agent that you want to connect the job tool to.

The name of the agent is displayed in the text-entry field of the job tool window.

4. Click Connect.

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

Double-clicking an agent in the Discovery window connects the job tool to the agent.

To Change the Default Discovery Parameters

1. In the Discovery window, click Setup.

2. In the Discovery Setup window, specify new values for these parameters:

---

Time to Live	The time to live for multicast packets. It must be a positive decimal integer.
Multicast Group	The multicast group that packets will be sent to. It must be an IP address.
Multicast Port	The port number for multicast packets.

---

3. Click OK.

To Revert to the Default Discovery Parameters

In the Discovery Setup window, click Defaults.

TABLE  8-1 Icons for the job Tool

Icon	Meaning
	A exists for the . It is possible to use the job tool to examine the properties and actions of the . The is not an instance of a base service. If you delete the instance, the agent will continue to work.
	A does not exist for the . The properties and actions of the are not accessible to the job tool. The is not an instance of a base service. If you delete the instance, the agent will continue to work.
	The is an instance of a base service of the agent. Do not delete an instance of a base service. If you do, the agent will no longer work.

Changing Your View of M-Beans

To View M-Bean Instances as a List

In the job tool window, select the List option.

The m-bean instances in an agent are represented as text in a list, as shown in FIGURE 8-8. Each item in the list is the object name of an m-bean instance in an agent. To return to an icon representation, select the Icon option.

To Choose the Domain

1. In the job tool window, set the Domains option to on.

A list of domains covered by the agent is added to the job tool window as shown in FIGURE 8-9.

2. From the list of the list of domains, select the domain of the m-bean instances you want to view.

Select the asterisk to view the m-bean instances in all domains. To remove the list of domains, set the Domains option to off.

• Reading or writing the properties of an m-bean instance
• Performing an action on an m-bean instance
• Instantiating an m-bean
• Deleting an m-bean instance

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

1. In the job tool window, select the m-bean instance that you want to read or write the properties of.

2. Click Properties.

The properties of an m-bean instance are displayed in a separate window. An example is shown in FIGURE 8-10.

3. In the properties window, make the changes to any read-write properties you want to change.

The text-entry field for a read-write property is a different color from the window background. The text-display field for a read-only property is the same color as the window background.

4. Click Apply to apply your changes.

The properties window remains open. Click Close to close the properties window without applying any changes.

The properties window is not automatically updated with changes to properties that have occurred since the window was opened. To update the properties displayed, click Refresh.

To Perform an Action on an M-Bean Instance

1. In the job tool window, select the m-bean instance that you want to perform an action on.

2. Click Actions.

3. In the action window, click the action you want to perform.

The action you want to perform must not take any arguments. Only actions that take no arguments are active in the method window. The names of actions that take one or more arguments are displayed but are grayed out and cannot be performed.

To Instantiate an M-Bean

1. In the job tool window, click Create.

2. In the Create Object window, specify the information required to instantiate the m-bean.

For information, see "Information for Instantiating an M-Bean" on page 116.

3. Click OK.

To Delete an M-Bean Instance

1. In the job tool window, select the m-bean instance that you want to delete.

Do not select an instance of a base service. If you delete a base service, the agent will no longer work.

2. Click Delete.

You are asked to confirm that you want to delete the m-bean instance.

Components of the Object Name of the M-Bean

Domain

Class

For the job tool only:

• All of the m-bean classes supplied with the Java Dynamic Management Kit that you are allowed to instantiate
• Other m-bean classes that you have already instantiated

Keys

Other Options

---

Note - If you are using the job tool, set the More option to on to add the Java Class and Class Loader text-entry fields to the Create Object window.

---

You only need to specify this option if the agent does not use the default rule for obtaining the Java class of an m-bean from the class part of its object name.

---

Note - The default rule for obtaining the Java class of an m-bean from its object name is described in "Mapping Rules for Class Names" on page 81.

---