CHAPTER 5

Command Line Options

---

Use the Solstice SyMON options described in this chapter on the command line when you invoke Solstice SyMON. For example, the -t option refers to the target system to monitor:

% /opt/SUNWsymon/bin/symon -t targetsystemname &

Solstice SyMON also recognizes the standard X Window System toolkit options.

---

Options to Solstice SyMON

The following entries describe the Solstice SyMON command-line options in man page type format.

dragthreshold

Name: -dragthreshold

Abbreviated Name: None

Default: 10

Resource: *dragthreshold

Description: This is the mouse drag threshold (pixels) for SysMeters.

flashDuration

Name: -flashDuration

Abbreviated Name: -fd

Default: 30

Resource: *flashDuration

Description: Controls the duration (msec) of the flashes of the System box. The System box is in the upper-left corner of the Launcher window, and it indicates which server is being monitored. Once Solstice SyMON has established communication with the server, this button flashes according to the -fd and -fi options until communication with the server ceases.TABLE 5-1 describes the action for flash duration settings.

TABLE 5-1

Flash Duration Setting	Action
zero (0)	Turns off the feature
Less than 0	Error message is printed and flash duration is set to 0
Greater than the flash interval	Flash duration is set to the flash interval and an error message is printed to the standard error
Equal to the flash interval	Turns the system button green constantly; the button may flicker as it is updated at each interval

See Also: flashInterval

flashInterval

Name: -flashInterval

Abbreviated Name: -fi

Default: 10000

Resource: *flashInterval

Description: Controls the frequency of flashing (msec) of the System box. The System boxn is in the upper-left corner of the Launcher window, and it indicates which server is being monitored. Once Solstice SyMON has established communication with the server, this button flashes according to the -fd and -fi options until communication is terminated.

If the interval is less than 1000 msec, an error message is printed to the standard error and the flash interval is set to 1000. Setting the flash interval and flash duration equally, turns the system button green constantly. The button may flicker as it is updated at each interval.

After each interval, Solstice SyMON executes a RPC ping of the target system. With the default flash interval and flash duration, each flash indicates a successful ping.

See Also: flashDuration

heartbeatInterval

Name: -heartbeatInterval

Abbreviated Name: -hi

Default: 10

Resource: *heartbeatInterval

Description: The heartbeat interval (seconds) is the interval between successive updates of the message in the Launcher footer, which states the amount of time remaining until the next data update. For example: "Next update request in 10 seconds."

help

Name: -help

Abbreviated Name: -h

Default: None

Resource: None

Description: Prints a list of options with default values and exits

installDir

Name: -installDir

Abbreviated Name: -I

Default: /opt/SUNWsymon

Resource: *installDir

Description: Sets the root directory to examine Tcl files (default is /opt/SUNWsymon)

interval

Name: -interval

Abbreviated Name: -i

Default: 10

Resource: *interval

Description: Polling interval (in seconds). This is the time between requests for data from agents. The minimum polling interval is 5 seconds. The maximum polling interval is 120 seconds.

To change the polling interval while Solstice SyMON is running, use the Launcher Options menu. From the Options menu of the Launcher, select Data Controls. From the Data Controls menu, set the polling interval.

Solstice SyMON polls the agents for data every interval seconds. It does all GUI updates necessary, then waits for at least minWait, and possibly until interval seconds from the start of the last update (whichever is greater) before polling again.

See Also: minWait

minWait

Name: -minWait

Abbreviated Name: -mw

Default: 1

Resource: *minWait

Description: Minimum wait (in seconds) between polls or updates to guarantee user interaction time. This specifies how long to wait after processing one data update before asking the target system for another update. This creates a time for you to reduce the polling frequency.

Solstice SyMON polls the agents for data every interval seconds. It does all GUI updates necessary, then waits for at least minWait, and possibly until interval seconds from the start of the last update (whichever is greater) before polling again.

See Also: interval

pruneTime

Name: -pruneTime

Abbreviated Name: -pt

Default: 120

Resource: *pruneTime

Description: Length of time (in minutes) for the Kernel Reader data to be retained in the GUI. For example, if the prune time is 180 minutes, Solstice SyMON deletes data older than 180 minutes.

rpcNum

Name: -rpcNum

Abbreviated Name: -rn or -n

Default: 100244

Resource: *rpcNum

Description: Enables you to assign a custom RPC number to Solstice SyMON. All client applications that want to connect to Solstice SyMON must know this custom RPC number. The default Solstice SyMON RPC number of 100244 is usually supplied to client applications. If you change this RPC number, you must provide the new RPC number to all client applications.

The RPC number you provide should be the RPC number for Solstice SyMON running on the monitored host from which all clients retrieve connectivity information (not the RPC number of the spawning Solstice SyMON on a remote system with an Event Generator).

session

Name: -session

Abbreviated Name: none

Default:""

Resource: *session

Description: The session option specifies a file to read when Solstice SyMON starts up. This file is a Tcl file in the same format as Tcl files that are saved in the System Meter, Kernel Data Catalog, or Logical View consoles. It defines the layout and contents of a Solstice SyMON instance.

This option is used by the CDE session manager to restore previously saved layouts. Not all windows are currently saved or restored--only the Launcher and System Meters. When you invoke Solstice SyMON at a later date, your previous environment is restored.

target

Name: -target

Abbreviated Name: -t

Default: target_system_name

Resource: *target

Description: Name of the server to be monitored

tempPruneTime

Name: -tempPruneTime

Abbreviated Name: -tpt

Default: 1440

Resource: *tempPruneTime

Description: Length of time (in minutes) for Config Reader data (such as board temperature) to be retained by the GUI. For example, if the tpt is 180 minutes, Solstice SyMON deletes data more than three hours old.

vtsui

Name: -vtsui

Abbreviated Name: None

Default: vtsui.online

Resource: *vtsui

Description: Path of SunVTS user interface binary