sag(1G) — A/UX 3.0.1




sag(1G)                                                   sag(1G)



NAME
     sag - generates a system activity graph

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

ARGUMENTS
     -e time
          Selects data up to time in the form hh[:mm], where hh
          is the time in hours (military time) and mm is the time
          in minutes.  The default is 18:00.

     -f file
          Specifies the file used as the data source for sar.
          The default is the current daily data file
          /usr/adm/sa/sadd.

          The file argument specifies a string that will match a
          column header in the sar report, with an optional
          device name in square brackets, e.g., r+w/s[dsk-1], or
          an integer value.  op is +, -, *, or / surrounded by
          blanks.  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)

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

     -s time
          Selects data later than time.  The default is 08:00.

     -T term
          Produces output suitable for terminal term.  See
          tplot(1G) for known terminals.  If term is vpr, output
          is processed by vpr -p and queued to a Versatec



January 1992                                                    1




sag(1G)                                                   sag(1G)



          printer.  Default for term is $TERM.

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

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

     -y spec
          Specifies the y axis with spec in the form:

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

          The -y default is:

             -y ``%usr 0 100; %usr + %sys 0 100; \
             %usr + %sys + %wio 0 100''


DESCRIPTION
     sag graphically displays the system activity data stored in
     a binary data file by a previous sar 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's available).  lo and hi are optional
     numeric scale limits.  If unspecified, they are deduced from
     the data.

     A single spec is permitted for the x axis.  If unspecified,
     time is used.  Up to 5 spec's separated by  ;  may be given
     for -y.  Enclose the -x and -y arguments in " " if blanks or
     \RETURN are included.

EXAMPLES
     Entering:

        sag

     will show today's CPU utilization.

FILES
     /usr/bin/sag
          Executable file
     /usr/adm/sa/sadd
          Daily data file for day dd

SEE ALSO
     sar (1), tplot (1G)






2                                                    January 1992

Museum