unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

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:


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE AvailabilitySUNWaccu


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



SunOS 5.10                        4 Mar 1998                            sag(1)