SysIII/usr/src/man/man1/sag.1m

.TH SAG 1M
.SH NAME
sag \- system activity graph
.SH SYNOPSIS
.B sag
[
.B \-s
time ] [
.B \-e
time ] [
.B \-T
term ] [
.B \-uirwcohdpaf
] [ file ]
.SH DESCRIPTION
.I Sag\^
displays, in a graphical form, the system activity of the
.SM UNIX
operating system during a specified time interval.
.I File\^
is the file that contains the daily system activity information,
default is 
.BI /usr/adm/sa/sa dd\^\f1,
where
.I dd\^
is today's day of the month.
.I Sag\^
has the following options:
.PP
.PD 0
.TP 12
.BI \-s \ time\^
Begin graph at
.I time\^
specified as
.IR hh:mm .
Default is
.BR 08:00 .
.TP
.BI \-e \ time\^
End graph at
.I time\^
specified as
.IR hh:mm .
Default is
.BR 18:00 .
.TP
.BI \-T \ term\^
Translate output to a form suitable for terminal
.IR term .
If this option is not used, the environment variable
.SM
.B $TERM
(see
.IR environ (7))
is used.
Refer to
.IR tplot (1G)
for available types of terminals.
.TP
.B \-u
Plot
.SM CPU
utilization, showing proportion of user, system and idle time (default option).
.TP
.B \-i
Plot percent of time the
.SM CPU
was idle and waiting on block
.SM I/O\*S,
waiting on swap in or swap out, or waiting on physical
.SM I/O\*S.
.TP
.B \-r
Plot logical reads/minute and block reads/minute.
.TP
.B \-w
Plot logical writes/minute and block writes/minute.
.TP
.B \-c
Plot buffer cache hit ratios for reads and for writes.
.TP
.B \-o
Plot block transfer rate between system buffers and devices, showing
reads/minute, writes/minute, and the sum of reads and writes/minute.
.TP 
.B \-h
Plot bytes read/second by system call
.IR read (2)
and bytes written/second
by system call
.IR write (2).
.TP
.B \-d
Plot the sum of reads and writes/minute for each of the first three
.SM RP\*S06
type disk drives.
.TP
.B \-p
Plot process switches/second,
process preemptions/second and system calls/second.
.TP
.B \-a
Plot process swapins/minute and process swapouts/minute.
.TP
.B \-f
Plot file access activities: iget/second, namei/second, and
directory blocks read/second.
.SH FILES
.TP "\w'/usr/adm/sa/sa dd\^    'u"
.RI /usr/adm/sa/sa dd\^
daily data file, where
.I dd\^
are digits representing the day of the month.
.SH SEE ALSO
graph(1G), tplot(1G), sar(8).
.SH NOTES
Plotted data points are extracted from the system activity file,
.BI /usr/adm/sa/sa dd\f1,\^
which is written under the control of
.IR cron (1M),
normally every 20 minutes between 8:00 and 18:00 on weekdays, and
hourly at other times.
.PP
In the event of a system outage, the system
activity counters are reset to zero when the system is rebooted.
This discontinuity is shown by a gap
in the plotted data.
.SH DIAGNOSTICS
.TP "\w'terminal type not known      'u"
``terminal type not known''
if
.SM
.B $TERM
is not set and
the
.B \-T
option is not specified.