24.1 Set Tool Window

This section briefly describes the functions of the Set Tool window. Using the window functions to perform Get and Set requests are described later.

The system to be affected is shown to the right of Set in the title bar of the window. The Set Tool window is divided into three portions:

• The top portion is a control panel that contains control buttons and text item fields. The control panel fields determine what is displayed in the middle portion of the window. Control panel buttons and fields are described in more detail below.

• The middle portion is an attribute list that displays a group of attributes and their values. The attributes that are displayed in the attribute list are specified in the control panel. Starting with version 2.3, you can click the Details button to see details of an attribute. More information is in the section below, "Attribute Details," provides more information.
• The bottom portion is a Set Information list. The Set Information list displays any new values that are entered into the attribute list. The Set Information list allows you to collect changes to multiple attributes (from one or more agents or groups) to be set in one operation.

24.1.1 Control panel buttons

The control panel buttons have the following functions:

• Get displays the current values for a group of attributes, or in the case of a table, a row of attributes.
• Set sends a Set request with the current set information.
• Unset undoes, if possible, the last successfully completed Set request.

The text item fields in the control panel allow you to specify the characteristics of the attributes displayed in the attribute list. These fields have the following functions:

• The Agent and Group fields are menus that allow you to select other set-able agents and groups for the same system. To choose a different agent or group, press MENU on the abbreviated menu button.
• The Key field is only displayed if the group is a table and allows you to specify a key to identify a row (an instance) of attributes in the table. If you know the key of the row you want, you can simply type in the value on the line. If you do not specify a key value when making a get request, the first key in the table is shown and the Key menu becomes available with the abbreviated menu button. The Key menu consists of all the keys of the rows in a table at the moment that you make the Get request.
• The Options field allows you to specify the community name that the SNMP proxy agent should use when making a Get or Set request. The community name specified in this field overrides the community name that is defined in the Properties window for the target element.

24.1.2 Attribute Details

Click the Details button to see a window similar to the one in Figure 24-3.

Figure 24-3

This is a read-only window. The fields have the following meanings:

• Name: name of the attribute
• Type: type of the attribute; if the attribute is an enumeration, the valid values are listed
• Access: how the attribute may be accessed
• Description: what the attribute means

24.2 Set Information List

The Set Information list allows you to set the values of multiple attributes-- not necessarily from the same group or agent--in a single operation of the Set Tool. As individual new values are entered, they are appended to the Set Information list. When you select the Set button, the Set Tool makes the appropriate number of agent requests to change the selected values.

To change the value of an attribute displayed in the Set Information list, double-click the SELECT button on the desired attribute. The control panel and the attribute list are updated with the information about the selected attribute. You can then change the New Value column. To delete a line from the Set Information list, first click SELECT on the line to highlight it, then press MENU on the Delete abbreviated menu button and release on Delete Selection. You

can also delete multiple lines at a time by selecting the lines and then using the Delete Selection option. The Delete All option from the Delete menu clears the entire Set Information list.

The File button menu allows you to store the current Set Information list to a specified file, or load previously stored Set Information data. The format of the file should be exactly the same as the contents of the Set Information list. Each line in the file (and in the Set Information list) contains the set information for a single attribute. It has the following format:

<agent>/<group>/<attribute>(<key>) New Value = <newvalue>

where:

<agent>

is the agent name of the attribute to be set.

<group>

is the group name of the attribute to be set.

<attribute>

is the attribute name to be set.

(<key>)

is the key of the attribute to be set, if the attribute is in a row in a table.

<newvalue>

is the new value for the attribute to be set to.

The above variables are delimited by the slash (/) character. One or more blanks must precede the keyword New Value.

If the file to be loaded has any agent or group data which does not apply to the current target system, the data is not loaded. Data loaded from a file is appended to any entries in the Set Information list.

While a Get or Set request is being performed, a busy pointer is displayed and the title bar of the Set Tool window is dimmed. The Set Tool window does not accept any input until a response to the request is received from the agent. If the request is taking an inordinate amount of time, perhaps due to an agent error, use the Quit option of the window menu to exit the Set Tool.

24.3 Invoking Set Tool from the Command Line

The Set Tool is implemented as a separate process and can be invoked from the command line (whether or not the SunNet Manager Console is running). The snm_set command line tool attempts to use whatever runtime database is available on the machine where the command is entered. If the SunNet Manager Console is running (or was running at some time), the Console's runtime database is used. If no database if found, snm_set returns an error message.The format for invoking the Set Tool, is:

host% <tools-path>/snm_set -t <target_system> -a <default_agent_name> -g <default_group_name>

where:

<tools-path> is:

• /usr/snm/bin for Solaris 1.1 installations
• /opt/SUNWconn/snm/bin for Solaris 2.x installations.

-t <target_system> is the name of the system you want to change attribute values on.

---

Note - If the name <target_system> contains spaces, then it must be surrounded by quote marks -- for example, "jaks machine".

---

-a <default_agent_name> is the name of the default agent you want to change attribute values for.

-g <default_group_name> is the name of the default group you want to change attribute values for.