Reports selected local and remote system statistics.
topas [ -d hotdisk ][ -f hotfs ] [ -h ] [ -i interval ] [ -n hotni ] [ -p hotprocess ] [ -w hotwlmclass ] [ -c hotprocessor ][ -I remotepollinterval ][ -@ [ wparname ] ] [ -U username ] | [ -C -D | -G | -F | -L | -P | -V | -T | -M | -t | -E | -W ] [ -m ]
The topas command reports selected statistics about the activity on the local system. The command uses the curses library to display its output in a format suitable for viewing on an 80x25 character-based display or in a window of at least the same size on a graphical display. The topas command requires the bos.perf.tools and perfagent.tools file sets to be installed on the system.
The topas command can also report a limited set of performance metrics from remote AIX® partitions that belong to the same hardware platform. This support is described in the Cross-Partition View and Cluster Utilization View sections.
If the topas command is invoked without flags, it runs as if invoked with the following command:
topas -d20 -i2 -n20 -p20 -w20 -c20 -f0
The program extracts statistics from the system with an interval specified by the monitoring_interval_in_seconds argument. The default output, as shown below, consists of two fixed parts and a variable section. The top two lines at the left of the display show the name of the system the topas command runs on, the date and time of the last observation, and the monitoring interval.
Item | Description |
---|---|
EVENTS/QUEUES | Displays the per-second frequency of selected system-global
events and the average size of the thread run and wait queues:
|
FILE/TTY | Displays the per-second frequency of selected file and the TTY statistics.
The following data is reported:
|
PAGING | Displays the per-second frequency of paging statistics. The
following data is reported:
|
MEMORY | Displays the real memory size and the distribution of memory
in use. The following data is reported:
|
PAGING SPACE | Displays the size and use of paging space. The following data
is reported:
|
NFS | Displays the NFS statistics in calls per second. The following
data is reported:
|
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:
|
The variable part of the topas display can have one, two, three, four, or five subsections. If more than one subsection displays, they are always shown in the following order:
When the topas command is started, it displays all subsections for which hot entities are monitored. The Workload Manager (WLM) Classes subsection is displayed only when WLM is active.
The WLM should be started to view the WLM and WPAR statistics.
The following table provides the details for the subsections that the topas command displays:
Item | Description |
---|---|
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:
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:
When this subsection first displays the list of hot network interfaces, the list is sorted by the BPS 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:
When this subsection first displays the list of hot physical disks, the list is sorted by the BPS 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 d key. 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:
When this subsection displays the list of the file systems, the list is sorted by the BPS 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 is filesystem001234, then
the name is displayed as files..01234.
|
WLM classes | This subsection displays a list of hot Workload Manager (WLM) Classes. The maximum number of WLM classes displayed is the number of hot WLM classes being monitored as specified with the -w flag. A smaller number of classes will be displayed if other subsections are also being displayed. Pressing the w key turns off this subsection. The following fields are displayed for each class:
When this subsection first displays the list of hot WLM classes, the list will be sorted by the CPU% field. However, the list can be sorted by the other fields by moving the cursor to the top of the desired column. Tip: If the WLM class name exceeds the field width in the
display, the WLM class name is truncated. The truncation contains
the first and last few characters of the WLM class, and the middle
part of the name is replaced by periods (..). For example, if the
WLM class name is unclassified00123, then the WLM
class name is displayed as uncla..00123.
|
Workload partitions | The workload partitions subsection replaces WLM subsection if invoked with the -@ flag. This subsection displays a list of hot workload partitions. The maximum number of workload partitions that are displayed is the number of hot WPARs that are monitored (when they are specified with the -w -@ flag). A smaller number of WPAR is displayed if other subsections are also being displayed. To turn off the workload partitions subsection, press the @ key. The following fields are displayed for each WPAR:
When this subsection displays the list of hot WPAR, the list is sorted by the CPU% field. However, the list can be sorted by the other fields by moving the cursor to the top of the target column that you want to use to sort the list. Tip: If
the WPAR name exceeds
the field width in the display, the WPAR name is truncated.
The truncation contains the first and last few characters of the WPAR, and the middle part
of the name is replaced by periods (..). For example, if the WPAR name is neptune00123,
then the WPAR is displayed
as neptu..00123.
|
Processes | This subsection displays a list of hot processes. The maximum
number of processes displayed is the number of hot processes being
monitored as specified with the -p flag. A smaller number of
processes will be displayed if other subsections are also being displayed.
Pressing the p key turns off this subsection. The processes
are sorted by their processor usage over the monitoring interval.
The following fields are displayed for each process:
Tip: If the WLM Class/WPAR name exceeds the field
width in the display, the WLM Class/WPAR name is truncated.
The truncation contains the first and last few characters of the WLM
Class/WPAR, and the
middle part of the name is replaced by periods (..). For example,
if the WLM Class/WPAR name
is unclassified00123, then the WLM Class/WPAR name is displayed as uncla..00123.
|
Item | Description |
---|---|
Adapter | The name of the adapter. |
KBPS | The amount of data transferred (read or written) in the adapter in kilobytes per second. |
TPS | Indicates the average number of transfers per second that the adapter issues. |
KB-R | The total number of kilobytes that are read from the adapter. |
KB-W | The total number of kilobytes that are written to the adapter. |
Item | Description |
---|---|
Vtargets/Disk | The name of the virtual target device or disk. |
Busy% | The percentage of time the virtual target device or disk is active (bandwidth use of the virtual target device or disk). |
KBPS | The amount of data that is read and written in kilobytes per second over the monitoring interval. This field is the sum of the values of the KB-R and KB-W metrics. |
TPS | The number of transfers per second that are issued to the virtual target device or disk. A transfer is an I/O request to the virtual target device or disk. Multiple logical requests can be combined into a single I/O request to the disk. A transfer is of medium size. |
KB-R | The number of kilobytes per second that are read from the virtual target device or disk. |
KB-W | The number of kilobytes per second that are written to the virtual target device or disk. |
AQD | The average number of requests that are waiting to be sent to the virtual target device or disk. |
AQW | The average time spent by a transfer request in the waiting queue. The suffix indicates the unit of time. The default time unit is millisecond. |
ART | The average time to receive a response from the hosting server for the read request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
AWT | The average time to receive a response from the hosting server for the write request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
MRT | The maximum time to receive a response from the hosting server for the read request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
MWT | The maximum time to receive a response from the hosting server for the write request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
Item | Description |
---|---|
vAdapter | The name of the virtual adapter. |
TPS | The number of transfers per second that are issued to the adapter. |
KBPS | The amount of data transferred (read or written) in kilobytes per second in the adapter. |
KB-R | The number of blocks received per second from the hosting server to the adapter. |
KB-W | The number of blocks sent per second from this adapter to the hosting server. |
AQD | The average number of requests waiting to be sent to the adapter. |
AQW | The average time spent by a transfer request in the waiting queue. The suffix indicates the unit of time. The default time unit is millisecond. |
ART | The average time to receive a response from the hosting server for the read request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
AWT | The average time to receive a response from the hosting server for the write request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
MRT | The maximum time to receive a response from the hosting server for the read request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
MWT | The maximum time to receive a response from the hosting server for the write request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
Item | Description |
---|---|
Vtargets/Disk | The name of the virtual target device or disk. |
Busy% | The percentage of time the virtual target device or disk is active (bandwidth use of the virtual target device or disk). |
KBPS | The amount of data that is read and written in kilobytes per second over the monitoring interval. This field is the sum of the values of the KB-R and KB-W metrics. |
TPS | The number of transfers per second that are issued to the virtual target device or disk. A transfer is an I/O request to the virtual target device or disk. Multiple logical requests can be combined into a single I/O request to the disk. A transfer is of medium size. |
KB-R | The number of kilobytes that are read per second from the virtual target device or disk. |
KB-W | The number of kilobytes that are written per second to the virtual target device or disk. |
AQD | The average number of requests that are waiting to be sent to the virtual target device or disk. |
AQW | The average time spent by a transfer request in the waiting queue. The suffix indicates the unit of time. The default time unit is millisecond. |
ART | The average time to receive a response from the hosting server for the read request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
AWT | The average time to receive a response from the hosting server for the write request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
MRT | The maximum time to receive a response from the hosting server for the read request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
MWT | The maximum time to receive a response from the hosting server for the write request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
When you use the topas -D command, you can press the m key to display the MPIO panel view. In this panel, the top section contains the same metrics that the Disks panel displays.
Item | Description |
---|---|
Path | The name of the path. |
Busy% | The percentage of time the path is active (bandwidth use of the path). |
KBPS | The amount of data that is read and written in kilobytes per second over the monitoring interval. This field is the sum of the values of the KB-R and KB-W metrics. |
TPS | The number of transfers per second that are issued in that path. |
KB-R | The number of kilobytes that is read per second in that path. |
KB-W | The number of kilobytes that is written per second in that path. |
The space bar key on the keyboard acts as a toggle for freezing the topas panel. If frozen, topas stops data collection and continues to display the data from the previous iteration. You can move around the panel and sort the data based on the selected column. In frozen state, if you move between panels, some panels may not display the data. In this case, press the space bar key to unfreeze the topas panel.
If the amount of data is more than the topas window size, then Page Up and Page Down keys are used to scroll though the data. The data is sorted based on the selected column.
When a Logical Partition panel (topas -L) is enabled in shared-memory mode, you can press the e key to display the I/O Memory Entitlement Pools panel.
Item | Description |
---|---|
iompn | The name of the I/O memory pool. |
iomin | The minimum I/O memory entitlement of the pool. |
iodes | The desired I/O memory entitlement of the pool. |
ioinu | The current I/O memory entitlement of the pool. |
iores | The reserved I/O memory entitlement of the pool. |
iohwm | The maximum I/O memory entitlement in use for the pool (high water mark). |
ioafl | The total number of times the allocation requests have failed for this pool. |
This panel displays metrics similar to the lparstat command for all the AIX partitions it can identify as belonging to the same hardware platform. Dedicated and shared partitions are displayed in separate sections with appropriate metrics. The top section represents aggregated data from the partition set to show overall partition, memory, and processor activity.
Remote enablement for this panel to collect from other partitions requires to use the latest updates to the perfagent.tools and bos.perf.tools to support this function. For earlier versions of AIX, the topas command also collects remote data from partitions that have the Performance Aide product (perfagent.server) installed. The topas -C command may not be able to locate partitions residing on other sub-nets. To avoid this, create a $HOME/Rsi.hosts file containing the fully qualified host names for each partition (including domains), one host per line.
The following metrics display in the initial cross-partition panel. Additional metrics with full descriptive labels can be displayed by using the key toggles identified in the Additional cross-partition panel subcommands section:
Item | Description |
---|---|
Shr | The number of shared partitions based on the system processor. |
Ded | The number of dedicated partitions based on the system processor. |
Item | Description |
---|---|
Mon | The total memory of monitored partitions |
Avl | The memory available to partition set |
InUse | The memory in use on monitored partitions |
Item | Description |
---|---|
Shr | The number of shared processors |
Ded | The number of dedicated processors |
PSz | The active physical processors in the physical shared processor pool being used by this LPAR |
APP | The available physical processors in the shared pool. This is equal to the idle cycles pool reported as a number of processors |
Don | The total number of processors donated to the pool |
Shr_PhysB | The total number of physical processors that are busy for all shared partitions |
Ded_PhysB | The total number of physical processors that are busy for all dedicated partitions |
Item | Description |
---|---|
Host | The host name |
OS | The operating system level |
Mod | The mode of the individual partitions. The mode is displayed in a set of 3 characters. |
Character | The first character indicates the CPU in the partition. The second character indicates the memory mode of the partition. The third character indicates the energy state of the partition. |
Mem | The total memory measured in gigabytes. |
InU | The memory in use measured in gigabytes. |
Lp | The number of logical processors. |
Us | The percentage of processor used by programs executing in user mode. |
Sy | The percentage of processor used by programs executing in kernel mod.e |
Wa | The percentage of time spent waiting for I/O. |
Id | The percentage of time the processors are idle. |
PhysB | The number of physical processors that are busy. |
Ent | The entitlement granted (shared-only). |
%Entc | The percent entitlement consumed (shared-only). |
Vcsw | The average of virtual context switches per second (shared-only). |
PhI | The average of phantom interrupts per second (shared-only). |
Pmem | The physical memory that is backing the partitions logical memory (if in shared-memory mode). |
%idon | The percentage of physical processor that is used while explicitly donating idle cycles. This metric is applicable only for donating dedicated partitions. |
%bdon | The percentage of physical processor that is used while busy cycles are being donated. This metric is applicable only for donating dedicated partitions. |
%istl | The percentage of physical processor that is used while idle cycles are being stolen by the hypervisor. This metric is applicable only for dedicated partitions. |
%bstl | The percentage of physical processor that is used while busy cycles are being stolen by the hypervisor. This metric is applicable only for dedicated partitions. |
First Character | Description |
---|---|
C | SMT enabled and capped |
c | SMT disabled and capped |
U | SMT enabled and uncapped |
u | SMT disabled and uncapped |
First Character | Description |
---|---|
S | SMT enabled and not donating |
d | SMT disabled and donating |
D | SMT enabled and donating |
- | SMT disabled and not donating |
Second Character | Description |
---|---|
M | AMS enabled and AME disabled |
- | AME and AMS disabled |
E | AME enabled and AMS enabled |
e | AME enabled and AMS disabled |
Third Character | Description |
---|---|
S | Static power save mode is enabled |
d | Power save mode is disabled |
D | Dynamic power save mode is enabled |
- | Unknown / Undefined |
E | Power save mode has been enabled |
d | Power save mode has been disabled |
The %idon and %bdon metrics are not displayed when there is no donating dedicated partition.
Topas CEC Monitor Interval: 10 Mon Jan 22 00:08:00 2007
Partition Info Memory (GB) Processor Virtual Pools : 2
Monitored : 2 Monitored : 6.2 Monitored :2.0 Avail Pool Proc: 5
UnMonitored: - UnMonitored: - UnMonitored: - Shr Physical Busy: 0.00
Shared : 0 Available : - Available : - Ded Physical Busy: 0.05
Uncapped : 0 UnAllocated: - UnAllocated: - Donated Phys. processors: 0.00
Capped : 2 Consumed : 1.9 Shared : 0 Stolen Phys. processors : 0.01
Dedicated : 2 Dedicated : 2 Hypervisor
Donating : 0 Donated : 0 Virt. Context Switch: 347
Pool Size : 0 Phantom Interrupts : 0
Host OS M Mem InU Lp Us Sy Wa Id PhysB Vcsw Ent %EntC PhI
-------------------------------------shared-------------------------------------
ptoolsl1 A53 U 3.1 1.9 4 1 2 0 96 0.01 398 0.20 5.3 0k
Host OS M Mem InU Lp Us Sy Wa Id PhysB Vcsw %istl %bstl %bdon %idon
------------------------------------dedicated-----------------------------------
ptools1 A54 S 3.1 0.9 2 0 0 0 99 0.00 177 0.1 0.0 0.0 0.0
ptoolsl3 A54 S 3.1 0.9 2 0 0 0 99 0.00 170 0.2 0.0 0.0 0.0
The following headers are in the previous screen:
Item | Description |
---|---|
Monitored | The number of partitions that are monitored |
Unmonitored | The number of partitions that are not monitored |
Shared | The number of shared partitions |
Uncapped | The number of uncapped shared partitions |
Capped | The number of capped partitions |
Dedicated | The number of dedicated partitions |
Donating | The number of partitions that are currently donating |
Item | Description |
---|---|
Monitored | The total memory that is monitored |
UnMonitored | The total memory that is not monitored |
Available | The total memory that is available |
UnAllocated | The total memory that is not allocated to any partition |
Consumed | The total memory that is consumed by the partitions |
Item | Description |
---|---|
Monitored | The number of physical processors that are monitored |
UnMonitored | The number of physical processors that are not monitored |
Available | The number of physical processors that are available in CEC system |
UnAllocated | The number of physical processors that are not allocated to any partition |
Shared | The number of processors that are in shared partitions |
Dedicated | The number of processors that are in dedicated partitions |
Donated | The sum of the number of processors in all the partitions donating |
Pool Size | The number of active shared processors in all of the pools |
Avail Proc Pool | The physical processors in the pool that is available |
Shr Physical Busy | The sum of physical busy of all of the shared partitions |
Ded Physical Busy | The sum of dedicated busy of all of the dedicated partitions |
Donated Phys. processors | The sum of the donated processor cycles from all of the partitions reported as a number of processors |
Stolen Phys. processors | The sum of stolen processor cycles from all of the partitions reported as a number of processors |
Virtual Pools | The number of virtual pools |
Virt. Context Switch | The total number of virtual context switches per second in the monitoring interval |
Phantom Interrupts | The total number of phantom interrupts per second in the monitoring interval |
pool psize entc maxc physb app mem muse
0 3.0 2.0 4.0 0.1 2.0 1.0 1.5
1 4.0 3.0 5.0 0.5 1.5 1.0 0.5
2 3.0 2.5 4.0 0.2 2.0 1.0 0.5
Item | Description |
---|---|
psize | The effective maximum capacity of the pool |
entc | The entitled capacity of the pool |
maxc | The maximum capacity of the pool |
physb | The sum of physical busy of processors in shared partitions of a pool |
app | The available physical processor in the pool |
mem | The sum of monitored memory for all shared partitions in the pool |
muse | The sum of memory consumed for all shared partitions in the pool |
Item | Description |
---|---|
Server | The name of the VIO Server. |
Client | The name of the VIO Client. |
KBPS | The amount of data that is read and written in kilobytes per second over the monitoring interval. This field is the sum of the values of the KB-R and KB-W metrics. |
TPS | The number of transfers that are issued per second. |
KB-R | The number of kilobytes that are read per second. |
KB-W | The number of kilobytes that are written per second. |
AQD | The average number of requests that are waiting to be sent. |
AQW | The average time spent by a transfer request in the waiting queue. The suffix indicates the unit of time. The default time unit is millisecond. |
ART | The average time to receive a response from the hosting server for the read request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
AWT | The average time to receive a response from the hosting server for the write request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
MRT | The maximum time to receive a response from the hosting server for the read request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
MWT | The maximum time to receive a response from the hosting server for the write request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
When the topas command is running inside the Virtual I/O Server/Client Throughput panel, press the d key after selecting a server from the Virtual I/O Server/Client Throughput panel to toggle to VIO Server/Client Disk Details panel. This panel displays the server adapter details in the top section and displays the target device and client disk details in the bottom of the section. To list the target devices and client disks belong to that adapter, select the adapter and press the f key.
Item | Description |
---|---|
Adapter | The name of the server adapter. |
Vtargets | The name of the virtual target device that belongs to the server adapter. |
Client_disk | The name of the client disk that is mapped to the virtual target device of the server adapter. |
Item | Description |
---|---|
KBPS | The amount of data transferred (read or written) in the adapter in kilobytes per second. |
TPS | The number of transfers per second that are issued to the adapter. |
KB-R | The total number of kilobytes read from the adapter. |
KB-W | The total number of kilobytes written to the adapter. |
AQD | The number of requests waiting to be sent to the adapter. |
AQW | The average time spent by a transfer request in the waiting queue. The suffix indicates the unit of time. The default time unit is millisecond. |
ART | The time to receive a response from the hosting server for the read request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
AWT | The time to receive a response from the hosting server for the write request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
MRT | The maximum time to receive a response from the hosting server for the read request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
MWT | The maximum time to receive a response from the hosting server for the write request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
Item | Description |
---|---|
Busy% | The percentage of time the that the virtual target device or disk is active (bandwidth use of the virtual target device or disk). |
KBPS | The number of kilobytes read and written per second over the monitoring interval. This field is the sum of the values of the KB-R and KB-W metrics. |
TPS | The number of transfers per second that are issued to the virtual target device or disk. A transfer is an I/O request to the virtual target device or disk. Multiple logical requests can be combined into a single I/O request to the virtual target device or disk. A transfer is of medium size. |
KB-R | The number of kilobytes read per second from the virtual target device or disk. |
KB-W | The number of kilobytes written per second to the virtual target device or disk. |
AQD | The average number of requests waiting to be sent to virtual target device or disk. |
AQW | The average time spent by a transfer request in the waiting queue. The suffix indicates the unit of time. The default time unit is millisecond. |
ART | The average time to receive a response from the hosting server for the read request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
AWT | The average time to receive a response from the hosting server for the write request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
MRT | The maximum time to receive a response from the hosting server for the read request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
MWT | The maximum time to receive a response from the hosting server for the write request sent. The suffix indicates the unit of time. The default time unit is millisecond. |
To display the Memory Pool panel from the CEC panel, press the m key. This panel displays the statistics of all of the memory pools in the system. To display the partitions corresponding to that pool in the lower section of the panel, select a particular memory pool and press the f key.
Item | Description |
---|---|
Mshr | The number of logical partitions (LPARs) running in the shared-memory mode. |
Mded | The number of LPARs running in dedicated-memory mode. |
Pools | The total number of memory pools in the system. |
Mpsz | The total size of physical memory of all the memory pools in gigabytes. |
MPuse | The total memory used by LPARs associated with all of the pools in gigabytes. |
Entl | The total I/O memory entitlement of all of the LPARs in all the pools in gigabytes. |
Use | The total I/O memory entitlement in use of all of the LPARs in all the pools in gigabytes. |
Mon | The total monitored memory of the system ( sum of the values of the Mpsz metric and the Total memory of dedicated memory partitions metric). |
InUse | The total memory in use of the system (sum of the MPuse metric and Total memory inuse for dedicated memory partitions metric). |
Avl | The total memory available for the system (the value of the Mon metric minus the value of the InUse metric). |
Item | Description |
---|---|
mpid | The ID of the memory pool. |
mpsz | The size of the total physical memory of the memory pool in gigabytes. |
mpus | The total memory of the memory pool in use ( this is the sum of the physical memory allocated to all of the LPARs in the pool). |
mem | The size of the aggregate logical memory of all the partitions in the pool in gigabytes. |
memu | The aggregate logical memory that is used for all the partitions in the pool in gigabytes. |
iome | The aggregate of I/O memory entitlement that is configured for all the LPARs in the pool in gigabytes. |
iomu | The aggregate of the I/O memory entitlement that is used for all the LPARs in the pool in gigabytes. |
hpi | The aggregate number of hypervisor page faults that have occurred for all of the LPARs in the pool. |
hpit | The aggregate of time spent in waiting for hypervisor page-ins by all of the LPARs in the pool in milliseconds. |
Item | Description |
---|---|
mem | The size of logical memory of the partition in gigabytes. |
memu | The logical memory that is used for the partition in gigabytes. |
meml | The logical memory loaned to hypervisor by the LPAR. |
pmem | The physical memory that is allocated to the partition from the memory pool in gigabytes. |
iom | The amount of I/O memory entitlement that is configured for the LPAR in gigabytes. |
iomu | The amount of I/O memory entitlement that is used for the LPAR in gigabytes. |
hpi | The number of hypervisor page faults. |
hpit | The time spent in waiting for hypervisor page-ins in milliseconds. |
vcsw | The virtual context switches average per second. |
physb | The physical processor that is busy. |
%entc | The percentage of the consumed processor entitlement. |
A cluster is a group of related partitions or nodes. The Cluster Utilization view can either show utilization of an HA cluster or a user-defined cluster. This panel displays metrics similar to the lparstat command for all the AIX partitions it can identify as belonging to the same hardware platform. The dedicated and shared partitions are displayed in separate sections with appropriate metrics. The top section represents aggregated data from the partition set to show overall partition, memory, and processor activity.
The following metrics are displayed in an initial cluster utilization panel. Additional metrics with full descriptive labels can be displayed using the key toggles identified in the Additional Cluster Utilization Panel Subcommands topic.
Item | Description |
---|---|
Shr | The number of shared partitions based on the system processor. |
Ded | The number of dedicated partitions based on the system processor. |
Item | Description |
---|---|
Mon | The total memory of monitored partitions. |
InUse | The memory in use on monitored partitions. |
Item | Description |
---|---|
Shr | The number of shared processors. |
Ded | The number of dedicated processors. |
Shr_PhysB | The total number of physical processors that are busy for all shared partitions. |
Ded_PhysB | The total number of physical processors that are busy for all dedicated partitions. |
Item | Description |
---|---|
Host | The host name. |
CEC | The CEC identifier. |
OS | The operating system level |
Mem | The total memory measured in gigabytes. |
M | The mode of the individual partitions. |
InU | The memory in use measured in gigabytes. |
Lp | The number of logical processors. |
Us | The percentage of the processor used by programs executing in user mode. |
Sy | The percentage of the processor used by programs executing in kernel mode. |
Wa | The percentage of time spent waiting for I/O. |
Id | The percentage of time the processors are idle. |
PhysB | The number of physical processors that are busy. |
Ent | The entitlement granted (shared-only). |
%Entc | The percentage entitlement consumed (shared-only). |
Vcsw | The average of virtual context switches per second (shared-only). |
Character | Description |
---|---|
C | SMT enabled and capped |
c | SMT disabled and capped |
U | SMT enabled and uncapped |
u | SMT disabled and uncapped |
Character | Description |
---|---|
S | SMT enabled and not donating |
d | SMT disabled and donating |
D | SMT enabled and donating |
- | SMT disabled and not donating |
Topas CEC Cluster Monitor ID: Interval: 10 Thu Apr 2 16:13:18 2009
Partitions Memory (GB) Processor
Shr :2 Mon : 6.0 Shr :1.5 Shr_PhyB : 0.01
Ded :2 InU : 3.0 Ded :2 Ded_PhyB : 0.00
Host CEC OS M Mem InU Lp Us Sy Wa Id PhysB Vcsw Ent %EntC
-------------------------------------shared-------------------------------
clock16 19318230 A61 U 2.0 1.1 2 0 0 0 99 0.00 423 0.75 0.6
clock15 19318230 A61 U 2.0 1.6 2 0 0 0 99 0.01 985 0.75 0.9
Host CEC OS M Mem InU Lp Us Sy Wa Id PhysB Vcsw
------------------------------------dedicated------------------
ses10 19318230 A61 D 2.0 1.1 2 0 0 0 99 0.00 0
clock10 19318230 A61 D 0.0 0.0 2 0 0 0 99 0.00 742
The following display when press g key from the above panel,
which brings the cluster utilization view with detailed headers:
Topas Cluster Monitor ID: Interval: 10 Thu Apr 2 16:13:44 2009
Partition Info Memory (GB) Processor Supplier: ses10.in.ibm.com
Monitored :4 Monitored:6.0 Monitored :3.5 Shr Physical Busy :0.01
Shared :2 Consumed :3.0 Shared :1.5 Ded Physical Busy :0.00
Uncapped :2 Dedicated :2
Capped :2
Dedicated :2
Host CEC OS M Mem InU Lp Us Sy Wa Id PhysB Vcsw Ent %EntC
-------------------------------------shared-------------------------------
clock16 19318230 A61 U 2.0 1.1 2 0 0 0 99 0.00 423 0.75 0.6
clock15 19318230 A61 U 2.0 1.6 2 0 0 0 99 0.01 985 0.75 0.9
Host CEC OS M Mem InU Lp Us Sy Wa Id PhysB Vcsw
------------------------------------dedicated------------------
ses10 19318230 A61 D 2.0 1.1 2 0 0 0 99 0.00 0
clock10 19318230 A61 D 0.0 0.0 2 0 0 0 99 0.00 742
Disks and network adapters added after starting topas or any other SPMI consumer will not be reflected in topas. You must stop topas and all clients that use SPMI and then restart after the changes to disks and network adapters are made.
Item | Description |
---|---|
-@wparname | Shows the WPAR-specific metrics. If you specify a WPAR name with the wparname parameter, the topas monitors that WPAR. |
-chotprocessor | Specifies with thehotprocessor parameter the number of hot processors to be monitored. This is also the maximum number of processors displayed when enough room is available on the screen. If this number exceeds the number of processors available, only the installed processors will be monitored and displayed. If this argument is omitted, a default of 2 is assumed. If a value of 0 (zero) is specified, no processor information is monitored. |
-C | Displays the Cross-partition panel. The topas command collects a set of metrics from AIX partitions running on the same hardware platform. The metrics are similar to those collected by the lparstat command. Dedicated and shared partitions are displayed, and a set of aggregated values provide an overview of the entire hardware systems partition set. Certain values only available from the HMC platform can be set through the line command if an HMC connection is not available. |
-G | Displays the Cluster Utilization panel. The topas command collects a set of metrics from AIX partitions that are running on the same hardware platform. The metrics are similar to those collected by the lparstat command. Dedicated and shared partitions are displayed. |
-D | Displays the Disk Metrics display (Disk panel
view). The display reports disk service times, disk queuing metrics,
and disk throughput. The following metrics are reported:
With the -D flag specified, you can run
the following subcommands:
Limitation: The -D option provides Disk panel view where it reports disk service times, disk queuing metrics, and disk throughput. Whenever -D option is started, it resets the disk minimum and maximum service time metrics during the first interval. Because the service time metrics are reset during first interval of -D option, the existing instance of -D option or some other consumer's use of the disk service time metrics is affected. |
-d hotdisk | Specifies the number of disks to be monitored. The hotdisk parameter specifies the number of the hot disks to be monitored. This is also the maximum number of disks displayed when enough room is available on the screen. When this number exceeds the number of disks installed, only the installed disks will be monitored and displayed. If this argument is omitted, a default of 2 is assumed. If a value of 0 (zero) is specified, no disk information is monitored. |
-E | Displays the statistics of the shared Ethernet adapter on a
Virtual I/O Server. The following metrics are displayed:
|
-F | Displays the file system display. When you specify the flag with the -@ flag or the @ subcommand, file system is shown in two windows. The top part of the display shows a list of active WPAR. This list can be sorted on any column. The display reports file system service times, file system queuing metrics, and file system throughput. The following metrics are reported:
Tip: If the file
system name exceeds the field width in the display, then the file
system name is displayed is truncated. The truncation contains the
first and last few characters of the file system, and the middle part
of the name is replaced by periods (..). For example, if the file
system name is filesystem001234, then the file system
name is displayed as files..01234.
|
-f HotFS | Specifies with the HotFS parameter the number of file system to be monitored. This is also the maximum number of file system displayed when enough room is available. When this number exceeds the number of file system mounted, only the mounted file system is monitored and displayed. If you do not specify the -f flag, the default value is two. If you specify a value of zero, the file system information is monitored. |
-h | Displays help information in the following format:
|
-i interval | Sets the monitoring interval or the recording interval in seconds.
If you specify the -i flag with the interval parameter,
the interval parameter sets the monitoring intervals. The default
value for theinterval parameter is two seconds. If you specify the -i flag with the -R mode, the interval parameter becomes the recording interval for partition metrics. The default value for theinterval parameter is 300 seconds. Valid values are 10, 15, 30, 60, 120, and 300 seconds. |
-I remotepollinterval | For cross-partition display, sets with the remotepollinterval parameter the sampling interval to collect data from remote partitions. The default value for the remotepollinterval parameter is 10 seconds. Values of 10, 15, 30, 60 and 120 seconds are allowed. |
-L | Displays the logical partition display. This
display reports similar data to what is provided to mpstat and lparstat. In
shared-memory mode, this panel displays information about I/O memory
entitlement of the partition. The existing %lbusy, %hypv and hcalls metrics
are replaced by the following metrics:
With the -L flag specified, you can press the e key to display the I/O Memory Entitlement Pools panel. For more information about this panel, see I/O Memory Entitlement Pools Panel. |
-M | Displays the Memory topology panel. The display reports similar data to what is provided by the lssrad command. There are two sections in this panel:
The following metrics are displayed as part of this panel.
|
-m | Displays in monochrome mode (no colors). |
-n hotni | Specifies with the hotni parameter the number of hot network interfaces to be monitored. This is also the maximum number of network interfaces displayed when enough room is available on the screen. When this number exceeds the number of network interfaces installed, only the installed network interfaces will be monitored and displayed. If this argument is omitted, a default of value of 2 is assumed. If a value of 0 (zero) is specified, no network information is monitored. |
-P | Similar to the ps command, the -P flag
displays the full-screen process display. This display shows a list
of the busiest processes, similar to the process subsection on the
default display, only with more columns showing more metrics per process.
This list can be sorted by any column. Following are the metrics displayed.
When specified with -@ (topas –P -@),
a new field WPAR is
displayed and the PPID field is removed. All other metrics
remains the same.
Tip: If the WPAR class name exceeds
12 characters and it need to be displayed in a 12 character format,
the first five characters will be followed by two periods (.), and
then follows the last five characters. For example, if the WPAR class name is neptune001234,
then the WPAR name is
displayed as neptu..01234.
|
-photprocess | Specifies with the hotprocess parameter the number of hot processes to be monitored. This is also the maximum number of processes shown when enough room is available on the screen. If this argument is omitted, a default of 20 is assumed. If a value of 0 is specified, no process information will be monitored. Retrieval of process information constitutes the majority of the topas overhead. If process information is not required, always use this option to specify that you do not want process information. |
-t | Toggles the tape display section on or off in the main topas display. |
-T | Displays the full screen tape display panel. The following
metrics are displayed in this panel:
|
-U username | With the -P flag, this flag shows the processes owned by the user specified with the username parameter. Only processes owned by the user that is specified will be shown in the All Process Display. |
-V | Displays the Volume Group panel. The panel reports the following
metrics of the volume groups in the top section of the panel, and
the same metrics of the logical volumes in the bottom section of the
panel.
|
-W | Displays the full-screen WLM class display,
which is a split display. The top part of the display shows a list
of hot WLM classes, similar to the WLM classes subsection on the default
display, but with enough space available to display the full class
names. This list can be sorted on any column. If you specify the -@ flag, or if you press the @ subcommand, the WPAR section is displayed and the WLM section is not displayed. The WPAR section shows the list of hot WPARs. This list can be sorted on any column. The bottom part of the display
shows a list of busiest processes, similar to the full screen process
display, but only displays processes that belong to one WLM class
or WPAR that are selected
with the f key.
Note: If the WLM class is not active then
the default system processes will be displayed in the bottom part
of the display.
|
-w [number of monitored hot WLM classes] | Specifies with the hotwlmclass parameter the number of hot Workload Manager (WLM) classes to be monitored. This is also the maximum number of WLM classes displayed when enough room is available on the screen. If this number exceeds the number of WLM classes installed, only the installed WLM classes will be monitored and displayed. If this argument is omitted, a default of 2 is assumed. If a value of 0 (zero) is specified, no WLM class information is monitored. |
While topas is running, it accepts 1-character subcommands. Each time the monitoring interval elapses, the program checks for one of the following subcommands and responds to the action requested.
Item | Description |
---|---|
a | Shows all of the variable subsections being monitored (processor, network, disk, WLM, and process). Pressing the a key always returns the topas command to the initial main display. |
c | Replaces the current display of the cumulative report with the processor subsection. When you press the c key again, it displays the cumulative report. The number of busiest processors displayed will depend upon the space available on the screen. |
C | Activates the Cross-Partition panel. If the panel is currently active, the C key resets the panel to display the global summary, dedicated, and shared sections. See the Additional Cross-partition Panel Subcommands section below for options specific to this panel. |
d | Replaces the current display of the total disk activity with a list of the busiest disks. When you press the d key again, it displays the total disk activity. The number of busiest disks displayed will depends on the space available on the screen. |
D | Replaces the current display with the Disk Metric display. This display offers additional information about disk access times and disk queuing. If the D key is pressed again, the display toggles back to the default main screen. |
E | Shows the shared Ethernet adapter panel in VIO Server. |
f | Press the f key while moving the cursor over a WLM class to display the list of top processes in the class at the bottom of the WLM screen. In the file system subsection of the topas command main panel, press the f key to replace the default report of total file system activity of the system with a list of busiest file system. When you press the f key again, it returns to the default display of the total file system activity. The number of busiest file system depends upon the space available on the screen. In the Volume Group panel (topas -V), you can select a volume group name and press the f key to display the list of top logical volumes that belong to the volume group at the bottom of the LVM panel. |
F | Replaces the default display with the full-screen file system display. This display provides more detailed information about file systems on the system than the file system section of the main display. When the you press the F key again, it returns to the default main display. |
G | Activates the Cluster Utilization panel. If the panel is currently active, the Gkey resets the panel to display the global summary, dedicated, and shared sections. See the Additional Cluster Utilization Panel Subcommands topic for options specific to this panel. |
h | Shows the help screen. |
H | Shows the help screen for the local panel, if available. |
L | Replaces the current display with the logical partition display; LPAR, Micro-Partitioning®, and simultaneous multithreading metrics similar to what lparstat and mpstat provide are displayed. |
n | Replaces the report on the total network activity of the system with the list of the busiest interfaces. Press the n key in the network interfaces subsection. The number of busiest interfaces displayed will depend upon the space available on the screen. |
p | Toggles the hot processes subsection on and off. The number of busiest processes displayed will depend upon the space available on the screen. |
P | Replaces the default display with the full-screen process display. This display provides more detailed information about processes running on the system than the process section of the main display. When the P key is pressed again, it toggles to the default main display. |
q | Quits the program. |
r | Refreshes the display. |
t | Toggles the tape display on or off in the main panel. |
T | Shows the full-screen tape display. |
V | Shows the Volume Group panel. |
w | Toggles the Workload Manager (WLM) classes subsection on and off. The number of busiest WLM classes displayed will depend upon the space available on the screen. |
W | Replaces the default display with the full-screen WLM class display. This display provides more detailed information about WLM classes, WPAR classes, and processes assigned to classes. When you press the @ key, the WLM class subsection is replaced by WPAR subsection. When you press the W key again, it toggles back to the default main display. |
@ | Toggles between the WLM class metric and WPAR metrics, that is, WPAR is monitored instead
of WLM. This is the at (@) key. This key is valid for the Main panel,
Process panel, File System panel, and WLM panel. If you press the @ key
from any other panel, it is ignored. The @ key is restricted
inside a WPAR, that
is, it is ignore inside a WPAR.
The @ key is valid in the following panels:
|
Arrow and Tab keys | Subsections from the main display such as the processor, Network, Disk, WLM Classes, and the full-screen WLM and Process displays can be sorted by different criteria. Positioning the cursor over a column activates sorting on that column. The entries are always sorted from highest to lowest value. The cursor can be moved by using the Tab key or the arrow keys. Sorting is only valid for 128 disks and 16 network adapters. |
~ | Shows the nmon screen. This is the tilde (~) key. |
When the topas Cross-partition panel is active, it accepts the following additional 1-character subcommands. Each time the monitoring interval elapses, the program checks for one of the following subcommands and responds to any requested action.
Item | Description |
---|---|
d | Toggles the dedicated partition section on and off. |
g | Toggles the top global section of the panel between brief listing, detailed listing, and off. |
r | Forces topas to search the for HMC configuration changes if a connection is available. This includes the discovery of new partitions, processors, or memory allocations. |
s | Toggles the shared partition section on and off. |
p | Toggles the pool panel section on or off. Inside the pool panel, user can select one pool ID and press the f key to list the shared partitions that belong to the pool. |
v | Toggles the Virtual I/O Server/Client Throughput details on or off. You can select one virtual I/O server and press the f key to list the VIO clients that belong to that server. |
m | Toggles the memory pool panel on or off. You can select a memory pool and press the f key to view the partitions in that pool. |
When the topas Cluster Utilization panel is active, it accepts the following additional 1-character subcommands. Each time the monitoring interval elapses, the program checks for one of the following subcommands and responds to any requested action:
Item | Description |
---|---|
d | Toggles the dedicated partition section on and off. |
g | Toggles the top global section of the panel between brief listing, detailed listing, and off. |
s | Toggles the shared partition section on and off. |
When the topas Disk panel is active, it accepts the following additional 1-character subcommands. Each time the monitoring interval elapses, the program checks for one of the following subcommands and responds to any requested action:
Item | Description |
---|---|
d | Toggles the Adapter panel on or off. |
m | Toggles the MPIO panel on or off. |
When the topas Adapter panel is active, it accepts the following additional 1-character subcommand. Each time the monitoring interval elapses, the program checks for one of the following subcommands and responds to any requested action:
Item | Description |
---|---|
v | Toggles the Virtual Adapter panel on or off. Press this key from the Adapter panel. |
When the topas Logical panel is active, it accepts the following additional 1-character subcommand. Each time the monitoring interval elapses, the program checks for one of the following subcommands and responds to any requested action:
Item | Description |
---|---|
e | Toggles the I/O Memory Entitlement Pools panel. |
When the topas Virtual I/O Server/Client Throughput panel is active, it accepts the following additional 1-character subcommand. Each time the monitoring interval elapses, the program checks for one of the following subcommands and responds to any requested action:
Item | Description |
---|---|
d | Turns the Virtual I/O Server/Client Disk panel on or off for the Virtual I/O Server that is selected in the Virtual I/O Server/Client Throughput panel. You can select the server adapters and press the f key to list the disks and the clients that belong to that adapter. |
The following is an example of the display generated by the topas -W command:
Topas Monitor for host: ptoolsl3 Interval: 2 Mon Feb 12 06:25:11 2007
WLM-Class (Active) CPU% Mem% Blk-I/O%
System 0 57 0
Shared 0 4 0
Default 0 0 0
Unmanaged 0 14 0
Unclassified 0 38 0
==============================================================================
DATA TEXT PAGE PGFAULTS
USER PID PPID PRI NI RES RES SPACE TIME CPU% I/O OTH COMMAND
root 1 0 108 20 197 9 180 0:24 0.0 0 0 init
root 1032 0 16 41 3 3374 3 0:00 0.0 0 0 lrud
root 1290 0 60 41 4 3374 4 0:02 0.0 0 0 xmgc
root 1548 0 36 41 4 3374 4 0:26 0.0 0 0 netm
root 1806 0 37 41 16 3374 16 13:25 0.0 0 0 gil
root 2064 0 16 41 4 3374 4 0:04 0.0 0 0 wlmsched
root 2698 1 108 20 14 2 14 0:00 0.0 0 0 shlap
root 3144 1 108 20 40 1 36 5:19 0.0 0 0 syncd
root 3362 0 108 20 4 3374 4 0:00 0.0 0 0 lvmbb
root 3666 1 108 20 135 23 123 0:00 0.0 0 0 errdemon
root 3982 0 108 20 4 3374 4 0:01 0.0 0 0 rtcmd
The following is an example of the display generated by topas –W -@ command:
Topas Monitor for host: ptoolsl3 Interval: 2 Mon Feb 12 06:25:11 2007
WPAR CPU% Mem% Blk-I/O%
neptune001234 0 1 0
==============================================================================
DATA TEXT PAGE PGFAULTS
USER PID PPID PRI NI RES RES SPACE TIME CPU% I/O OTH COMMAND
root 356372 491650 58 41 370 67 370 0:00 0.1 0 0 topas
root 262246 188508 24 41 256 21 256 6:27 0.1 0 0 xmtopas
root 192626 1 60 20 113 17 113 11:17 0.1 0 0 getty
root 61470 0 16 41 17 0 17 0:31 0.0 0 0 wlmsched
root 290818 1 58 41 284 67 284 1:54 0.0 0 1 topas
root 57372 0 37 41 30 0 30 3:39 0.0 0 0 gil
root 86248 1 60 20 47 0 47 1:04 0.0 0 0 rpc.lock
root 385224 237728 60 20 254 197 254 0:00 0.0 0 0 sendmail
root 131174 176242 60 20 175 79 175 0:03 0.0 0 0 aixmibd
root 53274 0 36 41 13 0 13 0:05 0.0 0 0 netm
root 90244 1 60 20 126 2 126 2:35 0.0 0 0 syncd
root 45078 0 60 41 14 0 14 0:58 0.0 0 0 xmgc
root 266384 176242 60 20 644 160 644 0:27 0.0 0 0 IBM.CSMA
root 250004 176242 60 20 617 157 617 0:26 0.0 0 0 rmcd
root 184410 176242 60 20 254 197 254 0:14 0.0 0 0 sendmail
root 151640 0 60 20 13 0 13 0:02 0.0 0 0 rgsr
root 40980 0 59 41 71 0 71 0:02 0.0 0 0 pilegc
root 110738 0 60 20 13 0 13 0:01 0.0 0 0 n4bg
root 180368 1 60 20 98 14 98 0:01 0.0 0 0 cron
root 1 0 60 20 158 10 158 0:01 0.0 0 0 init
topas -i5 -n0 -p0 -w0 -f0
topas -p5 -n0 -d0 -f0
topas
topas -P
topas -W
topas -L
topas -D
topas -F
topas -@ abc
topas -@
topas –V
topas –T
topas -E
topas -G
Item | Description |
---|---|
/usr/bin/topas | Contains the topas command. |