mpstat(C) 06 January 1993 mpstat(C) Name mpstat - multiprocessor CPU load status display Syntax mpstat [ -x | c CPU ] [ -bho ] mpstat [-V] Description The multiprocessor load display utility, mpstat, displays system proces- sor activity information on your screen for each of the processors installed on your system. CPU load display information updates every second. When you invoke mpstat, the Multiprocessor Activity window displays on your screen. For each CPU installed on your system the following informa- tion displays: CPU activity display windows The CPU Activity Display Window displays CPU activity. The percentage of kernel code running, the percentage of user code running, and the percentage of CPU idle time are indicated as follows: + dark shaded block or `:' - specifies one unit (5%) of kernel code + light shaded block or `#' - specifies one unit (5%) of user code The amount of space within the CPU Activity Display Window indicates the percentage of CPU idle time (one space equals 5%). Status Each CPU is in one of three states: + ACTIVE - The CPU is available to run any process. + STATIC - The CPU can only run processes specifically designated to run on that CPU. + INACTIVE - The CPU runs no processes. sys Specifies the number of system calls. cs Specifies the number of context switches. int Specifies the number of interrupts. tr Specifies the number of traps. The CPU load display utility displays status information for as many CPUs as possible on your screen. If you have a large number of processors installed, it may not be possible to display status information for all processors on one screen. mpstat allows you to examine status information for all CPUs using the screen movement keys. The screen movement keys are as follows: <Ctrl>f scrolls forward one screen <Ctrl>d scrolls forward one half screen <Ctrl>b scrolls backward one screen <Ctrl>u scrolls backward one half screen <Home> or <Ctrl>h moves to the first screen <End> or G moves to the last screen <Up Arrow> or j scrolls forward one CPU <Down Arrow> or k scrolls backward one CPU <Ctrl>r or <Ctrl>l refreshes the current screen The Help window displays a full list of the screen movement keys. Press `h' from the Multiprocessor Activity window to display the Help window. The Help window also displays Hotkey information. Hotkeys are used to move between mpstat windows. The Hotkeys are as follows: <Esc> or q exit the current window o display the Options window The mpstat utility allows you to lock this utility onto any one CPU (with the exception of the base CPU - CPU1). A lock on any CPU releases all other CPUs for normal operation. This will produce accurate system pro- cessor activity information. If you lock mpstat onto a CPU, that CPU will only execute mpstat and pro- cesses currently designated to run on that CPU. The CPU displays on the status information screen as being in a STATIC state. Invoke mpstat with the -c CPU option or select the lock option from the Options menu to lock mpstat to run on a specified CPU. Invoke mpstat with the -x (default) option to allow mpstat to free run on any CPU. Note that allowing mpstat to free run on any CPU does not pro- duce accurate processor load status information. mpstat also allows you to hide the locked CPU. This option will move data on the locked CPU from the status display screen into the back- ground. Invoke mpstat with the -h option or select the hide option from the Options menu to hide the statistics of the locked CPU. You can select the required options, on the Options screen, using the <Up Arrow> and <Down Arrow> keys. Invoke mpstat with the -o option or type `o' at the Multiprocessor Activity window to display the Options window. mpstat can be run with none or any of the following command line parameters: -c CPU lock mpstat utility on processor number CPU. Cannot be used with option -x -b use current screen colors -h hide statistics of locked CPU -o run Options window -x allow mpstat to free run on any CPU. Default option. Can- not be used with option -c -V display Corollary mpstat version number