sag(1)								   User Commands							    sag(1)

NAME

       sag - system activity graph

SYNOPSIS

       sag [-e time] [-f file] [-i sec] [-s time] [-T term] [-x spec] [-y spec]

DESCRIPTION

       The  sag  utility  graphically displays the system activity data stored in a binary data file by a previous sar(1) run. Any of the sar data
       items may be plotted singly or in combination, as cross plots or versus time. Simple arithmetic combinations of data may be specified.  sag
       invokes	 sar  and  finds  the  desired data by string-matching the data column header (run  sar to see what is available). The sag utility
       requires a graphic terminal to draw the graph, and uses tplot(1) to produce its output. When running Solaris 2.x and  OpenWindows,  perform
       the following steps:

       1.  Run an "xterm" as a Tektronics terminal: prompt# xterm -t

       2.  In the "xterm" window, run  sag specifying a  tek terminal: prompt# sag -T tek options

OPTIONS

       The following options are supported and passed through to  sar (see sar(1)):

       -e time	Select data up to time. Default is 18:00.

       -f file	Use file as the data source for sar. Default is the current daily data file /usr/adm/sa/sadd.

       -i sec	Select data at intervals as close as possible to sec seconds.

       -s time	Select data later than time in the form hh[:mm]. Default is 08:00.

       -T term	Produce output suitable for terminal term. See	tplot(1) for known terminals. Default for term is $TERM.

       -x spec	x axis specification with spec in the form:

		name[op name]...[lo hi]

		name  is  either a string that will match a column header in the sar  report, with an optional device name in square brackets, for
		example, r+w/s[dsk-1], or an integer value. op	is  + - * or /	surrounded by blank spaces. Up to five	names  may  be	specified.
		Parentheses  are  not  recognized.  Contrary  to  custom, + and - have precedence over * and /. Evaluation is left to right. Thus,
		A/A+B*100 is evaluated as (A/(A+B))*100, and A+B/C+D is (A+B)/(C+D). lo and hi are optional numeric scale limits. If  unspecified,
		they are deduced from the data.

		Enclose  spec in double-quotes ("") if it includes white space.

		A single spec is permitted for the x axis. If unspecified, time is used.

       -y spec	y  axis  specification with spec in the same form as for -x. Up to 5 spec arguments separated by a semi-colon (;) may be given for
		-y. The -y default is:

		-y"%usr0100;%usr+%sys0100;%usr+%sys+%wio0100"

EXAMPLES

       Example 1: Examples of the sag command.

       To see today's CPU utilization:

       example$ sag

       To see activity over 15 minutes of all disk drives:

       example$ TS=`date +%H:%M`
       example$ sar -o /tmp/tempfile 60 15
       example$ TE=`date +%H:%M`
       example$ sag -f /tmp/tempfile -s $TS -e $TE -y "r+w/s[dsk]"

FILES

       /usr/adm/sa/sadd        daily data file for day dd

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWaccu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       sar(1), tplot(1), attributes(5)

SunOS 5.10							    4 Mar 1998								    sag(1)