SA(8,C) AIX Commands Reference SA(8,C)
-------------------------------------------------------------------------------
sa
PURPOSE
sa - system accounting
SYNTAX
+--------------+ +------------------+ +-----------------+
/etc/sa ---| +----------+ |---| |---| |--->
+-| -a -i -r |-+ +- -S savacctfile -+ +- -U usacctfile -+
^| -b -j -s ||
|| -c -k -t ||
|| -d -K -u || +--------+
|| -D -l -v || >---| |---|
|| -f -n || +- file -+
|+----------+|
+------------+
DESCRIPTION
The sa command reports on, cleans up, and generally maintains accounting files.
The sa command is able to condense the information in /usr/adm/acct into a
summary file usr/adm/savacct which contains a count of the number of times each
command was called and the time resources consumed. This condensation is
desirable because on a large system /usr/adm/acct can grow by 100 blocks per
day. The summary file is normally read before the accounting file, so the
reports include all available information.
If a file name is given as the last argument, that file will be treated as the
accounting file; /usr/adm/acct is the default.
Output fields are labeled: "cpu" for the sum of user+system time (in minutes),
"re" for real time (also in minutes), "k" for cpu-time averaged core usage (in
1k units), "avio" for average number of i/o operations per execution. With
options fields labeled "tio" for total i/o operations, "k*sec" for cpu storage
integral (kilo-core seconds), "u" and "s" for user and system cpu time alone
(both in minutes) will sometimes appear.
FLAGS
-a Print all command names, even those containing unprintable characters
and those used only once. By default, those are placed under the name
'***other.'
Processed November 8, 1990 SA(8,C) 1
SA(8,C) AIX Commands Reference SA(8,C)
-b Sort output by sum of user and system time divided by number of calls.
Default sort is by sum of user and system times.
-c Besides total user, system, and real time for each command print
percentage of total time over all commands.
-d Sort by average number of disk i/o operations.
-D Print and sort by total number of disk i/o operations.
-f Force no interactive threshold compression with -v flag.
-i Don't read in summary file.
-j Instead of total minutes time for each category, give seconds per call.
-k Sort by cpu-time average memory usage.
-K Print and sort by cpu-storage integral.
-l Separate system and user time; normally they are combined.
-m Print number of processes and number of CPU minutes for each user.
-n Sort by number of calls.
-r Reverse order of sort.
-s Merge accounting file into summary file /usr/adm/savacct when done.
-t For each command report ratio of real time to the sum of user and system
times.
-u Superseding all other flags, print for each command in the accounting
file the user ID and command name.
-v Followed by a number n, types the name of each command used n times or
fewer. Await a reply from the terminal; if it begins with 'y', add the
command to the category '**junk'. This is used to strip out garbage.
-S The following filename is used as the command summary file instead of
/usr/adm/savacct.
-U The following filename is used instead of /usr/adm/usracct to accumulate
the per-user statistics printed by the -m option.
FILES
/usr/adm/acct Raw accounting.
/usr/adm/savacct
Summary.
Processed November 8, 1990 SA(8,C) 2
SA(8,C) AIX Commands Reference SA(8,C)
/usr/adm/usracct
Per-user summaries
RELATED INFORMATION
See the following commands: "ac" and "acct/*."
Processed November 8, 1990 SA(8,C) 3