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 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  ter-
              minal: 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:




SunOS 5.11           Last change: 4 Mar 1998                    1






User Commands                                              sag(1)



                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]"






SunOS 5.11           Last change: 4 Mar 1998                    2






User Commands                                              sag(1)



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


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWaccu                    
    


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


     System Administration Guide: Advanced Administration

































SunOS 5.11           Last change: 4 Mar 1998                    3