Manualshelf

sa1.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages
1234
s
sa1(1M) sa1(1M)
NAME
sa1, sa2, sadc - system activity report package
SYNOPSIS
/usr/lbin/sa/sa1
[ tn]
/usr/lbin/sa/sa2
[-aAbcdLHmqtuvwy
][-s time ][-e time ][
-i sec ]
/usr/lbin/sa/sadc
[ tn][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 incre-
mented 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.
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 to mark the time at which the counters restart from zero. Executing the following command in
a system startup script:
/usr/lbin/sa/sadc /var/adm/sa/sa‘date +%d‘
writes the special record to the daily data file to mark the system restart. Instructions for creating sys-
tem startup scripts may be found in the 10.0 File System Layout White Paper, which is online on
http://docs.hp.com
.
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 following entries, if placed in
crontab, produce
records every 20 minutes during working hours and hourly otherwise (see cron (1M)):
0 * * * 0,6 /usr/lbin/sa/sa1
0 8-17 * * 1-5 /usr/lbin/sa/sa1 1200 3
0 18-7 * * 1-5 /usr/lbin/sa/sa1
The shell script sa2, a variant of sar, writes a daily report in file
/var/adm/sa/sardd. The options
are explained in sar (1M). The following
crontab entry reports important activities hourly during the
working day:
5 18 * * 1-5 /usr/lbin/sa/sa2 -s 8:00 -e 18:01 -i 3600 -A
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 */
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)