Transcription

1 Page 1 of 33 AIX 6.1 정보 > Commands > t topas Command Purpose Reports selected local and remote system statistics. Syntax topas [ -d hotdisk ][ -f hotfs ] [ -h ] [ -i interval ] [ -n hotni ] [ -p hotprocess ] [ -w hotwlmclass ] [ -c hotprocessor ][ -I remotepollinterval ][ -@ [ wparname ] ] [ -U username ] [ -C -R [ -o field = value,... ] -D -F -L -P -V -T -M -t -E -W ] [ -m ] Restriction: You cannot use the -C, -R, -L, -E, -V, -v, -T, -t, -w, -W, -I, -@ options when you issue the command from a workload partition. Description 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 section. The topas -D command reports the disk details. This report is described in the Disk Panel section. You can run the subcommands from the Disk Panel to display the following views: Adapter Panel Specified by pressing the d key. This panel provides details on the adapters and the disks that belong to the selected adapters. Virtual Adapter Panel Specified by pressing the d key and then the v key. This panel provides details of the virtual adapters that are related to the disks. MPIO Panel Specified by pressing the m key. This panel provides the details of the disks and the paths. Restriction: Adapter Panel, Virtual Adapter Panel and MPIO Panel are restricted inside WPARs. 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 Note: The CEC or cluster panel re-spawns when the migration or hibernation of the partition is complete. All other behavior for the CEC and any other panel remains the same in the event of migration or hibernation. 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

2 Page 2 of 33 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. The second fixed part fills the rightmost 25 positions of the display. It contains the following subsections of statistics: EVENTS/QUEUES Displays the per-second frequency of selected system-global events and the average size of the thread run and wait queues: Cswitch Syscalls Reads Writes Forks Execs The number of context switches per second over the monitoring interval. The total number of system calls per second that are run over the monitoring interval. The number of read system calls per second that are run over the monitoring interval. The number of write system calls per second that are run over the monitoring interval. The number of fork system calls per second that are run over the monitoring interval. 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 Writech Rawin The amount of bytes read per second through the read system call over the monitoring interval. The amount of bytes written per second through the write system call over the monitoring interval. The amount of raw bytes read per second from TTYs over the monitoring interval.

3 Page 3 of 33 Ttyout Igets Namei Dirblk The amount of bytes written to TTYs per second over the monitoring interval. The number of calls per second to the inode lookup routines over the monitoring interval. The number of calls per second to the path name lookup routines over the monitoring interval. 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 Steals PgspIn PgspOut PageIn PageOut Sios The total number of page faults taken per second over the monitoring interval. This includes page faults that do not cause paging activity. The physical memory 4 K frames stolen per second by the virtual memory manager over the monitoring interval. The number of 4 K pages read from paging space per second over the monitoring interval. The number of 4 K pages written to paging space per second over the monitoring interval. 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. 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. The number of I/O requests per second issued by the virtual memory manager over the monitoring interval.

4 Page 4 of 33 MEMORY Displays the real memory size and the distribution of memory in use. The following data is reported: Real,MB % Comp The size of real memory in megabytes. The percentage of real memory currently allocated to computational page frames. Computational page frames are generally those that are backed by paging space. % Noncomp % Client The percentage of real memory currently allocated to noncomputational frames. Non-computational page frames are generally those that are backed by file space, either data files, executable files, or shared library files. 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 Active WPAR AME 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. Displays the total number of resource active workload partitions. 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]

5 Page 5 of 33 Expansion Factors: Target & Actual. CI Compressed Pool Page-Ins. CO Compressed Pool Page-Outs. 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: Processor utilization Network interfaces Physical disks File system Workload Manager classes workload partitions Processes 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. Tip: When there is no WPAR specific information for a metric, the system-wide value is displayed for that metric in inverted background (that is, white text and black context). The following table provides the details for the subsections that the topas command displays: 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% Kern% Wait% Idle% Physc The percentage of processor used by programs running in user mode. (Default sorted by User%) The percentage of processor used by programs running in kernel mode. The percentage of time spent in waiting for I/O. The percentage of time that the processors are idle. The number of physical processors that are consumed. Displayed only if the partition is running with shared processor.

6 Page 6 of 33 %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 KBPS I-Pack O-Pack KB-In KB-Out The name of the network interface. The total throughput in kilobytes per second over the monitoring interval. This field is the sum of kilobytes received and kilobytes sent per second. The amount of data packets received per second over the monitoring interval. The amount of data packets sent per second over the monitoring interval. The number of kilobytes received per second over the monitoring interval. 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.

