sar(1M)           MISC. REFERENCE MANUAL PAGES            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 [-ubdycwaqvmpgrkxDSAC] [-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
     several  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, paging, and
     Remote File Sharing.

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

     sadc, the data collector, samples system data n times,  with
     an  interval  of  t  seconds  between samples, and writes in
     binary format to ofile or to standard output.  The  sampling
     interval  t should be greater than 5 seconds; otherwise, the
     activity of sadc itself may affect the sample.  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 the 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       following        entries        in
     /var/spool/cron/crontabs/sys  will  produce records every 20
     minutes during working hours and hourly otherwise:
          0 * * * 0-6 /usr/lib/sa/sa1
          20,40 8-17 * * 1-5 /usr/lib/sa/sa1
     See crontab(1) for details.

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



       Last change: System Performance Analysis Utilities       1

sar(1M)           MISC. REFERENCE MANUAL PAGES            sar(1M)



     activities hourly during the working day:

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

     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 */
       struct vminfo vmi;/* defined in /usr/include/sys/sysinfo.h */
       rfsrvinfot  rfsrv;/* defined in /usr/include/sys/fs/rfacct.h */
       fsinfot  rfsin;
       fsinfot  rfsout;/* defined in /usr/include/sys/sysinfo.h */
       rfcinfot  rfc;/* defined in /usr/include/sys/fs/rfacct.h */
       struct kmeminfo km;/* defined in /usr/include/sys/sysinfo.h */
       struct bpbinfo bi[4];/* Co-processor info defined in sys/sysinfo.h */
       int  bpbutilize/* Co-processor utilize flag */
       int  minserve, maxserve;/* RFS server low and high water marks */
       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  */
       timet  ts;    /* time stamp, seconds  */
       int apstate;   /* Co-processor flag */
       long  devio[NDEVS][5];/* device unit information  */
     #define IOOPS   0/* cumulative I/O requests  */
     #define IOBCNT  1/* cumulative blocks transferred */
     #define IOACT   2/* cumulative drive busy time in ticks  */
     #define IORESP  3/* cumulative I/O resp time in ticks */
     #define IOID    4
     };

FILES
     /var/adm/sa/sadd daily data file
     /var/adm/sa/sardddaily report file
     /tmp/sa.adrfl    address file

SEE ALSO
     crontab(1), sag(1G), sar(1), timex(1).






       Last change: System Performance Analysis Utilities       2