sa1(1M) 																   sa1(1M)

NAME

       sa1, sa2, sadc - system activity report package

SYNOPSIS

       [t n]

       time] time] sec]

       [t n] [ofile]

DESCRIPTION

       System activity data can be accessed at the special request of a user (see sar(1M)) 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  CPU  utilization
       counters,  buffer  usage counters, activity counters for disk, lunpath, HBA, tape I/O, and tty devices, switching and system-call counters,
       file-access counters, queue activity counters, and counters for inter-process communications.

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

       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.
       Executing the following command in a system startup script:

       writes the special record to the daily data file to mark the system restart.  Instructions for creating system startup scripts may be found
       in the which is online on

       The  shell  script  a variant of is used to collect and store data in binary file 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, if placed in produce  records  every
       20 minutes during working hours and hourly otherwise (see cron(1M)):

       The  shell  script  a variant of writes a daily report in file The options are explained in sar(1M).  The following entry reports important
       activities hourly during the working day:

       Structure of the binary daily data file lists information about the active processors.  The structure of the binary daily data file is:

       struct sa {
       long	version[PST_MAX_CPUSTATES];
				   /* sadd file version */
       psetid_t psetid[SAR_MAX_PROCS][2];
				   /* mapping of psetid and cpus in the
				    * system */
       int	cpus[SAR_MAX_PROCS];
				   /* active processors list */
       unsigned long long cpu [PST_MAX_CPUSTATES];
				   /* average time spent in each state */
       unsigned long mp_cpu [SAR_MAX_PROCS][PST_MAX_CPUSTATES];
				   /* per proc cpu time */
       unsigned long proc_cnt;	   /* MP: number of active processors */
       unsigned long max_proc_cnt; /* MP: max active processors */
       unsigned long bread;	   /* transfer of data between system
				    * buffers and disk or other block devices
				    */
       unsigned long bwrite;
       unsigned long lread;	   /* access of system buffers */
       unsigned long lwrite;
       unsigned long phread;	   /* transfer via physical device mechanism */
       unsigned long phwrite;
       unsigned long swapin;	   /* number of swap transfers */
       unsigned long swapout;
       unsigned long bswapin;	   /* number of 512-bytes transferred
				    * (for bswapin:include initial loading of
				    * some programs
				    */
       unsigned long bswapout;
       unsigned long pswitch;	   /* process switches */
       unsigned long syscall;	   /* system calls of all types */
       unsigned long sysread;	   /* specific system calls */
       unsigned long syswrite;	   /* number of write() system calls */
       unsigned long sysfork;	   /* number of fork() system calls */
       unsigned long sysexec;	   /* number of exec() system calls */
       unsigned long runque;	   /* run queue of processes in memory and
				    * runable */
       unsigned long runocc;	   /* time occurring */
       unsigned long mp_runque [SAR_MAX_PROCS];
       unsigned long mp_runocc [SAR_MAX_PROCS];
       unsigned long swpque;	   /* swap queue of processes swapped */
				    * out but ready to run. */
       unsigned long swpocc;
       unsigned long iget;	   /* use of file access system routines */
       unsigned long namei;
       unsigned long dirblk;	   /* number of directory blocks encountered */
       unsigned long readch;	   /* characters transferred by read system
				    * calls */
       unsigned long writech;	   /* characters transferred by write system
				    * calls*/
       unsigned long rcvint;	   /* receive interrupt */
       unsigned long xmtint;	   /* transfer interrupt */
       unsigned long mdmint;	   /* modem interrupt */
       unsigned long rawch;	   /* input character */
       unsigned long canch;	   /* input character processed by cannon */
       unsigned long outch;	   /* output character */
       unsigned long msg;	   /* message primitive */
       unsigned long sema;	   /* semaphore primitive */
       unsigned long select;	   /* select system calls */
       unsigned int  sztext;	   /* current size of text table */
       unsigned int  szinode;	   /* current size of inode table */
       unsigned int  szfile;	   /* current size of file table */
       unsigned int  szproc;	   /* current size of proc table */
       unsigned int  msztext;	   /* maximum size of text table */
       unsigned int  mszinode;	   /* maximum size of inode table */
       unsigned int  mszfile;	   /* maximum size of file table */
       unsigned int  mszproc;	   /* maximum size of proc table */
       unsigned long inodeovf;	   /* cumulative overflows of inode table */
				    * since boot */
       unsigned long fileovf;	   /* cumulative overflows of file table */
				    * since boot */
       unsigned long procovf;	   /* cumulative overflows of proc table */
				    * since boot */
       time_t  ts;		   /* time stamp  */
       unsigned long elements_in_use;
       long	     elements[20];
       };

WARNINGS

       This structure can change in future releases, with no support for backward compatibility.

FILES

       address file
       daily data file
       daily report file

SEE ALSO

       timex(1), cron(1M), sar(1M), intro(7).

       on

STANDARDS CONFORMANCE

																	   sa1(1M)