'\"macro stdmacro
.if n .pH g1.sag @(#)sag	40.5 of 1/8/90
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} sag 1 "System Performance Analysis Utilities" "\&"
.if \nX=1 .ds x} sag 1 "System Performance Analysis Utilities"
.if \nX=2 .ds x} sag 1 "" "\&"
.if \nX=3 .ds x} sag "" "" "\&"
.TH \*(x}
.SH NAME
\f4sag\fP \- system activity graph
.SH SYNOPSIS
\f4sag\fP
[ options ]
.SH DESCRIPTION
\f4sag\fP
graphically displays the system activity data
stored in a binary data file by a previous
\f4sar\fP(1)
run.
Any of the
\f4sar\fP
data items may be plotted
singly, or in combination; as cross plots, or versus time.
Simple arithmetic combinations of data may be specified.
\f4sag\fP
invokes 
\f4sar\fP
and finds the desired data by string-matching the data column header
(run 
\f4sar\fP
to see what is available).
These \f2options\fP are passed through to 
\f4sar\fP:
.TP 9
\f4\-s \f2time\f1
Select data later than
.I time
in the form hh\|[\^:mm\^]\^.
Default is 08:00.
.TP 9
\f4\-e \f2time\f1
Select data up to
.IR time .
Default is 18:00.
.TP 9
\f4\-i \f2sec\f1
Select data at intervals as close as possible to \f2sec \f1seconds.
.TP 9
\f4\-f \f2file\f1
Use \f2file \f1as the data source for \f4sar\f1.
Default is the current daily data file \f4/usr/adm/sa/sa\f2dd\f1.
.P
Other \f2options\fP:
.TP 9
\f4\-T \f2term\f1
Produce output suitable for terminal \f2term\f1.
See \f4tplot\f1(1G) for known terminals.
Default for
.I term
is
\f4\s-1$TERM\s+1\f1.
.TP 9
\f4\-x \f2spec\f1
x axis specification with
.I spec
in the form:
.RS
"name\|[op \|name]\|.\|.\|.\|[lo \|hi]"
.RE
.TP 9
\f4\-y \f2spec\f1
y axis specification with
.I spec
in the same form as above.
.P
\f2Name\f1 is either a string that will match a column header in the \f4sar \f1
report, with an optional device name in square brackets,
e.g., \f4r+w/s[dsk\-1]\f1, or an integer value.
\f2Op \f1 is \f4 + \- \(**\f1 or \f4/ \f1surrounded by blanks.
Up to five names may be specified.
Parentheses are not recognized.
Contrary to custom,
\f4\0+\0\f1 and \f4\0\-\0\f1
have precedence over
\f4\0\(**\0\f1 and \f4\0/"\f1.
Evaluation is left to right.
Thus
A\0/\0A\0+\0B\0\(**\0100
is evaluated (A/(A+B))\(**100,
and
A\0+\0B\0/\0C\0+\0D
is (A+B)/(C+D).
.IR "Lo " "and " "hi "
are optional numeric scale limits.
If unspecified, they are deduced from the data.
.P
A single
.I spec
is permitted for the x axis.
If unspecified, \f2time\fP is used.
Up to 5
\f2spec\f1's
separated by
\f4\|;\|\f1
may be given for
\f4\-y\f1.
Enclose the
\f4\-x\f1 and \f4\-y\f1
arguments in
\f4"\|"\f1
if they include whitespace.
The
\f4\-y\f1
default is:
.PP
.RS 0
\f4\-y\0"%usr\00\0100;\0%usr\0+\0%sys\00\0100;\0%usr\0+\0%sys\0+\0%wio\00\0100"\f1
.RE
.SH EXAMPLES
To see today's
.SM CPU
utilization:
.RS
sag
.RE
.P
To see activity over 15 minutes of all disk drives:
.RS
TS=\*`date\0+%H:%M\*`
.br
sar\0\-o\0tempfile\060\015
.br
TE=\*`date\0+%H:%M\*`
.br
sag\0\-f\0tempfile\0\-s\0$TS\0\-e\0$TE\0\-y\0"r+w/s[dsk]"
.RE
.br
.ne 3
.SH FILES
.TP 22
\f4/usr/adm/sa/sa\f2dd\f1
daily data file for day \f2dd\f1.
.SH SEE ALSO
\f4sar\fP(1).
.\"	@(#)sag.1g	6.2 of 9/2/83
.Ee
