sar(1M)                        DG/UX R4.11MU05                       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 [-ubdycwaqvmprA] [-s time] [-e time] [-i sec]

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

       Sadc and the shell procedures sa1 and sa2 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 to mark the time at which the counters restart from
       zero.  When accounting is turned on, the /usr/sbin/init.d/rc.account
       entry:

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

       writes the special record to the daily data file to mark the system
       restart.

       The shell script sa1, a variant of sadc, collects and stores data in
       binary file /usr/adm/sa/sadd (dd is the current day).  The arguments
       t and n write records n times at an interval of t seconds; the
       default is to write once.  The following crontab [see cron(1M)]
       entries will produce records every 20 minutes during working hours
       and hourly otherwise:

            0 * * * 0,6 su - sys -c "/usr/lib/sa/sa1"
            0 8-17 * * 1-5 su sys -c "/usr/lib/sa/sa1 1200 3"
            0 18-7 * * 1-5 su sys -c "/usr/lib/sa/sa1"

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

       5 18 * * 1-5 su adm -c "/usr/lib/sa/sa2 -s 8:00 -e 18:01 -i 3600 -A"

       reports important activities hourly during the working day.

FILES
       /usr/adm/sa/sadd    Daily data file
       /usr/adm/sa/sardd   Daily report file

NOTES
       A new version of sadc, nsadc is available for recording additional
       information. In a future major revision of DG/UX nsadc will be named
       sadc and the current sadc will be named osadc.

SEE ALSO
       cron(1M), sar(1), nsar(1), nsar(1M), timex(1).


Licensed material--property of copyright holder(s)