7 Page 7 of 33 Busy% KBPS TPS KB-Read KB-Writ The percentage of time the physical disk is active (bandwidth use of the drive). 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. 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. The number of kilobytes read per second from the physical disk. 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 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: File System KBPS TPS KB-Read KB-Writ The name of the file system. 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. 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. The number of kilobytes read per second from the file system.

8 Page 8 of 33 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. WLM classes 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 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: % processor Utilization The average processor use of the WLM class over the monitoring interval. % Mem Utilization The average memory use of the WLM class over the monitoring interval. % Blk I/O The average percent of block I/O of the WLM class over the monitoring interval. 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. Workload partitions 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 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 key. The following fields are displayed for each WPAR: WPAR The name of the workload partition (WPAR). % processor Utilization

9 Page 9 of 33 The average processor use of the WPAR over the monitoring interval. % Mem Utilization The average memory use of the WPAR over the monitoring interval. % Blk I/O The average percent of block I/O of the WPAR over the monitoring interval. 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. Processes 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 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: Name The name of the executable program executing in the process. The name is stripped of any pathname and argument information and truncated to 9 characters in length. Process ID The process ID of the process. % CPU Utilization The average processor use of the process over the monitoring interval. The first time a process is shown, this value is the average processor use over the lifetime of the process. Paging Space Used The size of the paging space allocated to this process. This can be considered an expression of the footprint of the process but does not include the memory used to keep the executable program and any shared libraries it may depend on. Process Owner (if the WLM section is off) The user name of the user who owns the process. Workload Manager (WLM) Class (if the WLM section is on) The WLM class to which the process belongs. WPAR (if the WPAR section is on)

10 Page 10 of 33 Adapter Panel View The WPAR name that the process belongs to. 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 When you use the topas -D command, you can press the d key to display the Adapter Panel view. In this panel, the following metrics are displayed: Adapter KBPS TPS KB-R KB-W The name of the adapter. The amount of data transferred (read or written) in the adapter in kilobytes per second. Indicates the average number of transfers per second that the adapter issues. The total number of kilobytes that are read from the adapter. The total number of kilobytes that are written to the adapter. If you press the f key, the following details of the disks that belong to the adapter are displayed on the Adapter Panel: 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 number of queues that are waiting per request reported in milliseconds. The suffix indicates the unit of time. The default time unit is 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 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 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 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

11 Page 11 of 33 Virtual Adapter Panel View When you run the topas -D command, you can press the v key to display the Virtual Adapter Panel view. In this panel, the following metrics are displayed: vadapter TPS KBPS KB-R KB-W AQD AQW ART AWT MRT MWT The name of the virtual adapter. The number of transfers per second that are issued to the adapter. The amount of data transferred (read or written) in kilobytes per second in the adapter. The number of blocks received per second from the hosting server to the adapter. The number of blocks sent per second from this adapter to the hosting server. The average number of requests waiting to be sent to the adapter. The average time spent by a transfer request in the waiting queue. The suffix indicates the unit of time. The default time unit is 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 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 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 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 If you press the f key, the following details of the disks that belong to the adapter are displayed on the Virtual Adapter Panel: Vtargets/Disk Busy% KBPS TPS KB-R KB-W AQD AQW ART AWT The name of the virtual target device or disk. The percentage of time the virtual target device or disk is active (bandwidth use of the virtual target device or disk). 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. 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. The number of kilobytes that are read per second from the virtual target device or disk. The number of kilobytes that are written per second to the virtual target device or disk. The average number of requests that are waiting to be sent to the virtual target device or disk. The average number of queues that are waiting per request reported in milliseconds. The suffix indicates the unit of time. The default time unit is 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 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

12 Page 12 of 33 MRT MWT 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 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 MPIO Panel View 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. The bottom section of the panel contains the following fields: Path Busy% KBPS TPS KB-R KB-W The name of the path. The percentage of time the path is active (bandwidth use of the path). 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. The number of transfers per second that are issued in that path. The number of kilobytes that is read per second in that path. The number of kilobytes that is written per second in that path. I/O Memory Entitlement Pools Panel 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. The following metrics are displayed in the lower section of this panel: iompn iomin iodes ioinu iores iohwm ioafl The name of the I/O memory pool. The minimum I/O memory entitlement of the pool. The desired I/O memory entitlement of the pool. The current I/O memory entitlement of the pool. The reserved I/O memory entitlement of the pool. The maximum I/O memory entitlement in use for the pool (high water mark). The total number of times the allocation requests have failed for this pool. Cross-Partition View and Recording 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. Besides the display option, the topas -R option runs the topas command in the background (with no display) and record the Cross-Partition data. Recordings are made to the /etc/perf/ directory, and are of the form topas_cec. YYMMDD. Recordings cover single-day periods (24 hours) and are retained for eight days before they are automatically deleted. This allows a

