sar(1M)                                                   sar(1M)



NAME
     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
     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 and tape I/O activity, TTY device activity,
     switching and system-call activity, file-access, queue
     activity, inter-process communications and paging.

     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/rc 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:



Page 1                            CX/UX Administrator's Reference

sar(1M)                                                   sar(1M)



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

     will report important activities hourly during the working
     day.

     The structure of the binary daily data file is:

     struct sa {
        struct sysinfo si;  /* see /usr/include/sys/sysinfo.h */
        struct minfo mi;    /* defined in sys/sysinfo.h */
        int  szinode;       /* current size of inode table  */
        int  szfile;        /* current size of file table  */
        int  szproc;        /* current size of proc table  */
        int   szlckf;       /* current size of file record header table */
        int   szlckr;       /* current size of file record lock table */
        int  mszinode;      /* size of inode table  */
        int  mszfile;       /* size of file table  */
        int  mszproc;       /* size of proc table  */
        int   mszlckf;      /* maximum size of file record header table */
        int   mszlckr;      /* maximum size of file record lock table */
        long  inodeovf;     /* cumulative overflows of inode table  */
        long  fileovf;      /* cumulative overflows of file table  */
        long  procovf;      /* cumulative overflows of proc table  */
        time_t  ts;         /* time stamp, seconds  */
        long  devio[NDEVS][4];  /* device unit information  */
     #define IO_OPS         0   /* cumulative I/O requests  */
     #define IO_BCNT        1   /* cumulative blocks transferred */
     #define IO_ACT         2   /* cumulative drive busy time in ticks  */
     #define IO_RESP        3   /* cumulative I/O resp time in ticks */
     };

FILES
     /var/adm/sa/sadd daily data file
     /var/adm/sa/sardd daily report file
     /tmp/sa.adr address file

SEE ALSO
     cron(1M).
     sag(1G), sar(1), timex(1) in the CX/UX User's Reference
     Manual.














Page 2                            CX/UX Administrator's Reference