SAR(1M)                                                                SAR(1M)


NAME
     sar: sa1, sa2, sadc - system activity report package

SYNOPSIS
     /usr/lib/sa/sadc [t n] [ofile]

     /usr/lib/sa/sa1 [t n]

     /usr/lib/sa/sa2 [-ubdDycwaqvmprtghIA] [-s time] [-e time] [-i sec]

DESCRIPTION
     System activity data can be accessed at the special request of a user
     (see sar(1)) and automatically on a routine basis as described here.  The
     operating system contains a number of counters that are incremented as
     various system actions occur.  These include counters for CPU
     utilization, buffer usage, disk I/O activity, TTY device activity,
     switching and system-call activity, file-access, queue activity, inter-
     process communications, paging and graphics.

     sadc and shell procedures, sa1 and sa2, are used to sample, save, and
     process this data.

     sadc, the data collector, samples system data n times every t seconds and
     writes in binary format to ofile or to standard output.  If t and n are
     omitted, a special record is written.  This facility is used at system
     boot time, when booting to a multiuser state, to mark the time at which
     the counters restart from zero.  For example, the /etc/init.d/perf file
     writes the restart mark to the daily data by the command entry:

          su sys -c "/usr/lib/sa/sadc /var/adm/sa/sa`date +%d`"


     The shell script sa1, a variant of sadc, is used to collect and store
     data in binary file /var/adm/sa/sadd where dd is the current day.  The
     arguments t and n cause records to be written n times at an interval of t
     seconds, or once if omitted.  The entries in /usr/spool/cron/crontabs/sys
     (see cron(1M)):

          0 * * * 0-6 /usr/lib/sa/sa1
          20,40 8-17 * * 1-5 /usr/lib/sa/sa1

     will produce records every 20 minutes during working hours and hourly
     otherwise.

     The shell script sa2, a variant of sar(1), writes a daily report in file
     /var/adm/sa/sardd.  The options are explained in sar(1).  The
     /usr/spool/cron/crontabs/sys entry:

          5 18 * * 1-5 /usr/lib/sa/sa2 -s 8:00 -e 18:01 -i 1200 -A


     will report important activities hourly during the working day.

FILES
     /var/adm/sa/sadd     daily data file
     /var/adm/sa/sardd    daily report file

SEE ALSO


                                                                        Page 2