13 Page 13 of 33 week's worth of data to be retained on the system at all times. The topasout command is used to convert these recordings into various text-based reports. If you use the topas -R function on an LPAR-capable system, you must identify a partition for collecting and recording this data. The topas -R command also records the VIO Server/Client throughput details as well. To run the topas -R command from the /etc/inittab file, see the SMIT panels for topas/topasout. 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 crosspartition panel subcommands section: Partition totals: Shr Ded The number of shared partitions based on the system processor. The number of dedicated partitions based on the system processor. Memory (in GB) Mon Avl InUse The total memory of monitored partitions The memory available to partition set The memory in use on monitored partitions Processor: Shr Ded PSz APP Don Shr_PhysB Ded_PhysB The number of shared processors The number of dedicated processors The active physical processors in the physical shared processor pool being used by this LPAR The available physical processors in the shared pool. This is equal to the idle cycles pool reported as a number of processors The total number of processors donated to the pool The total number of physical processors that are busy for all shared partitions The total number of physical processors that are busy for all dedicated partitions Individual partition data: Host The host name OS The operating system level M The mode of the individual partitions. The mode is displayed in a set of 3 characters. The first character indicates the CPU in the partition. Character Description For shared partitions: C SMT enabled and capped c SMT disabled and capped U SMT enabled and uncapped u SMT disabled and uncapped For dedicated partitions: S SMT enabled and not donating d SMT disabled and donating D SMT enabled and donating - SMT disabled and not donating The second character indicates the memory mode of the partition. Character Description M In shared memory mode (For shared partitions)

14 Page 14 of 33 Mem InU Lp Us Sy Wa Id PhysB Ent %Entc Vcsw PhI Pmem %idon %bdon %istl %bstl - Not in shared memory mode The third character indicates the energy state of the partition. Character Description S Static power save mode is enabled d Power save mode is disabled D Dynamic power save mode is enabled - Unknown / Undefined The total memory measured in gigabytes. The memory in use measured in gigabytes. The number of logical processors. The percentage of processor used by programs executing in user mode. The percentage of processor used by programs executing in kernel mod.e The percentage of time spent waiting for I/O. The percentage of time the processors are idle. The number of physical processors that are busy. The entitlement granted (shared-only). The percent entitlement consumed (shared-only). The average of virtual context switches per second (shared-only). The average of phantom interrupts per second (shared-only). The physical memory that is backing the partitions logical memory (if in shared-memory mode). The percentage of physical processor that is used while explicitly donating idle cycles. This metric is applicable only for donating dedicated partitions. The percentage of physical processor that is used while busy cycles are being donated. This metric is applicable only for donating dedicated partitions. 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. 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. The %idon and %bdon metrics are not displayed when there is no donating dedicated partition. Requirement: At least one partition to be monitored must have Pool Utilization Authority (PUA) configured for pool information metrics to be collected. For cross-partition monitoring/recording, some global data is not available from any partition. The -o option allows you to specify these fields in the command line. Optionally, you can configure a system to allow the topas command to query the HMC directly for this information. This requires the following steps: 1. Install OpenSSH at the partition Enable remote command support on the HMC for user hscroot to allow ssh connections to be opened from the partition. Configure ssh on the HMC to not require a password for the HMC user hscroot when queried from the selected partition. This requires the.ssh/authorized_keys2 on the HMC for user login hscroot. Run ssh -l hscroot hmc_address date from the partition to confirm whether the date is displayed without requiring that a password be entered.

