nsar(1M)                       DG/UX R4.11MU05                      nsar(1M)


NAME
       nsar: nsa1, nsa2, nsadc - system activity report package

SYNOPSIS
       /usr/lib/sa/nsadc [-W D=dtypes] [t n] [ofile]

       /usr/lib/sa/nsa1 [-W D=dtypes] [t n]

       /usr/lib/sa/nsa2 [-ubdycwaqvmprA] [-W D=dtypes] [-s time] [-e time]
       [-i sec]

DESCRIPTION
       Nsar(1M) accesses system activity data automatically on a routine
       basis.  Such data can also be accessed at the special request of a
       user through nsar(1).  The operating system contains a number of
       counters that are incremented as various system actions occur.  These
       include CPU utilization counters, paging activity 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.

       Nsadc and the shell procedures nsa1 and nsa2 sample, save, and
       process this data.

       Nsadc, 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. If accounting is turned on, the
       /usr/sbin/init.d/rc.account entry:

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

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

       The -W D=dtypes option controls the types of disks whose activity
       nsadc will record.  Dtypes is a comma-separated list of zero or more
       disk types. Disk types are "v" for virtual disks, or "p" for physical
       disks. Without this option only physical disk activity is recorded.
       With "v" in the list, nsadc records I/O activity on a per-OSM volume
       basis. The option with an empty list, -W D=, may be specified to
       minimize the size of the output file when I/O activity information is
       not needed.

       The shell script nsa1, a variant of nsadc, collects and stores data
       in binary file /usr/adm/sa/nsadd (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 record activity, including physical and virtual disk I/O
       activity, every 20 minutes during working hours and hourly otherwise:

            0 * * * 0,6 su - sys -c "/usr/lib/sa/nsa1 -W D=p,v"
            0 8-17 * * 1-5 su sys -c "/usr/lib/sa/nsa1 -W D=p,v 1200 3"
            0 18-7 * * 1-5 su sys -c "/usr/lib/sa/nsa1 -W D=p,v"

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

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

       reports important activities, including physical but not virtual
       disks, hourly during the working day.

FILES
       /usr/adm/sa/nsadd   Daily data file
       /usr/adm/sa/nsardd  Daily report file

NOTE
       Nsadc will replace sadc in a future major revision of the DG/UX
       system. The current sadc will then be named osadc and the current
       nsadc will then be named sadc.

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


Licensed material--property of copyright holder(s)