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 combi-
     nation,  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  termi-
        nal: 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 unspeci-
           fied, 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  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWaccu                    |
    |_____________________________|_____________________________|

SEE ALSO

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