15 Page 15 of Utilize the topas -o options described in the usage table to specify the managed system and HMC names when running the topas command. Restriction: This functionality is currently available only for HMC version 5 and above, and should only be enabled after careful consideration of any security implications. The following displays when press the g key in the initial screen, which brings the cross partition view with detailed headers: Topas CEC Monitor Interval: 10 Mon Jan 22 00:08:00 2 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. Shared : 0 Available : - Available : - Ded Physical Busy: 0. Uncapped : 0 UnAllocated: - UnAllocated: - Donated Phys. processo Capped : 2 Consumed : 1.9 Shared : 0 Stolen Phys. processor Dedicated : 2 Dedicated : 2 Hypervisor Donating : 0 Donated : 0 Virt. Context Switch: Pool Size : 0 Phantom Interrupts : Host OS M Mem InU Lp Us Sy Wa Id PhysB Vcsw Ent %EntC PhI shared ptoolsl1 A53 U k Host OS M Mem InU Lp Us Sy Wa Id PhysB Vcsw %istl %bstl %bdon %ido dedicated ptools1 A54 S ptoolsl3 A54 S The following headers are in the previous screen: Partition Info: Monitored Unmonitored Shared Uncapped Capped Dedicated Donating The number of partitions that are monitored The number of partitions that are not monitored The number of shared partitions The number of uncapped shared partitions The number of capped partitions The number of dedicated partitions The number of partitions that are currently donating Memory: Monitored UnMonitored Available UnAllocated Consumed The total memory that is monitored The total memory that is not monitored The total memory that is available The total memory that is not allocated to any partition The total memory that is consumed by the partitions Processor: Monitored UnMonitored Available UnAllocated Shared Dedicated Donated Pool Size The number of physical processors that are monitored The number of physical processors that are not monitored The number of physical processors that are available in CEC system The number of physical processors that are not allocated to any partition The number of processors that are in shared partitions The number of processors that are in dedicated partitions The sum of the number of processors in all the partitions donating The number of active shared processors in all of the pools

16 Page 16 of 33 Avail Proc Pool Shr Physical Busy Ded Physical Busy Donated Phys. processors Stolen Phys. processors Virtual Pools Virt. Context Switch Phantom Interrupts The physical processors in the pool that is available The sum of physical busy of all of the shared partitions The sum of dedicated busy of all of the dedicated partitions The sum of the donated processor cycles from all of the partitions reported as a number of processors The sum of stolen processor cycles from all of the partitions reported as a number of processors The number of virtual pools The total number of virtual context switches per second in the monitoring interval The total number of phantom interrupts per second in the monitoring interval When the topas command is running inside any cross partition view, press the p key to bring up the pool panel. The following is an example that displays: pool psize entc maxc physb app mem muse You can scroll up or down in the pool ID column and press the f key to list only the shared partitions that belong to the poolid where cursor is positioned. The following headers might be displayed in the screen: psize entc maxc physb app mem muse The effective maximum capacity of the pool The entitled capacity of the pool The maximum capacity of the pool The sum of physical busy of processors in shared partitions of a pool The available physical processor in the pool The sum of monitored memory for all shared partitions in the pool The sum of memory consumed for all shared partitions in the pool When the topas command is running inside any cross-partition view, press the v key to display the Virtual I/O Server/Client Throughput Panel. The following metrics are displayed: Server Client KBPS TPS KB-R KB-W AQD AQW ART AWT MRT The name of the VIO Server. The name of the VIO Client. 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. The number of transfers that are issued per second. The number of kilobytes that are read per second. The number of kilobytes that are written per second. The average number of requests that are waiting to be sent. The average number of queues that are waiting per request reported in milliseconds. The suffix indicates the unit of time. The default time unit is 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 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 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

17 Page 17 of 33 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 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. The following metrics are displayed in a Virtual I/O Server/Client Disk Details Panel: Adapter Vtargets Client_disk The name of the server adapter. The name of the virtual target device that belongs to the server adapter. The name of the client disk that is mapped to the virtual target device of the server adapter. The following details of the adapters are displayed on the top section of the panel: KBPS TPS KB-R KB-W AQD AQW ART AWT MRT MWT The amount of data transferred (read or written) in the adapter in kilobytes per second. The number of transfers per second that are issued to the adapter. The total number of kilobytes read from the adapter. The total number of kilobytes written to the adapter. The number of requests waiting to be sent to the adapter. The time spent by a transfer request in the waiting queue. The suffix indicates the unit of time. The default time unit is 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 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 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 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 The following details for the virtual target device and client disk are displayed on the panel: Busy% KBPS TPS KB-R KB-W AQD The percentage of time the that the virtual target device or disk is active (bandwidth use of the virtual target device or disk). 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. 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. The number of kilobytes read per second from the virtual target device or disk. The number of kilobytes written per second to the virtual target device or disk. The average number of requests waiting to be sent to virtual target device or disk.

