Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ sag(8) — AIX PS/2 1.2.1

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

sar

tplot



SAG(8,C)                    AIX Commands Reference                     SAG(8,C)



-------------------------------------------------------------------------------
sag



PURPOSE

Displays a graph of system activity.

SYNTAX


       +--- -s08:00 ----+   +--- -e18:00 ----+   +- -f/usr/adm/sa/sadd -+
sag ---| +-- -s hh ---+ |---| +-- -e hh ---+ |---|                      |-->
       +-|            |-+   +-|            |-+   +------ -f file -------+
         +- -s hh:mm -+       +- -e hh:mm -+

    +--------------+   +---- -T$TERM -----+   +--------------+
>---|              |---|                  |---| +----------+ |---|
    +- -i seconds -+   +- -T workstation -+   +-| -x spec  |-+
                                               ^| -y spec 1||
                                               |+----------+|
                                               +------------+


-----------------
1 The default for -y is '% usr 0 100; % usr + % sys 0 100; % usr + %
  sys + %wio 0 100'.


DESCRIPTION

The sag command displays a graph of system activity.  It gets information
either from the daily activity file usr/adm/sa/sadd or from the binary data
file selected by the -f flag.  You must have already created this file by
running the sar command with the -o flag.  (See "sar.")

The sag command calls the sar command, selecting the desired data by
string-matching the data column header.

FLAGS

The sag command passes the first four of the following flags to sar in order to
collect the desired data for display.  The last three flags specify plotting
parameters.

-e  hh[:mm]       Selects data up to the time specified by hh[:mm]).  The
                  default time is 18:00.

-f  file          Reads data from file.  The default file is /usr/adm/sa/sadd,
                  the current daily data file.




Processed November 8, 1990         SAG(8,C)                                   1





SAG(8,C)                    AIX Commands Reference                     SAG(8,C)



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

-s  hh[:mm]       Selects data later than the specified time.  Default is
                  08:00.

-T  work station  Produces output suitable for work station.  (See "tplot" for
                  known work stations.)  If you do not specify a work station,
                  sag uses the value found in the shell variable $TERM.

-x  spec          Specifies the x axis.  spec has the following form:

                     name [opname]...[lo hi]

                  where name is a character string matching a column header in
                  the sar-created data file (with an optional device name in
                  brackets), or it is an integer value.  op is +, "-", "*", or
                  / surrounded by blanks, with up to five names specified.
                  Parentheses are not recognized and evaluation is left to
                  right.  The + and "-" have precedence over "*" and / in
                  evaluating expressions.  lo and hi specify numeric scale
                  limits.  If these limits are unspecified, sag gets these
                  limits from the data.

-y  spec          Specifies the y axis.  spec has the same form as x spec.

Specify only one spec for the x axis.  If unspecified, the x axis assumes the
time specified with the -e and -s flags (or their defaults if they are not
used) as x axis limits.  You can specify up to five specs separated by ; (a
semicolon) for -y.  If unspecified, the y axis has the value:

  -y "%usr 0 100; %usr + %sys 0 100; %usr + %sys + %wio 0 100"

If you include blanks or an escaped carriage return (\Enter) within the -x and
-y specs, enclose them in " " (double quotation marks).

FILES

/usr/adm/sa/sadd  Daily data file for day dd.

RELATED INFORMATION

See the following commands:  "sar" and "tplot."













Processed November 8, 1990         SAG(8,C)                                   2



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026