COMMANDS
=========
topas : general overview
topas -D : Reports the disk details
=============================================================
Processor utilization
-----------------------
This subsection displays a bar chart showing cumulative processor usage. If more than one processor exists, a list of processors can be displayed by pressing the c key twice. Pressing the c key only once will turn this subsection off. The following fields are displayed by both formats:
User%
The percentage of processor used by programs running in user mode. (Default sorted by User%)
Kern%
The percentage of processor used by programs running in kernel mode.
Wait%
The percentage of time spent in waiting for I/O.
Idle%
The percentage of time that the processors are idle.
Physc
The number of physical processors that are consumed. Displayed only if the partition is running with shared processor.
%Entc
The percentage of entitled capacity that is consumed. Displayed only if the partition is running with shared processor.
When this subsection first displays the list of hot processors, the list is sorted by the User% field. However, the list can be sorted by the other fields by moving the cursor to the top of the desired column.
Network interfaces
--------------------
This subsection displays a list of hot network interfaces. The maximum number of interfaces displayed is the number of hot interfaces being monitored, as specified with the -n flag. A smaller number of interfaces will be displayed if other subsections are also being displayed. Pressing the n key turns off this subsection. Pressing the n key again shows a one-line report summary of the activity for all network interfaces. Both reports display the following fields:
Interf
The name of the network interface.
KBPS
The total throughput in kilobytes per second over the monitoring interval. This field is the sum of kilobytes received and kilobytes sent per second.
I-Pack
The amount of data packets received per second over the monitoring interval.
O-Pack
The amount of data packets sent per second over the monitoring interval.
KB-In
The number of kilobytes received per second over the monitoring interval.
KB-Out
The number of kilobytes sent per second over the monitoring interval.
When this subsection first displays the list of hot network interfaces, the list is sorted by the KBPS field. However, the list can be sorted by the other fields by moving the cursor to the top of the desired column. Sorting is only valid for up to 16 network adapters.
Physical disks
--------------
This subsection displays a list of hot physical disks. The maximum amount of physical disks displayed is the number of hot physical disks being monitored as specified with the -d flag. A smaller number of physical disks will be displayed if other subsections are also being displayed. Pressing the d key turns off this subsection. Pressing the d key again shows a one-line report summary of the activity for all physical disks. Both reports display the following fields:
Disk
The name of the physical disk.
Busy%
The percentage of time the physical disk is active (bandwidth use of the drive).
KBPS
The amount of data transferred (read and written) in kilobytes per second over the monitoring interval. This field is the sum of the values of the KB-Read and KB-Writ.
TPS
The number of transfers per second that were issued to the physical disk. A transfer is an I/O request to the physical disk. Multiple logical requests can be combined into a single I/O request to the disk. A transfer is of indeterminate size.
KB-Read
The number of kilobytes read per second from the physical disk.
KB-Writ
The number of kilobytes written per second to the physical disk.
When this subsection first displays the list of hot physical disks, the list is sorted by the KBPS field. However, the list can be sorted by the other fields by moving the cursor to the top of the desired column. Sorting is only valid for up to 128 physical disks.
File system
------------
This subsection displays a list of hot file systems. If the File system subsection is displayed, the Physical disk subsection is not displayed. The maximum number of file systems that are displayed is the number of hot file systems that are monitored (when they are specified with the -f flag). A smaller number of file systems is displayed if other subsections are also being displayed. To turn off this subsection, press the dkey. When you press the f key to show a one-line report summary of the activity for all of the file systems. When you press the f key again, the File system subsection is no longer displayed, and the Physical disk subsection is displayed. Both reports display the following fields:
File System
The name of the file system.
KBPS
The amount of data transferred (read and written) in kilobytes per second over the monitoring interval. This field is the sum of the values of the KB-Read and KB-Writ fields.
TPS
The number of transfers per second that are issued to the file system. A transfer is an I/O request to the file system. Multiple logical requests can be combined into a single I/O request to the file system. The size of a transfer is not determinate.
KB-Read
The number of kilobytes read per second from the file system.
KB-Writ
The number of kilobytes written per second to the file system.
When this subsection displays the list of the file systems, the list is sorted by the KBPS field. However, the list can be sorted by the other fields by moving the cursor to the top of the target column.
Tip:
If the file system name exceeds the field width in the display, then the file system name is displayed in a truncated format. The truncation contains the first and last few characters of the file system, the middle part of the name is replaced by periods (..). For example, if the file system name isfilesystem001234, then the name is displayed as files..01234.
EVENTS/QUEUES
------------------
Displays the per-second frequency of selected system-global events and the average size of the thread run and wait queues:
Cswitch
The number of context switches per second over the monitoring interval.
Syscalls
The total number of system calls per second that are run over the monitoring interval.
Reads
The number of read system calls per second that are run over the monitoring interval.
Writes
The number of write system calls per second that are run over the monitoring interval.
Forks
The number of fork system calls per second that are run over the monitoring interval.
Execs
The number of exec system calls per second that are run over the monitoring interval.
Runqueue
The average number of threads that were ready to run but were waiting for a processor to become available.
Waitqueue
The average number of threads that were waiting for paging to complete.
FILE/TTY
---------
Displays the per-second frequency of selected file and the TTY statistics. The following data is reported:
Readch
The amount of bytes read per second through the read system call over the monitoring interval.
Writech
The amount of bytes written per second through the write system call over the monitoring interval.
Rawin
The amount of raw bytes read per second from TTYs over the monitoring interval.
Ttyout
The amount of bytes written to TTYs per second over the monitoring interval.
Igets
The number of calls per second to the inode lookup routines over the monitoring interval.
Namei
The number of calls per second to the path name lookup routines over the monitoring interval.
Dirblk
The number of directory blocks scanned per second by the directory search routine over the monitoring interval.
PAGING
--------
Displays the per-second frequency of paging statistics. The following data is reported:
Faults
The total number of page faults taken per second over the monitoring interval. This includes page faults that do not cause paging activity.
Steals
The physical memory 4 K frames stolen per second by the virtual memory manager over the monitoring interval.
PgspIn
The number of 4 K pages read from paging space per second over the monitoring interval.
PgspOut
The number of 4 K pages written to paging space per second over the monitoring interval.
PageIn
The number of 4 K pages read per second over the monitoring interval. This includes paging activity associated with reading from file systems. Subtract PgspIn from this value to get the number of 4K pages read from file systems per second over the monitoring interval.
PageOut
The number of 4 K pages written per second over the monitoring interval. This includes paging activity associated with writing to file systems. Subtract PgspOut from this value to get the number of 4K pages written to file systems per second over the monitoring interval.
Sios
The number of I/O requests per second issued by the virtual memory manager over the monitoring interval.
MEMORY
---------
Displays the real memory size and the distribution of memory in use. The following data is reported:
Real,MB
The size of real memory in megabytes.
% Comp
The percentage of real memory currently allocated to computational page frames. Computational page frames are generally those that are backed by paging space.
% Noncomp
The percentage of real memory currently allocated to non-computational frames. Non-computational page frames are generally those that are backed by file space, either data files, executable files, or shared library files.
% Client
The percentage of real memory currently allocated to cache remotely mounted files.
PAGING SPACE
---------------
Displays the size and use of paging space. The following data is reported:
Size,MB
The sum of all paging spaces on the system, in megabytes.
% Used
The percentage of total paging space currently in use.
% Free
The percentage of total paging space currently free.
NFS
-----
Displays the NFS statistics in calls per second. The following data is reported:
Server V2 calls/sec
Client V2 calls/sec
Server V3 calls/sec
Client V3 calls/sec
Total WPAR
------------
Displays the total number of workload partitions that are defined in the system. The total amount of workload partitions can be in the following states: Defined, Active, Broken or Transition.
Active WPAR
--------------
Displays the total number of resource active workload partitions.
AME
----
Displays memory compression statistics in an Active Memory Expansion enabled system. The following data is reported:
TMEM,MB
True Memory Size, in megabytes.
CMEM,MB
Compressed Pool Size, in megabytes.
EF[T/A]
Expansion Factors: Target & Actual.
CI
Compressed Pool Page-Ins.
CO
Compressed Pool Page-Outs.
=======================================================
While topas is running, it accepts one-character subcommands. Each time the monitoring interval elapses, the program checks for one of the following subcommands and responds to the action requested.