18 Page 18 of 33 AQW ART AWT MRT MWT The average number of queues that are waiting per request reported in milliseconds. The suffix indicates the unit of time. The default time unit is 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 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 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 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 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. The following values are displayed in the header section of the panel: Mshr Mded Pools Mpsz MPuse Entl Use Mon InUse Avl The number of logical partitions (LPARs) running in the shared-memory mode. The number of LPARs running in dedicated-memory mode. The total number of memory pools in the system. The total size of physical memory of all the memory pools in gigabytes. The total memory used by LPARs associated with all of the pools in gigabytes. The total I/O memory entitlement of all of the LPARs in all the pools in gigabytes. The total I/O memory entitlement in use of all of the LPARs in all the pools in gigabytes. The total monitored memory of the system ( sum of the values of the Mpsz metric and the Total memory of dedicated memory partitions metric). The total memory in use of the system (sum of the MPuse metric and Total memory inuse for dedicated memory partitions metric). The total memory available for the system (the value of the Mon metric minus the value of the InUse metric). The following values of the pools are displayed: mpid mpsz mpus mem memu iome iomu hpi The ID of the memory pool. The size of the total physical memory of the memory pool in gigabytes. 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). The size of the aggregate logical memory of all the partitions in the pool in gigabytes. The aggregate logical memory that is used for all the partitions in the pool in gigabytes. The aggregate of I/O memory entitlement that is configured for all the LPARs in the pool in gigabytes. The aggregate of the I/O memory entitlement that is used for all the LPARs in the pool in gigabytes. The aggregate number of hypervisor page faults that have occurred for all of the LPARs in the pool.

19 Page 19 of 33 hpit The aggregate of time spent in waiting for hypervisor page-ins by all of the LPARs in the pool in milliseconds. The following values of the partitions in the pools are displayed: mem memu meml pmem iom iomu hpi hpit vcsw physb %entc The size of logical memory of the partition in gigabytes. The logical memory that is used for the partition in gigabytes. The logical memory loaned to hypervisor by the LPAR. The physical memory that is allocated to the partition from the memory pool in gigabytes. The amount of I/O memory entitlement that is configured for the LPAR in gigabytes. The amount of I/O memory entitlement that is used for the LPAR in gigabytes. The number of hypervisor page faults. The time spent in waiting for hypervisor page-ins in milliseconds. The virtual context switches average per second. The physical processor that is busy. The percentage of the consumed processor entitlement. Implementation Specifics 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. Flags wparname Shows the WPAR-specific metrics. If you specify a WPAR name with the wparname parameter, the topas monitors that WPAR. -c hotprocessor 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 -o field = value,... 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: -o availmem = [total amount of memory allocated to all partitions, in GB] -o unavailmem = [total amount of memory unallocated from the HMC, in GB] -o availprocessor = [total number of physical processors allocated for all partitions] -o unavailprocessor = [total number of physical processors unallocated from the HMC] -o poolsize = [defined pool size required if HMC Processor Utilization Authority restricts access]

20 Page 20 of 33 -o partitions = [number of partitions defined on the HMC] -o reconfig = [number of seconds between checking for HMC configuration changes. Allowed values are 30, 60, 90, 120, 180, 240, 300 seconds. The default is 60 seconds] -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: Disk Busy% KBPS TPS KB-R ART MRT KB-W AWT MWT AQW The name of the physical disk. The percentage of time that the physical disk is active (bandwidth use for the disk). The number of kilobytes that are 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. The number of transfers per second that are 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 medium size. The number of kilobytes read per second from the physical disk. 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 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 The number of kilobytes written per second to the physical disk. 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 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

21 Page 21 of 33 The average number of queues that are waiting per request reported in milliseconds. AQD The average number of requests that are waiting to be sent to disk. With the -D flag specified, you can run the following subcommands: To view the Adapter Panel, press the d key. To display all of the virtual adapters present in the partition (Virtual Adapter Panel), press the v key. To display the disks that belong to the adapter or the virtual adapter, press the f key. To display the MPIO Panel, press the m key. This panel displays the disks details and the path details. To list the paths of the disks, press the f key. -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: KBPS I-Pack O-Pack KB-In KB-Out The total throughput in kilobytes per second over the monitoring interval. This field is the sum of the kilobytes received and kilobytes sent per second. The number of data packets received per second over the monitoring interval. The number of data packets sent per second over the monitoring interval. The number of kilobytes received per second over the monitoring interval. The number of kilobytes sent per second over the monitoring interval. -F Displays the file system display. When you specify the flag with the -@ flag or 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:

22 Page 22 of 33 File System KBPS TPS The name of file system. The amount of data transferred (read and written) per second over the monitoring interval. This field is the sum of the values of KB-Read and KB-Writ. 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 amount of kilobytes read per second from the file system. KB-Writ The amount of kilobytes written per second from the file system. Open The logical number of files open. Create The logical number of files creates. Lock The number of files lock file system. -f HotFS 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 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: usage: topas [-d number-of-monitored-hot-disks] [-h] [-i monitoring-interval_in_seconds] [-n number-of-monitored-hot-network-interfaces] [-p number-of-monitored-hot-processes] [-w number-of-monitored-hot-wlm classes] [-c number-of-monitored-hot-processors] [-U username_owned_processes] [-D -P -W -L] [-m]