NAME

symon - bring up the Solstice SyMON system monitor console

SYNOPSIS

symon [ -colorMap ] [ -cm ] [ * colorMap]

[ -dragthreshold pixels ] [ * dragthresholdpixels ]

[ -flashDuration milliseconds ]

[ -fd milliseconds ] [ * flashDurationmilliseconds ]

[ -flashInterval milliseconds ] [ -fi milliseconds ] [ * flashIntervalmilliseconds ] [ -heartbeatInterval intervals ] [ -hi intervals ] [ * heartbeatIntervalintervals ] [ -interval intervals ] [ -i intervals ] [ * intervalintervals ]

[ -installDir path ] [ -I path ] [ * installDirpath ]

[ -minWait seconds ] [ -mw seconds ] [ * minWaitseconds ]

[ -pruneTime minutes ] [ -pt minutes ] [ * pruneTimeminutes ] [ -session file ] [ * sessionfile ] [ -target machine ] [ -t machine ] [ * targetmachine ] [ -tempPruneTime minutes ] [ -tpt minutes ] [ * tempPruneTimeminutes ] [ -vtsui file ] [ * vtsuifile ] [ -help ] [ -h ] [ -? ]

AVAILABILITY

SUNWsymon

DESCRIPTION

symon is the primary user interface to the Solstice SyMON system monitor. Invoking symon brings up the launcher window, from which the seven Solstice SyMON consoles are launched:

Event Viewer

Kernel Data Catalog

Physical View

Log Viewer

Logical View

Process Viewer

On-line Diagnostics

For further details on the operation of symon please see the Solstice SyMON User's Guide.

OPTIONS

-colorMap

Use a private color map for the Launcher and Physical View windows to ensure correct colors in the images. May result

in colormap flashing of images and of other applications,

such as the Netscape browser (default is to use the default

colormap).

-cm

Same as -colorMap

* colorMap

Same as -colorMap

-flashDuration

Set time that flashes of the system indicator on the launcher

console will last (default is 30 milliseconds).

-dragthreshold

Sets the mouse drag threshold for Sysmeters (default is 10

pixels).

* dragthreshold

Same as -dragthreshold

-fd

Same as -flashDuration

* flashDuration

Same as -flashDuration

-flashInterval

Set time interval between flashes of the system indicator on

the launcher console (default is 2000 milliseconds).

-fi

Same as -flashInterval

* flashInterval

Same as -flashInterval

-heartbeatInterval

Set the polling time for the heartbeat check for agents

(default is 10 intervals).

-hi

Same as -heartbeatInterval

-installDir

Set the directory root to examine for tcl files, etc. (default is

/opt/SUNWsymon ).

-I

Same as -installDir

* installDir

Same as -installDir

-interval

Set the polling interval for agents (default is 10 intervals).

-i

Same as -interval

-minWait

Set a minimum wait time between polls/updates (default is 1 second between the end of one poll and the start of the next).

-mw

Same as -minWait

-pruneTime

Time after which unchanged data (old processes) is pruned

from the sm_krd (Kernel Reader) hierarchy (default is 120

minutes).

-pt

Same as -pruneTime

-session

Specifies a Tcl file, which defines the layout and contents of a Solstice SyMON instance. This file is read when Solstice

SyMON starts up to restore a previously saved layout.

-tempPruneTime

Time after which unchanged Config Reader data (board temperature) will be pruned from sm_configd hierarchy (default is 1440 minutes).

-tpt

Same as -tempPruneTime

-target

System to be monitored.

-t

Same as -target

-vtsui

Name of SunVTS user interface binary (default is vtsui ).

-help

Listing of arguments.

-h

Same as -help

-?

Same as -help

ENVIRONMENT

TCL_LIBRARY

Location of the Tcl library.

XFILESEARCHPATH

Location of the X Files.

DTAPPSEARCHPATH

Location of the CDE X Defaults files.

DTDATABASESEARCHPATH

Location of the CDE database files.

DTHELPSEARCHPATH

Location of the CDE help files.

XMICONSEARCHPATH

Location of the symon icons.

FILES

common.tcl

Common Tcl routines for the display.

cpu_utilization.tcl

Tcl routines to define the chart for CPU utilization.

memory_usage.tcl

Tcl routines to define the chart for memory usage.

init.tcl

Tcl routines to initialize symon.

queue_lengths.tcl

Tcl routines to define the chart for queue lengths.

sysmeter.tcl

Tcl routines to define the chart for System Meters.

NOTES

Solstice SyMON uses ASCII-format Tcl files as a means of saving and restoring the state of the program's GUI. Currently, this feature only works for system meters, the process viewer, and the event viewer. Some Tcl files are provided with the Solstice SyMON product to serve as examples. Normally these Tcl files should be created by using the GUI to configure the desired windows, and then saved by invoking save in a system meter (to save the state of one system meter) or in the kernel data catalog window (to save the state of all system meters).

Symon examines or creates the directory $HOME/.symon and creates a directory structure there to contain Tcl files that the user has created and links to Tcl files in the official installation. The purpose is that both sets of files may be browsed easily at the same time in a single file selection dialog.

When a Solstice SyMON release is run for the first time by a user, it will create symbolic links in the user's directory ( $HOME/.symon/lib/tcl/C ) that point to any Tcl files in the installation directory (usually /opt/SUNWsymon/lib/tcl/C ). Thus, any new Tcl files in a new release will be picked up. If the user has files or links in their directory that match the names of files in the official directory, then links will be removed and remade to the official files. User files matching official file names will result in a dialog box in Solstice SyMON that explains the options the user has at that point: Either to keep the local file, to remove it and have Solstice SyMON link to the official version, or to manually merge the two files.

SEE ALSO

sm_configd(1M), sm_confsymon(1M), sm_control(1M), sm_egd (1M),sm_krd(1M), sm_logscand(1M), sm_symond (1M),auth_checker.tcl(4), auth_list.tcl(4), event_gen.tcl(4), logscan.tcl(4), rules.tcl(4), sm_symond.conf (4)