IBM Tivoli Monitoring: AIX Premium Agent Version User's Guide SA

Transcription

1 Tioli IBM Tioli Monitoring: AIX Premium Agent Version User's Guide SA

2

3 Tioli IBM Tioli Monitoring: AIX Premium Agent Version User's Guide SA

4 Note Before using this information and the product it supports, read the information in Appendix E, Notices, on page 335. This edition applies to ersion of IBM Tioli Monitoring: AIX Premium Agent (product number 5724-C04) and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright IBM Corporation 2007, US Goernment Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

5 Contents Tables ii Chapter 1. Oeriew of the AIX Premium Agent IBM Tioli Monitoring oeriew Features of the monitoring agent Functions of the monitoring agent New in this release Components of the IBM Tioli Monitoring enironment User interface options Chapter 2. Requirements and agent-specific installation and configuration information for the monitoring agent Requirements for the monitoring agent Installing language packs Windows systems UNIX or Linux systems Agent-specific installation and configuration Installation Configuration Additional information Chapter 3. Workspaces reference About workspaces More information about workspaces Predefined workspaces Agent Naigator items AIX Premium Naigator item Memory Naigator item Networking Naigator item Process Naigator item Status Naigator item Storage Naigator item System Naigator item Top Resources Naigator item User Naigator item WPAR Naigator item Chapter 4. Attributes reference About attributes More information about attributes Attribute groups and attributes for the AIX Premium Agent Actie Memory Expansion attribute group Actie Users attribute group AMS Pool attribute group CPU Detail attribute group CPU Summary attribute group Defined Users attribute group Deices attribute group Disks attribute group File Systems attribute group Internet Protocol Detail attribute group Internet Protocol Summary attribute group Logical Partition attribute group Logical Volumes attribute group MPIO Attributes attribute group MPIO Status attribute group Network Adapters Rates attribute group Network Adapters Totals attribute group Network Interfaces attribute group NIM Resources attribute group Paging Space attribute group Performance Object Status attribute group Physical Memory attribute group Physical Volumes attribute group Print Queues attribute group Processes Detail attribute group Processes Summary attribute group Quality Of Serice attribute group System Call attribute group System IO attribute group TADDM attribute group TCP attribute group Top 50 CPU Processes attribute group Top 50 Memory Processes attribute group Virtual Memory Management attribute group Volume Groups attribute group Workload Manager attribute group WPAR CPU attribute group WPAR FileSystem attribute group WPAR Information attribute group WPAR Network attribute group WPAR Physical Memory attribute group Disk capacity planning for historical data Chapter 5. Situations reference About situations More information about situations Predefined situations AIX Premium Naigator item Memory Naigator item KPX_memrepage_Info situation KPX_mm_pginwait_Info situation KPX_mm_pgfault_Info situation KPX_mm_pgreclm_Info situation KPX_mm_unpin_low_Warn situation KPX_mm_pgout_pend_Info situation KPX_AME_CPU_Used_High_Warn situation 224 KPX_AME_Deficit_Mem_Warn situation Networking Naigator item KPX_Pkts_Sent_Errors_Info situation KPX_Sent_Pkts_Dropped_Info situation KPX_Pkts_Rec_Errors_Info situation KPX_Bad_Pkts_Recd_Info situation KPX_Rec_pkts_dropped_Info situation Copyright IBM Corp. 2007, 2010 iii

6 KPX_Qoerflow_Info situation KPX_Netwk_Bandwidth_High_Info situation 229 KPX_Media_Spd_Half_Duplex_Warn situation 229 KPX_perip_InputErrs_Info situation KPX_perip_InputPkts_Drop_Info situation KPX_perip_OutputErrs_Info situation KPX_TCP_ConnInit_Info situation KPX_TCP_ConnEst_Info situation Process Naigator item KPX_totproc_cs_Info situation KPX_totproc_runq_ag_Info situation KPX_totproc_load_ag_Info situation KPX_totnum_procs_Info situation KPX_perproc_IO_pgf_Info situation KPX_perproc_nonIO_pgf_Info situation KPX_perproc_memres_datasz_Info situation KPX_perproc_memres_textsz_Info situation KPX_perproc_mem_textsz_Info situation KPX_perproc_ol_cs_Info situation Status Naigator item KPX_Deice_Stopped_Warn situation Storage Naigator item KPX_Actie_Disk_Pct_Info situation KPX_Ag_Read_Transfer_MS_Info situation KPX_Read_Timeouts_Per_Sec_Info situation KPX_Failed_Read_Per_Sec_Info situation KPX_Ag_Write_Transfer_MS_Info situation KPX_Write_Timeout_Per_Sec_Info situation KPX_Failed_Writes_Per_Sec_Info situation KPX_Ag_Req_In_WaitQ_MS_Info situation KPX_SericeQ_Full_Per_Sec_Info situation System Naigator item KPX_PHYP_Pct_High_Info situation KPX_Reduced_Proc_Freq_Info situation KPX_perCPU_syscalls_Info situation KPX_perCPU_forks_Info situation KPX_perCPU_execs_Info situation KPX_perCPU_cs_Info situation KPX_Tot_syscalls_Info situation KPX_Tot_forks_Info situation KPX_Tot_execs_Info situation KPX_LPARBusy_pct_Warn situation KPX_LPARPhyBusy_pct_Warn situation KPX_LPARcs_Info situation KPX_LPARfreepool_Warn situation KPX_LPARPhanIntrs_Info situation KPX_LPARentused_Info situation KPX_LPARphyp_used_Info situation KPX_LPAR_MaxCPUCapUsed_Info situation 254 KPX_LPAR_Moed_Info situation Top Resources Naigator item User Naigator item KPX_user_acct_locked_Info situation KPX_user_login_retries_Info situation KPX_user_idletime_Info situation WPAR Naigator item KPX_WPAR_CPU_Usage_Warn situation KPX_WPAR_Mem_Usage_Warn situation KPX_WPAR_Broken_Warn situation KPX_WPAR_RC_Inactie_Info situation KPX_WPAR_Unlim_CPU_Shares_Info situation 260 KPX_WPAR_Min_CPU_Limit_Info situation KPX_WPAR_Unlim_Mem_Shares_Info situation 261 KPX_WPAR_Min_Mem_Limit_Info situation KPX_WPAR_Admin_Op_Info situation Chapter 6. Take Action commands reference About Take Action commands More information about Take Action commands 265 Predefined Take Action commands Chapter 7. Policies reference About policies More information about policies Predefined policies Chapter 8. Tioli Common Reporting for the pseries monitoring agents Report package Prerequisites Importing and running IBM Tioli Monitoring for System p Cognos reports Cognos report descriptions Chapter 9. Troubleshooting Gathering product information for IBM Software Support Built-in troubleshooting features Problem classification Trace logging Oeriew of log file management Principal trace log files Setting RAS trace parameters Problems and workarounds Installation and configuration troubleshooting 291 Remote deployment troubleshooting Agent troubleshooting Workspace troubleshooting Situation troubleshooting Take Action commands troubleshooting Discoery Library Adapter for the agent troubleshooting Support information Appendix A. IBM Tioli Enterprise Console eent mapping Appendix B. Discoery Library Adapter for the AIX Premium monitoring agent About the DLA More information about DLAs Prerequisites DLA data model class types represented in CDM 325 LPAR class AIX class TMSAgent class i IBM Tioli Monitoring: AIX Premium Agent: User's Guide

7 Appendix C. Documentation library 329 AIX Premium Agent library Prerequisite publications Related publications Other sources of documentation Appendix D. Accessibility Naigating the interface using the keyboard Magnifying what is displayed on the screen Appendix E. Notices Trademarks Index Contents

8 i IBM Tioli Monitoring: AIX Premium Agent: User's Guide

9 Tables 1. Capacity planning for historical data logged by IBM Tioli Monitoring: AIX Premium Agent Information to gather before contacting IBM Software Support Trace log files for troubleshooting agents Problems and solutions for installation and configuration General problems and solutions for uninstallation Remote deployment problems and solutions Agent problems and solutions Workspace problems and solutions General situation problems and solutions Problems with configuring situations that you sole in the Situation Editor Problems with configuration of situations that you sole in the Workspace area Take Action commands problems and solutions Discoery Library Adapter for AIX Premium Agent problems and solutions Copyright IBM Corp. 2007, 2010 ii

10 iii IBM Tioli Monitoring: AIX Premium Agent: User's Guide

11 Chapter 1. Oeriew of the AIX Premium Agent The AIX Premium Agent proides you with the capability to monitor AIX. This chapter proides a description of the features, components, and interface options for the AIX Premium Agent. IBM Tioli Monitoring oeriew IBM Tioli Monitoring is the base software for the AIX Premium Agent. IBM Tioli Monitoring proides a way to monitor the aailability and performance of all the systems in your enterprise from one or seeral designated workstations. It also proides useful historical data that you can use to track trends and to troubleshoot system problems. You can use IBM Tioli Monitoring to perform the following tasks: Monitor for alerts on the systems that you are managing by using predefined situations or custom situations. Establish your own performance thresholds. Trace the causes leading to an alert. Gather comprehensie data about system conditions. Use policies to perform actions, schedule work, and automate manual tasks. The Tioli Enterprise Portal is the interface for IBM Tioli Monitoring products. By proiding a consolidated iew of your enironment, the Tioli Enterprise Portal permits you to monitor and resole performance issues throughout the enterprise. See the IBM Tioli Monitoring publications listed in Prerequisite publications on page 329 for complete information about IBM Tioli Monitoring and the Tioli Enterprise Portal. Features of the monitoring agent The AIX Premium Agent software can identify and notify you of common problems with the application that it monitors. The software includes the following features: Monitoring Data gathering Eent management Functions of the monitoring agent The AIX Premium Agent proides the following functions: AIX Aailability, Health, and Performance Resource Monitoring Monitors the aailability, health, and performance of key AIX system resources: LPAR configurations, CPU, memory, storage, network, printers, NIM, and Workload Partitions (WPARS). Copyright IBM Corp. 2007,

12 New in this release For ersion of the AIX Premium Agent, the following updates hae been made since ersion 6.2.2: New attributes in the CPU Summary attribute group that monitor processor frequency and a new Reduced_Proc_Freq_Info situation that alerts you when a processor is running at reduced frequencies. New attributes added to the Logical Partition attribute group that monitor the 4-Thread SMT on IBM POWER7 hardware. New Cognos -based Tioli Common Reporting reports that proide easy-to-use drag, drop, and piot capabilities to significantly reduce the time for building custom reports for historical data. Components of the IBM Tioli Monitoring enironment User interface options After you install and set up the AIX Premium Agent, you hae an enironment that contains the client, serer, and monitoring agent implementation for IBM Tioli Monitoring that contains the following components: Tioli Enterprise Portal client with a Jaa -based user interface for iewing and monitoring your enterprise. Tioli Enterprise Portal Serer that is placed between the client and the Tioli Enterprise Monitoring Serer and enables retrieal, manipulation, and analysis of data from the monitoring agents. The Tioli Enterprise Portal Serer is the central repository for all user data. Tioli Enterprise Monitoring Serer that acts as a collection and control point for alerts receied from the monitoring agents, and collects their performance and aailability data. The Tioli Enterprise Monitoring Serer is also a repository for historical data. Tioli Enterprise Monitoring Agent: AIX Premium Agent. This monitoring agent collects and distributes data to a Tioli Enterprise Portal Serer. IBM Tioli Enterprise Console is an optional component that acts as a central collection point for eents from arious sources. These sources include other Tioli software applications, Tioli partner applications, custom applications, network management platforms, and relational database systems. You can iew these eents through the Tioli Enterprise Portal (using the eent iewer), and you can forward eents from IBM Tioli Monitoring situations to the IBM Tioli Enterprise Console component. IBM Tioli Netcool/OMNIbus is an optional component and an alternatie to the IBM Tioli Enterprise Console. The Netcool/OMNIbus software is a serice leel management (SLM) system that deliers real-time, centralized monitoring of complex networks and IT domains. The Tioli Netcool/OMNIbus components work together to collect and manage network eent information. Tioli Common Reporting is a separately installable feature aailable to users of Tioli software. This feature proides a consistent approach to generating and customizing reports. Some indiidual products proide reports that are designed for use with Tioli Common Reporting, and hae a consistent look and feel. Installation of the base software and other integrated applications proides the following interfaces that you can use to work with your resources and data: Tioli Enterprise Portal browser client interface The browser client interface is automatically installed with the Tioli 2 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

13 Enterprise Portal Serer. To start the Tioli Enterprise Portal browser client in your Internet browser, enter the URL for a specific Tioli Enterprise Portal browser client installed on your Web serer. Tioli Enterprise Portal desktop client interface The desktop client interface is a Jaa-based graphical user interface (GUI) on a Windows or Linux workstation. Manage Tioli Enterprise Monitoring Serices window The window for the Manage Tioli Enterprise Monitoring Serices utility is used for configuring the agent and starting Tioli serices not already designated to start automatically. IBM Tioli Enterprise Console An eent management application that integrates system, network, database, and application management to help ensure the optimal aailability of IT serices for an organization. Tioli Netcool/OMNIbus eent list You can use the eent list to monitor and manage alerts. An alert is created when the ObjectSerer receies an eent, alarm, message, or data item. Each alert is made up of columns (or fields) of information that are held in a row in the ObjectSerer alerts.status table. In addition, the Tioli Netcool/OMNIbus Web GUI is a Web-based application that processes network eents from one or more data sources and presents the eent data in arious graphical formats. Tioli Common Reporting A Web user interface for specifying report parameters and other report properties, generating formatted reports, scheduling reports, and iewing reports. The user interface is based on the Tioli Integrated Portal. Chapter 1. Oeriew of the AIX Premium Agent 3

14 4 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

15 Chapter 2. Requirements and agent-specific installation and configuration information for the monitoring agent This chapter contains information about the requirements for the AIX Premium Agent, and agent-specific information related to installation and configuration of the agent. To install and configure the AIX Premium Agent, use the procedures for installing monitoring agents in the IBM Tioli Monitoring Installation and Setup Guide along with the information in this chapter. If you are performing a silent installation using a response file, see the information about performing a silent installation in the IBM Tioli Monitoring Installation and Setup Guide. Requirements for the monitoring agent In addition to the requirements described in the IBM Tioli Monitoring Installation and Setup Guide, the AIX Premium Agent has the following requirements: The monitoring agent runs on any of these operating systems: AIX 5.3 Technology Leel 5 (32/64 bit) and aboe AIX 6.1 (64 bit) AIX 7.1 The agent is not supported inside a WPAR (workload partition) enironment. Note: For the most current information about the operating systems that are supported, see support/tioli_supported_platforms.html. This agent monitors the following ersions: AIX 5.3 Technology Leel 5 with Serice Pack 4 and aboe with the perfagent.tools and aboe fileset The AIX Premium agent must be installed on the AIX system to be monitored. A single computer that hosts the hub monitoring serer, portal serer, and a monitoring agent requires approximately 300 MB of space. A computer that hosts only the monitoring agent requires approximately 30 MB of space, including the specific enablement code for the monitoring agent. More space is required for each additional monitoring agent that you deploy on the monitoring computer. The monitoring agent must be connected to the following software: IBM Tioli Monitoring V6.2.2 or later After you install the prerequisite software, install the following software, which is required for the AIX Premium Agent to operate: AIX Premium Agent AIX Premium Agent for Tioli Enterprise Monitoring Serer support AIX Premium Agent for Tioli Enterprise Portal Serer support AIX Premium Agent for Tioli Enterprise Portal Desktop Client support AIX Premium Agent for Tioli Enterprise Portal Browser Client support Copyright IBM Corp. 2007,

16 Installing language packs To install a language pack for the agent support files on the Tioli Enterprise Monitoring Serer, the Tioli Enterprise Monitoring Agent, and the Tioli Enterprise Portal Serer, first make sure that you hae already installed the product in English, and then perform the following steps depending on which operating system you are using. Windows systems 1. Double-click lpinstaller.bat in the language pack CD to launch the installation program. 2. Select the language of the installer and click OK. 3. Click Next on the Introduction panel. 4. Click Add/Update and click Next. 5. Select the folder in which the National Language Support package (NLSPackage) files are located. Note: Usually the NLSPackage files are located in the nlspackage folder where the executable installer program is located. 6. Select the language support for the agent of your choice and click Next. Note: Hold down the Ctrl key for multiple selections. 7. Select the languages that you want to install and click Next. 8. Examine the installation summary page and click Next to begin installation. 9. Click Finish after installation completes to exit the installer. 10. Restart the Tioli Enterprise Portal Desktop Client, Tioli Enterprise Portal Serer, and Eclipse Help Serer if any of these components are installed. UNIX or Linux systems 1. Run the following command to create a temporary directory on the computer. Make sure that the full path of the directory does not contain any spaces: mkdir dir_name 2. Mount the language pack CD to the temporary directory you just created. 3. Run the following command to launch the installation program: cd dir_name lpinstaller.sh -c install_dir Where install_dir is where you installed IBM Tioli Monitoring. Usually it is /opt/ibm/itm for AIX and Linux systems. 4. Select the language of the installer and click OK. 5. Click Next on the Introduction panel. 6. Click Add/Update and click Next. 7. Select the folder in which the National Language Support package (NLSPackage) files are located. Note: Usually, the NLSPackage files are located in the nlspackage folder where the executable installer file is located. 8. Select the language support for the agent of your choice and click Next. Note: Hold down the Ctrl key for multiple selections. 6 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

17 9. Select the languages that you want to install and click Next. 10. Examine the installation summary page and click Next to begin installation. 11. Click Finish after the installation completes to exit the installer. 12. Restart the Tioli Enterprise Portal Desktop Client, Tioli Enterprise Portal Serer, and Eclipse Help Serer if any of these components are installed. Agent-specific installation and configuration In addition to the installation and configuration information in the IBM Tioli Monitoring Installation and Setup Guide, use the information in this section to install and configure the AIX Premium Agent. Installation The AIX Premium agent is installed on an AIX operating system computer using the install_dir/install.sh script. Configuration The AIX Premium agent is configured on an AIX system using the standard IBM Tioli Monitoring agent installation procedure. Additional information The agent must be installed, configured, and started under the root user ID. If you install as nonroot, you are prompted for the root password during the installation. Prompting occurs so that the install script can add the agents to the system initialization scripts. If you do not enter the root password, the agents are not automatically started when the system is restarted. Also, if you install as nonroot, no WPAR data is aailable. The IBM Tioli Monitoring install.sh script identifies AIX 6.1 systems as AIX 5.3. Install the agent on AIX 6.1 by using the AIX 5.3 installer option. LPARs running the agent must hae the "Allow processor pool utilization authority" or "Allow performance information collection" option checked in the Hardware Management Console (HMC) to monitor the Aailable CPU Units in Pool attribute. Chapter 2. Requirements and agent-specific installation and configuration information for the monitoring agent 7

18 8 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

19 Chapter 3. Workspaces reference About workspaces This chapter contains an oeriew of workspaces, references for detailed information about workspaces, and descriptions of the predefined workspaces included in this monitoring agent. A workspace is the working area of the Tioli Enterprise Portal application window. Use the Naigator tree that is displayed at the left of the workspace, to select the workspace you want to see. As part of the application window, the right side of the status bar shows the Tioli Enterprise Portal Serer name and port number to which the displayed information applies, and the ID of the current user. When you select an item in the Naigator tree, a default workspace is displayed. When you right-click a Naigator item, a menu that includes a Workspace item is displayed. The Workspace item contains a list of workspaces for that Naigator item. Each workspace has at least one iew. Some iews hae links to other workspaces. The workspaces in the Naigator are shown in a Physical iew that shows your enterprise as a physical mapping or a dynamically populated logical iew that is agent-specific. You can also create a Logical iew. The Physical iew is the default iew. This monitoring agent proides predefined workspaces. You cannot modify or delete the predefined workspaces, but you can create new workspaces by editing them and saing the changes with a different name. A table iew within a workspace corresponds to a group of attributes; the columns in the table iew show some or all the attributes aailable in the attribute group. More information about workspaces Predefined workspaces For more information about creating, customizing, and working with workspaces, see the Tioli Enterprise Portal User's Guide. For a list of the predefined workspaces for this monitoring agent and a description of each workspace, see the Predefined workspaces section in this chapter and the information in that section for each indiidual workspace. Some attribute groups for this monitoring agent might not be represented in the predefined workspaces or iews for this agent. For a full list of the attribute groups, see the Attributes reference section. The AIX Premium Agent proides the following predefined workspaces, which are organized by Naigator item. AIX Premium Naigator item AIX Premium workspace Copyright IBM Corp. 2007,

20 Performance Object Status workspace Resources - Summary Graph workspace Memory Naigator item Actie Memory Expansion workspace Memory workspace Networking Naigator item Network Adapter Utilization workspace Network Protocol Views workspace Networking workspace Process Naigator item Process workspace Status Naigator item Status workspace Storage Naigator item File Systems workspace Logical Volume Details workspace MPIO Storage Information workspace Storage workspace System Storage Information workspace Volume Groups and Logical Volumes workspace System Naigator item CPU Utilization workspace LPAR Information workspace NIM Resources workspace Print Queues workspace System workspace Workload Manager workspace Top Resources Naigator item Top Resources workspace User Naigator item User workspace WPAR Naigator item WPAR workspace WPAR CPU workspace WPAR Details workspace WPAR Memory workspace WPAR Network and File System workspace WPAR Process Views workspace Agent Naigator items This section contains descriptions of predefined workspaces. The workspaces are organized by the Naigator item to which the workspaces are releant. 10 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

21 AIX Premium Naigator item AIX Premium workspace This workspace displays a quick list of key system resources: CPU, real memory, physical olume, and network interfaces. This workspace contains the following iews: Logical Partition Attributes Shows basic LPAR configuration settings. Logical Partition Units Shows CPU allocation and aailability information. Network Interface Resources Shows a table of network interfaces. Total Real Memory Shows total memory along with the amount free and used. Physical Volumes Shows a table of physical olumes, their size, and associated olume group. Number of CPUs Shows the number of CPUs and ersion of AIX. Performance Object Status workspace This workspace reflects the status of other attribute groups so you can see the status of all of the performance objects that make up this application all at once. Each of these other performance attribute groups is represented by a row in this table or other type of iew. The status for an attribute group reflects the result of the last attempt to collect data for that attribute group, which allows you to see whether the agent is performing correctly. Unlike other attribute groups, the Performance Object Status attribute group does not reflect the state of the monitored application. The Performance Object Status attribute group is most often used to determine why data does not seem to be aailable for one of the other performance attribute groups. This workspace contains the following iew: Performance Object Status Shows a table of the attribute groups associated with the AIX Premium Agent. Resources - Summary Graph workspace This workspace displays graphs of CPU, memory, physical olume resources, and a table of network interfaces. This workspace contains the following iews: CPU Aailability Shows a pie chart of oerall CPU utilization. Physical Volume Resources Shows stacked bar charts of free to used space on physical olumes. Real Memory Resources Shows a stacked bar chart of free and used memory. Network Interface Resources Shows a table of network interfaces. Chapter 3. Workspaces reference 11

22 Memory Naigator item Actie Memory Expansion workspace This workspace contains the following iews: Effectie Memory Layout Shows the layout and sizes of compressed and uncompressed memory, included the deficit if one is present. Expansion Factors Shows a moing graph of target memory expansion factor and current memory expansion factor. AME Summary Shows a table of summary attributes for AME. AME Details Shows attributes for AME at a detailed leel. Memory workspace This workspace displays information about the real memory and paging space utilization, and Virtual Memory Manager (VMM) paging rates. This workspace contains the following iews: Real Memory Utilization Shows a stacked bar chart of free and used memory. Computational Memory Shows a stacked bar chart of non-computational and computational memory. VMM Paging Rates Shows basic paging rates. Page Fault Rates Shows adanced paging rates. Paging Space Utilization Shows a stacked bar chart of free and used paging space. Networking Naigator item Network Adapter Utilization workspace This workspace displays utilization and errors per network adapter. This workspace contains the following iews: Adapter Throughput Shows summary per adapter throughput information. Bandwidth Utilization Shows the network bandwidth utilization of each network interface. Network Error Rate Shows summary per adapter error rate information. Utilization per Adapter Shows summary utilization totals per adapter. Network Protocol Views workspace This workspace displays iews of IP, TCP, and per IP interface utilization metrics. 12 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

23 This workspace contains the following iews: IP Packet Statistics Shows rates of IP traffic. IP Throughput per Adapter Shows the rate of IP packets transmitted and receied per interface. TCP Throughput Shows the rate of TCP packets transmitted and receied per interface. Networking workspace This workspace has iews that show Network Interfaces Status (name, IP addr, and so on) as well as Network Quality of Serice attributes. This workspace contains the following iews: Network Interfaces Status Shows a table of network interfaces. Network Quality of Serice Shows a ariety of metrics associated with network quality of serice. Common TCP/IP Problems with Network Interfaces Shows an explanation of how to diagnose and correct common TCP/IP problems with network interfaces. Process Naigator item Process workspace This workspace displays global and per process iews. This workspace contains the following iews: Queue Aerages Shows run queue and swap queue aerage sizes. Kernel Processes Shows rate of kernel processes being created and exiting. Utilization Shows total system number of processes, load aerage utilization aerage, and context switches per second. Per Process Information Shows a list of all processes on the system, their attributes, and their resource consumption. Status Naigator item Status workspace This workspace has iews that show the aailability of network and storage deices as well as a list of deices and their type, class, parent name, and status. This workspace contains the following iew: Deice Status Shows the status of deices associated with an LPAR, including their parent names, deice type and class. Chapter 3. Workspaces reference 13

24 Storage Naigator item File Systems workspace This workspace displays information about file system Sizes in table and graph forms. This workspace contains the following iews: File System Metrics Shows file systems, their mount points, associated olume groups, and usage statistics. File System Utilization Shows a stacked bar chart of free and used space for each file system. Logical Volume Details workspace This workspace displays detailed information about logical olumes including their size, type, mount point, and associated olume group. This workspace contains the following iews: Logical Volume Sizes Shows a bar chart of the sizes of each logical olume. Logical Volume Details Shows details for each logical olume including associated olume group and current state. MPIO Storage Information workspace The MPIO Storage Information workspace has iews that show the Multi-Path I/O (MPIO) Attributes, Connection Status, and Storage Deices Utilization on the current LPAR. This workspace contains the following iews: MPIO Attributes Shows the attributes, alues, and descriptions of each storage deice. It also indicates whether an attribute is user settable or not. MPIO Connection Status Shows a list of storage deices, the parent name of each deice, the deice path status, the deice operational status and the connection ID of the storage deice listed. Storage Deices Utilization Shows key utilization metrics for each storage deice associated with the LPAR. Storage workspace This workspace displays information about physical olume size and metrics. This workspace contains the following iews: Physical Volume Sizes Shows the used and aailable space as a stacked bar graph for each physical olume. Physical Volume Metrics Shows the number of logical olumes and stale partitions. Physical Volume Details Shows the details of each physical olume including associated olume groups, size, and allocation details. 14 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

25 System Storage Information workspace This workspace shows performance metrics for each actie disk and adapter. This workspace contains the following iews: Disk and Adapter Details Shows all disks and adapters, their types, and summary statistics. Disk and Adapter Transfer Rates Shows transfered KB per second for each disk and adapter. Disk and Adapter I/O Rates Shows read and write KB per second for each disk and adapter. Disk and Adapter Timeout Rates Shows read and write timeouts per second for each disk and adapter. Volume Groups and Logical Volumes workspace This workspace displays sizes and other properties of olume groups and logical olumes. This workspace contains the following iews: Volume Group Sizes Shows the used and free space as a stacked bar graph for each olume group. Volume Group Details Shows detailed information about each olume group, including allocated physical and logical olumes. Volume Group Allocations Shows the number of actie physical olumes and stale physical olumes as a stacked bar graph per olume group. Logical Volume Sizes Shows the size of each logical olume. Logical Volume Mappings Shows the association between logical olumes and olume groups. System Naigator item CPU Utilization workspace This workspace displays a real-time graph of CPU utilization and CPU utilization per processor. This workspace contains the following iews: Total CPU Utilization Shows a real-time graph of oerall CPU utilization. Processor Frequency Information Shows the fractional number of physical processors that are used in each mode. Actual metrics use PURR counters, normalized metrics use SPURR counters. CPU Utilization per Processor Shows a pie chart of utilization per CPU. Chapter 3. Workspaces reference 15

26 LPAR Information workspace This workspace displays LPAR CPU utilization, number of CPUs, entitlement, and LPAR attributes. This workspace contains the following iews: CPU Entitlement Shows the entitlement of the LPAR in the context of the number of CPUs for the host. LPAR CPUs Shows allocation of physical and logical CPUs in a shared pool. LPAR Attributes Shows LPAR metrics that are determined by configuration. LPAR Utilization Shows LPAR metrics that change frequently and dynamically. LPAR CPU Utilization Shows a pie chart of oerall CPU utilization. Actie Memory Sharing (AMS) Pool Shows information about AMS shared memory pools. NIM Resources workspace This workspace displays a table of NIM resources aailable. This workspace contains the following iews: Network Installation Management (NIM) Introduction Shows a table of aailable NIM resources. NIM Resources Shows an introduction to NIM. Print Queues workspace This workspace displays a list of printers and print queues. This workspace contains the following iews: Printers, Print Jobs, and Queues Shows list of actie print queues. Print Queues Shows descriptie text of printers, print jobs, and queues. System workspace This workspace displays information about summary and per processor CPU utilization. This workspace contains the following iews: CPU Utilization per Processor Shows a pie chart of utilization per CPU. CPU Aailability Shows a pie chart of oerall CPU utilization. CPU Details per Processor Shows detailed information on the workload of each CPU. LPAR Eents Shows LPAR creation, migration, and deletion eents. 16 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

27 Workload Manager workspace This workspace displays the CPU, memory, and disk resource metrics per WLM class. This workspace contains the following iews: WLM Class Load Shows CPU, disk, and memory load percentages for each workload manager class. Workload Manager Settings Shows settings for each workload manager class. Top Resources Naigator item Top Resources workspace This workspace displays information about file system sizes and top CPU and memory utilization by process. This workspace contains the following iews: Top Memory Processes Shows the highest memory-consuming processes listed in descending order by memory usage. File System Metrics Shows file systems, their mount points, associated olume groups, and usage statistics. File System Sizes Shows pie charts of free and used space for file systems. Top CPU Processes Shows the highest CPU-consuming processes listed in descending order by CPU usage. User Naigator item User workspace This workspace displays information about both defined users and currently actie users. This workspace contains the following iews: Defined Users Shows a list of all users defined in /etc/passwd. Actie Users Shows a list of all users who are currently logged in with details about each session. WPAR Naigator item WPAR workspace This workspace proides a summary of CPU utilization, memory utilization, and current status of all of the WPARs. This workspace contains the following iews: LPAR CPU Utilization by WPARs Shows the percentage of entitlement for the LPAR consumed by each WPAR. Chapter 3. Workspaces reference 17

28 LPAR Memory Utilization by WPARs Shows the percentage of memory for the LPAR used by each WPAR. WPAR Status and Configuration Proides a summarized status for all of the WPARs. WPAR CPU workspace This workspace proides detailed information on CPU consumption and CPU resource limits for a WPAR. This workspace contains the following iews: CPU Usage Shows the WPARs CPU consumption and its consumption limit. CPU Usage Modes Shows a pie chart of percentage CPU utilization in user and system modes for the WPAR. CPU Limit Shows a bar chart with CPU consumption limit for the WPAR and the entitlement for the LPAR. CPU Usage Details Shows detailed CPU usage and limits for the WPAR. Workspace Naigation Lists all of the WPARs in the partition with links beside them to naigate to the desired workspace. WPAR Details workspace This workspace proides detailed iews on the status, configuration, and resource limits of a WPAR. This workspace contains the following iews: Resource Controls Shows a table with arious resource controls for the WPAR. CPU Resource Limits Lists the CPU resource limits for the WPAR. Memory Resource Limits Lists the memory resource limits for the WPAR. Configuration Shows arious configuration parameters for the WPAR. Administration Status Shows a table proiding administratie information and status of the WPAR. WPAR Memory workspace This workspace proides detailed information on memory consumption and memory resource limits for a WPAR. This workspace contains the following iews: Used and Free Memory Shows a bar chart with the amount of free and used memory in the WPAR. 18 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

29 Memory Utilization Shows the used and free memory percentages for the WPAR as a pie chart. Memory Usage and Aailability Shows memory usage for the WPAR and memory size against the total memory aailable in the partition. Memory Usage Details. Shows detailed memory usage and limits for the WPAR. Workspace Naigation Lists all of the WPARs in the partition with links beside them to naigate to the desired workspace. WPAR Network and File System workspace This workspace displays networking and file system information for a WPAR. This workspace contains the following iews: Network Summary Shows a table with network interface related metrics for the WPAR. File System Summary Shows the file system information for the WPAR. Workspace Naigation Lists all of the WPARs in the partition with links beside them to naigate to the desired workspace. WPAR Process Views workspace This workspace shows detailed information on the processes running inside a WPAR. This workspace contains the following iews: Process Information Shows all of the processes running inside the WPAR. Workspace Naigation Lists all of the WPARs in the partition with links beside them to naigate to the desired workspace. Chapter 3. Workspaces reference 19

30 20 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

31 Chapter 4. Attributes reference About attributes This chapter contains an oeriew of attributes, references for detailed information about attributes, and descriptions of the attributes for each attribute group included in this monitoring agent. Attributes are the application properties that are being measured and reported by the AIX Premium Agent. Attributes are organized into groups according to their purpose. The attributes in a group can be used in the following two ways: Chart or table iews Attributes are displayed in chart and table iews. The chart and table iews use queries to specify which attribute alues to request from a monitoring agent. You use the Query editor to create a query, modify an existing query, or apply filters and set styles to define the content and appearance of a iew based on an existing query. Situations You use attributes to create situations that monitor the state of your operating system, database, or application. A situation describes a condition you want to test. When you start a situation, the Tioli Enterprise Portal compares the alues you hae assigned to the situation attributes with the alues collected by the AIX Premium Agent and registers an eent if the condition is met. You are alerted to eents by indicator icons that are displayed in the Naigator. More information about attributes For more information about using attributes and attribute groups, see the Tioli Enterprise Portal User's Guide. For a list of the attributes groups, a list of the attributes in each attribute group, and descriptions of the attributes for this monitoring agent, see the Attribute groups and attributes section in this chapter. Attribute groups and attributes for the AIX Premium Agent This monitoring agent contains the following attribute groups. The table name depends on the maximum table name limits of the target database being used for the Tioli Data Warehouse. If the maximum name is 30 characters, then any warehouse table name longer than 30 characters is shortened to 30 characters. Attribute group name: Actie Memory Expansion Table name: KPX55AME Warehouse table name: KPX_ACTIVE MEMORY EXPANSION or KPX55AME Attribute group name: Actie Users Table name: KPX42ACTIV Warehouse table name: KPX_ACTIVE USERS or KPX42ACTIV Attribute group name: AMS Pool Table name: KPX53MPOOL Copyright IBM Corp. 2007,

32 Warehouse table name: KPX_AMS POOL or KPX53MPOOL Attribute group name: CPU Detail Table name: KPX09CPUDE Warehouse table name: KPX_CPU DETAIL or KPX09CPUDE Attribute group name: CPU Summary Table name: KPX08CPUSU Warehouse table name: KPX_CPU SUMMARY or KPX08CPUSU Attribute group name: Defined Users Table name: KPX41DEFIN Warehouse table name: KPX_DEFINED USERS or KPX41DEFIN Attribute group name: Deices Table name: KPX51DEVIC Warehouse table name: KPX_DEVICES or KPX51DEVIC Attribute group name: Disks Table name: KPX26DISKS Warehouse table name: KPX_DISKS or KPX26DISKS Attribute group name: File Systems Table name: KPX30FILES Warehouse table name: KPX_FILE SYSTEMS or KPX30FILES Attribute group name: Internet Protocol Detail Table name: KPX36INTER Warehouse table name: KPX_INTERNET PROTOCOL DETAIL or KPX36INTER Attribute group name: Internet Protocol Summary Table name: KPX35INTER Warehouse table name: KPX_INTERNET PROTOCOL SUMMARY or KPX35INTER Attribute group name: Logical Partition Table name: KPX14LOGIC Warehouse table name: KPX_LOGICAL PARTITION or KPX14LOGIC Attribute group name: Logical Volumes Table name: KPX29LOGIC Warehouse table name: KPX_LOGICAL VOLUMES or KPX29LOGIC Attribute group name: MPIO Attributes Table name: KPX52MPIOA Warehouse table name: KPX_MPIO ATTRIBUTES or KPX52MPIOA Attribute group name: MPIO Status Table name: KPX51MPIOS Warehouse table name: KPX_MPIO STATUS or KPX51MPIOS Attribute group name: Network Adapters Rates Table name: KPX34NETWO Warehouse table name: KPX_NETWORK ADAPTERS RATES or KPX34NETWO Attribute group name: Network Adapters Totals Table name: KPX33NETWO 22 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

33 Warehouse table name: KPX_NETWORK ADAPTERS TOTALS or KPX33NETWO Attribute group name: Network Interfaces Table name: KPX32NETWO Warehouse table name: KPX_NETWORK INTERFACES or KPX32NETWO Attribute group name: NIM Resources Table name: KPX16NIMRE Warehouse table name: KPX_NIM RESOURCES or KPX16NIMRE Attribute group name: Paging Space Table name: KPX13PAGIN Warehouse table name: KPX_PAGING SPACE or KPX13PAGIN Attribute group name: Performance Object Status Table name: KPXPOBJST Warehouse table name: KPX_PERFORMANCE OBJECT STATUS or KPXPOBJST Attribute group name: Physical Memory Table name: KPX19PHYSI Warehouse table name: KPX_PHYSICAL MEMORY or KPX19PHYSI Attribute group name: Physical Volumes Table name: KPX27PHYSI Warehouse table name: KPX_PHYSICAL VOLUMES or KPX27PHYSI Attribute group name: Print Queues Table name: KPX17PRINT Warehouse table name: KPX_PRINT QUEUES or KPX17PRINT Attribute group name: Processes Detail Table name: KPX24PROCE Warehouse table name: KPX_PROCESSES DETAIL or KPX24PROCE Attribute group name: Processes Summary Table name: KPX23PROCE Warehouse table name: KPX_PROCESSES SUMMARY or KPX23PROCE Attribute group name: Quality Of Serice Table name: KPX54QOS Warehouse table name: KPX_QUALITY OF SERVICE or KPX54QOS Attribute group name: System Call Table name: KPX12SYSTE Warehouse table name: KPX_SYSTEM CALL or KPX12SYSTE Attribute group name: System IO Table name: KPX11SYSTE Warehouse table name: KPX_SYSTEM IO or KPX11SYSTE Attribute group name: TADDM Table name: KPX56TADDM Warehouse table name: KPX_TADDM or KPX56TADDM Attribute group name: TCP Table name: KPX37TCP Warehouse table name: KPX_TCP or KPX37TCP Chapter 4. Attributes reference 23

34 Attribute group name: Top 50 CPU Processes Table name: KPX02TOP50 Warehouse table name: KPX_TOP 50 CPU PROCESSES or KPX02TOP50 Attribute group name: Top 50 Memory Processes Table name: KPX03TOP50 Warehouse table name: KPX_TOP 50 MEMORY PROCESSES or KPX03TOP50 Attribute group name: Virtual Memory Management Table name: KPX20VIRTU Warehouse table name: KPX_VIRTUAL MEMORY MANAGEMENT or KPX20VIRTU Attribute group name: Volume Groups Table name: KPX28VOLUM Warehouse table name: KPX_VOLUME GROUPS or KPX28VOLUM Attribute group name: Workload Manager Table name: KPX15WORKL Warehouse table name: KPX_WORKLOAD MANAGER or KPX15WORKL Attribute group name: WPAR CPU Table name: KPX46WPARC Warehouse table name: KPX_WPAR CPU or KPX46WPARC Attribute group name: WPAR FileSystem Table name: KPX49WPFIL Warehouse table name: KPX_WPAR FILESYSTEM or KPX49WPFIL Attribute group name: WPAR Information Table name: KPX50WPINF Warehouse table name: KPX_WPAR INFORMATION or KPX50WPINF Attribute group name: WPAR Network Table name: KPX48WPNET Warehouse table name: KPX_WPAR NETWORK or KPX48WPNET Attribute group name: WPAR Physical Memory Table name: KPX47WPPHM Warehouse table name: KPX_WPAR PHYSICAL MEMORY or KPX47WPPHM The remaining sections of this chapter contain descriptions of these attribute groups, which are listed alphabetically. The following information is proided for each attribute group: Historical group Whether the attribute group is a historical type that you can roll off to a data warehouse Attribute descriptions, type, and for each attribute in the attribute group Some attributes are designated as key attributes. A key attribute is an attribute that is used in warehouse aggregation to identify rows of data that represent the same object. 24 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

35 Actie Memory Expansion attribute group This attribute group contains attributes associated with the AIX memory expansion feature. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Actie Memory Expansion attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP AME Mode attribute Actie Memory Expansion (AME) mode is 'Enabled' or 'Disabled' for this partition. Integer with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Disabled (0) Enabled (1) AME_MODE True Memory Size MB attribute Chapter 4. Attributes reference 25

36 The size of the memory (Compressed + Uncompressed memory, when AME is enabled; LPAR memory size, when AME is disabled). Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) TRUE_MEMORY_SIZE_MB or TMSM Target Memory Expansion Factor attribute The target Memory Expansion Factor is the HMC-configured multiplier (1.00 to 10.00) used to calculate the target expanded memory size. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) TARGET_MEMORY_EXPANSION_FACTOR or TMEF Current Memory Expansion Factor attribute The current Memory Expansion Factor is the ratio of the current effectie memory size to real memory size. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) 26 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

37 CURRENT_MEMORY_EXPANSION_FACTOR or CMEF Effectie Memory Size MB attribute The memory size that the operating system reports (real memory times the Memory Expansion Factor configured by the HMC). Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) EFFECTIVE_MEMORY_SIZE_MB or EMSM Target Compressed Memory Size MB attribute The target size of the compressed memory pool (based on current compression ratio and expanded memory size). Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) TARGET_COMPRESSED_MEM_SIZE_MB or TCMSM Max Compressed Memory Size MB attribute The maximum possible size of the compressed memory pool in MB. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) Chapter 4. Attributes reference 27

38 MAX_COMPRESSED_MEM_SIZE_MB or MCMSM Minimum Uncompressed Memory Size MB attribute The minimum possible size of uncompressed memory in MB. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) MIN_UNCOMPRESSED_MEM_SIZE_MB or MUMSM Compressed Memory Size MB attribute The current size of the compressed memory pool in MB. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) COMPRESSED_MEM_SIZE_MB or CMSM Compressed Data Size MB attribute The size of compressed memory after expansion (less any memory deficit). Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) 28 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

39 COMPRESSED_DATA_SIZE_MB or CDSM Uncompressed Data Size MB attribute The size of the uncompressed memory. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) UNCOMPRESSED_DATA_SIZE_MB or UDSM Compressed Memory In Use MB attribute The amount of memory use in the compressed memory pool. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) COMPRESSED_MEM_INUSE_MB or CMIM Compressed Memory In use Pct attribute The percentage of the compressed memory pool that is in use. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) Chapter 4. Attributes reference 29

40 COMPRESSED_MEM_INUSE_PCT or CMIP Compressed Memory Pct attribute The percentage of true memory (compressed + uncompressed) used by the compressed memory pool. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) COMPRESSED_MEM_PCT or CMP Compressed Memory Free MB attribute The amount of free memory in the compressed memory pool. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) COMPRESSED_MEM_FREE_MB or CMFM Compressed Memory Free Pct attribute The percentage of free pages in the compressed memory pool. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) 30 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

41 COMPRESSED_MEM_FREE_PCT or CMFP Compression Ratio attribute The Compression Ratio is the ratio of memory size before compression to memory size after compression. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) COMPRESSION_RATIO or CR Compressed Memory Page Ins attribute The number of page-ins per second to the compressed memory pool. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) COMPRESSED_MEM_PAGE_INS or CMPI Compressed Memory Page Outs attribute The number of page-outs per second from the compressed memory pool. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Chapter 4. Attributes reference 31

42 COMPRESSED_MEM_PAGE_OUTS or CMPO Compressed Number Of Working Pages attribute The number of compressed working pages. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) COMPRESSED_NUM_WORKING_PAGES or CNWP Uncompressed Memory Size MB attribute The current size of the uncompressed memory pool in MB. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) UNCOMPRESSED_MEM_SIZE_MB or UMSM Uncompressed Memory In Use MB attribute The total amount of memory in use in the uncompressed memory pool in MB. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) 32 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

43 UNCOMPRESSED_MEM_INUSE_MB or UMIM Uncompressed Memory In Use Pct attribute The percentage of the uncompressed memory pool that is in use. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) UNCOMPRESSED_MEM_INUSE_PCT or UMIP Uncompressed Memory Free Pct attribute The percentage of the uncompressed pool that is free. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) UNCOMPRESSED_MEM_FREE_PCT or UMFP Uncompressed True Memory In Use Pct attribute The percentage of true memory (compressed + uncompressed) that is used by the uncompressed memory pool. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) Chapter 4. Attributes reference 33

44 UNCOMPRESSED_TRUE_MEM_INUSE_PCT or UTMIP Uncompressed Number of Working Pages attribute The number of uncompressed working pages. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) UNCOMPRESSED_NUM_WORKING_PAGES or UNWP CPU Used Pct attribute The percentage of CPU used for memory expansion. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) CPU_USED_PCT or CUP Deficit Memory MB attribute The difference between desired memory expansion and actual memory expansion in MB. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) 34 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

45 Actie Users attribute group DEFICIT_MEMORY_MB or DMM Deficit Expansion Factor attribute The Deficit factor needed to reach the target expansion factor. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) DEFICIT_EXPANSION_FACTOR or DEF This attribute group contains information about the users actie on this system. Historical group This attribute group is not part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Actie Users attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Chapter 4. Attributes reference 35

46 User Name attribute - This attribute is a key attribute. The logon user name. USER_NAME tty attribute The name of the TTY the user is on. TTY Login Date Time attribute The time of day the user logged on. LOGIN_DATE_TIME or LDT Hostname attribute The name of the computer from which the user is logged in. HOSTNAME Idle Time attribute The number of minutes since a program last attempted to read from the terminal. IDLE_TIME JCPU attribute The system unit time used by all processes and their children on that terminal. 36 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

47 AMS Pool attribute group JCPU PCPU attribute The system unit time used by the currently actie process. PCPU Current Process attribute The name and arguments of the current process. CURRENT_PROCESS or CP This attribute group contains information about the Actie Memory Sharing (AMS) pool. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the AMS Pool attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP AMS Mode attribute Chapter 4. Attributes reference 37

48 Indicates whether the LPAR is in AMS shared or dedicated mode. Integer with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Dedicated (0) Shared (1) AMS_MODE AMS Pool ID attribute - This attribute is a key attribute. The pool ID associated with the LPAR. All LPARs in AMS mode will hae a pool ID of 0 until multiple pools are supported. Integer with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) AMS_POOL_ID or API AMS Pool Size attribute AMS Memory pool size in GB. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) AMS_POOL_SIZE or APS 38 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

49 AMS Physical Mem attribute Physical memory supporting AMS logical memory for the partition. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) AMS_PHYSICAL_MEM or APM AMS Mem Loaned attribute AMS logical memory loaned to the hyperisor. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) AMS_MEM_LOANED or AML AMS Memory Entitlement attribute AMS memory entitlement of the partition (MB). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) AMS_MEMORY_ENTITLEMENT or AME AMS Memory Ent InUse attribute Chapter 4. Attributes reference 39

50 AMS memory entitlement of the partition in use (MB). Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) AMS_MEMORY_ENT_INUSE or AMEI Hyperisor Page Ins attribute Number of hyperisor page-ins. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) HYPERVISOR_PAGE_INS or HPI Hyperisor Page Ins Time attribute Time spent waiting for hyperisor page-ins in nanoseconds. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) HYPERVISOR_PAGE_INS_TIME or HPIT 40 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

51 CPU Detail attribute group This attribute group contains information for each CPU. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the CPU Detail attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP CPU Number attribute - This attribute is a key attribute. The CPU identifier number. CPU_NUMBER User CPU Pct attribute The time this processor spent executing in CPU user mode percentage. (usr) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Chapter 4. Attributes reference 41

52 USER_CPU_PCT or UCP System CPU Pct attribute The time this processor spent executing in CPU kernel mode percentage. (sys) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) SYSTEM_CPU_PCT or SCP IO Wait CPU Pct attribute The time this processor spent waiting for IO percentage. (wait) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) IO_WAIT_CPU_PCT or IWCP Idle CPU Pct attribute The time this processor spent executing in CPU idle mode percentage. (idl) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) 42 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

53 IDLE_CPU_PCT or ICP Context Switches per Sec attribute The process context switches on this processor per second. (csw) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) CONTEXT_SWITCHES_PER_SEC or CSPS Syscalls per Sec attribute The system calls on this processor per second. (syscl) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) SYSCALLS_PER_SEC or SPS Reads per Sec attribute The read system calls on this processor per second. (sysread) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Chapter 4. Attributes reference 43

54 READS_PER_SEC or RPS Writes per Sec attribute The write system calls on this processor per second. (syswrite) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) WRITES_PER_SEC or WPS Forks per Sec attribute The fork system calls on this processor per second. (sysfork) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) FORKS_PER_SEC or FPS Execs per Sec attribute The exec system calls on this processor per second. (sysexec) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) EXECS_PER_SEC or EPS 44 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

55 Read Char per Sec attribute The KBs read through the read sys call on this processor per second. (readch_kb) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) READ_CHAR_PER_SEC or RCPS Write Char per Sec attribute The KBs written through the write sys call on this processor per second. (writech_kb) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) WRITE_CHAR_PER_SEC or WCPS Inode Lookup per Sec attribute The calls to i-node lookup routines for this processor per second. (iget) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) INODE_LOOKUP_PER_SEC or ILPS Chapter 4. Attributes reference 45

56 Path Name Lookup per Sec attribute The calls to path name lookup routine for this processor per second. (namei) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PATH_NAME_LOOKUP_PER_SEC or PNLPS Dir Blk Scans per Sec attribute The directory blocks scanned for this processor per second. (dirblk) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) DIR_BLK_SCANS_PER_SEC or DBSPS Minor Page Faults attribute The minor page faults per second. (minf) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MINOR_PAGE_FAULTS or MPF Major Page Faults attribute 46 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

57 The major page faults per second. (majf) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MAJOR_PAGE_FAULTS or MPF0 Interrupts attribute The hardware deice interrupts per second. (intr) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) INTERRUPTS Inoluntary Context Switches attribute The inoluntary context switches by process per second. (icsw) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) INVOLUNTARY_CONTEXT_SWITCHES or ICS Run Queue attribute The aerage number of processes on the run queue per second. (runq) Chapter 4. Attributes reference 47

58 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) RUN_QUEUE Logical Processor Affinity attribute The percentage of logical processor re-dispatches within the scheduling affinity domain 3. (lpa) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) LOGICAL_PROCESSOR_AFFINITY or LPA Message Ops attribute The number of IPC message operations per second. (msg) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MESSAGE_OPS or MO Semaphore Ops attribute The number of IPC semaphore operations per second. (sema) 48 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

59 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) SEMAPHORE_OPS or SO Blocks Read attribute The number of system block reads per second. (sysread) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) BLOCKS_READ or BR Blocks Write attribute The number of system block writes per second. (syswrite) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) BLOCKS_WRITE or BW Logical Read Requests attribute The number of logical read requests per second. (lread) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Chapter 4. Attributes reference 49

60 Not_Collected (-1) LOGICAL_READ_REQUESTS or LRR Logical Write Requests attribute The number of logical write requests per second. (lwrite) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) LOGICAL_WRITE_REQUESTS or LWR Physical Reads attribute The number of physical read requests per second. (phread) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PHYSICAL_READS or PR Physical Writes attribute The number of physical write requests per second. (phwrite) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) 50 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

61 PHYSICAL_WRITES or PW Logical Context Switches attribute The number of logical context switches per second. (lcsw) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) LOGICAL_CONTEXT_SWITCHES or LCS Physical Consumption attribute The number of physical CPU units consumed by this logical CPU. (pc) Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) PHYSICAL_CONSUMPTION or PC CPU Summary attribute group This attribute group contains system-wide CPU usage information. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Chapter 4. Attributes reference 51

62 Attribute descriptions The following list contains information about each attribute in the CPU Summary attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP System Software Version attribute The system software ersion identification. SYSTEM_SOFTWARE_VERSION or SSV Number of CPUs attribute The number of logical CPUs that are actie. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) NUMBER_OF_CPUS or NOC User CPU Pct attribute The system-wide time spent executing in CPU user mode percentage. 52 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

63 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) USER_CPU_PCT or UCP System CPU Pct attribute The system-wide time spent executing in CPU kernel mode percentage. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) SYSTEM_CPU_PCT or SCP IO Wait CPU Pct attribute The system-wide time waiting for CPU I/O percentage. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) IO_WAIT_CPU_PCT or IWCP Idle CPU Pct attribute The system-wide time spent in CPU idle mode percentage. Chapter 4. Attributes reference 53

64 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) IDLE_CPU_PCT or ICP Physical Consumption attribute The number of physical CPU units consumed by this LPAR. (pc) Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) PHYSICAL_CONSUMPTION or PC Donation Enablement attribute Status of the willingness of this LPAR to allow unused CPU cycles to be used by other LPARs [disabled,capable/disabled,enabled]. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) disable (0) capable (1) enable (2) DONATION_ENABLEMENT or DE Donated Idle Cycles Pct attribute The percentage of physical processor that is used by explicitly donated idle cycles, for dedicated partitions only. 54 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

65 Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) DONATED_IDLE_CYCLES_PCT or DICP Donated Busy Cycles Pct attribute The percentage of physical processor that is used by donating busy cycles, for dedicated partitions only. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) DONATED_BUSY_CYCLES_PCT or DBCP Stolen Idle Cycles Pct attribute The percentage of physical processor that is comprised of idle cycles stolen by the hyperisor, for dedicated partitions only. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) STOLEN_IDLE_CYCLES_PCT or SICP Stolen Busy Cycles Pct attribute Chapter 4. Attributes reference 55

66 The percentage of physical processor that is comprised of busy cycles stolen by the hyperisor, for dedicated partitions only. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) STOLEN_BUSY_CYCLES_PCT or SBCP Hyperisor Calls attribute The number of hyperisor calls made during the monitoring period. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) HYPERVISOR_CALLS or HC Time Spent in Hyperisor Pct attribute The percentage of time spent in the hyperisor during the monitoring period. Real number (gauge) with 1 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-10) TIME_SPENT_IN_HYPERVISOR_PCT or TSIHP 56 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

67 Donating LPARs attribute The number of LPARs donating CPU cycles. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) DONATING_LPARS or DL Aerage Operating Frequency GHz attribute The aerage operating frequency for the processor in GHz. Real number (gauge) with 1 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) AVERAGE_OPERATING_FREQUENCY_GHZ or AOFG Aerage Operating Frequency Pct attribute The operating frequency as a percentage of base processor frequency. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) AVERAGE_OPERATING_FREQUENCY_PCT or AOFP Actual Aerage Physical CPU User Mode attribute Chapter 4. Attributes reference 57

68 Aerage CPU units charged to User mode based on the POWER User mode PURR register. Real number (gauge) with 3 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) ACTUAL_AVERAGE_PHYSICAL_CPU_USER or AAPCU Actual Aerage Physical CPU System Mode attribute Aerage CPU units charged to System mode based on the POWER System mode PURR register. Real number (gauge) with 3 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) ACTUAL_AVERAGE_PHYSICAL_CPU_SYSTEM or AAPCS Actual Aerage Physical CPU Idle Mode attribute Aerage CPU units charged to Idle mode based on the POWER Idle mode PURR register. Real number (gauge) with 3 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) 58 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

69 ACTUAL_AVERAGE_PHYSICAL_CPU_IDLE or AAPCI Actual Aerage Physical CPU Wait Mode attribute Aerage CPU units charged to Wait mode based on the POWER Wait mode PURR register. Real number (gauge) with 3 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) ACTUAL_AVERAGE_PHYSICAL_CPU_WAIT or AAPCW Normalized Aerage Physical CPU User Mode attribute Aerage Normalized CPU units charged to User mode based on the POWER User mode SPURR register. Real number (gauge) with 3 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) NORMALIZED_AVERAGE_PHYSICAL_CPU_USER or NAPCU Normalized Aerage Physical CPU System Mode attribute Aerage Normalized CPU units charged to System mode based on the POWER System mode SPURR register. Real number (gauge) with 3 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Chapter 4. Attributes reference 59

70 Defined Users attribute group NORMALIZED_AVERAGE_PHYSICAL_CPU_SYSTEM or NAPCS Normalized Aerage Physical CPU Idle Mode attribute Aerage Normalized CPU units charged to Idle mode based on the POWER Idle mode SPURR register. Real number (gauge) with 3 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) NORMALIZED_AVERAGE_PHYSICAL_CPU_IDLE or NAPCI Normalized Aerage Physical CPU Wait Mode attribute Aerage Normalized CPU units charged to Wait mode based on the POWER Wait mode SPURR register. Real number (gauge) with 3 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) NORMALIZED_AVERAGE_PHYSICAL_CPU_WAIT or NAPCW This attribute group contains information about the users defined on this system. Historical group This attribute group is not part of the default historical group, and is eligible for use with Tioli Data Warehouse. 60 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

71 Attribute descriptions The following list contains information about each attribute in the Defined Users attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP User Name attribute - This attribute is a key attribute. The logon user name. USER_NAME Roles attribute The roles defined for this user ID. ROLES Account Locked attribute An indicator of whether or not the user account has been locked. ACCOUNT_LOCKED or AL Expires attribute The expiration date of this user ID. Chapter 4. Attributes reference 61

72 Deices attribute group EXPIRES Loginretries attribute The number of incorrect logon attempts before the user ID is locked. Integer (32-bit gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: LOGINRETRIES or L This attribute group contains network and storage deice status information. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Deices attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP 62 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

73 Disks attribute group Name attribute - This attribute is a key attribute. The name of the deice. NAME Parent attribute - This attribute is a key attribute. The parent deice name. PARENT attribute The deice type. TYPE State attribute The deice status. STATE Class attribute The class of the deice. CLASS This attribute group contains system disk information. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Chapter 4. Attributes reference 63

74 Attribute descriptions The following list contains information about each attribute in the Disks attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Name attribute - This attribute is a key attribute. The deice name. NAME Parent attribute - This attribute is a key attribute. The parent deice name. PARENT attribute The type of deice. TYPE Actie Disk Pct attribute The percentage of time the physical disk was actie (bandwidth utilization for the drie). This percentage is alid for the Disk type. 64 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

75 Real number (gauge) with 1 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-10) ACTIVE_DISK_PCT or ADP Transfers Bytes per Sec attribute The amount of data transferred (read or written) to the drie in bytes per second. This percentage is alid for Adapter and Disk types. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) TRANSFERS_BYTES_PER_SEC or TBPS Transfers KB per Sec attribute The amount of data transferred (read or written) to the drie in KBs per second. This alue is alid for the Adapter type. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) TRANSFERS_KB_PER_SEC or TKPS Transfers per Sec attribute Chapter 4. Attributes reference 65

76 The number of transfers per second issued to the physical disk. A transfer is an I/O request to the physical disk, which can be a combination of multiple logical requests. A transfer is of indeterminate size and alid for all storage deice types. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) TRANSFERS_PER_SEC or TPS Read KB per Sec attribute The total number of KBs read. This number is alid for all storage deice types. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) READ_KB_PER_SEC or RKPS Written KB per Sec attribute The total number of KBs written. This number is alid for all storage deice types. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) WRITTEN_KB_PER_SEC or WKPS 66 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

77 Read Transfers per Sec attribute The number of read transfers per second. This is number alid for all storage deice types, except Adapter. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) READ_TRANSFERS_PER_SEC or RTPS Ag Read Transfer MS attribute The aerage serice time in milliseconds per read transfer. This time is alid for all storage deice types, except Adapter. Real number (gauge) with 1 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-10) AVG_READ_TRANSFER_MS or ARTM Min Read Serice MS attribute The minimum read serice time in milliseconds. This time is alid for all storage deice types, except Adapter. Real number (gauge) with 1 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-10) Chapter 4. Attributes reference 67

78 MIN_READ_SERVICE_MS or MRSM Max Read Serice MS attribute The maximum read serice time in milliseconds. This time is alid for all storage deice types, except Adapter. Real number (gauge) with 1 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-10) MAX_READ_SERVICE_MS or MRSM0 Read Timeouts per Sec attribute The number of read timeouts per second. This number is alid for the Disk type. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) READ_TIMEOUTS_PER_SEC or RTPS0 Failed Read per Sec attribute The number of failed read requests per second. This number is alid for the Disk type. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) 68 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

79 FAILED_READ_PER_SEC or FRPS Write Transfers per Sec attribute The number of write transfers per second. This number is alid for all storage deice types, except Adapter. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) WRITE_TRANSFERS_PER_SEC or WTPS Ag Write Transfer MS attribute The aerage serice time in milliseconds per write transfer. This time is alid for all storage deice types, except Adapter. Real number (gauge) with 1 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-10) AVG_WRITE_TRANSFER_MS or AWTM Min Write Serice MS attribute The minimum write serice time in milliseconds. This time is alid for all storage deice types, except Adapter. Real number (gauge) with 1 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-10) Chapter 4. Attributes reference 69

80 MIN_WRITE_SERVICE_MS or MWSM Max Write Serice MS attribute The maximum write serice time in milliseconds. This time is alid for all storage deice types, except Adapter. Real number (gauge) with 1 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-10) MAX_WRITE_SERVICE_MS or MWSM0 Write Timeout per Sec attribute The number of write timeouts per second. This number is alid for the Disk type. Real number (gauge) with 1 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-10) WRITE_TIMEOUT_PER_SEC or WTPS0 Failed Writes per Sec attribute The number of failed write requests per second. This number is alid for the Disk type. 70 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

81 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) FAILED_WRITES_PER_SEC or FWPS Ag Request In WaitQ MS attribute The aerage time in milliseconds spent by a transfer request in the wait queue. This time is alid for all storage deice types, except Adapter. Real number (gauge) with 1 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-10) AVG_REQUEST_IN_WAITQ_MS or ARIWM Min Request In WaitQ MS attribute The minimum time in milliseconds spent by a transfer request in the wait queue. This time is alid for all storage deice types, except Adapter. Real number (gauge) with 1 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-10) MIN_REQUEST_IN_WAITQ_MS or MRIWM Max Request In WaitQ MS attribute Chapter 4. Attributes reference 71

82 The maximum time in milliseonds spent by a transfer request in the wait queue. This time is alid for all storage deice types, except Adapter. Real number (gauge) with 1 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-10) MAX_REQUEST_IN_WAITQ_MS or MRIWM0 Ag WaitQ Size attribute The aerage wait queue size. This size is alid for all storage deice types, except Adapter. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) AVG_WAITQ_SIZE or AWS Ag SericeQ Size attribute The aerage serice queue size. This size is alid for all storage deice types, except Adapter. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) AVG_SERVICEQ_SIZE or ASS 72 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

83 File Systems attribute group SericeQ Full per Sec attribute The number of times the serice queue becomes full (the disk is not accepting any more serice requests) per second. This number is alid for all storage deice types, except Adapter. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) SERVICEQ_FULL_PER_SEC or SFPS This attribute group contains file system information. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the File Systems attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Name attribute - This attribute is a key attribute. The file system name. Chapter 4. Attributes reference 73

84 NAME Mount Point attribute The file system mount point. MOUNT_POINT or MP Volume Group Name attribute The name of the olume group. VOLUME_GROUP_NAME or VGN Size MB attribute The file system size in MB. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) SIZE_MB Free MB attribute The file system free space in MB. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) 74 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

85 FREE_MB Used MB attribute The file system used space in MB. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) USED_MB Free Pct attribute The file system free space percentage. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) FREE_PCT Used Pct attribute The file system used space percentage. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Chapter 4. Attributes reference 75

86 USED_PCT Internet Protocol Detail attribute group This attribute group contains IP interface details. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Internet Protocol Detail attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Name attribute - This attribute is a key attribute. The interface name. NAME Packets Receied per Sec attribute The IP packets receied per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) 76 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

87 PACKETS_RECEIVED_PER_SEC or PRPS Ioctet Receied KB per Sec attribute The KBs receied per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) IOCTET_RECEIVED_KB_PER_SEC or IRKPS Input Errors per Sec attribute The input errors per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) INPUT_ERRORS_PER_SEC or IEPS Multicast Pkt Receied per Sec attribute The multicast packets receied per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Chapter 4. Attributes reference 77

88 MULTICAST_PKT_RECEIVED_PER_SEC or MPRPS Input Packets Dropped per Sec attribute The input packets dropped per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) INPUT_PACKETS_DROPPED_PER_SEC or IPDPS Packets Transmitted per Sec attribute The packets transmitted per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PACKETS_TRANSMITTED_PER_SEC or PTPS Ioctet Transmitted KB per Sec attribute The KBs transmitted per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) 78 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

89 IOCTET_TRANSMITTED_KB_PER_SEC or ITKPS Output Errors per Sec attribute The output errors per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) OUTPUT_ERRORS_PER_SEC or OEPS Multicast Pkt Transmitted per Sec attribute The multicast packets transmitted per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MULTICAST_PKT_TRANSMITTED_PER_SEC or MPTPS Internet Protocol Summary attribute group This attribute group contains system-wide IP networking information. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Internet Protocol Summary attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. Chapter 4. Attributes reference 79

90 NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Packets Receied per Sec attribute The IP packets receied per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PACKETS_RECEIVED_PER_SEC or PRPS Frag Receied per Sec attribute The IP fragments receied per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) FRAG_RECEIVED_PER_SEC or FRPS Packets Forwarded per Sec attribute The IP packets forwarded per second. 80 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

91 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PACKETS_FORWARDED_PER_SEC or PFPS Receied Datagrams per Sec attribute The successfully receied IP datagrams per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) RECEIVED_DATAGRAMS_PER_SEC or RDPS Transmitted Datagrams per Sec attribute The transmitted IP datagrams per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) TRANSMITTED_DATAGRAMS_PER_SEC or TDPS Total Packets Reassembled per Sec attribute The IP packets successfully reassembled per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Chapter 4. Attributes reference 81

92 Not_Collected (-1) TOTAL_PACKETS_REASSEMBLED_PER_SEC or TPRPS Frag Output Packets per Sec attribute The output packets successfully fragmented per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) FRAG_OUTPUT_PACKETS_PER_SEC or FOPPS Logical Partition attribute group This attribute group contains information about the logical partition. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Logical Partition attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. 82 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

93 TIMESTAMP User CPU Pct attribute The LPAR system time spent in CPU User mode percentage. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) USER_CPU_PCT or UCP System CPU Pct attribute The LPAR system time spent in CPU System mode percentage. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) SYSTEM_CPU_PCT or SCP IO Wait CPU Pct attribute The LPAR system time spent in CPU I/O Wait mode percentage. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) IO_WAIT_CPU_PCT or IWCP Chapter 4. Attributes reference 83

94 Idle CPU Pct attribute The LPAR system time spent in CPU Idle mode percentage. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) IDLE_CPU_PCT or ICP Entitlement attribute The number of entitlement units assigned to this LPAR. (ent) Real number (gauge) with 1 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-10) ENTITLEMENT or E Total Used Pct attribute The percentage of the Total System CPU being used by this LPAR. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) TOTAL_USED_PCT or TUP Entitlement Used Pct attribute 84 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

95 The percentage of the gien CPU Entitlement being used by this LPAR. (entc) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) ENTITLEMENT_USED_PCT or EUP LPAR Number attribute The LPAR identification number assigned to this LPAR. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) LPAR_NUMBER or LN Shared Mode attribute The shared Logical Partition mode (dedicated or shared). SHARED_MODE or SM Capped Mode attribute The capped Logical Partition mode (uncapped or capped). CAPPED_MODE or CM SMT Mode attribute Chapter 4. Attributes reference 85

96 The simultaneous multi-threading mode (off or on). SMT_MODE Number of Physical CPUs attribute The number of actie licensed physical CPUs. (pcpu) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) NUMBER_OF_PHYSICAL_CPUS or NOPC Number of Virtual CPUs attribute The number of current online irtual CPUs. (cpu) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) NUMBER_OF_VIRTUAL_CPUS or NOVC Number of Logical CPUs attribute The number of current online logical CPUs. (lcpu) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) 86 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

97 NUMBER_OF_LOGICAL_CPUS or NOLC Aailable CPUs in Pool attribute The number of CPUs that are aailable for allocation. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) AVAILABLE_CPUS_IN_POOL or ACIP Number of Physical CPUs in Shared Pool attribute The number of physical CPUs in the shared pool. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) NUMBER_OF_PHYSICAL_CPUS_IN_SHARED_POOL or NOPCISP Busy Pct attribute The logical busy time percentage. (%lbusy) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Chapter 4. Attributes reference 87

98 BUSY_PCT Phys Busy Pct attribute The physical busy time of a full processor percentage. (pbusy) Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PHYS_BUSY_PCT or PBP Virt Context CPU Switches per Sec attribute The irtual CPU context switches per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) VIRT_CONTEXT_CPU_SWITCHES_PER_SEC or VCCSPS Max Memory attribute The maximum amount of memory that this LPAR can support in MB. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MAX_MEMORY 88 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

99 Min Memory attribute The minimum amount of memory that this LPAR can support in MB. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MIN_MEMORY Max Phys CPUs attribute The maximum number of physical CPUs in the system. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MAX_PHYS_CPUS or MPC Min Virt CPUs attribute The minimum number of irtual CPUs in this LPAR. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MIN_VIRT_CPUS or MVC Max Virt CPUs attribute Chapter 4. Attributes reference 89

100 The maximum number of irtual CPUs in this LPAR. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MAX_VIRT_CPUS or MVC0 Min CPU Capacity attribute The minimum processor capacity (CPU units: 100 per processor). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MIN_CPU_CAPACITY or MCC Max CPU Capacity attribute The maximum processor capacity (CPU units: 100 per processor). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MAX_CPU_CAPACITY or MCC0 CPU Capacity Increment attribute The processor capacity change granule (CPU units: 100 per processor). 90 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

101 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) CPU_CAPACITY_INCREMENT or CCI Online Mem attribute The amount of current online memory in MB. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) ONLINE_MEM Max Dispatch Latency attribute The maximum latency between dispatches in nanoseconds. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MAX_DISPATCH_LATENCY or MDL Unallocated CPU In Pool attribute The unallocated capacity aailable in the shared pool. Chapter 4. Attributes reference 91

102 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) UNALLOCATED_CPU_IN_POOL or UCIP CPU Entitlement attribute The entitled processor capacity for the partition. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) CPU_ENTITLEMENT or CE Capacity Weight attribute The relatie weight between 0 and 255 that is used to determine how much extra CPU capacity this LPAR is to receie. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) CAPACITY_WEIGHT or CW Min Req Virt CPU attribute The minimum required irtual processor capacity. 92 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

103 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MIN_REQ_VIRT_CPU or MRVC Phantom Interrupts attribute The number of phantom interrupts. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PHANTOM_INTERRUPTS or PI Entitlement Pct attribute The entitlement as a percentage. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) ENTITLEMENT_PCT or EP Num Hyperisor Calls per Sec attribute The number of hyperisor calls per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Chapter 4. Attributes reference 93

104 Not_Collected (-1) NUM_HYPERVISOR_CALLS_PER_SEC or NHCPS Time In Hyperisor Pct attribute The time spent in the hyperisor percentage. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) TIME_IN_HYPERVISOR_PCT or TIHP Machine ID attribute The frame hardware ID to which this LPAR belongs. MACHINE_ID Uptime attribute The period of time this LPAR has been operational. UPTIME Hostname attribute The host name of the LPAR. HOSTNAME Physical CPU Units Used attribute 94 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

105 The number of physical CPU units consumed by this LPAR. (physb) Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) PHYSICAL_CPU_UNITS_USED or PCUU Aailable CPU Units in Pool attribute The number of physical CPU units that are aailable for allocation from the shared pool. (app) Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) AVAILABLE_CPU_UNITS_IN_POOL or ACUIP Physical CPU Size of Shared Pool attribute The number of physical CPU units in the shared pool. (psize) Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) PHYSICAL_CPU_SIZE_OF_SHARED_POOL or PCSOSP Chapter 4. Attributes reference 95

106 Last Machine ID attribute The preious frame hardware ID of this LPAR before it was migrated to the current frame. This attribute is cached for 5 minutes after the LPAR migration is detected to allow a situation to discoer and report that the LPAR had been migrated. LAST_MACHINE_ID or LMI Max CPU Cap Used Pct attribute The percentage of maximum physical CPU aailable to this LPAR that was actually used. For capped LPARs this is the same as CPU_Phys_Ent_Pct. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) MAX_CPU_CAP_USED_PCT or MCCUP CPU Pool ID attribute The ID of the Shared Processor Pool. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) POOLID Pool Entitlement attribute The entitled capacity of the pool. 96 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

107 Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) POOL_ENTITLEMENT or PE Maximum Pool Capacity attribute The maximum pool capacity. Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) MAXIMUM_POOL_CAPACITY or MPC0 SMT Threads attribute The number of threads per CPU. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) SMT_THREADS or ST Entitlement attribute The number of entitlement units assigned to this LPAR. (ent) Chapter 4. Attributes reference 97

108 Logical Volumes attribute group Real number (gauge) with 2 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-100) ENTITLEMENT_2 or E2 This attribute group contains logical olume information. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Logical Volumes attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Name attribute - This attribute is a key attribute. The name of the logical olume. NAME State attribute 98 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

109 The state of the logical olume. STATE Volume Group Name attribute The name of the olume group. VOLUME_GROUP_NAME or VGN attribute The logical olume type. TYPE Mount Point attribute The file system mount point for the logical olume. MOUNT_POINT or MP Size MB attribute The size of the logical olume in MB. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) SIZE_MB Chapter 4. Attributes reference 99

110 MPIO Attributes attribute group This attribute group contains Multi Path I/O attribute information. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the MPIO Attributes attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Deice Name attribute - This attribute is a key attribute. The name of the storage deice. DEVICE_NAME or DN Attribute attribute - This attribute is a key attribute. The name of the attribute. ATTRIBUTE Value attribute The alue of the attribute. 100 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

111 MPIO Status attribute group VALUE attribute The description of the attribute. DESCRIPTION or D User Settable attribute Whether or not the attribute can be set by the user. USER_SETTABLE or US This attribute group contains Multi-Path I/O status information. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the MPIO Status attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Chapter 4. Attributes reference 101

112 Deice Name attribute - This attribute is a key attribute. The name of the deice. DEVICE_NAME or DN Parent attribute - This attribute is a key attribute. The parent deice of the current deice. PARENT Path Status attribute The current status of the path. PATH_STATUS or PS Status attribute The operational status of the deice. STATUS Connection attribute - This attribute is a key attribute. The connection ID of the SCSI deice. CONNECTION Network Adapters Rates attribute group This attribute group contains network adapter rate information. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. 102 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

113 Attribute descriptions The following list contains information about each attribute in the Network Adapters Rates attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Name attribute - This attribute is a key attribute. The name of the adapter. NAME Parent attribute - This attribute is a key attribute. The parent adapter name. PARENT attribute The type of adapter. TYPE Bytes Sent per Sec attribute The number of bytes per second transmitted successfully by the deice. Chapter 4. Attributes reference 103

114 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) BYTES_SENT_PER_SEC or BSPS Pkts Sent per Sec attribute The number of packets per second transmitted successfully by the deice. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PKTS_SENT_PER_SEC or PSPS Pkts Sent Errors per Sec attribute The number of output errors per second encountered on this deice. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PKTS_SENT_ERRORS_PER_SEC or PSEPS Sent Pkts Dropped per Sec attribute The number of packets per second accepted by the deice drier for transmission and not gien to the deice for any reason. 104 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

115 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) SENT_PKTS_DROPPED_PER_SEC or SPDPS Broadcast Pkts Sent per Sec attribute The number of broadcast packets per second transmitted without any error. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) BROADCAST_PKTS_SENT_PER_SEC or BPSPS Multicast Pkts Sent per Sec attribute The number of multicast packets per second transmitted without any error. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MULTICAST_PKTS_SENT_PER_SEC or MPSPS Sent Interrupts per Sec attribute The number of transmit interrupts per second receied by the drier from the adapter. Chapter 4. Attributes reference 105

116 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) SENT_INTERRUPTS_PER_SEC or SIPS Bytes Recd per Sec attribute The number of bytes receied successfully by the deice per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) BYTES_RECVD_PER_SEC or BRPS Pkts Recd per Sec attribute The number of packets receied successfully by the deice per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PKTS_RECVD_PER_SEC or PRPS Pkts Rec Errors per Sec attribute The number of input errors encountered on this deice per second. 106 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

117 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PKTS_RECV_ERRORS_PER_SEC or PREPS Bad Pkts Recd per Sec attribute The number of bad packets receied by the deice drier per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) BAD_PKTS_RECVD_PER_SEC or BPRPS Rec Pkts Dropped per Sec attribute The number of packets receied by the deice drier (per second) from this deice and not gien to a network drier for any reason. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) RECV_PKTS_DROPPED_PER_SEC or RPDPS Broadcast Pkts Recd per Sec attribute The number of broadcast packets receied per second without any error. Chapter 4. Attributes reference 107

118 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) BROADCAST_PKTS_RECVD_PER_SEC or BPRPS0 Multicast Pkts Recd per Sec attribute The number of multicast packets receied per second without any error. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MULTICAST_PKTS_RECVD_PER_SEC or MPRPS Rec Interrupts per Sec attribute The number of interrupts receied per second by the drier from the adapter. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) RECV_INTERRUPTS_PER_SEC or RIPS TransmitsQ per Sec attribute The number of pending outgoing packets per second on either the software transmit queue or the hardware transmit queue. 108 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

119 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) TRANSMITSQ_PER_SEC or TPS Max TransmitsQ per Sec attribute The maximum number of outgoing packets per second eer queued to the software transmit queue. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MAX_TRANSMITSQ_PER_SEC or MTPS Qoerflow per Sec attribute The number of outgoing packets per second that hae oerflowed the software transmit queue. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) QOVERFLOW_PER_SEC or QPS Real Pkts Recd per Sec attribute The number of packets receied on the physical network per second. Chapter 4. Attributes reference 109

120 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) REAL_PKTS_RECVD_PER_SEC or RPRPS Real Pkts Bridged per Sec attribute The number of packets receied per second on the physical network that were bridged to the irtual network. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) REAL_PKTS_BRIDGED_PER_SEC or RPBPS Real Pkts Consumed per Sec attribute The number of packets receied per second on the physical network that were addressed to the interface configured oer the shared ethernet adapter. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) REAL_PKTS_CONSUMED_PER_SEC or RPCPS Real Pkts Fragmented per Sec attribute The number of packets receied per second on the physical network that were fragmented before being bridged to the irtual 110 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

121 network because they were bigger than the Maximum Transmission Unit (MTU) for the outgoing adapter. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) REAL_PKTS_FRAGMENTED_PER_SEC or RPFPS Real Pkts Sent per Sec attribute The number of packets sent per second on the physical network. Includes packets sent from the interface configured oer the shared ethernet adapter as well as each packet bridged from the irtual network to the physical network (including fragments). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) REAL_PKTS_SENT_PER_SEC or RPSPS Real Pkts Dropped per Sec attribute The number of packets receied per second on the physical network that were dropped. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) REAL_PKTS_DROPPED_PER_SEC or RPDPS0 Chapter 4. Attributes reference 111

122 Virtual Pkts Recd per Sec attribute The number of packets receied per second on the irtual network, for example, on all of the irtual adapters. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) VIRTUAL_PKTS_RECVD_PER_SEC or VPRPS Virtual Pkts Bridged per Sec attribute The number of packets receied per second on the irtual network that were bridged to the physical network. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) VIRTUAL_PKTS_BRIDGED_PER_SEC or VPBPS Virtual Pkts Consumed per Sec attribute The number of packets receied per second on the irtual network that were addressed to the interface configured oer the shared ethernet adapter. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) 112 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

123 VIRTUAL_PKTS_CONSUMED_PER_SEC or VPCPS Virtual Pkts Fragmented per Sec attribute The number of packets receied per second on the irtual network that were fragmented before being bridged to the physical network because they were bigger than the Maximum Transmission Unit (MTU) of the outgoing adapter. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) VIRTUAL_PKTS_FRAGMENTED_PER_SEC or VPFPS Virtual Pkts Sent per Sec attribute The number of packets sent on the irtual network per second. Includes packets sent from the interface configured oer the shared ethernet adapter as well as each packet bridged from the physical network to the irtual network (including fragments). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) VIRTUAL_PKTS_SENT_PER_SEC or VPSPS Virtual Pkts Dropped per Sec attribute The number of packets receied per second on the irtual network that were dropped. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Chapter 4. Attributes reference 113

124 VIRTUAL_PKTS_DROPPED_PER_SEC or VPDPS Output Pkts Generated per Sec attribute The number of packets with a alid VLAN tag or no VLAN tag sent out of the interface configured oer the SEA per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) OUTPUT_PKTS_GENERATED_PER_SEC or OPGPS Output Pkts Dropped per Sec attribute The number of packets sent out of the interface configured oer the shared ethernet adapter that are dropped because of an incorrect VLAN tag per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) OUTPUT_PKTS_DROPPED_PER_SEC or OPDPS Output Pkts Failures per Sec attribute The number of packets that cannot be sent because of underlying deice errors per second. Includes errors sending on the physical network and irtual network including fragments and ICMP error packets generated by the SEA. 114 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

125 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) OUTPUT_PKTS_FAILURES_PER_SEC or OPFPS Mem Alloc Failures per Sec attribute The number of packets that cannot be sent per second because there was insufficient network memory to complete an operation. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MEM_ALLOC_FAILURES_PER_SEC or MAFPS ICMP Error Pkts Sent per Sec attribute The number of ICMP error packets sent per second. Includes ICMP error packets successfully sent when a big packet cannot be fragmented because the Don't Fragment bit was set. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) ICMP_ERROR_PKTS_SENT_PER_SEC or IEPSPS Non IP Pkts Larger Than MTU per Sec attribute The number of packets that cannot be sent per second because they Chapter 4. Attributes reference 115

126 were bigger than the Maximum Transmission Unit (MTU) of the outgoing adapter and cannot be fragmented because they were not IP packets. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) NON_IP_PKTS_LARGER_THAN_MTU_PER_SEC or NIPLTMPS ThreadQ Oerflow Pkts per Sec attribute The number of packets that were dropped from the thread queues per second because there was no space to accomodate a newly-receied packet. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) THREADQ_OVERFLOW_PKTS_PER_SEC or TOPPS HA Keep Alie Pkts per Sec attribute The number of high aailability keepalie packets receied on the control channel per second. Keepalie packets are receied on the backup shared ethernet adapter while the primary SEA is actie. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) HA_KEEP_ALIVE_PKTS_PER_SEC or HKAPPS 116 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

127 HA Recoery Pkts per Sec attribute The number of high aailability recoery packets receied on the control channel per second. Recoery packets are sent by the primary shared ethernet adapter when it recoers from a failure and is ready to be actie again. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) HA_RECOVERY_PKTS_PER_SEC or HRPPS HA Notify Pkts per Sec attribute The number of high aailability notify packets receied on the control channel per second. Notify packets are sent by the backup shared ethernet adapter when it detects that the primary SEA has recoered. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) HA_NOTIFY_PKTS_PER_SEC or HNPPS HA Limbo Pkts per Sec attribute The number of high aailability limbo packets receied on the control channel per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Chapter 4. Attributes reference 117

128 HA_LIMBO_PKTS_PER_SEC or HLPPS HA State attribute The current high aailability state of the shared ethernet adapter. HA_STATE HA Bridge Mode attribute Describes to what leel, if any, the shared ethernet adapter is currently bridging traffic. HA_BRIDGE_MODE or HBM Times Primary per Sec attribute The number of times the shared ethernet adapter was idle and became actie because the primary SEA had a failure. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) TIMES_PRIMARY_PER_SEC or TPPS Time Backup per Sec attribute The number of times the shared ethernet adapter was actie and became idle because of a failure. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) 118 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

129 TIME_BACKUP_PER_SEC or TBPS HA Mode attribute The high aailability mode of the shared ethernet adapter (Auto, Backup, or Disabled). HA_MODE Priority attribute The trunk priority of the irtual ethernets for the shared ethernet adapter. Used by the SEA protocol to determine which SEA acts as primary and which one acts as backup. Values range from 1-12, where a lower number is faored to act as a primary. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PRIORITY Adapter Protocol attribute Indicates the selected network adapter transmission protocol: Auto Negotiation, Full, or Half Duplex. ADAPTER_PROTOCOL or AP Media Speed Running attribute Indicates the maximum media speed setting (adapter bandwidth in Mbps). Chapter 4. Attributes reference 119

130 MEDIA_SPEED_RUNNING or MSR Bandwidth Util Pct attribute Percentage of physical network adapter bandwidth utilized. Real number (gauge) with 3 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1000) BANDWIDTH_UTIL_PCT or BUP Network Adapters Totals attribute group This attribute group contains network adapter totals. Historical group This attribute group is not part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Network Adapters Totals attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Name attribute - This attribute is a key attribute. The name of the adapter. 120 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

131 NAME Parent attribute - This attribute is a key attribute. The parent adapter name. PARENT attribute The type of adapter. TYPE Bytes Sent attribute The number of bytes transmitted successfully by the deice. BYTES_SENT Pkts Sent attribute The number of packets transmitted successfully by the deice. PKTS_SENT Pkts Sent Error attribute The number of output errors encountered on this deice. PKTS_SENT_ERROR or PSE Sent Pkts Dropped attribute The number of packets accepted by the deice drier for transmission that were not gien to the deice for any reason. Chapter 4. Attributes reference 121

132 SENT_PKTS_DROPPED or SPD Broadcast Pkts Sent attribute The number of broadcast packets transmitted without any error. BROADCAST_PKTS_SENT or BPS Multicast Pkts Sent attribute The number of multicast packets transmitted without any error. MULTICAST_PKTS_SENT or MPS Sent Interrupts attribute The number of transmit interrupts receied by the drier from the adapter. SENT_INTERRUPTS or SI Bytes Recd attribute The number of bytes receied successfully by the deice. BYTES_RECVD or BR Pkts Recd attribute The number of packets receied successfully by the deice. PKTS_RECVD Pkts Rec Error attribute 122 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

133 The number of input errors encountered on this deice. PKTS_RECV_ERROR or PRE Bad Pkts Recd attribute The number of bad packets receied by the deice drier. BAD_PKTS_RECVD or BPR Rec Pkts Dropped attribute The number of packets receied by the deice drier from this deice that were not gien to a network drier for any reason. RECV_PKTS_DROPPED or RPD Broadcast Pkts Recd attribute The number of broadcast packets receied without any error. BROADCAST_PKTS_RECVD or BPR0 Multicast Pkts Recd attribute The number of multicast packets receied without any error. MULTICAST_PKTS_RECVD or MPR Rec Interrupts attribute The number of interrupts receied by the drier from the adapter. RECV_INTERRUPTS or RI Chapter 4. Attributes reference 123

134 TransmitsQ attribute The number of pending outgoing packets on either the software transmit queue or the hardware transmit queue. TRANSMITSQ Max TransmitsQ attribute The maximum number of outgoing packets eer queued to the software transmit queue. MAX_TRANSMITSQ or MT Qoerflow attribute The number of outgoing packets that hae oerflowed the software transmit queue. QOVERFLOW Real Pkts Recd attribute The number of packets receied on the physical network. REAL_PKTS_RECVD or RPR Real Pkts Bridged attribute The number of packets receied on the physical network that were bridged to the irtual network. REAL_PKTS_BRIDGED or RPB Real Pkts Consumed attribute The number of packets receied on the physical network that were addressed to the interface configured oer the SEA. 124 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

135 REAL_PKTS_CONSUMED or RPC Real Pkts Fragmented attribute The number of packets receied on the physical network that were fragmented before being bridged to the irtual network because they were bigger than the Maximum Transmission Unit (MTU) for the outgoing adapter. REAL_PKTS_FRAGMENTED or RPF Real Pkts Sent attribute The number of packets sent on the physical network, including packets sent from the interface configured oer the SEA as well as each packet bridged from the irtual network to the physical network (including fragments). REAL_PKTS_SENT or RPS Real Pkts Dropped attribute The number of packets receied on the physical network that were dropped. REAL_PKTS_DROPPED or RPD0 Virtual Pkts Recd attribute The number of packets receied on the irtual network. VIRTUAL_PKTS_RECVD or VPR Virtual Pkts Bridged attribute The number of packets receied on the irtual network that were bridged to the physical network. Chapter 4. Attributes reference 125

136 VIRTUAL_PKTS_BRIDGED or VPB Virtual Pkts Consumed attribute The number of packets receied on the irtual network that were addressed to the interface configured oer the SEA. VIRTUAL_PKTS_CONSUMED or VPC Virtual Pkts Fragmented attribute The number of packets receied on the irtual network that were fragmented before being bridged to the physical network because they were bigger than the Maximum Transmission Unit (MTU) for the outgoing adapter. VIRTUAL_PKTS_FRAGMENTED or VPF Virtual Pkts Sent attribute The number of packets sent on the irtual network. This includes packets sent from the interface configured oer the SEA as well as each packet bridged from the physical network to the irtual network (including fragments). VIRTUAL_PKTS_SENT or VPS Virtual Pkts Dropped attribute The number of packets receied on the irtual network that were dropped. VIRTUAL_PKTS_DROPPED or VPD Output Pkts Generated attribute The number of packets with a alid VLAN tag or no VLAN tag sent out of the interface configured oer the SEA. 126 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

137 OUTPUT_PKTS_GENERATED or OPG Output Pkts Dropped attribute The number of packets sent out of the interface configured oer the SEA that are dropped because of an incorrect VLAN tag. OUTPUT_PKTS_DROPPED or OPD Output Pkts Failures attribute The number of packets that cannot be sent because of underlying deice errors, including errors sending on the physical network and irtual network. This also includes fragments and ICMP error packets generated by the SEA. OUTPUT_PKTS_FAILURES or OPF Mem Alloc Failures attribute The number of packets that cannot be sent because there was insufficient network memory to complete an operation. MEM_ALLOC_FAILURES or MAF ICMP Error Pkts Sent attribute The ICMP error packets sent. The number of ICMP error packets sent successfully when a big packet cannot be fragmented because the Don't Fragment bit was set. ICMP_ERROR_PKTS_SENT or IEPS Non IP Pkts Larger Than MTU attribute The number of packets that cannot be sent because they were Chapter 4. Attributes reference 127

138 bigger than the Maximum Transmission Unit (MTU) for the outgoing adapter and could not be fragmented because they were not IP packets. NON_IP_PKTS_LARGER_THAN_MTU or NIPLTM ThreadQ Oerflow Pkts attribute The number of packets that were dropped from the thread queues because there was no space to accomodate a newly-receied packet. THREADQ_OVERFLOW_PKTS or TOP HA Keep Alie Pkts attribute The number of high aailability keepalie packets receied on the control channel. Keepalie packets are receied on the backup shared ethernet adapter while the primary SEA is actie. HA_KEEP_ALIVE_PKTS or HKAP HA Recoery Pkts attribute The number of recoery packets receied on the control channel. Recoery packets are sent by the primary SEA when it recoers from a failure and is ready to be actie again. HA_RECOVERY_PKTS or HRP HA Notify Pkts attribute The number of high aailability notify packets receied on the control channel. Notify packets are sent by the backup shared ethernet adapter when it detects that the primary SEA has recoered. HA_NOTIFY_PKTS or HNP 128 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

139 HA Limbo Pkts attribute The number of high aailability limbo packets receied on the control channel. HA_LIMBO_PKTS or HLP HA State attribute The current high aailability state of the shared ethernet adapter. HA_STATE HA Bridge Mode attribute The leel at which the shared ethernet adapter is currently bridging traffic. HA_BRIDGE_MODE or HBM Times Primary attribute The number of times the shared ethernet adapter was idle and became actie because the primary SEA had a failure. TIMES_PRIMARY or TP Times Backup attribute The number of times the shared ethernet adapter was actie and became idle because of a failure. TIMES_BACKUP or TB HA Mode attribute The high aailability mode of the shared ethernet adapter (Auto, Backup, or Disabled). Chapter 4. Attributes reference 129

140 HA_MODE Priority attribute The trunk priority of the irtual ethernets on the shared ethernet adapter. Used by the SEA protocol to determine which SEA acts as primary and which one acts as backup. Values are from 1-12, where a lower number is faored to act as a primary. PRIORITY Network Interfaces attribute group This attribute group contains network interface information. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Network Interfaces attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Name attribute - This attribute is a key attribute. The name of the network interface. 130 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

141 NAME State attribute The status of the network interface adapter. STATE IP Address attribute The IP or network address of the network interface. IP_ADDRESS MTU attribute The maximum transmission unit size (bytes). MTU Mask attribute The internet network mask. MASK Domain attribute The internet domain name. DOMAIN Gateway attribute The IP address of the gateway serer. Chapter 4. Attributes reference 131

142 GATEWAY Nameserer attribute The IP address of the domain name serer. NAMESERVER NIM Resources attribute group This attribute group contains information on the NIM resources aailable. Historical group This attribute group is not part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the NIM Resources attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Name attribute - This attribute is a key attribute. The name of the NIM objects as defined in the NIM Enironment. 132 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

143 NAME attribute The type of object for the specific NIM object. TYPE Class attribute The class type of the NIM object. CLASS State attribute The state of the NIM object. STATE Serer attribute The NIM object name of the serer for the NIM resource. SERVER Location attribute The path name of the NIM resource. LOCATION Information attribute The additional miscellaneous information about a NIM object. Chapter 4. Attributes reference 133

144 Paging Space attribute group INFORMATION or I This attribute group contains paging space information. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Paging Space attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Total Size MB attribute The total size of the actie paging space (MB). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) TOTAL_SIZE_MB or TSM Free MB attribute 134 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

145 The system paging space that is free (MB). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) FREE_MB Used MB attribute The system paging space that is used (MB). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) USED_MB Free Pct attribute The percentage of system paging space that is free. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) FREE_PCT Used Pct attribute The percentage of system paging space that is used. Chapter 4. Attributes reference 135

146 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) USED_PCT Pages Read per Sec attribute The number of 4K pages per second read from paging space by the VMM. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PAGES_READ_PER_SEC or PRPS Pages Written per Sec attribute The number of 4K pages per second written to paging space by the VMM. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PAGES_WRITTEN_PER_SEC or PWPS 136 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

147 Performance Object Status attribute group The Performance Object Status attribute group contains information that reflects the status of other attribute groups so you can see the status of all of the performance objects that make up this application all at once. Each of these other performance attribute groups is represented by a row in this table (or other type of iew). The status for an attribute group reflects the result of the last attempt to collect data for that attribute group, which allows you to see whether the agent is performing correctly. Unlike other attribute groups, the Performance Object Status attribute group does not reflect the state of the monitored application. This attribute group is most often used to determine why data is not aailable for one of the performance attribute groups. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Performance Object Status attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Query Name attribute - This attribute is a key attribute. The name of the attribute group. QUERY_NAME or ATTRGRP Object Name attribute The name of the performance object. Chapter 4. Attributes reference 137

148 OBJECT_NAME or OBJNAME Object attribute The type of the performance object. Integer with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: WMI (0) PERFMON (1) WMI_ASSOCIATION_GROUP (2) JMX (3) SNMP (4) SHELL_COMMAND (5) JOINED_GROUPS (6) CIMOM (7) CUSTOM (8) ROLLUP_DATA (9) WMI_REMOTE_DATA (10) LOG_FILE (11) JDBC (12) CONFIG_DISCOVERY (13) NT_EVENT_LOG (14) FILTER (15) SNMP_EVENT (16) PING (17) DIRECTOR_DATA (18) DIRECTOR_EVENT (19) SSH_REMOTE_SHELL_COMMAND (20) OBJECT_TYPE or OBJTYPE Object Status attribute The status of the performance object. Integer with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: ACTIVE (0) INACTIVE (1) 138 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

149 OBJECT_STATUS or OBJSTTS Error Code attribute The error code associated with the query Integer with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: NO_ERROR (0) GENERAL_ERROR (1) OBJECT_NOT_FOUND (2) COUNTER_NOT_FOUND (3) NAMESPACE_ERROR (4) OBJECT_CURRENTLY_UNAVAILABLE (5) COM_LIBRARY_INIT_FAILURE (6) SECURITY_INIT_FAILURE (7) PROXY_SECURITY_FAILURE (9) NO_INSTANCES_RETURNED (10) ASSOCIATOR_QUERY_FAILED (11) REFERENCE_QUERY_FAILED (12) NO_RESPONSE_RECEIVED (13) CANNOT_FIND_JOINED_QUERY (14) CANNOT_FIND_JOIN_ATTRIBUTE_IN_QUERY_1_RESULTS (15) CANNOT_FIND_JOIN_ATTRIBUTE_IN_QUERY_2_RESULTS (16) QUERY_1_NOT_A_SINGLETON (17) QUERY_2_NOT_A_SINGLETON (18) NO_INSTANCES_RETURNED_IN_QUERY_1 (19) NO_INSTANCES_RETURNED_IN_QUERY_2 (20) CANNOT_FIND_ROLLUP_QUERY (21) CANNOT_FIND_ROLLUP_ATTRIBUTE (22) FILE_OFFLINE (23) NO_HOSTNAME (24) MISSING_LIBRARY (25) ATTRIBUTE_COUNT_MISMATCH (26) ATTRIBUTE_NAME_MISMATCH (27) COMMON_DATA_PROVIDER_NOT_STARTED (28) CALLBACK_REGISTRATION_ERROR (29) MDL_LOAD_ERROR (30) AUTHENTICATION_FAILED (31) CANNOT_RESOLVE_HOST_NAME (32) Chapter 4. Attributes reference 139

150 Physical Memory attribute group SUBNODE_UNAVAILABLE (33) SUBNODE_NOT_FOUND_IN_CONFIG (34) ATTRIBUTE_ERROR (35) CLASSPATH_ERROR (36) CONNECTION_FAILURE (37) FILTER_SYNTAX_ERROR (38) FILE_NAME_MISSING (39) SQL_QUERY_ERROR (40) SQL_FILTER_QUERY_ERROR (41) SQL_DB_QUERY_ERROR (42) SQL_DB_FILTER_QUERY_ERROR (43) PORT_OPEN_FAILED (44) ACCESS_DENIED (45) TIMEOUT (46) NOT_IMPLEMENTED (47) REQUESTED_A_BAD_VALUE (48) RESPONSE_TOO_BIG (49) GENERAL_RESPONSE_ERROR (50) SCRIPT_NONZERO_RETURN (51) SCRIPT_NOT_FOUND (52) SCRIPT_LAUNCH_ERROR (53) CONF_FILE_DOES_NOT_EXIST (54) CONF_FILE_ACCESS_DENIED (55) INVALID_CONF_FILE (56) EIF_INITIALIZATION_FAILED (57) CANNOT_OPEN_FORMAT_FILE (58) FORMAT_FILE_SYNTAX_ERROR (59) REMOTE_HOST_UNAVAILABLE (60) EVENT_LOG_DOES_NOT_EXIST (61) PING_FILE_DOES_NOT_EXIST (62) NO_PING_DEVICE_FILES (63) PING_DEVICE_LIST_FILE_MISSING (64) ERROR_CODE or ERRCODE This attribute group contains information about the physical memory for the system. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. 140 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

151 Attribute descriptions The following list contains information about each attribute in the Physical Memory attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Memory Size MB attribute The total amount of physical memory aailable to this system (MB). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MEMORY_SIZE_MB or MSM Free Memory MB attribute The amount of free (unallocated) system memory in MB. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Chapter 4. Attributes reference 141

152 FREE_MEMORY_MB or FMM Used Memory MB attribute The amount of used (allocated) system memory in MB. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) USED_MEMORY_MB or UMM Free Memory Pct attribute The percentage of system memory that is free (unallocated). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) FREE_MEMORY_PCT or FMP Used Memory Pct attribute The percentage of system memory that is used (allocated). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) 142 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

153 USED_MEMORY_PCT or UMP Non Comp Memory attribute The number of non-computational 4K pages resident in memory. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) NON_COMP_MEMORY or NCM Comp Memory attribute The number of computational 4K pages resident in memory. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) COMP_MEMORY or CM Decay Rate attribute The decay rate for repaging alues per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) DECAY_RATE Chapter 4. Attributes reference 143

154 Repaging Rate attribute The global repaging rate per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) REPAGING_RATE or RR Physical Volumes attribute group This attribute group contains physical olume information. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Physical Volumes attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Name attribute - This attribute is a key attribute. The name of the physical olume. 144 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

155 NAME State attribute The state of the physical olume. STATE Volume Group Name attribute The name of the olume group. VOLUME_GROUP_NAME or VGN Number of Logical Volumes attribute The number of logical olumes using the physical olume. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) NUMBER_OF_LOGICAL_VOLUMES or NOLV Number of Stale Partitions attribute The number of partitions not updated in a mirrored LVM enironment. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Chapter 4. Attributes reference 145

156 NUMBER_OF_STALE_PARTITIONS or NOSP Size MB attribute The size of the physical olume in MB. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) SIZE_MB Free MB attribute The amount of aailable space in the physical olume in MB. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) FREE_MB Used MB attribute The amount of used space in the physical olume in MB. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) 146 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

157 Print Queues attribute group USED_MB Free Pct attribute The percentage of free space in the physical olume. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) FREE_PCT Used Pct attribute The percentage of space used in the physical olume. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) USED_PCT Unique ID attribute - This attribute is a key attribute. The unique identifier for the disk (UDID). UNIQUE_ID This attribute group contains print queue information. Historical group This attribute group is not part of the default historical group, and is eligible for use with Tioli Data Warehouse. Chapter 4. Attributes reference 147

158 Attribute descriptions The following list contains information about each attribute in the Print Queues attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Name attribute - This attribute is a key attribute. The print queue name. NAME Deice attribute The print deice name. DEVICE State attribute The print queue status. STATE attribute The printer description. 148 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

159 DESCRIPTION or D Processes Detail attribute group This attribute group contains detailed process information. Historical group This attribute group is not part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Processes Detail attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Process Name attribute The process name. PROCESS_NAME or PN Process ID attribute - This attribute is a key attribute. The process ID. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Chapter 4. Attributes reference 149

160 Not_Collected (-1) PROCESS_ID Parent Process ID attribute The parent process ID. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PARENT_PROCESS_ID or PPI Nice attribute The process nice alue. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) NICE User Name attribute The user name. USER_NAME Repage Count per Sec attribute 150 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

161 The process repage count per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) REPAGE_COUNT_PER_SEC or RCPS IO Page Fault per Sec attribute The process page faults inoling IO per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) IO_PAGE_FAULT_PER_SEC or IPFPS Non IO Page Fault per Sec attribute The process page faults not inoling IO per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) NON_IO_PAGE_FAULT_PER_SEC or NIPFPS Text Size attribute The code size (bytes). Chapter 4. Attributes reference 151

162 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) TEXT_SIZE Resident Text Size attribute The amount of resident physical memory used by the process code (4K pages). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) RESIDENT_TEXT_SIZE or RTS Resident Data Size attribute The amount of resident physical memory used by the process priate data (4K pages). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) RESIDENT_DATA_SIZE or RDS Page Space Used attribute The amount of page space used by the process priate data (4K pages). 152 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

163 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PAGE_SPACE_USED or PSU Signals In per Sec attribute The number of signals receied by the process per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) SIGNALS_IN_PER_SEC or SIPS Voluntary Context Switches per Sec attribute The number of oluntary context switches performed by the process per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) VOLUNTARY_CONTEXT_SWITCHES_PER_SEC or VCSPS Process Group ID attribute The process group ID. Chapter 4. Attributes reference 153

164 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PROCESS_GROUP_ID or PGI Priority attribute The process priority. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PRIORITY State attribute The process state: None, Created, Dying, Stopped, Actie, Swapped. Integer with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: None (0) Created (4) Dying (5) Stopped (6) Actie (7) Swapped (8) STATE Process UID attribute The real user ID for the process. 154 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

165 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PROCESS_UID or PU Thread Count attribute The number of threads associated with this process. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) THREAD_COUNT or TC Process Core Size attribute The process core image size. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PROCESS_CORE_SIZE or PCS Inoluntary Context Switches Per Sec attribute The inoluntary context switches by process per second. Chapter 4. Attributes reference 155

166 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) INVOLUNTARY_CONTEXT_SWITCHES_PER_SEC or ICSPS Total CPU Time attribute The total CPU used by this process. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) TOTAL_CPU_TIME or TCT CPU Pct attribute The percentage of CPU used by this process. Real number (gauge) with 1 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-10) CPU_PCT WPAR Name attribute The name of the WPAR. 156 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

167 WPAR_NAME WLM Name attribute The WLM class name to which the process belongs. WLM_NAME Full Path attribute The full path of the command (with options). FULL_PATH Processes Summary attribute group This attribute group contains system-wide process information. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Processes Summary attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Process Context Switches per Sec attribute Chapter 4. Attributes reference 157

168 The process context switches per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PROCESS_CONTEXT_SWITCHES_PER_SEC or PCSPS Run Queue Ag attribute The aerage count of processes that are waiting for the CPU. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) RUN_QUEUE_AVG or RQA Swap Queue Ag attribute The aerage count of processes waiting to be paged in. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) SWAP_QUEUE_AVG or SQA Kern Procs Created per Sec attribute The number of kernel process creations per second. 158 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

169 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) KERN_PROCS_CREATED_PER_SEC or KPCPS Kern Procs Exit per Sec attribute The number of kernel process exits per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) KERN_PROCS_EXIT_PER_SEC or KPEPS Load Ag attribute The partition load aerage. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) LOAD_AVG Utilization Ag attribute The partition utilization aerage. Chapter 4. Attributes reference 159

170 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) UTILIZATION_AVG or UA Total Num Processes attribute The number of processes. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) TOTAL_NUM_PROCESSES or TNP Quality Of Serice attribute group This attribute group contains networking quality of serice information. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Quality Of Serice attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute 160 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

171 The local time at the agent when the data was collected. TIMESTAMP Policy Rule Priority attribute The Policy Rule Priority number. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) POLICY_RULE_PRIORITY or PRP Protocol attribute - This attribute is a key attribute. The protocol to which this rule applies (TCP or UDP). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) ICMP (1) IGMP (2) TCP (6) UDP (17) PROTOCOL Source IP Addr start attribute - This attribute is a key attribute. The start of the Source IP Address range for this rule. Chapter 4. Attributes reference 161

172 SOURCE_IP_ADDR_START or SIAS Source IP Addr end attribute - This attribute is a key attribute. The end of the Source IP Address range for this rule. SOURCE_IP_ADDR_END or SIAE Dest IP Addr start attribute - This attribute is a key attribute. The start of the Destination IP Address range for this rule. DEST_IP_ADDR_START or DIAS Dest IP Addr end attribute - This attribute is a key attribute. The end of the Destination IP Address range for this rule. DEST_IP_ADDR_END or DIAE Source Port start attribute The start of the source port range for this rule. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: ANY_PORT (-2) Not_Collected (-1) SOURCE_PORT_START or SPS Source Port end attribute The end of the source port range for this rule. 162 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

173 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: ANY_PORT (-2) Not_Collected (-1) SOURCE_PORT_END or SPE Dest Port start attribute The start of the destination port range for this rule. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: ANY_PORT (-2) Not_Collected (-1) DEST_PORT_START or DPS Dest Port end attribute The end of the destination port range for this rule. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: ANY_PORT (-2) Not_Collected (-1) DEST_PORT_END or DPE Serice Class attribute The Serice Class (Integrated Serices Controlled Load, Integrated Serices Guaranteed Rate, or Differentiated Serices). Chapter 4. Attributes reference 163

174 Integer with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Integrated_Serices_Controlled_Load (5) Integrated_Serices_Guaranteed_Rate (2) Differentiated_Serices (1) SERVICE_CLASS or SC Peak Rate attribute The highest allowed rate (bytes/second). PEAK_RATE Aerage Rate attribute The aerage allowed rate (bytes/second). AVERAGE_RATE or AR Bucket Depth attribute The bucket depth for the profile. BUCKET_DEPTH or BD Guaranteed Rate attribute The guaranteed rate for the policy (only applicable if Serice_Class is 'Integrated Serices Guaranteed Rate'). GUARANTEED_RATE or GR Slack Term attribute 164 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

175 The slack_term for the policy (only applicable if Serice_Class is 'Integrated Serices Guaranteed Rate'). SLACK_TERM TOS In attribute The outgoing TOS (compliant) (Differentiated Serices Only). TOS_IN TOS Out attribute The outgoing TOS (non-compliant) (Differentiated Serices Only). TOS_OUT Max Packet Size attribute Do not apply this rule to packets larger than this size. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MAX_PACKET_SIZE or MPS Min Packet Size attribute Do not apply this rule to packets smaller than this size. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Chapter 4. Attributes reference 165

176 MIN_PACKET_SIZE or MPS0 Num Connections attribute The total number of connections for this profile. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) NUM_CONNECTIONS or NC Bytes Xmited attribute The total number of bytes transmitted. BYTES_XMITED or BX Packets Xmited attribute The total number of packets transmitted. PACKETS_XMITED or PX In Profile Bytes Xmited attribute The total number of in-profile bytes transmitted. IN_PROFILE_BYTES_XMITED or IPBX In Profile Packets Xmited attribute 166 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

177 System Call attribute group The total number of in-profile packets transmitted. IN_PROFILE_PACKETS_XMITED or IPPX This attribute group contains system call rate information. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the System Call attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Num Syscalls per Sec attribute The total system calls per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Chapter 4. Attributes reference 167

178 NUM_SYSCALLS_PER_SEC or NSPS Reads per Sec attribute The read system calls per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) READS_PER_SEC or RPS Writes per Sec attribute The write system calls per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) WRITES_PER_SEC or WPS Forks per Sec attribute The fork system calls per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) FORKS_PER_SEC or FPS 168 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

179 System IO attribute group Execs per Sec attribute The exec system calls per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) EXECS_PER_SEC or EPS This attribute group contains information related to System IO. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the System IO attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Syscall Read Chars per Sec attribute The KBs read through the read sys call per second. Chapter 4. Attributes reference 169

180 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) SYSCALL_READ_CHARS_PER_SEC or SRCPS Syscall Write Chars per Sec attribute The KBs written through the write sys call per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) SYSCALL_WRITE_CHARS_PER_SEC or SWCPS Logical Blk Buffer Cache Reads per Sec attribute The logical reads from a block deice through the buffer cache per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) LOGICAL_BLK_BUFFER_CACHE_READS_PER_SEC or LBBCRPS Logical Blk Buffer Cache Writes per Sec attribute The logical writes to a block deice through the buffer cache per second. 170 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

181 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) LOGICAL_BLK_BUFFER_CACHE_WRITES_PER_SEC or LBBCWPS Phys Blk Buffer Cache Reads per Sec attribute The physical 4K reads from a block deice to buffer cache per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PHYS_BLK_BUFFER_CACHE_READS_PER_SEC or PBBCRPS Phys Blk Buffer Cache Writes per Sec attribute The physical 4K writes to a block deice from buffer cache per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PHYS_BLK_BUFFER_CACHE_WRITES_PER_SEC or PBBCWPS Phys Raw Reads per Sec attribute The physical reads directly from a raw deice per second. Chapter 4. Attributes reference 171

182 TADDM attribute group Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PHYS_RAW_READS_PER_SEC or PRRPS Phys Raw Writes per Sec attribute The physical writes directly to a raw deice per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PHYS_RAW_WRITES_PER_SEC or PRWPS This attribute group contains the CEC identification information required by the Tioli Application Dependency Discoery Manager (TADDM) application. Historical group This attribute group is not part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the TADDM attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute 172 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

183 The local time at the agent when the data was collected. TIMESTAMP CEC Mfg attribute The name of the CEC manufacturer (IBM). CEC_MFG CEC Model attribute The CEC system model number. CEC_MODEL CEC SN attribute The CEC system serial number. CEC_SN LPAR Num attribute The LPAR identification number. Integer (32-bit gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: LPAR_NUM Chapter 4. Attributes reference 173

184 TCP attribute group This attribute group contains system-wide TCP networking information. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the TCP attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Connections Initiated per Sec attribute The TCP connections initiated per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) CONNECTIONS_INITIATED_PER_SEC or CIPS Connections Established per Sec attribute The TCP connections established per second. 174 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

185 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) CONNECTIONS_ESTABLISHED_PER_SEC or CEPS Connections Closed per Sec attribute The TCP connections closed per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) CONNECTIONS_CLOSED_PER_SEC or CCPS Total Packets Sent per Sec attribute The TCP packets sent per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) TOTAL_PACKETS_SENT_PER_SEC or TPSPS Data Packets Sent per Sec attribute The TCP data packets sent per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Chapter 4. Attributes reference 175

186 Not_Collected (-1) DATA_PACKETS_SENT_PER_SEC or DPSPS Data Sent KB per Sec attribute The TCP data KBs sent per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) DATA_SENT_KB_PER_SEC or DSKPS Data Pkt Retransmitted per Sec attribute The TCP data packets retransmitted per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) DATA_PKT_RETRANSMITTED_PER_SEC or DPRPS Ack Only Pkt Sent per Sec attribute The TCP ack-only packets sent per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) 176 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

187 ACK_ONLY_PKT_SENT_PER_SEC or AOPSPS Total Packets Receied per Sec attribute The TCP total packets receied per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) TOTAL_PACKETS_RECEIVED_PER_SEC or TPRPS Ack Pkt Receied per Sec attribute The TCP ack packets receied per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) ACK_PKT_RECEIVED_PER_SEC or APRPS Top 50 CPU Processes attribute group This attribute group contains the processes that are the top 50 CPU users. Historical group This attribute group is not part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Top 50 CPU Processes attribute group: Chapter 4. Attributes reference 177

188 Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Name attribute The process name. NAME ID attribute - This attribute is a key attribute. The process identification number. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) ID CPU Pct attribute The percentage of CPU utilized by the process. Real number (gauge) with 1 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: 178 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

189 Not_Collected (-10) CPU_PCT Memory KB attribute The amount of memory utilized by the process (KB). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MEMORY_KB Owner attribute The system user name that owns the process. OWNER Full Path attribute The full path of the command (with options). FULL_PATH Top 50 Memory Processes attribute group This attribute group contains the processes that are the top 50 memory users. Historical group This attribute group is not part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Top 50 Memory Processes attribute group: Chapter 4. Attributes reference 179

190 Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Name attribute The process name. NAME ID attribute - This attribute is a key attribute. The process identification number. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) ID CPU Pct attribute The percentage of CPU utilized by the process. Real number (gauge) with 1 decimal places of precision with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: 180 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

191 Not_Collected (-10) CPU_PCT Memory KB attribute The amount of memory utilized by the process (KB). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MEMORY_KB Owner attribute The system user name that owns the process. OWNER Full Path attribute The full path of the command (with options). FULL_PATH Virtual Memory Management attribute group This attribute group contains information about irtual memory management for the system. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Chapter 4. Attributes reference 181

192 Attribute descriptions The following list contains information about each attribute in the Virtual Memory Management attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Pages Read per Sec attribute The number of 4K pages read by VMM per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PAGES_READ_PER_SEC or PRPS Pages Written per Sec attribute The number of 4K pages written by VMM per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) 182 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

193 PAGES_WRITTEN_PER_SEC or PWPS Paging Space Read per Sec attribute The number of 4K pages read from paging space by VMM per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PAGING_SPACE_READ_PER_SEC or PSRPS Paging Space Written per Sec attribute The number of 4K pages written to paging space by VMM per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PAGING_SPACE_WRITTEN_PER_SEC or PSWPS Zero Fill per Sec attribute The page faults satisfied by zero-filling memory frames per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Chapter 4. Attributes reference 183

194 ZERO_FILL_PER_SEC or ZFPS Pagein Wait per Sec attribute The process waits because of page-ins per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PAGEIN_WAIT_PER_SEC or PWPS0 Page Fault per Sec attribute The total page faults per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PAGE_FAULT_PER_SEC or PFPS Page Reclaim per Sec attribute The page faults satisfied by page reclaims per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PAGE_RECLAIM_PER_SEC or PRPS0 184 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

195 Steals per Sec attribute The physical memory 4K frames stolen by VMM per second. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) STEALS_PER_SEC or SPS Memory Not Pinned attribute The number of 4K memory pages that are not pinned. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MEMORY_NOT_PINNED or MNP Comp Repage Pct attribute The percentage of repage requests coming from computational segments. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) COMP_REPAGE_PCT or CRP Noncomp Repage Pct attribute Chapter 4. Attributes reference 185

196 The percentage of repage requests coming from non-computational segments. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) NONCOMP_REPAGE_PCT or NRP Pending Client Pageout attribute The total number of client (remote file) page replacement page-outs pending. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) PENDING_CLIENT_PAGEOUT or PCP Volume Groups attribute group This attribute group contains olume group information. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Volume Groups attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. 186 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

197 NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP Name attribute - This attribute is a key attribute. The name of the olume group. NAME State attribute The state of the olume group. STATE Number of Logical Volumes attribute The number of logical olumes currently in the olume group. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) NUMBER_OF_LOGICAL_VOLUMES or NOLV Number of Physical Volumes attribute The total number of physical olumes within the olume group. Chapter 4. Attributes reference 187

198 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) NUMBER_OF_PHYSICAL_VOLUMES or NOPV Number of Actie Physical Volumes attribute The number of physical olumes that are currently actie. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) NUMBER_OF_ACTIVE_PHYSICAL_VOLUMES or NOAPV Number of Stale Physical Volumes attribute The number of physical olumes that are not current. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) NUMBER_OF_STALE_PHYSICAL_VOLUMES or NOSPV Size MB attribute The size of the olume group in MB. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: 188 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

199 Not_Collected (-1) SIZE_MB Free MB attribute The amount of aailable space in the olume group in MB. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) FREE_MB Used MB attribute The amount of used space in the olume group in MB. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) USED_MB Free Pct attribute The percentage of free space in the olume group. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Chapter 4. Attributes reference 189

200 FREE_PCT Used Pct attribute The percentage of space used in the olume group. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) USED_PCT Workload Manager attribute group This attribute group contains workload manager (WLM) class information. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the Workload Manager attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP 190 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

201 Class Name attribute - This attribute is a key attribute. The name of the WLM class. A class is a collection of processes (jobs) with a single set of resource limits applied to it. CLASS_NAME Tier Num attribute The tier number (0-9) to which the WLM class belongs. This number defines the relatie priority of a class (0 is high, 9 is low). Integer (32-bit gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: TIER_NUM CPU Consumed Pct attribute The percentage of the total CPU consumed within an interal by all threads in the class. (total CPU for class/total CPU aailable). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) CPU_CONSUMED_PCT or CCP CPU Desired Pct attribute The desired percentage of CPU resource to allocate to the class. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Chapter 4. Attributes reference 191

202 Not_Collected (-1) CPU_DESIRED_PCT or CDP CPU total attribute The sum of all CPU cycles consumed by all threads in the class. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) CPU_TOTAL CPU shares attribute The number of CPU shares to be allocated to the class ( ). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) CPU_SHARES CPU min attribute The minimum percentage of CPU that must be made aailable when requested. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) 192 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

203 CPU_MIN CPU Soft Max attribute The maximum percentage of CPU that can be made aailable to the class when there is CPU contention. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) CPU_SOFT_MAX or CSM CPU Hard Max attribute The maximum percentage of CPU that can be aailable to the class when there is no CPU contention. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) CPU_HARD_MAX or CHM Mem Consumed Pct attribute The percentage of total memory consumed (within an interal) by all threads in the class. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Chapter 4. Attributes reference 193

204 MEM_CONSUMED_PCT or MCP Mem Desired Pct attribute The desired percentage of memory resources to allocate to the class. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MEM_DESIRED_PCT or MDP Mem total attribute The sum of all memory consumed by all threads in the class. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MEM_TOTAL Mem shares attribute The number of memory shares to be allocated to the class ( ). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) 194 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

205 MEM_SHARES Mem min attribute The minimum percentage of memory that must be made aailable when requested. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MEM_MIN Mem Soft Max attribute The maximum percentage of memory that can be made aailable to the class when there is memory contention. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MEM_SOFT_MAX or MSM Mem Hard Max attribute The maximum percentage of memory that can be aailable to the class when there is no memory contention. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Chapter 4. Attributes reference 195

206 MEM_HARD_MAX or MHM Disk Consumed Pct attribute The percentage of total disk resources consumed (within an interal) by all threads in the class. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) DISK_CONSUMED_PCT or DCP Disk Desired Pct attribute The desired percentage of disk resources to allocate to the class. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) DISK_DESIRED_PCT or DDP Disk total attribute The sum of all the disk resources consumed by all threads in the class. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) 196 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

207 DISK_TOTAL Disk shares attribute The number of disk shares to be allocated to the class ( ). Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) DISK_SHARES or DS Disk min attribute The minimum percentage of disk resource that must be made aailable when requested. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) DISK_MIN Disk Soft Max attribute The maximum percentage of disk resource that can be made aailable to the class when there is disk contention. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Chapter 4. Attributes reference 197

208 WPAR CPU attribute group DISK_SOFT_MAX or DSM Disk Hard Max attribute The maximum percentage of disk resource that can be made aailable to the class when there is no disk contention. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) DISK_HARD_MAX or DHM This attribute group contains CPU usage information for WPARs. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the WPAR CPU attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP 198 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

209 WPAR Name attribute - This attribute is a key attribute. The name of the WPAR. WPAR_NAME User CPU Pct attribute The time this WPAR spent running in CPU user mode percentage. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) USER_CPU_PCT or UCP System CPU Pct attribute The time this WPAR spent running in CPU kernel mode percentage. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) SYSTEM_CPU_PCT or SCP Num CPUs Consumed attribute The number of physical processors consumed by the WPAR when the LPAR is in shared processor mode. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Chapter 4. Attributes reference 199

210 Not_Collected (-1) NUM_CPUS_CONSUMED or NCC WPAR CPU Consumed Pct attribute The percentage of its CPU share consumed by the WPAR. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) WPAR_CPU_CONSUMED_PCT or WCCP LPAR CPU Consumed Pct attribute The percentage of CPU entitlement of the LPAR consumed by the WPAR. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) LPAR_CPU_CONSUMED_PCT or LCCP CPU Consumption Limit attribute The maximum number of physical processors that a WPAR is allowed to consume. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) 200 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

211 CPU_CONSUMPTION_LIMIT or CCL RC CPU Limits Hard Max attribute The maximum percentage CPU that a WPAR can hae een if there is no contention for CPU. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) RC_CPU_LIMITS_HARD_MAX or RCLHM LPAR Entitlement attribute The number of entitlement units assigned to this LPAR. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) LPAR_ENTITLEMENT or LE WPAR FileSystem attribute group This attribute group contains file system information for WPARs. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Chapter 4. Attributes reference 201

212 Attribute descriptions The following list contains information about each attribute in the WPAR FileSystem attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP WPAR Name attribute The name of the WPAR. WPAR_NAME Mount Point attribute - This attribute is a key attribute. The file system mount point. MOUNT_POINT or MP Deice Name attribute The file system mounted. DEVICE_NAME or DN VFS attribute The irtual file system type. 202 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

213 VFS_TYPE Node Name attribute The name of the remote node. NODE_NAME Mount Options attribute The specified mount options. MOUNT_OPTIONS or MO WPAR Information attribute group This attribute group contains the general configuration parameters of the WPARs. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the WPAR Information attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. Chapter 4. Attributes reference 203

214 TIMESTAMP WPAR Name attribute - This attribute is a key attribute. The name of the WPAR. WPAR_NAME attribute The type of the WPAR. Integer with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Application (0) System (1) TYPE State attribute The current state of the WPAR. Integer with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Defined (0) Loaded (1) Actie (2) Frozen (3) Paused (4) Transitional (5) Broken (6) STATE Owner attribute The user ID that owns the WPAR. 204 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

215 OWNER Hostname attribute The host name for the WPAR. HOSTNAME Home attribute The home directory for the WPAR. HOME Autostart attribute Indicates whether the WPAR starts on reboot. Integer with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: No (0) Yes (1) AUTOSTART Shares usr Dir attribute Indicates whether the WPAR shares its /usr file system with the LPAR. Integer with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: No (0) Yes (1) Chapter 4. Attributes reference 205

216 SHARES_USR_DIR or SUD Checkpointable attribute Indicates whether the WPAR can be checkpointed or not. Integer with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: No (0) Yes (1) CHECKPOINTABLE or C WPAR Application Path attribute The full path of the executable file to run inside the Application WPAR. WPAR_APPLICATION_PATH or WAP RC Is Actie attribute Indicates whether the resource controls are actie or not. Integer with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: No (0) Yes (1) RC_IS_ACTIVE or RIA RC RSet attribute The name of the configured Resource Set. RC_RSET 206 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

217 RC CPU Shares attribute The number of CPU shares for this WPAR. RC_CPU_SHARES or RCS RC CPU Limits Min attribute The minimum percentage of CPU that is guaranteed to the WPAR. RC_CPU_LIMITS_MIN or RCLM RC CPU Limits Soft Max attribute The maximum percentage of CPU that a WPAR can hae when there is a contention for CPU. RC_CPU_LIMITS_SOFT_MAX or RCLSM RC CPU Limits Hard Max attribute The maximum percentage of CPU that a WPAR can hae een if there is no contention for CPU. RC_CPU_LIMITS_HARD_MAX or RCLHM RC Memory Shares attribute The number of memory shares for this WPAR. RC_MEMORY_SHARES or RMS RC Memory Limits Min attribute The minimum percentage of memory that is guaranteed to the WPAR. Chapter 4. Attributes reference 207

218 RC_MEMORY_LIMITS_MIN or RMLM RC Memory Limits Soft Max attribute The maximum percentage of memory that a WPAR can hae when there is a contention for memory. RC_MEMORY_LIMITS_SOFT_MAX or RMLSM RC Memory Limits Hard Max attribute The maximum percentage of memory that a WPAR can hae een if there is no contention for memory. RC_MEMORY_LIMITS_HARD_MAX or RMLHM RC per Process VM Limit attribute The maximum amount of irtual memory that a process in the WPAR can consume. RC_PER_PROCESS_VM_LIMIT or RPPVL RC Max Processes attribute The total number of processes allowed in the WPAR. RC_MAX_PROCESSES or RMP RC Max Threads attribute The total number of threads allowed in the WPAR. RC_MAX_THREADS or RMT Admin Operation attribute 208 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

219 The administratie operation being performed. ADMIN_OPERATION or AO Admin Process ID attribute The PID of the administratie operation being performed. ADMIN_PROCESS_ID or API Admin Start Time attribute The time when the administratie operation started. ADMIN_START_TIME or AST IP Address attribute The IP or Network address of the network interface. IP_ADDRESS WPAR Network attribute group This attribute group contains network related information for WPARs. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the WPAR Network attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. Chapter 4. Attributes reference 209

220 NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP WPAR Name attribute - This attribute is a key attribute. The name of the WPAR. WPAR_NAME Interface Name attribute The name of the network interface. INTERFACE_NAME or IN IP Address attribute The IP or network address of the network interface. IP_ADDRESS Network Mask attribute The internet network mask. NETWORK_MASK or NM Broadcast IP attribute The broadcast IP address. 210 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

221 BROADCAST_IP or BI WPAR Physical Memory attribute group This attribute group contains memory usage information for WPARs. Historical group This attribute group is part of the default historical group, and is eligible for use with Tioli Data Warehouse. Attribute descriptions The following list contains information about each attribute in the WPAR Physical Memory attribute group: Node attribute - This attribute is a key attribute. The managed system name of the agent. NODE Timestamp attribute The local time at the agent when the data was collected. TIMESTAMP WPAR Name attribute - This attribute is a key attribute. The name of the WPAR. WPAR_NAME Memory Size MB attribute The total amount of physical memory aailable to the WPAR in MB. Chapter 4. Attributes reference 211

222 Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) MEMORY_SIZE_MB or MSM Used Memory MB attribute The amount of used (allocated) memory in the WPAR in MB. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) USED_MEMORY_MB or UMM Free Memory MB attribute The amount of free (unallocated) memory in the WPAR in MB. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) FREE_MEMORY_MB or FMM Free Memory Pct attribute The percentage of free memory in the WPAR. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: 212 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

223 Not_Collected (-1) FREE_MEMORY_PCT or FMP Used Memory Pct attribute The percentage of used memory in the WPAR. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) USED_MEMORY_PCT or UMP LPAR Memory Used Pct attribute The percentage of LPAR memory used by the WPAR. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) LPAR_MEMORY_USED_PCT or LMUP RC Memory Limits Hard Max attribute The maximum percentage of memory that a WPAR can hae een if there is no contention for memory. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) Chapter 4. Attributes reference 213

224 RC_MEMORY_LIMITS_HARD_MAX or RMLHM LPAR Memory Size MB attribute The total amount of physical memory aailable to the LPAR in MB. Integer (gauge) with enumerated alues. The strings are displayed in the Tioli Enterprise Portal. The warehouse and queries return the alues shown in parentheses. The following alues are defined: Not_Collected (-1) LPAR_MEMORY_SIZE_MB or LMSM Disk capacity planning for historical data Disk capacity planning for a monitoring agent is a prediction of the amount of disk space to be consumed for each attribute group with historical data that is being collected. Required disk storage is an important factor when you are defining data collection rules and your strategy for historical data collection. The table in this chapter proides the following information required to calculate disk space for this monitoring agent: Table is the table name as it is displayed in the warehouse database, if the attribute group is configured to be written to the warehouse. The table name listed here corresponds to the table name in Attribute groups and attributes for the AIX Premium Agent on page 21 Attribute group is the name of the attribute group used to create the table in the warehouse database if it is short enough to fit in the table naming constraints of the database being used for the warehouse. The attribute group name listed here corresponds to the Warehouse table name in Attribute groups and attributes for the AIX Premium Agent on page 21. Bytes per instance (agent) is an estimate of the record length for each row or instance written to the agent disk for historical data collection. This estimate can be used for agent disk space planning purposes. Database bytes per instance (warehouse) is an estimate of the record length for detailed records written to the warehouse database, if the attribute group is configured to be written to the warehouse. Detailed records are records that hae been uploaded from the agent for long-term historical data collection. This estimate can be used for warehouse disk space planning purposes. Aggregate bytes per instance (warehouse) is an estimate of the record length for aggregate records written to the warehouse database, if the attribute group is configured to be written to the warehouse. Aggregate records are created by the 214 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

225 Summarization agent for attribute groups that hae been configured for summarization. This estimate can be used for warehouse disk space planning purposes. In addition to the information in the tables, you must know the number of instances of data that you plan to collect. An attribute group can hae single or multiple instances of data depending on the application enironment that is being monitored. For example, if your attribute group is monitoring each processor in your computer and you hae a dual processor computer, the number of instances is two. The following table contains capacity planning information for the data logged by IBM Tioli Monitoring: AIX Premium Agent. Table 1. Capacity planning for historical data logged by IBM Tioli Monitoring: AIX Premium Agent Database bytes per instance (warehouse) Table Attribute group Bytes per instance (agent) KPX55AME KPX_ACTIVE_MEMORY_EXPANSION KPX42ACTIV KPX_ACTIVE_USERS KPX53MPOOL KPX_AMS_POOL KPX09CPUDE KPX_CPU_DETAIL KPX08CPUSU KPX_CPU_SUMMARY KPX41DEFIN KPX_DEFINED_USERS KPX51DEVIC KPX_DEVICES KPX26DISKS KPX_DISKS KPX30FILES KPX_FILE_SYSTEMS KPX36INTER KPX_INTERNET_PROTOCOL_DETAIL KPX35INTER KPX_INTERNET_PROTOCOL_SUMMARY KPX14LOGIC KPX_LOGICAL_PARTITION KPX29LOGIC KPX_LOGICAL_VOLUMES KPX52MPIOA KPX_MPIO_ATTRIBUTES KPX51MPIOS KPX_MPIO_STATUS KPX34NETWO KPX_NETWORK_ADAPTERS_RATES KPX33NETWO KPX_NETWORK_ADAPTERS_TOTALS KPX32NETWO KPX_NETWORK_INTERFACES KPX16NIMRE KPX_NIM_RESOURCES KPX13PAGIN KPX_PAGING_SPACE KPXPOBJST KPX_PERFORMANCE_OBJECT_STATUS KPX19PHYSI KPX_PHYSICAL_MEMORY KPX27PHYSI KPX_PHYSICAL_VOLUMES KPX17PRINT KPX_PRINT_QUEUES KPX24PROCE KPX_PROCESSES_DETAIL KPX23PROCE KPX_PROCESSES_SUMMARY KPX54QOS KPX_QUALITY_OF_SERVICE KPX12SYSTE KPX_SYSTEM_CALL Aggregate bytes per instance (warehouse) Chapter 4. Attributes reference 215

226 Table 1. Capacity planning for historical data logged by IBM Tioli Monitoring: AIX Premium Agent (continued) Database bytes per instance (warehouse) Table Attribute group Bytes per instance (agent) KPX11SYSTE KPX_SYSTEM_IO KPX56TADDM KPX_TADDM KPX37TCP KPX_TCP KPX02TOP50 KPX_TOP_50_CPU_PROCESSES KPX03TOP50 KPX_TOP_50_MEMORY_PROCESSES KPX20VIRTU KPX_VIRTUAL_MEMORY_MANAGEMENT KPX28VOLUM KPX_VOLUME_GROUPS KPX15WORKL KPX_WORKLOAD_MANAGER KPX46WPARC KPX_WPAR_CPU KPX49WPFIL KPX_WPAR_FILESYSTEM KPX50WPINF KPX_WPAR_INFORMATION KPX48WPNET KPX_WPAR_NETWORK KPX47WPPHM KPX_WPAR_PHYSICAL_MEMORY Aggregate bytes per instance (warehouse) For more information about historical data collection, see the IBM Tioli Monitoring Administrator's Guide. 216 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

227 Chapter 5. Situations reference About situations This chapter contains an oeriew of situations, references for detailed information about situations, and descriptions of the predefined situations included in this monitoring agent. A situation is a logical expression inoling one or more system conditions. Situations are used to monitor the condition of systems in your network. You can manage situations from Tioli Enterprise Portal by using the Situation Editor. The monitoring agents that you use to monitor your system enironment include a set of predefined situations that you can use as-is. You can also create new situations to meet your requirements. Predefined situations contain attributes that check for system conditions common to many enterprises. Using predefined situations can improe the speed with which you can begin using the AIX Premium Agent. You can change the conditions or alues being monitored by a predefined situation to the conditions or alues best suited to your enterprise. You can display predefined situations and create your own situations using the Situation Editor. The left frame of the Situation editor initially lists the situations associated with the Naigator item that you selected. When you click a situation name or create a situation, the right frame opens with the following tabs: Formula Formula describing condition being tested. Distribution List of managed systems (operating systems, subsystems, or applications) to which the situation can be distributed. All the AIX Premium Agent managed systems are assigned by default. Expert adice Comments and instructions to be read in the eent workspace. Action Command to be sent to the system. Until More information about situations Options to close the eent after a period of time, or when another situation becomes true. The Tioli Enterprise Portal User's Guide contains more information about predefined and custom situations and how to use them to respond to alerts. For a list of the predefined situations for this monitoring agent and a description of each situation, see the Predefined situations section in this chapter and the information in that section for each indiidual situation. Copyright IBM Corp. 2007,

228 Predefined situations This monitoring agent contains the following predefined situations, which are organized by Naigator item. AIX Premium Not applicable Memory KPX_memrepage_Info KPX_mm_pginwait_Info KPX_mm_pgfault_Info KPX_mm_pgreclm_Info KPX_mm_unpin_low_Warn KPX_mm_pgout_pend_Info KPX_AME_CPU_Used_High_Warn KPX_AME_Deficit_Mem_Warn Networking KPX_Pkts_Sent_Errors_Info KPX_Sent_Pkts_Dropped_Info KPX_Pkts_Rec_Errors_Info KPX_Bad_Pkts_Recd_Info KPX_Rec_pkts_dropped_Info KPX_Qoerflow_Info KPX_Netwk_Bandwidth_High_Info KPX_Media_Spd_Half_Duplex_Warn KPX_perip_InputErrs_Info KPX_perip_InputPkts_Drop_Info KPX_perip_OutputErrs_Info KPX_TCP_ConnInit_Info KPX_TCP_ConnEst_Info Process KPX_totproc_cs_Info KPX_totproc_runq_ag_Info KPX_totproc_load_ag_Info KPX_totnum_procs_Info KPX_perproc_IO_pgf_Info KPX_perproc_nonIO_pgf_Info KPX_perproc_memres_datasz_Info KPX_perproc_memres_textsz_Info KPX_perproc_mem_textsz_Info KPX_perproc_ol_cs_Info Status KPX_Deice_Stopped_Warn Storage KPX_Actie_Disk_Pct_Info KPX_Ag_Read_Transfer_MS_Info 218 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

229 KPX_Read_Timeouts_Per_Sec_Info KPX_Failed_Read_Per_Sec_Info KPX_Ag_Write_Transfer_MS_Info KPX_Write_Timeout_Per_Sec_Info KPX_Failed_Writes_Per_Sec_Info KPX_Ag_Req_In_WaitQ_MS_Info KPX_SericeQ_Full_Per_Sec_Info System KPX_PHYP_Pct_High_Info KPX_Reduced_Proc_Freq_Info KPX_perCPU_syscalls_Info KPX_perCPU_forks_Info KPX_perCPU_execs_Info KPX_perCPU_cs_Info KPX_Tot_syscalls_Info KPX_Tot_forks_Info KPX_Tot_execs_Info KPX_LPARBusy_pct_Warn KPX_LPARPhyBusy_pct_Warn KPX_LPARcs_Info KPX_LPARfreepool_Warn KPX_LPARPhanIntrs_Info KPX_LPARentused_Info KPX_LPARphyp_used_Info KPX_LPAR_MaxCPUCapUsed_Info KPX_LPAR_Moed_Info Top Resources Not applicable User KPX_user_acct_locked_Info KPX_user_login_retries_Info KPX_user_idletime_Info WPAR KPX_WPAR_CPU_Usage_Warn KPX_WPAR_Mem_Usage_Warn KPX_WPAR_Broken_Warn KPX_WPAR_RC_Inactie_Info KPX_WPAR_Unlim_CPU_Shares_Info KPX_WPAR_Min_CPU_Limit_Info KPX_WPAR_Unlim_Mem_Shares_Info KPX_WPAR_Min_Mem_Limit_Info KPX_WPAR_Admin_Op_Info The remaining sections of this chapter contain descriptions of each of these situations. The situations are organized by Naigator item. The following information is proided about each situation: Chapter 5. Situations reference 219

230 AIX Premium Naigator item Memory Naigator item Information about the conditions that the situation tests. Formula Syntax that contains one or more logical expressions describing the conditions for the situation to monitor. Distribution Whether the situation is automatically distributed to instances of the agent or is aailable for manual distribution. Run at startup Whether the situation starts monitoring when the agent starts. Sampling interal Number of seconds that elapses between one sample of data that the monitoring agent collects for the serer and the next sample. Situation persistence Whether the conditions specified in the situation ealuate to "true" for the defined number of occurrences in a row before the situation is raised. The default of one means no persistence-checking takes place. Seerity Seerity of the predefined eents: Warning, Informational, or Critical. Clearing conditions Controls when a true situation closes: after a period of time, when another situation is true, or whicheer occurs first if both are selected. No predefined situations are included for this Naigator item. KPX_memrepage_Info situation The Physical Memory Repaging rate is high. The situation will be ealuated for the table. Formula *IF *VALUE KPX_PHYSICAL_MEMORY.Repaging_Rate *GT 10 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute 220 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

231 Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_mm_pginwait_Info situation The Virtual Memory Manager Page-In wait is higher than expected. The situation will be ealuated for the table. Formula *IF *VALUE KPX_VIRTUAL_MEMORY_MANAGEMENT.Pagein_Wait_per_Sec *GT 1000 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_mm_pgfault_Info situation The VMM Page fault rate is higher than expected. The situation will be ealuated for the table. Formula *IF *VALUE KPX_VIRTUAL_MEMORY_MANAGEMENT.Page_Fault_per_Sec *GT 1000 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Chapter 5. Situations reference 221

232 Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_mm_pgreclm_Info situation The Virtual Memory Manager Page Reclaim is higher than expected. The situation will be ealuated for the table. Formula *IF *VALUE KPX_VIRTUAL_MEMORY_MANAGEMENT.Page_Reclaim_per_Sec *GT 1000 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. 222 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

233 KPX_mm_unpin_low_Warn situation The amount of pinned memory is higher than expected. The situation will be ealuated for the table. Formula *IF *VALUE KPX_VIRTUAL_MEMORY_MANAGEMENT.Memory_Not_Pinned *LT 100 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Warning Clearing conditions The situation clears when the condition becomes false. KPX_mm_pgout_pend_Info situation The VMM page-outs pending is higher than expected. The situation will be ealuated for the table. Formula *IF *VALUE KPX_VIRTUAL_MEMORY_MANAGEMENT.Pending_Client_Pageout *GT 100 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Chapter 5. Situations reference 223

234 Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_AME_CPU_Used_High_Warn situation The CPU used for memory compression is higher than expected. The situation will be ealuated for the table. Formula *IF *VALUE KPX_ACTIVE_MEMORY_EXPANSION.CPU_Used_Pct *GT 25 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 30 seconds Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 2. Seerity Warning Clearing conditions The situation clears when the condition becomes false. KPX_AME_Deficit_Mem_Warn situation AME Deficit memory is greater than zero. The situation will be ealuated for the table. Formula *IF *VALUE KPX_ACTIVE_MEMORY_EXPANSION.Deficit_Memory_MB *GT 0 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. 224 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

235 Distribution This situation is aailable for distribution. Run at startup No Sampling interal 30 seconds Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 2. Seerity Warning Networking Naigator item Clearing conditions The situation clears when the condition becomes false. KPX_Pkts_Sent_Errors_Info situation The packets sent error rate is higher than normal. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_NETWORK_ADAPTERS_RATES.Pkts_Sent_Errors_per_Sec *GT 10 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. Chapter 5. Situations reference 225

236 KPX_Sent_Pkts_Dropped_Info situation The rate of dropped packets is higher than normal. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_NETWORK_ADAPTERS_RATES.Sent_Pkts_Dropped_per_Sec *GT 10 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_Pkts_Rec_Errors_Info situation The packets receied error rate is higher than normal. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_NETWORK_ADAPTERS_RATES.Pkts_Rec_Errors_per_Sec *GT 10 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute 226 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

237 Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_Bad_Pkts_Recd_Info situation The rate that bad packets are receied is higher than normal. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_NETWORK_ADAPTERS_RATES.Bad_Pkts_Recd_per_Sec *GT 10 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_Rec_pkts_dropped_Info situation Rate that receied packets are dropped is higher than normal. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_NETWORK_ADAPTERS_RATES.Rec_Pkts_Dropped_per_Sec *GT 10 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Chapter 5. Situations reference 227

238 Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_Qoerflow_Info situation The transmit queue oerflow rate is higher than normal. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_NETWORK_ADAPTERS_RATES.Qoerflow_per_Sec *GT 10 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. 228 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

239 KPX_Netwk_Bandwidth_High_Info situation Bandwidth utilization for the interface is higher than expected. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_NETWORK_ADAPTERS_RATES.Bandwidth_Util_Pct *GT 60 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is automatically distributed to instances of this agent. Run at startup Yes Sampling interal 10 minutes Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 3. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_Media_Spd_Half_Duplex_Warn situation Media speed selected is set to half duplex. The situation will be ealuated for each distinct alue of Parent. Formula *IF *VALUE KPX_NETWORK_ADAPTERS_RATES.Media_Speed_Running *EQ Half Duplex See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is automatically distributed to instances of this agent. Run at startup Yes Sampling interal 30 seconds Chapter 5. Situations reference 229

240 Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 1. Seerity Warning Clearing conditions The situation clears when the condition becomes false. KPX_perip_InputErrs_Info situation The Internet Protocol input error rate is high. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_INTERNET_PROTOCOL_DETAIL.Input_Errors_per_Sec *GT 100 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_perip_InputPkts_Drop_Info situation The IP input packets dropped rate is higher than expected. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_INTERNET_PROTOCOL_DETAIL.Input_Packets_Dropped_per_Sec *GT 100 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. 230 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

241 Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_perip_OutputErrs_Info situation The Internet Protocol output error rate is higher than expected. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_INTERNET_PROTOCOL_DETAIL.Output_Errors_per_Sec *GT 100 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. Chapter 5. Situations reference 231

242 KPX_TCP_ConnInit_Info situation The number of TCP connections initiated is high. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_TCP.Connections_Initiated_per_Sec *GT 1000 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_TCP_ConnEst_Info situation The Number of TCP connections established is high. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_TCP.Connections_Established_per_Sec *GT 1000 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute 232 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

243 Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Process Naigator item Clearing conditions The situation clears when the condition becomes false. KPX_totproc_cs_Info situation The number of Process Context Switches is higher than expected. The situation will be ealuated for the table. Formula *IF *VALUE KPX_PROCESSES_SUMMARY.Process_Context_Switches_per_Sec *GT 1000 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_totproc_runq_ag_Info situation The process run queue is higher than expected. The situation will be ealuated for the table. Formula *IF *VALUE KPX_PROCESSES_SUMMARY.Run_Queue_Ag *GT 10 Chapter 5. Situations reference 233

244 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_totproc_load_ag_Info situation The process load aerage is higher than expected. The situation will be ealuated for the table. Formula *IF *VALUE KPX_PROCESSES_SUMMARY.Load_Ag *GT 10 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. 234 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

245 KPX_totnum_procs_Info situation The total number of processes is higher than expected. The situation will be ealuated for the table. Formula *IF *VALUE KPX_PROCESSES_SUMMARY.Total_Num_Processes *GT 1000 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_perproc_IO_pgf_Info situation The process I/O page fault rate is higher than expected. The situation is ealuated for each distinct alue of the PN attribute. Formula *IF *VALUE KPX_PROCESSES_DETAIL.IO_Page_Fault_per_Sec *GT 10 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Chapter 5. Situations reference 235

246 Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_perproc_nonIO_pgf_Info situation The process non-i/o page fault rate is higher than expected. The situation is ealuated for each distinct alue of the PN attribute. Formula *IF *VALUE KPX_PROCESSES_DETAIL.Non_IO_Page_Fault_per_Sec *GT 100 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_perproc_memres_datasz_Info situation The process resident data size is larger than expected. The situation is ealuated for each distinct alue of the PN attribute. Formula *IF *VALUE KPX_PROCESSES_DETAIL.Resident_Data_Size *GT 100 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. 236 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

247 Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_perproc_memres_textsz_Info situation The process resident text size is larger than expected. The situation is ealuated for each distinct alue of the PN attribute. Formula *IF *VALUE KPX_PROCESSES_DETAIL.Resident_Text_Size *GT 100 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. Chapter 5. Situations reference 237

248 KPX_perproc_mem_textsz_Info situation The process text size is larger than expected. The situation is ealuated for each distinct alue of the PN attribute. Formula *IF *VALUE KPX_PROCESSES_DETAIL.Text_Size *GT 100 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_perproc_ol_cs_Info situation The oluntary context switches rate is higher than expected. The situation is ealuated for each distinct alue of the PN attribute. Formula *IF *VALUE KPX_PROCESSES_DETAIL.Voluntary_Context_Switches_per_Sec *GT 100 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute 238 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

249 Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Status Naigator item Clearing conditions The situation clears when the condition becomes false. KPX_Deice_Stopped_Warn situation Triggers when the status of a deice is not normal. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_DEVICES.State *EQ Stopped See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Warning Storage Naigator item Clearing conditions The situation clears when the condition becomes false. KPX_Actie_Disk_Pct_Info situation The percentage of time the disks are busy is higher than normal. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_DISKS.Actie_Disk_Pct *GT 80 Chapter 5. Situations reference 239

250 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_Ag_Read_Transfer_MS_Info situation The aerage time it takes to complete a disk read is high. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_DISKS.Ag_Read_Transfer_MS *GT 5 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. 240 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

251 KPX_Read_Timeouts_Per_Sec_Info situation The number of disk read timeouts per second is high. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_DISKS.Read_Timeouts_per_Sec *GT 10 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_Failed_Read_Per_Sec_Info situation The number of failed disk read requests per second is high. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_DISKS.Failed_Read_per_Sec *GT 10 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Chapter 5. Situations reference 241

252 Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_Ag_Write_Transfer_MS_Info situation The aerage time it takes to complete a disk write is high. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_DISKS.Ag_Write_Transfer_MS *GT 5 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_Write_Timeout_Per_Sec_Info situation The number of disk write timeouts per second is high. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_DISKS.Write_Timeout_per_Sec *GT 10 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. 242 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

253 Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_Failed_Writes_Per_Sec_Info situation The number of failed disk write requests per second is high. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_DISKS.Failed_Writes_per_Sec *GT 10 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. Chapter 5. Situations reference 243

254 KPX_Ag_Req_In_WaitQ_MS_Info situation The time a disk transfer request is in the wait queue is high. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_DISKS.Ag_Request_In_WaitQ_MS *GT 20 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_SericeQ_Full_Per_Sec_Info situation The rate at which the disk serice queue becomes full is high. The situation is ealuated for each distinct alue of the NAME attribute. Formula *IF *VALUE KPX_DISKS.SericeQ_Full_per_Sec *GT 5 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute 244 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

255 Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational System Naigator item Clearing conditions The situation clears when the condition becomes false. KPX_PHYP_Pct_High_Info situation The percent of time spent in the hyperisor is high. The situation will be ealuated for the table. Formula *IF *VALUE KPX_CPU_SUMMARY.Time_Spent_in_Hyperisor_Pct *GT 3 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 30 seconds Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 2. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_Reduced_Proc_Freq_Info situation The processor is operating at reduced rates. The situation will be ealuated for the table. Formula *IF *VALUE KPX_CPU_SUMMARY.Aerage_Operating_Frequency_Pct *LE 99 *AND *VALUE KPX_CPU_SUMMARY.Aerage_Operating_Frequency_Pct *GE 0 Chapter 5. Situations reference 245

256 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 5 minutes Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 3. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_perCPU_syscalls_Info situation The number of syscalls per CPU is high. The situation is ealuated for each distinct alue of the CPU_NUMBER attribute. Formula *IF *VALUE KPX_CPU_DETAIL.Syscalls_per_Sec *GT See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. 246 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

257 KPX_perCPU_forks_Info situation The number of forks per CPU is high. The situation is ealuated for each distinct alue of the CPU_NUMBER attribute. Formula *IF *VALUE KPX_CPU_DETAIL.Forks_per_Sec *GT 1000 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_perCPU_execs_Info situation The number of execs per CPU is high. The situation is ealuated for each distinct alue of the CPU_NUMBER attribute. Formula *IF *VALUE KPX_CPU_DETAIL.Execs_per_Sec *GT 1000 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Chapter 5. Situations reference 247

258 Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_perCPU_cs_Info situation The number of context switches per CPU is high. The situation is ealuated for each distinct alue of the CPU_NUMBER attribute. Formula *IF *VALUE KPX_CPU_DETAIL.Context_Switches_per_Sec *GT 1000 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_Tot_syscalls_Info situation The total number of syscalls is high. The situation is ealuated for each distinct alue of the CPU_NUMBER attribute. Formula *IF *VALUE KPX_SYSTEM_CALL.Num_Syscalls_per_Sec *GT See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. 248 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

259 Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_Tot_forks_Info situation The total number of forks is high. The situation is ealuated for each distinct alue of the CPU_NUMBER attribute. Formula *IF *VALUE KPX_SYSTEM_CALL.Forks_per_Sec *GT 1000 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. Chapter 5. Situations reference 249

260 KPX_Tot_execs_Info situation The total number of execs is high. The situation is ealuated for each distinct alue of the CPU_NUMBER attribute. Formula *IF *VALUE KPX_SYSTEM_CALL.Execs_per_Sec *GT 1000 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_LPARBusy_pct_Warn situation The LPAR logical busy percentage is high. The situation is ealuated for each distinct alue of the CPU_NUMBER attribute. Formula *IF *VALUE KPX_LOGICAL_PARTITION.Busy_Pct *GT 95 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute 250 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

261 Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Warning Clearing conditions The situation clears when the condition becomes false. KPX_LPARPhyBusy_pct_Warn situation The LPAR physical busy percentage is high. The situation is ealuated for each distinct alue of the CPU_NUMBER attribute. Formula *IF *VALUE KPX_LOGICAL_PARTITION.Phys_Busy_Pct *GT 95 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Warning Clearing conditions The situation clears when the condition becomes false. KPX_LPARcs_Info situation The LPAR irtual context switching rate is high. The situation is ealuated for each distinct alue of the CPU_NUMBER attribute. Formula *IF *VALUE KPX_LOGICAL_PARTITION.Virt_Context_CPU_Switches_per_Sec *GT 1000 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Chapter 5. Situations reference 251

262 Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_LPARfreepool_Warn situation The LPAR CPU free pool space is getting low. The situation is ealuated for each distinct alue of the CPU_NUMBER attribute. Formula *IF *VALUE KPX_LOGICAL_PARTITION.Unallocated_CPU_In_Pool *LT 100 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Warning Clearing conditions The situation clears when the condition becomes false. 252 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

263 KPX_LPARPhanIntrs_Info situation The number of LPAR phantom interrupts is high. The situation is ealuated for each distinct alue of the CPU_NUMBER attribute. Formula *IF *VALUE KPX_LOGICAL_PARTITION.Phantom_Interrupts *GT 100 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_LPARentused_Info situation The LPAR CPU utilization is more than its entitlement. The situation is ealuated for each distinct alue of the CPU_NUMBER attribute. Formula *IF *VALUE KPX_LOGICAL_PARTITION.Entitlement_Pct *GT 100 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Chapter 5. Situations reference 253

264 Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_LPARphyp_used_Info situation The PHYP (hyperisor) is using more CPU than expected. The situation is ealuated for each distinct alue of the CPU_NUMBER attribute. Formula *IF *VALUE KPX_LOGICAL_PARTITION.Time_In_Hyperisor_Pct *GT 1 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_LPAR_MaxCPUCapUsed_Info situation Triggers when Max_CPU_Cap_Used Pct GT 80%. The situation is ealuated for each distinct alue of the CPU_NUMBER attribute. Formula *IF *VALUE KPX_LOGICAL_PARTITION.Max_CPU_Cap_Used_Pct *GT 80 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. 254 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

265 Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_LPAR_Moed_Info situation Triggers when last and current LPAR Machine ID are not equal. The situation is ealuated for each distinct alue of the CPU_NUMBER attribute. Formula *IF *VALUE KPX_LOGICAL_PARTITION.Machine_ID *NE KPX_LOGICAL_PARTITION.Last_Machine_ID See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 1. Seerity Informational Clearing conditions The situation clears when the condition becomes false. Top Resources Naigator item No predefined situations are included for this Naigator item. Chapter 5. Situations reference 255

266 User Naigator item KPX_user_acct_locked_Info situation The user account is locked. The situation is ealuated for each distinct alue of the USER_NAME attribute. Formula *IF *SCAN KPX_DEFINED_USERS.Account_Locked *EQ true See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 hour Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_user_login_retries_Info situation The user login retries is high. The situation is ealuated for each distinct alue of the USER_NAME attribute. Formula *IF *VALUE KPX_DEFINED_USERS.Loginretries *GT 4 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 hour 256 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

267 Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_user_idletime_Info situation The user idle time is longer than expected. The situation is ealuated for each distinct alue of the USER_NAME attribute. Formula *IF *VALUE KPX_ACTIVE_USERS.Idle_Time *GT See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 hour Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 24. Seerity Informational WPAR Naigator item Clearing conditions The situation clears when the condition becomes false. KPX_WPAR_CPU_Usage_Warn situation The WPAR CPU utilization is high. The situation is ealuated for each distinct alue of the WPAR_NAME attribute. Formula *IF *VALUE KPX_WPAR_CPU.WPAR_CPU_Consumed_Pct *GT 95 Chapter 5. Situations reference 257

268 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Warning Clearing conditions The situation clears when the condition becomes false. KPX_WPAR_Mem_Usage_Warn situation The WPAR Memory utilization is high. The situation is ealuated for each distinct alue of the WPAR_NAME attribute. Formula *IF *VALUE KPX_WPAR_PHYSICAL_MEMORY.Used_Memory_Pct *GT 95 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 5. Seerity Warning Clearing conditions The situation clears when the condition becomes false. 258 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

269 KPX_WPAR_Broken_Warn situation A WPAR has entered broken state. The situation is ealuated for each distinct alue of the WPAR_NAME attribute. Formula *IF *SCAN KPX_WPAR_INFORMATION.State *EQ Broken See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 2. Seerity Warning Clearing conditions The situation clears when the condition becomes false. KPX_WPAR_RC_Inactie_Info situation Resource controls are not actie for this WPAR. The situation is ealuated for each distinct alue of the WPAR_NAME attribute. Formula *IF *SCAN KPX_WPAR_INFORMATION.RC_Is_Actie *EQ No See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 hour Chapter 5. Situations reference 259

270 Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 2. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_WPAR_Unlim_CPU_Shares_Info situation The WPAR CPU resource controls are set to unlimited. The situation is ealuated for each distinct alue of the WPAR_NAME attribute. Formula *IF *SCAN KPX_WPAR_INFORMATION.RC_CPU_Shares *EQ Unlimited *AND *VALUE KPX_WPAR_INFORMATION.RC_CPU_Limits_Hard_Max *EQ 100 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 hour Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 2. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_WPAR_Min_CPU_Limit_Info situation The WPAR CPU minimum resource control is not set. The situation is ealuated for each distinct alue of the WPAR_NAME attribute. Formula *IF *VALUE KPX_WPAR_INFORMATION.RC_CPU_Limits_Min *EQ 0 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. 260 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

271 Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 hour Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 2. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_WPAR_Unlim_Mem_Shares_Info situation The WPAR Memory Share Resource Controls are set to unlimited. The situation is ealuated for each distinct alue of the WPAR_NAME attribute. Formula *IF *SCAN KPX_WPAR_INFORMATION.RC_Memory_Shares *EQ Unlimited *AND *VALUE KPX_WPAR_INFORMATION.RC_Memory_Limits_Hard_Max *EQ 100 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 hour Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 2. Seerity Informational Clearing conditions The situation clears when the condition becomes false. Chapter 5. Situations reference 261

272 KPX_WPAR_Min_Mem_Limit_Info situation The WPAR memory limit minimum resource control is set to zero. The situation is ealuated for each distinct alue of the WPAR_NAME attribute. Formula *IF *VALUE KPX_WPAR_INFORMATION.RC_Memory_Limits_Min *EQ 0 See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 hour Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 2. Seerity Informational Clearing conditions The situation clears when the condition becomes false. KPX_WPAR_Admin_Op_Info situation The WPAR is running a system administation task. The situation is ealuated for each distinct alue of the WPAR_NAME attribute. Formula *IF *SCAN KPX_WPAR_INFORMATION.Admin_Operation *NE none See Attribute groups and attributes for the AIX Premium Agent on page 21 for descriptions of the attributes in this formula. Distribution This situation is aailable for distribution. Run at startup No Sampling interal 1 minute 262 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

273 Situation persistence The number of times the conditions of the situation must occur for the situation to be true is 1. Seerity Informational Clearing conditions The situation clears when the condition becomes false. Chapter 5. Situations reference 263

274 264 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

275 Chapter 6. Take Action commands reference This chapter contains an oeriew of Take Action commands, references for detailed information about Take Action commands, and descriptions of the Take Action commands included in this monitoring agent, if any. About Take Action commands Take Action commands can be run from the portal client or included in a situation or a policy. When included in a situation, the command runs when the situation becomes true. A Take Action command in a situation is also referred to as reflex automation. When you enable a Take Action command in a situation, you automate a response to system conditions. For example, you can use a Take Action command to send a command to restart a process on the managed system or to send a text message to a cell phone. Adanced automation uses policies to perform actions, schedule work, and automate manual tasks. A policy comprises a series of automated steps called actiities that are connected to create a workflow. After an actiity is completed, the Tioli Enterprise Portal receies return code feedback, and adanced automation logic responds with subsequent actiities prescribed by the feedback. A basic Take Action command shows the return code of the operation in a message box that is displayed after the action completes or in a log file. After you close this window, no further information is aailable for this action. More information about Take Action commands For more information about working with Take Action commands, see the Tioli Enterprise Portal User's Guide. Predefined Take Action commands The AIX Premium Agent does not proide predefined Take Action commands. Copyright IBM Corp. 2007,

276 266 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

277 Chapter 7. Policies reference About policies This chapter contains an oeriew of policies, references for detailed information about policies, and descriptions of the predefined policies included in this monitoring agent, if any. Policies are an adanced automation technique for implementing more complex workflow strategies than you can create through simple automation. A policy is a set of automated system processes that can perform actions, schedule work for users, or automate manual tasks. You use the Workflow Editor to design policies. You control the order in which the policy executes a series of automated steps, which are also called actiities. Policies are connected to create a workflow. After an actiity is completed, Tioli Enterprise Portal receies return code feedback and adanced automation logic responds with subsequent actiities prescribed by the feedback. More information about policies Predefined policies This monitoring agent does not proide predefined policies. For more information about working with policies, see the Tioli Enterprise Portal User's Guide. For information about using the Workflow Editor, see the IBM Tioli Monitoring Administrator's Guide or the Tioli Enterprise Portal online help. The AIX Premium Agent does not proide predefined policies. Copyright IBM Corp. 2007,

278 268 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

279 Chapter 8. Tioli Common Reporting for the pseries monitoring agents Report package Reiew this chapter for agent-specific information about IBM Tioli Common Reporting for the pseries monitoring agents. Use this chapter in conjunction with the Tioli Common Reporting chapter in the IBM Tioli Monitoring Administrator's Guide, V6.2.2 Fix Pack 2 for complete information about prerequisites, importing reports, and running reports. Complete documentation for the Tioli Common Reporting tool is located at com.ibm.tioli.tcr.doc/tcr_welcome.html. The Tioli Common Reporting web site contains articles and how-to ideos on subjects such as how to create an IBM Tioli Monitoring reports using drag-and-drop methods, how to import Tioli Common Reporting and Cognos reports, and how to set up Cognos and Tioli Common Reporting data connections. You can find a report catalog and information on reporting across Tioli products at groups/serice/html/communityiew?communityuuid=9caf63c9-15a1-4a03-96b3-8fc700f3a364. IBM Tioli Monitoring V6.2.2 introduces the Cognos data model and reports to be used in Tioli Common Reporting. The reports in this package are historical reports, reporting against summarized data collected in Tioli Data Warehouse V These reports are built to run only against the IBM Tioli Monitoring VIOS Premium, CEC Base, and AIX Premium agents. The DB2, Oracle, and SQL Serer databases are supported for running all reports. The Cognos reports can be administered, run, and edited by IBM Tioli Common Reporting for Asset and Performance Management Version 1.3 software included with IBM Tioli Monitoring Fix Pack 2 or later. For more information about Tioli Common Reporting, see This ersion of Tioli Common Reporting includes Cognos Business Intelligence and Reporting V8.4. Prerequisites The Cognos reports require the following prerequisites steps: IMPORTANT: All prerequisites described here must be met or the reports cannot run. Install Tioli Common Reporting for Asset and Performance Management V1.3 Tioli Common Reporting for Asset and Performance Management V1.3 must be installed and running. To install and configure Tioli Common Reporting, see the Copyright IBM Corp. 2007,

280 documentation in the IBM Tioli Common Reporting for Asset and Performance Management information center at IBM Tioli Common Reporting for Asset and Performance Management information center. To ensure that Tioli Common Reporting is running, go to machine_name:16316/ibm/console/. Obtain and extract the reports package from the product media The Cognos reports are aailable in the following package: Product Media root/reports/ibm_tioli_monitoring_system_p_reports_6221.zip Copy this package under C:\sysp_tcr_reports or /sysp_tcr_reports on the same computer where the Tioli Common Reporting serer is installed. Known issue: The package cannot be extracted to path names that contain spaces. Unzip this package in the same directory. This directory contains the database scripts required to prepare the Tioli Data Warehouse for Cognos reports and a report installer that imports the reports into Tioli Common Reporting and sets up the database connection. Configure Historical Collection for CEC Base, VIOS Premium, and AIX Premium agents and the Summarization and Pruning agent After IBM Tioli Monitoring V6.2.2 Fix Pack 2 is installed and the CEC, VIOS, and AIX Premium agents are installed and configured, configure historical collection. Also, configure the Warehouse Summarization and Pruning agent with or without shifts enabled. For more information on how to enable historical collection and configure the Warehouse Summarization and Pruning agent in IBM Tioli Monitoring, see the following documentation: com.ibm.itm.doc_6.2.2fp1/history_manage_intro.htm com.ibm.itm.doc_6.2.2fp2/historical_data_storage.htm com.ibm.itm.doc_6.2.2fp2/history_configureintro_tep.htm Note: Daily and hourly summarization must be enabled for the following tables: AIX Premium Agent KPX_AMS_POOL KPX_CPU_DETAIL KPX_CPU_SUMMARY KPX_ACTIVE_MEMORY_EXPANSION KPX_DISKS KPX_FILE_SYSTEMS KPX_LOGICAL_PARTITION KPX_LOGICAL_VOLUMES KPX_NETWORK_ADAPTERS_RATES KPX_NETWORK_INTERFACES KPX_PAGING_SPACE KPX_PHYSICAL_VOLUMES KPX_VOLUME_GROUPS 270 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

281 KPX_PHYSICAL_MEMORY KPX_SYSTEM_CALL KPX_SYSTEM_IO KPX_PROCESSES_SUMMARY KPX_WPAR_INFORMATION KPX_WPAR_NETWORK KPX_VIRTUAL_MEMORY_MANAGEMENT CEC Base Agent KPK_AMS_POOLS KPK_CPU_POOLS KPK_GLOBAL_CEC KPK_MON_LPARS KPK_MON_UNMON_ALLOC KPK_PER_LPAR HMC Base Agent No reports VIOS Premium Agent KVA_AMS_POOL KVA_CPU_DETAIL KVA_CPU_SUMMARY KVA_DISKS KVA_FILE_SYSTEMS KVA_INTERNET_PROTOCOL_DETAIL KVA_INTERNET_PROTOCOL_SUMMARY KVA_LOGICAL_PARTITION KVA_LOGICAL_VOLUMES KVA_NETWORK_ADAPTERS_RATES KVA_NETWORK_MAPPINGS KVA_PAGING_SPACE KVA_VOLUME_GROUPS KVA_PHYSICAL_MEMORY KVA_SYSTEM_CALL KVA_SYSTEM_IO KVA_STORAGE_MAPPINGS KVA_PROCESSES_SUMMARY KVA_PROCESSES_DETAIL KVA_TCP To ensure that the required iews are present, run the following query against the Tioli Data Warehouse: DB2 : select distinct "VIEWNAME" from SYSCAT.VIEWS where "VIEWNAME" like %V Oracle: select distinct "VIEW_NAME" from USER_VIEWS where "VIEW_NAME" like %V MS SQL Serer: select distinct "NAME" from SYS.VIEWS where "NAME" like %V The result set contains the following iews: AIX Premium Agent KPX_AMS_POOL_HV, KPK_PER_LPAR_DV KPX_CPU_DETAIL_HV, KPX_CPU_DETAIL_DV KPX_CPU_SUMMARY_HV, KPX_CPU_SUMMARY_DV KPX_ACTIVE_MEMORY_EXPANSION_HV, KPX_ACTIVE_MEMORY_EXPANSION_DV KPX_DISKS_HV, KPX_DISKS_DV KPX_FILE_SYSTEMS_HV, KPX_FILE_SYSTEMS_DV Chapter 8. Tioli Common Reporting for the pseries monitoring agents 271

282 KPX_LOGICAL_PARTITION_HV, KPX_LOGICAL_PARTITION_DV KPX_LOGICAL_VOLUMES_HV, KPX_LOGICAL_VOLUMES_DV KPX_NETWORK_ADAPTERS_RATES_HV, KPX_NETWORK_ADAPTERS_RATES_DV KPX_NETWORK_INTERFACES_HV, KPX_NETWORK_INTERFACES_DV KPX_PAGING_SPACE_HV, KPX_PAGING_SPACE_DV KPX_PHYSICAL_VOLUMES_HV, KPX_PHYSICAL_VOLUMES_DV KPX_VOLUME_GROUPS_HV, KPX_VOLUME_GROUPS_DV KPX_PHYSICAL_MEMORY_HV, KPX_PHYSICAL_MEMORY_DV KPX_SYSTEM_CALL_HV, KPX_SYSTEM_CALL_DV KPX_SYSTEM_IO_HV, KPX_SYSTEM_IO_DV KPX_PROCESSES_SUMMARY_HV, KPX_PROCESSES_SUMMARY_DV KPX_WPAR_INFORMATION_HV, KPX_WPAR_INFORMATION_DV KPX_WPAR_NETWORK_HV, KPX_WPAR_NETWORK_DV KPX_VIRTUAL_MEMORY_MANAGEMENT_HV, KPX_VIRTUAL_MEMORY_MANAGEMENT_DV CEC Base Agent KPK_AMS_POOLS_HV, KPK_AMS_POOLS_DV KPK_CPU_POOLS_HV, KPK_CPU_POOLS_DV KPK_GLOBAL_CEC_HV, KPK_GLOBAL_CEC_DV KPK_MON_LPARS_HV, KPK_MON_LPARS_DV KPK_MON_UNMON_ALLOC_HV, KPK_MON_UNMON_ALLOC_DV KPK_PER_LPAR_HV, KPK_PER_LPAR_DV HMC Base Agent No reports VIOS Premium Agent KVA_AMS_POOL_HV, KVA_AMS_POOL_DV KVA_CPU_DETAIL_HV, KVA_CPU_DETAIL_DV KVA_CPU_SUMMARY_HV, KVA_CPU_SUMMARY_DV KVA_DISKS_HV, KVA_DISKS_DV KVA_FILE_SYSTEMS_HV, KVA_FILE_SYSTEMS_DV KVA_INTERNET_PROTOCOL_DETAIL_HV, KVA_INTERNET_PROTOCOL_DETAIL_DV KVA_INTERNET_PROTOCOL_SUMMARY_HV, KVA_INTERNET_PROTOCOL_SUMMARY_DV KVA_LOGICAL_PARTITION_HV, KVA_LOGICAL_PARTITION_DV KVA_LOGICAL_VOLUMES_HV, KVA_LOGICAL_VOLUMES_DV KVA_NETWORK_ADAPTERS_RATES_HV, KVA_NETWORK_ADAPTERS_RATES_DV KVA_NETWORK_MAPPINGS_HV, KVA_NETWORK_MAPPINGS_DV KVA_PAGING_SPACE_HV, KVA_PAGING_SPACE_DV KVA_VOLUME_GROUPS_HV, KVA_VOLUME_GROUPS_DV KVA_PHYSICAL_MEMORY_HV, KVA_PHYSICAL_MEMORY_DV KVA_SYSTEM_CALL_HV, KVA_SYSTEM_CALL_DV KVA_SYSTEM_IO_HV, KVA_SYSTEM_IO_DV KVA_STORAGE_MAPPINGS_HV, KVA_STORAGE_MAPPINGS_DV KVA_PROCESSES_SUMMARY_HV, KVA_PROCESSES_SUMMARY_DV KVA_PROCESSES_DETAIL_HV, KVA_PROCESSES_DETAIL_DV KVA_TCP_HV, KVA_TCP_DV KVA_VIRTUAL_MEMORY_MANAGEMENT_HV, KVA_VIRTUAL_MEMORY_MANAGEMENT_DV KVA_PHYSICAL_VOLUMES_HV, KVA_PHYSICAL_VOLUMES_DV 272 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

283 Prepare the Tioli Data Warehouse to support Cognos dimensions See "Creating shared dimension tables and populating the time dimensions table" in the IBM Tioli Monitoring Administrator's Guide, V6.2.2 Fix Pack 2 "Tioli Common Reporting" chapter at infocenter/tiihelp/15r1/topic/com.ibm.itm.doc_6.2.2fp2/ tcr_reports_dimensionsshared.htm. Connect to the Tioli Data Warehouse by using the database client oer ODBC See "Connecting to the Tioli Data Warehouse using the database client oer ODBC" in the IBM Tioli Monitoring Administrator's Guide, V6.2.2 Fix Pack 2 "Tioli Common Reporting" chapter at infocenter/tiihelp/15r1/topic/com.ibm.itm.doc_6.2.2fp2/tcr_tdwconnect.htm. Importing and running IBM Tioli Monitoring for System p Cognos reports IMPORTANT: All prerequisites must be met before importing and running the reports, or the reports cannot run. The IBM Tioli Monitoring for System p Reports package contains an installer that performs the following tasks: Importing the reports and data model into Tioli Common Reporting Configuring a data source to connect to Tioli Data Warehouse See "Installing and running IBM Cognos reports" in the IBM Tioli Monitoring Administrator's Guide, V6.2.2 Fix Pack 2 "Tioli Common Reporting" chapter for information about importing and running Cognos reports at publib.boulder.ibm.com/infocenter/tiihelp/15r1/topic/ com.ibm.itm.doc_6.2.2fp2/tcr_install_itm.htm. IMPORTANT: You must hae completed all of the steps described under Prerequisites on page 269 before you can import and run reports. If you are using a schema other than ITMUSER you must perform the following steps for the data model and reports to run: 1. Make sure you hae completed the following steps: a. Altered the schema name in the database scripts when you prepared the Tioli Data Warehouse for Cognos dimensions in Prepare the Tioli Data Warehouse to support Cognos dimensions of Prerequisites on page 269. b. Installed the reports package using the Reports installer as explained in "Installing and running IBM Cognos reports" in the IBM Tioli Monitoring Administrator's Guide, V6.2.2 Fix Pack 2 "Tioli Common Reporting" chapter for information about importing and running Cognos reports at com.ibm.itm.doc_6.2.2fp2/tcr_install_itm.htm. To erify that you hae installed the reports package, go to Tioli Common Reporting and make sure you can see "IBM Tioli Monitoring for Virtual Serers Reports" in the Public Folders of IBM Cognos Connection. Chapter 8. Tioli Common Reporting for the pseries monitoring agents 273

284 2. Install and configure the Cognos Framework Manager, which is the data modeling tool. See the following instructions: infocenter/tiihelp/23r1/topic/com.ibm.tioli.tcr_cog.doc/ ttcr_cog_configure_frameworkmgr.html 3. Open the Framework Manager. Select File > Open. Browse to the extracted System p reports package. Browse to the "model" folder and select the ITM for System p.cpf file. 4. If you are prompted to enter login credentials, enter your tipadmin user ID and password. 5. After the IBM Tioli Monitoring for System p data model in the Framework Manager opens, expand Data Sources under IBM Tioli Monitoring for System p in the Project Viewer. 6. Select TDW under Data Sources 7. When you select TDW, the Properties iew is updated with information about the TDW data source. By default, the Properties iew is located at the bottom center of the screen. If you do not see it there, select View > Properties. 8. In the Properties, edit the Schema field. Change it from ITMUSER to your schema name. 9. Sae the project. 10. In the Project Viewer, expand Packages. 11. Right-click IBM Tioli Monitoring for System p Reports. 12. Select Publish Packages. 13. The Publish Wizard opens. 14. Keep the default selection and click Next. 15. Click Next on the next screen. 16. Clear the Verify the package before publishing check box. 17. Click Publish. 18. A window is displayed that alerts you that A package with that name already exists and asks Do you want to publish this package? 19. Click Yes. 20. After the package is published, you are informed that the package has been published. 21. Go back to Tioli Common Reporting and check if the Modified field of "IBM Tioli Monitoring for System p Reports" in the Public Folders of IBM Cognos Connection shows the time of publishing. After completing these steps, you can run any report from the IBM Tioli Monitoring for System p Reports package. Cognos report descriptions The following Cognos reports are described in this chapter: Top or Bottom n CECs by Physical CPU Utilization report on page 276 Shows aerage CPU Utilization for all CECs in the enironment during the report period, with bar charts showing the top and bottom n CECs based on CPU utilization. Top or Bottom LPARs by Physical CPU Utilization report on page 277 Shows CPU Utilization for all LPARs in the enironment. LPAR Physical CPU Utilization Details report on page IBM Tioli Monitoring: AIX Premium Agent: User's Guide

285 Shows aerage and maximum CPU usage oer a specified period of time for the selected LPARs. Top or Bottom CECs by Physical Memory Utilization report on page 279 Shows aerage and maximum CPU usage oer a specified period of time for the selected LPARs. Top or Bottom LPARs in a CEC by Physical Memory Utilization report on page 280 Shows aerage and maximum memory utilization and physical memory allocated in megabytes for all LPARs in the enironment. LPAR Physical Memory Utilization Details report on page 281 Shows s current, aerage, and maximum memory utilization for one or more LPARs. Top or Bottom VIOSs by Disk Capacity report on page 282 Shows the top and bottom VIOSs based on aerage megabytes used and the disk capacity for all VIOSs in the enironment. VIOS Disk Capacity Details report on page 283 Shows aerage megabytes used and free on the disk oer a selected period of time. The Cognos reports use the following attribute groups: KPK_GLOBAL_CEC_HV KPK_MON_UNMON_ALLOC_DV KPK_MON_LPARS_DV KPK_GLOBAL_CEC_HV KPK_MON_LPARS_HV KPK_GLOBAL_CEC_HV KPK_GLOBAL_CEC_HV KPK_MON_LPARS_HV KPK_MON_LPARS_DV KPK_GLOBAL_CEC_HV KPK_MON_LPARS_HV KVA_PHYSICAL_VOLUMES_DV KVA_STORAGE_MAPPINGS_DV KVA_PHYSICAL_VOLUMES_DV KVA_STORAGE_MAPPINGS_DV Chapter 8. Tioli Common Reporting for the pseries monitoring agents 275

286 Top or Bottom n CECs by Physical CPU Utilization report Name Purpose Parameters Top or Bottom n CECs by Physical CPU Utilization This report displays aerage CPU Utilization for all CECs in the enironment during the report period, with bar charts showing the top and bottom n CECs based on CPU utilization. Help identify patterns in physical CPU utilization. Date Range Report Period You can choose from a predefined date range such as Last Week, Current Month, Last 30 Days, and so on; or, you can enter a start and end date and time for the reporting period. Start Date You can choose a start date from a calendar and start time from the time widget. Both date and time must be selected. End Date You can choose a start date from a calendar and start time from the time widget. Both date and time must be selected. Display Options The colors on the heat chart are displayed based on the following alues: Top/Bottom N CECs You can choose any integer to filter the number of top CECs isible in the bar charts. Shift and Vacation Periods The colors on the heat chart are displayed based on the following alues: Shift Period If shifts are enabled, the hourly tables hae a alue for SHIFTPERIOD of 1 or 2, based on peak and off-peak hours configured in the data warehouse. The daily tables hae alues of 1 and 2, corresponding to the peak and off peak-hours, respectiely, and a alue of -1 corresponding to the summarized alue for that day. If shifts are not enabled, the default alue is -1. Vacation Period If acation period is not enabled, the default alue is -1. Otherwise, enter 1 or 2, corresponding to the peak and off-peak hours, respectiely. Tables or iews used Output KPK_GLOBAL_CEC_HV KPK_MON_UNMON_ALLOC_DV This report shows two bar charts. One chart displays the top n CECs based on aerage CPU Utilization. The other chart displays the bottom n CECs. A table below these charts displays CPU attributes for all CECs in the enironment during the report period. Use the CEC names in the table to drill down to the CPU Utilization across all LPARs in a CEC report. Note: This measurement of CPU utilization for the frame is currently accurate only if all of the LPARs are "Monitored." 276 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

287 Top or Bottom LPARs by Physical CPU Utilization report Name Purpose Parameters Top or Bottom LPARs by Physical CPU Utilization This report displays CPU Utilization for all LPARs in the enironment. Help identify patterns in physical CPU utilization by LPAR. Date Range Report Period You can choose from a predefined date range such as Last Week, Current Month, Last 30 Days, and so on; or, you can enter a start and end date and time for the reporting period. Start Date You can choose a start date from a calendar and start time from the time widget. Both date and time must be selected. End Date You can choose a start date from a calendar and start time from the time widget. Both date and time must be selected. Display Options The colors on the heat chart are displayed based on the following alues: CEC Select the desired CEC from the enironment or select % to iew the top and bottom LPARs from all CECs in the enironment. Top/Bottom N LPARs You can choose any integer to filter the number of top CECs isible in the bar charts. Shift and Vacation Periods The colors on the heat chart are displayed based on the following alues: Shift Period If shifts are enabled, the hourly tables hae a alue for SHIFTPERIOD of 1 or 2, based on peak and off-peak hours configured in the data warehouse. The daily tables hae alues of 1 and 2, corresponding to the peak and off peak-hours, respectiely, and a alue of -1 corresponding to the summarized alue for that day. If shifts are not enabled, the default alue is -1. Vacation Period If acation period is not enabled, the default alue is -1. Otherwise, enter 1 or 2, corresponding to the peak and off peak-hours, respectiely. Tables or iews used Output KPK_MON_LPARS_DV KPK_GLOBAL_CEC_HV This report shows two bar charts. One bar displays the top n LPARs based on aerage CPU Utilization; the other displays the bottom n LPARs for the selected CEC. A table below these charts displays arious CPU attributes for all LPARs in the enironment, such as Total and Maximum Physical CPU used, Aerage LPAR CPU Utilization (%), Total CPU Units Allocated, and Aerage Physical CPU Entitlement (%). Use the LPAR names in the table to drill down to the CPU Utilization oer time for that LPAR. Chapter 8. Tioli Common Reporting for the pseries monitoring agents 277

288 LPAR Physical CPU Utilization Details report Name Purpose Parameters System p: LPAR Physical CPU Utilization Details This report shows aerage and maximum CPU usage oer a specified period of time for the selected LPARs. Help identify patterns in physical CPU utilization by LPAR. Date Range Report Period You can choose from a predefined date range such as Last Week, Current Month, Last 30 Days, and so on; or, you can enter a start and end date and time for the reporting period. Start Date You can choose a start date from a calendar and start time from the time widget. Both date and time must be selected. End Date You can choose a start date from a calendar and start time from the time widget. Both date and time must be selected. Display Options The colors on the heat chart are displayed based on the following alues: CEC Select the desired CEC from the enironment. LPAR Select the desired LPAR (one or many) from the specified CEC. Summarization Choose the summarization type from the drop-down list. The options are Hourly and Daily (the default alue). Shift and Vacation Periods The colors on the heat chart are displayed based on the following alues: Shift Period If shifts are enabled, the hourly tables hae a alue for SHIFTPERIOD of 1 or 2, based on peak and off-peak hours configured in the data warehouse. The daily tables hae alues of 1 and 2, corresponding to the peak and off peak-hours, respectiely, and a alue of -1 corresponding to the summarized alue for that day. If shifts are not enabled, the default alue is -1. Vacation Period If acation period is not enabled, the default alue is -1. Otherwise, enter 1 or 2, corresponding to the peak and off peak-hours, respectiely. Tables or iews used Output KPK_MON_LPARS_HV KPK_GLOBAL_CEC_HV This report shows an area chart displaying the total CPU units used oer a selected period of time for the selected LPARs or for all the LPARs in a CEC. A table iew below chart shows arious CPU attributes such as Total and Maximum Physical CPU Units Used, Aerage and Maximum CPU Entitlement Used (%), Aerage, Maximum and Total CPU Allocated, and Maximum CPU Cap Used (%). 278 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

289 Top or Bottom CECs by Physical Memory Utilization report Name Purpose Parameters System p: Top or Bottom CECs by Physical Memory Utilization This report shows aerage and maximum CPU usage oer a specified period of time for the selected LPARs. Help identify patterns in physical CPU utilization by LPAR. Date Range Report Period You can choose from a predefined date range such as Last Week, Current Month, Last 30 Days, and so on; or, you can enter a start and end date and time for the reporting period. Start Date You can choose a start date from a calendar and start time from the time widget. Both date and time must be selected. End Date You can choose a start date from a calendar and start time from the time widget. Both date and time must be selected. Display Options The colors on the heat chart are displayed based on the following alues: CEC Select the desired CEC from the enironment. LPAR Select the desired LPAR (one or many) from the specified CEC. Summarization Choose the summarization type from the drop-down list. The options are Hourly and Daily (the default alue). Shift and Vacation Periods The colors on the heat chart are displayed based on the following alues: Shift Period If shifts are enabled, the hourly tables hae a alue for SHIFTPERIOD of 1 or 2, based on peak and off-peak hours configured in the data warehouse. The daily tables hae alues of 1 and 2, corresponding to the peak and off peak-hours, respectiely, and a alue of -1 corresponding to the summarized alue for that day. If shifts are not enabled, the default alue is -1. Vacation Period If acation period is not enabled, the default alue is -1. Otherwise, enter 1 or 2, corresponding to the peak and off-peak hours, respectiely. Tables or iews used Output KPK_GLOBAL_CEC_HV KPK_MON_LPARS_HV This report shows two bar charts. One displays the top n CECs based on aerage Memory Utilization; the other displays the bottom n CECs. A table below these charts shows memory attributes such as Aerage and Maximum Allocated Memory Used in MB and % for all CECs. For each CEC agent in the table, you can drill through to the Memory Utilization across all LPARs in a CEC report. Chapter 8. Tioli Common Reporting for the pseries monitoring agents 279

290 Top or Bottom LPARs in a CEC by Physical Memory Utilization report Name Purpose Parameters System p: Top or Bottom LPARs in a CEC by Physical Memory Utilization This report shows aerage and maximum memory utilization and physical memory allocated in megabytes for all LPARs in the enironment. Help identify patterns in physical CPU utilization by LPAR. Date Range Report Period You can choose from a predefined date range such as Last Week, Current Month, Last 30 Days, and so on; or, you can enter a start and end date and time for the reporting period. Start Date You can choose a start date from a calendar and start time from the time widget. Both date and time must be selected. End Date You can choose a start date from a calendar and start time from the time widget. Both date and time must be selected. Display Options The colors on the heat chart are displayed based on the following alues: CEC Select the desired CEC from the enironment or select % to iew the top and bottom LPARs from all CECs in the enironment Top N LPARs Choose any integer on which to filter the number of top LPARs isible in the bar charts. Bottom N LPARs Choose any integer on which to filter the number of bottom LPARs isible in the bar charts Shift and Vacation Periods The colors on the heat chart are displayed based on the following alues: Shift Period If shifts are enabled, the hourly tables hae a alue for SHIFTPERIOD of 1 or 2, based on peak and off-peak hours configured in the data warehouse. The daily tables hae alues of 1 and 2, corresponding to the peak and off peak-hours, respectiely, and a alue of -1 corresponding to the summarized alue for that day. If shifts are not enabled, the default alue is -1. Vacation Period If acation period is not enabled, the default alue is -1. Otherwise, enter 1 or 2, corresponding to the peak and off peak-hours, respectiely. Tables or iews used Output KPK_MON_LPARS_DV KPK_GLOBAL_CEC_HV This report shows two bar charts. One displays the top n LPARs based on aerage memory utilization, and the other displays the bottom n LPARs. A table below these charts displays arious memory attributes for all LPARs in the enironment. Use the LPAR names in the table to drill down to the Memory Utilization oer time report for that LPAR. 280 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

291 LPAR Physical Memory Utilization Details report Name Purpose Parameters System p: LPAR Physical Memory Utilization Details This report shows current, aerage, and maximum memory utilization for one or more LPARs. Help identify patterns in physical LPAR physical memory utilization. Date Range Report Period You can choose from a predefined date range such as Last Week, Current Month, Last 30 Days, and so on; or, you can enter a start and end date and time for the reporting period. Start Date You can choose a start date from a calendar and start time from the time widget. Both date and time must be selected. End Date You can choose a start date from a calendar and start time from the time widget. Both date and time must be selected. Display Options The colors on the heat chart are displayed based on the following alues: CEC Select the desired CEC from the enironment. LPAR Select the desired LPAR (one or many) from the specified CEC. Summarization Choose the summarization type from the drop-down list. The options are Hourly and Daily (the default alue). Shift and Vacation Periods The colors on the heat chart are displayed based on the following alues: Shift Period If shifts are enabled, the hourly tables hae a alue for SHIFTPERIOD of 1 or 2, based on peak and off-peak hours configured in the data warehouse. The daily tables hae alues of 1 and 2, corresponding to the peak and off peak-hours, respectiely, and a alue of -1 corresponding to the summarized alue for that day. If shifts are not enabled, the default alue is -1. Vacation Period If acation period is not enabled, the default alue is -1. Otherwise, enter 1 or 2, corresponding to the peak and off peak-hours, respectiely. Tables or iews used Output KPK_MON_LPARS_HV This report is an oerlaid line chart showing the aerage and maximum memory utilization for one or more LPARs oer a selected period of time. A table shows detailed alues such as aerage and maximum physical memory in both percentage and megabytes. Chapter 8. Tioli Common Reporting for the pseries monitoring agents 281

292 Top or Bottom VIOSs by Disk Capacity report Name Purpose Parameters System p: Top or Bottom VIOSs by Disk Capacity This report shows the top and bottom VIOSs based on aerage megabytes used and the disk capacity for all VIOSs in the enironment. Help identify patterns in VIOS usage by measuring disk capacity. Date Range Report Period You can choose from a predefined date range such as Last Week, Current Month, Last 30 Days, and so on; or, you can enter a start and end date and time for the reporting period. Start Date You can choose a start date from a calendar and start time from the time widget. Both date and time must be selected. End Date You can choose a start date from a calendar and start time from the time widget. Both date and time must be selected. Display Options The colors on the heat chart are displayed based on the following alues: Top/Bottom N VIOSs Choose any integer on which to filter the number of top or bottom VIOSs isible in the bar charts Shift and Vacation Periods The colors on the heat chart are displayed based on the following alues: Shift Period If shifts are enabled, the hourly tables hae a alue for SHIFTPERIOD of 1 or 2, based on peak and off-peak hours configured in the data warehouse. The daily tables hae alues of 1 and 2, corresponding to the peak and off peak-hours, respectiely, and a alue of -1 corresponding to the summarized alue for that day. If shifts are not enabled, the default alue is -1. Vacation Period If acation period is not enabled, the default alue is -1. Otherwise, enter 1 or 2, corresponding to the peak and off peak-hours, respectiely. Tables or iews used Output KVA_PHYSICAL_VOLUMES_DV KVA_STORAGE_MAPPINGS_DV This report shows two stacked bar charts. One chart displays the top n VIOSs based on aerage megabytes used. The top part of each bar shows the aerage size in megabytes. The other report displays the bottom n VIOSs. A table below these charts displays disk capacity for all VIOSs in the enironment. Each VIOS name in the table is a link that you can use to drill down to the disk capacity oer time for that VIOS. 282 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

293 VIOS Disk Capacity Details report Name Purpose Parameters System p: VIOS Disk Capacity Details This report shows aerage megabytes used and free on the disk oer a selected period of time. Help identify patterns in VIOS usage by measuring disk capacity. Date Range Report Period You can choose from a predefined date range such as Last Week, Current Month, Last 30 Days, and so on, or, you can enter a start and end date and time for the reporting period. Start Date You can choose a start date from a calendar and start time from the time widget. Both date and time must be selected. End Date You can choose a start date from a calendar and start time from the time widget. Both date and time must be selected. Display Options The colors on the heat chart are displayed based on the following alues: VIOS Select the desired VIOS in the enironment. Summarization Choose the summarization type from the drop-down list. The options are Hourly and Daily (the default alue). Shift and Vacation Periods The colors on the heat chart are displayed based on the following alues: Shift Period If shifts are enabled, the hourly tables hae a alue for SHIFTPERIOD of 1 or 2, based on peak and off-peak hours configured in the data warehouse. The daily tables hae alues of 1 and 2, corresponding to the peak and off peak-hours, respectiely, and a alue of -1 corresponding to the summarized alue for that day. If shifts are not enabled, the default alue is -1. Vacation Period If acation period is not enabled, the default alue is -1. Otherwise, enter 1 or 2, corresponding to the peak and off peak-hours, respectiely. Tables or iews used Output KVA_PHYSICAL_VOLUMES_DV KVA_STORAGE_MAPPINGS_DV This report shows a stacked area chart for each disk in the VIOS. The lower area of the chart shows the aerage megabytes used on the disk oer a selected period of time. The upper area shows aerage free megabytes on the disk oer the selected period of time. A table shows detailed alues for all disks. Chapter 8. Tioli Common Reporting for the pseries monitoring agents 283

294 284 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

295 Chapter 9. Troubleshooting This chapter proides agent-specific troubleshooting information. See the IBM Tioli Monitoring Troubleshooting Guide for general troubleshooting information. Also see Support information on page 303 for other problem-soling options. Note: You can resole some problems by ensuring that your system matches the system requirements listed in Chapter 2, Requirements and agent-specific installation and configuration information for the monitoring agent, on page 5. Gathering product information for IBM Software Support Before contacting IBM Software Support about a problem you are experiencing with this product, gather the information in Table 2 that relates to the problem. Table 2. Information to gather before contacting IBM Software Support Information type Log files Collect trace log files from failing systems. Most logs are located in a logs subdirectory on the host computer. See Trace logging on page 286 for lists of all trace log files and their locations. See the Tioli Enterprise Portal User's Guide for general information about the IBM Tioli Monitoring enironment. AIX information Version number and patch leel Operating system Operating system ersion number and patch leel Messages Messages and other information displayed on the screen Version numbers for Version number of the following members of the monitoring enironment: IBM Tioli Monitoring IBM Tioli Monitoring. Also proide the patch leel, if aailable. IBM Tioli Monitoring: AIX Premium Agent Screen captures Screen captures of incorrect output, if any. (UNIX only) Core dump files If the system stops on UNIX systems, collect the core dump file from the install_dir/bin directory, where install_dir is the directory where you installed the monitoring agent. You can use the pdcollect tool to collect the most commonly used information from a system. This tool gathers log files, configuration information, ersion information, and other data. See the "pdcollect tool" section in the "Tools" chapter of the IBM Tioli Monitoring Troubleshooting Guide for more information about using this tool. See for information about working with IBM Software Support. Built-in troubleshooting features The primary troubleshooting feature in the AIX Premium Agent is logging. Logging refers to the text messages and trace data generated by the AIX Premium Agent. Messages and trace data are sent to a file. Trace data captures transient information about the current operating enironment when a component or application fails to operate as designed. IBM Software Copyright IBM Corp. 2007,

296 Problem classification Trace logging Support personnel use the captured trace information to determine the source of an error or unexpected condition. See Trace logging for more information. The following types of problems might occur with the AIX Premium Agent: Installation and configuration General usage and operation Display of monitoring data Take Action commands This chapter proides symptom descriptions and detailed workarounds for these problems, and describes the logging capabilities of the monitoring agent. See the IBM Tioli Monitoring Troubleshooting Guide for general troubleshooting information. Trace logs capture information about the operating enironment when component software fails to operate as intended. The principal log type is the RAS (Reliability, Aailability, and Sericeability) trace log. These logs are in the English language only. The RAS trace log mechanism is aailable for all components of IBM Tioli Monitoring. Most logs are located in a logs subdirectory on the host computer. See the following sections to learn how to configure and use trace logging: Principal trace log files on page 287 Examples: using trace logs on page 288 Setting RAS trace parameters on page 289 Note: The documentation refers to the RAS facility in IBM Tioli Monitoring as "RAS1". IBM Software Support uses the information captured by trace logging to trace a problem to its source or to determine why an error occurred. All components in the IBM Tioli Monitoring enironment hae a default tracing leel. The tracing leel can be changed on a per-component leel to adjust the type of trace information collected, the degree of trace detail, the number of trace logs to be kept, and the amount of disk space used for tracing. Oeriew of log file management Table 3 on page 287 proides the names, locations, and descriptions of RAS1 log files. The log file names adhere to the following naming conention: Windows systems hostname_productcode_program_hextimestamp-nn.log Linux and UNIX systems hostname_productcode_hextimestamp-nn.log where: hostname is the host name of the computer where the monitoring component is running. productcode is the two-character product code. For IBM Tioli Monitoring: AIX Premium Agent, the product code is px. program is the name of the program being run. 286 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

297 HEXtimestamp is a hexadecimal time stamp representing the time at which the program started. nn is a rolling log suffix. Principal trace log files Table 3 contains locations, file names, and descriptions of trace logs that can help determine the source of problems with agents. Table 3. Trace log files for troubleshooting agents System where log is located File name and path On the Tioli Enterprise Monitoring Serer On the Tioli Enterprise Monitoring Serer On the Tioli Enterprise Monitoring Serer Windows: The file in the install_dir\installitm path UNIX: The candle_installation.log file in the install_dir/logs path The Warehouse_Configuration.log file is in the following location on Windows systems: install_dir\installitm The name of the RAS log file is as follows: Windows: install_dir\logs\ hostname_ms_timestamp-nn.log UNIX: install_dir/logs/ hostname_ms_timestamp-nn.log Proides details about products that are installed. Note: Trace logging is enabled by default. A configuration step is not required to enable this tracing. Proides details about the configuration of data warehousing for historical reporting. Traces actiity on the monitoring serer. On the Tioli Enterprise Portal Serer On the Tioli Enterprise Portal Serer Note: File names for RAS1 logs include a hexadecimal time stamp. Also on UNIX systems, a log with a decimal time stamp is proided: hostname_productcode_timestamp.log and hostname_productcode_ timestamp.pidnnnnn in the install_dir/logs path, where nnnnn is the process ID number. The name of the RAS log file is as follows: Windows: install_dir\logs\ hostname_cq_hextimestamp-nn.log UNIX : install_dir/logs/ hostname_cq_hextimestamp-nn.log Note: File names for RAS1 logs include a hexadecimal time stamp. Also on UNIX systems, a log with a decimal time stamp is proided: hostname_productcode_timestamp.log and hostname_productcode_ timestamp.pidnnnnn in the install_dir/logs path, where nnnnn is the process ID number. The teps_odbc.log file is located in the following path: Windows: install_dir\installitm UNIX: install_dir/logs Traces actiity on the portal serer. When you enable historical reporting, this log file traces the status of the warehouse proxy agent. Chapter 9. Troubleshooting 287

298 Table 3. Trace log files for troubleshooting agents (continued) System where log is located File name and path On the computer that hosts the monitoring agent The RAS1 log files are as follows: UNIX: hostname_px_hextimestamp-nn.log in the install_dir/logs directory Traces actiity of the monitoring agent. On the computer that hosts the monitoring agent These logs are in the following directories: UNIX: install_dir/logs The agent operations log files are as follows: instance_hostname_px.lg0 is the current log created when the agent was started. Shows whether the agent was able to connect to the monitoring serer. Shows which situations are started and stopped, and shows other eents while the agent is running. A new ersion of this file is generated eery time the agent is restarted. On the computer that hosts the monitoring agent instance_hostname_px.lg1 is the backup of the preious log. These logs are in the following directory depending on the operating system that you are using: UNIX: install_dir/logs The Take Action command log files are as follows: host_px_takeactioncommand.log The logs are in the following directories: UNIX: install_dir/logs IBM Tioli Monitoring generates one backup copy of the *.LG0 file with the tag.lg1. View.LG1 to learn the following details regarding the preious monitoring session: Status of connectiity with the monitoring serer. Situations that were running. The success or failure status of Take Action commands. Traces actiity each time a Take Action command runs. For example, when a hypothetical start_command Take Action command runs, IBM Tioli Monitoring generates a start_command.log file. Definitions of ariables: timestamp is time stamp whose format includes year (y), month (m), day (d), hour (h), and minute (m), as follows: yyyymmdd hhmm HEXtimestamp is a hexadecimal representation of the time at which the process was started. install_dir represents the directory path where you installed the IBM Tioli Monitoring component. install_dir can represent a path on the computer that hosts the monitoring system, the monitoring agent, or the portal. instance refers to the name of the database instance that you are monitoring. hostname refers to the name of the computer on which the IBM Tioli Monitoring component runs. nn represents the circular sequence in which logs are rotated. Ranges from 1-5, by default. But the first is always retained, because it includes configuration parameters. productcode specifies the product code, for example, um for Uniersal Agent or nt for Windows. See the IBM Tioli Monitoring Installation and Setup Guide for more information about the complete set of trace logs that are maintained on the monitoring serer. Examples: using trace logs Typically, IBM Software Support applies specialized knowledge to analyze trace logs to determine the source of problems. You can open trace logs in a text editor to learn some basic facts about your IBM Tioli Monitoring enironment. The following examples are from the Tioli Enterprise Monitoring Serer log. Example one This excerpt shows the typical log for a failed connection between a monitoring agent and a monitoring serer with the host name serer1a: 288 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

299 (Thursday, August 11, 2005, 08:21:30-{94C}kdcl0cl.c,105,"KDCL0_ClientLookup") status=1c020006, "location serer unaailable", ncs/kdc1_stc_server_unavailable (Thursday, August 11, 2005, 08:21:35-{94C}kraarreg.cpp,1157,"LookupProxy") Unable to connect to broker at ip.pipe:: status=0, "success", ncs/kdc1_stc_ok (Thursday, August 11, 2005, 08:21:35-{94C}kraarreg.cpp,1402,"FindProxyUsingLocalLookup") Unable to find running CMS on CT_CMSLIST <IP.PIPE:#serer1a> Example two The following excerpts from the trace log for the monitoring serer show the status of an agent, identified here as "Remote node." The name of the computer where the agent is running is SERVER5B: (42C039F A4:kpxreqhb.cpp,649,"HeartbeatInserter") Remote node SERVER5B:PX is ON-LINE.... (42C3079B A4:kpxreqhb.cpp,644,"HeartbeatInserter") Remote node SERVER5B:PX is OFF-LINE. Key points regarding the preceding excerpt: The monitoring serer appends the PX product code to the serer name to form a unique name (SERVER5B:PX) for this instance of the AIX Premium Agent. By using this unique name, you can distinguish multiple monitoring products that might be running on SERVER5B. The log shows when the agent started (ON-LINE) and later stopped (OFF-LINE) in the enironment. For the sake of breity, an ellipsis (...) represents the series of trace log entries that were generated while the agent was running. Between the ON-LINE and OFF-LINE log entries, the agent was communicating with the monitoring serer. The ON-LINE and OFF-LINE log entries are always aailable in the trace log. All trace leels that are described in Setting RAS trace parameters proide these entries. On Windows systems, you can use the following alternate method to iew trace logs: 1. In the Windows Start menu, choose Program Files > IBM Tioli Monitoring > Manage Tioli Enterprise Monitoring Serices. The Manage Tioli Enterprise Monitoring Serices window is displayed. 2. Right-click a component and select Adanced > View Trace Log in the menu. For example, if you want to iew the trace log of the AIX agent, right-click the name of that agent in the window. You can also use the iewer to access remote logs. Note: The iewer conerts time stamps in the logs to a format that is easier to read. Setting RAS trace parameters Objectie Pinpoint a problem by setting detailed tracing of indiidual components of the monitoring agent and modules. Background Information The AIX Premium Agent uses RAS1 tracing and generates the logs described in Table 3 on page 287. The default RAS1 trace leel is ERROR. Chapter 9. Troubleshooting 289

300 Before you begin See Oeriew of log file management on page 286 to ensure that you understand log rolling and can reference the correct log files when you manage log file generation. After you finish Monitor the size of the logs directory. Default behaior can generate a total of 45 MB to 60 MB for each agent that is running on a computer. For example, each database instance that you monitor can generate 45 MB to 60 MB of log data. See the "Procedure" section to learn how to adjust file size and numbers of log files to preent logging actiity from occupying too much disk space. Regularly prune log files other than the RAS1 log files in the logs directory. Unlike the RAS1 log files that are pruned automatically, other log types can grow indefinitely, for example, the logs in Table 3 on page 287 that include a process ID number (PID). Use collector trace logs as an additional source of troubleshooting information. Note: The KDC_DEBUG setting and the Maximum error tracing setting can generate a large amount of trace logging. Use these settings only temporarily while you are troubleshooting problems. Otherwise, the logs can occupy excessie amounts of hard disk space. Procedure On Windows systems, you can use the graphical user interface to set trace options: 1. Open the Manage Tioli Enterprise Monitoring Serices window. 2. Right-click the icon of the monitoring agent with logging you want to modify. 3. Select Adanced > Edit Trace Parms. The Tioli Enterprise Monitoring Serer Trace Parameters window is displayed. 4. Select a new trace setting in the pull-down menu in the Enter RAS1 Filters field or type a alid string. The selections are as follows: General error tracing. KBB_RAS1=ERROR Intensie error tracing. KBB_RAS1=ERROR (UNIT:kqz ALL) Maximum error tracing. KBB_RAS1=ERROR (UNIT:kqz ALL) (UNIT:kra ALL) Notes: As this example shows, you can set multiple RAS tracing options in a single statement. 5. Modify the alue for 'Maximum Log Size Per File (MB)" to change the log file size (changes LIMIT alue). 6. Modify the alue for 'Maximum Number of Log Files Per Session" to change the number of log files per startup of a program (changes COUNT alue). 7. Modify the alue for 'Maximum Number of Log Files Total" to change the number of log files for all startups of a program (changes MAXFILES alue). 8. (Optional) Click Y (Yes) in the KDC_DEBUG Setting menu to log information that can help you diagnose communications and connectiity problems between the monitoring agent and the monitoring serer. Note: The KDC_DEBUG setting and the Maximum error tracing setting can generate a large amount of trace logging. Use these settings only temporarily, while you are troubleshooting problems. Otherwise, the logs can occupy excessie amounts of hard disk space. 290 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

301 Problems and workarounds 9. Click OK. You see a message reporting a restart of the monitoring agent so that your changes take effect. You can also manually edit the RAS1 trace logging parameters using this method: 1. Open the trace options file: Windows: install_dir\tmaitm6\kpxenv UNIX: install_dir/config/px.ini 2. Edit the line that begins with KBB_RAS1= to set trace logging preferences. For example, if you want detailed trace logging, set the Maximum Tracing option:kbb_ras1=error (UNIT:kqz ALL) (UNIT:kra ALL) 3. Edit the line that begins with KBB_RAS1_LOG= to manage the generation of log files: MAXFILES: the total number of files that are to be kept for all startups of a gien program. When this alue is exceeded, the oldest log files are discarded. Default alue is 9. LIMIT: the maximum size, in megabytes (MB) of a RAS1 log file. Default alue is 5. IBM Software Support might guide you to modify the following parameters: COUNT: the number of log files to keep in the rolling cycle of one program startup. Default is 3. PRESERVE: the number of files that are not to be reused in the rolling cycle of one program startup. Default alue is 1. Notes: The KBB_RAS1_LOG parameter also proides for the specification of the log file directory, log file name, and the inentory control file directory and name. Do not modify these alues or log information can be lost. 4. Restart the monitoring agent so that your changes take effect. The following sections proide symptoms and workarounds for problems that might occur with the AIX Premium Agent: Installation and configuration troubleshooting on page 291 Remote deployment troubleshooting on page 294 Agent troubleshooting on page 295 Workspace troubleshooting on page 297 Situation troubleshooting on page 299 Note: You can resole some problems by ensuring that your system matches the system requirements listed in Chapter 2, Requirements and agent-specific installation and configuration information for the monitoring agent, on page 5. This Troubleshooting chapter proides agent-specific troubleshooting information. See the IBM Tioli Monitoring Troubleshooting Guide for general troubleshooting information. Installation and configuration troubleshooting This section proides tables that show solutions for installation, configuration, and uninstallation problems. Chapter 9. Troubleshooting 291

302 Table 4. Problems and solutions for installation and configuration Problem Solution (UNIX only) During a command-line installation, you choose to install a component that is currently installed, and you see the following warning: WARNING - you are about to install the SAME ersion of "component_name" You must exit and restart the installation process. You cannot return to the list where you selected components to install. When you run the installer again, do not attempt to install any component that is currently installed. where component_name is the name of the component that you are attempting to install. Note: This problem affects UNIX command-line installations. If you monitor only Windows enironments, you see this problem if you choose to install a product component (for example, a monitoring serer) on a UNIX system. A problem can arise when you install and configure a new monitoring agent on a computer where other agents are running as described in this example: Agents are running on a computer and communicating with a Tioli Enterprise Monitoring Serer, called TEMS1. You install a new agent on the same computer and you want this agent to communicate with a different monitoring serer, called TEMS2. When you configure the new agent to communicate with TEMS2, all the existing agents are reconfigured to communicate with TEMS2. Diagnosing problems with product browse settings (Windows systems only). A message similar to "Unable to find running CMS on CT_CMSLIST" in the log file is displayed. You must reconfigure the preiously existing agents to restore their communication connection with TEMS1. For example, you can right-click the row for a specific agent in the Manage Tioli Enterprise Monitoring Serices, and select Reconfigure. See the IBM Tioli Monitoring Installation and Setup Guide for more information about reconfiguration. When you hae problems with browse settings, perform the following steps: 1. Click Start > Programs > IBM Tioli Monitoring > Manage Tioli Enterprise Monitoring Serices. The Manage Tioli Enterprise Monitoring Serices window is displayed. 2. Right-click the Windows agent and select Browse Settings. A text window is displayed. 3. Click Sae As and sae the information in the text file. If requested, you can forward this file to IBM Software Support for analysis. If a message similar to "Unable to find running CMS on CT_CMSLIST" is displayed in the log file, the agent cannot connect to the monitoring serer. Confirm the following points: Do multiple network interface cards (NICs) exist on the system? If multiple NICs exist on the system, find out which one is configured for the monitoring serer. Ensure that you specify the correct host name and port settings for communication in the IBM Tioli Monitoring enironment. 292 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

303 Table 4. Problems and solutions for installation and configuration (continued) Problem Solution The system is experiencing high CPU usage. Agent process: View the memory usage of the KPXCMA process. If CPU usage seems to be excessie, recycle the monitoring agent. The artwork in the installation panels in the Japanese enironment are missing, and some panels hae a truncation problem. In the Install Prerequisites panel during agent installation, the following extra string displays in Russian: \r In the Select Features panel during agent installation, the of each feature is in English in an NLV enironment. When new V6.1 or V6.2 agent support files are added to IBM Tioli Monitoring V6.2.1 on Windows 2008, the portal serer configuration portion of the installation hangs. Warning message during application support installation KCIIN1421W WARNING - unable to copy eclipse agent plugin file $CANDLEHOME/$ITM_BINARCH/ cw/iehs/kpx /eclipse/plugins/com.ibm.kpx.doc Network Cards: The network card configurations can decrease the performance of a system. Each of the stream of packets that a network card receies (assuming that it is a broadcast or destined for the under-performing system) must generate a CPU interrupt and transfer the data through the I/O bus. If the network card in question is a bus-mastering card, work can be offloaded and a data transfer between memory and the network card can continue without using CPU processing power. Bus-mastering cards are 32-bit and are based on PCI or EISA bus architectures. There is no workaround at this time. There is no workaround at this time. There is no workaround at this time. See "When new agent support files are added to V6.2.1, the portal serer configuration portion of the installation hangs" in the "Installation and configuration troubleshooting" chapter of the IBM Tioli Monitoring Troubleshooting Guide. Manually rename or delete the agent plug-in file and run the application support installation again. Cannot find the agent support files for the Linux operating system. Support files for all IBM Tioli Monitoring supported operating systems are located on the support file image. Support files for the AIX operating system are also located on the agent image. Chapter 9. Troubleshooting 293

304 Table 5. General problems and solutions for uninstallation Problem Solution On Windows, uninstallation of IBM Tioli Monitoring fails to uninstall the entire enironment. The way to remoe inactie managed systems (systems whose status is OFFLINE) from the Naigator tree in the portal is not obious. While running./uninstall.sh to uninstall the agent, one of its components, or both, you receie the following error message and the uninstallation does not complete: uninstall.sh failure: KCI0766E could not find arch "aix536" in a JRE ersion file. Be sure that you follow the general uninstallation process described in the IBM Tioli Monitoring Installation and Setup Guide: 1. Remoe Tioli Enterprise Monitoring Serer Application support by completing the following steps: a. Use Manage Tioli Enterprise Monitoring Serices. b. Select Tioli Enterprise Monitoring Serer. c. Right-click and select Adanced. d. Select Remoe TEMS application support. e. Select the agent to remoe its application support. 2. Uninstall monitoring agents first, as in the following examples: Uninstall a single monitoring agent for a specific database. -OR Uninstall all instances of a monitoring product, such as IBM Tioli Monitoring for Databases. 3. Uninstall IBM Tioli Monitoring. Use the following steps to remoe, but not uninstall, an offline managed system from the Naigator tree: 1. Click the Enterprise icon in the Naigator tree. 2. Right-click, and then click Workspace > Managed System Status. 3. Right-click the offline managed system, and select Clear offline entry. If you also want to uninstall the monitoring agent, use the procedure described in the IBM Tioli Monitoring Installation and Setup Guide. There is a separate, manual procedure for uninstalling the system monitor agent that monitors the Linux or UNIX operating system: 1. Stop the agent by running the following command: InstDir/bin/itmcmd agent stop all 2. Stop any other agents running from the same InstDir directory. 3. Run the following command: InstDir/bin/uninstall.sh REMOVE EVERYTHING Note: Running the uninstall.sh script with REMOVE EVERYTHING remoes all agent files and deletes the installation subdirectory tree. Remote deployment troubleshooting Table 6 on page 295 lists problems that might occur with remote deployment. This section proides information about troubleshooting remote deployment of the monitoring agent. See the IBM Tioli Monitoring Troubleshooting Guide for general troubleshooting information. This section describes problems and solutions for remote deployment and remoal of agent software using the Agent Remote Deploy process. 294 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

305 Table 6. Remote deployment problems and solutions Problem Solution While you are using the remote deployment feature Do not close or modify this window. It is part of the to install the AIX Premium Agent, an empty installation process and is dismissed automatically. command window is displayed on the target computer. This problem occurs when the target of remote deployment is a Windows computer. (See the IBM Tioli Monitoring Installation and Setup Guide for more information about the remote deployment feature.) The remoal of a monitoring agent fails when you use the remote remoal process in the Tioli Enterprise Portal desktop or browser. This problem might occur when you attempt the remote remoal process immediately after you hae restarted the Tioli Enterprise Monitoring Serer. You must allow time for the monitoring agent to refresh its connection with the Tioli Enterprise Monitoring Serer before you begin the remote remoal process. Agent troubleshooting This section lists problems that might occur with agents. Table 7. Agent problems and solutions Problem Solution Log data accumulates too rapidly. If you want to receie multiple trace logs for separate inocations of the same Take Action command, leaing this setting on permanently fills the aailable disk space. No data shown in the Tioli Enterprise Portal for all attribute groups. This chapter proides agent-specific troubleshooting information. See the IBM Tioli Monitoring Troubleshooting Guide for general troubleshooting information. Check the RAS trace option settings, which are described in Setting RAS trace parameters on page 289. The trace options settings that you can set on the KBB_RAS1= and KDC_DEBUG= lines potentially generate large amounts of data. Do not leae this setting on permanently. By doing so, you create a new log file for each inocation of the Take Action command and all of them are left on the agent system. Inspect the data in the Performance Object Status attribute group and restart the agent. Chapter 9. Troubleshooting 295

306 Table 7. Agent problems and solutions (continued) Problem Solution Empty workspace iews are displayed in the Tioli Enterprise Portal. IBM Tioli Monitoring uses timeout settings during agent metric gathering as a way to aoid prolonged waits for data at the Tioli Enterprise Portal client. When an agent takes longer than the portal timeout period to proide data, the requesting portal workspaces show empty iews. The IBM Tioli Monitoring System p agents implement metric caching to alleiate running into these timeouts when metric data acquisition is taking a long time. When data is retrieed by the agent, it caches the attribute group returned to the portal. Metrics gathered within the portal timeout period are readily displayed on the console. Those attribute groups taking longer, are displayed from cache while the agent continues to collect data in the background for the original request. Because of the way some metrics are gathered, certain metrics take longer than the default timeout and fail to make it to the cache before the portal timeout expires. Typically, this problem is caused by network traffic, SSH communication oerhead, HMC IPC communication layer, Logical Volume Manager communication layer and possible other circumstances. As a result, the portal displays empty workspace iews for these attribute groups. The workspace only shows data once the data has been cached. CPU, network interface, and Workload Manager (WLM) metrics are not dynamically updated in the CPU Detail, Workload Manager and Internet Protocol Detail attribute groups, if these resources are added or remoed after the AIX Premium agent is started. The following attribute groups are affected by these behaiors: File Systems Physical Volumes Logical Volumes Network Adapter Totals Network Adapter Rates Metrics for these attribute groups are taken from the System Performance Measurement Interface (SPMI) shared library. After the SPMI is initialized, it creates a list of CPUs, network interfaces, and WLM classes configured. The SPMI library does not reinitialize these lists until one of the following occurs: 1. The system is rebooted. 2. The number of consumers using the library goes to zero, and programs that were using the library end their SPMI connection gracefully. 3. A manual recycling of the SPMI shared library is performed. Recycling of the IBM Tioli Monitoring agent might not sole the problem if there are other SPMI consumers. A consumer is any program that has established a connection with the SPMI to acquire data. It is also possible to hae a program that is a DDS (Dynamic Data Supplier) that proides data to the SPMI. Some examples of both are: topas, xmtopas, xmserd, xmtrend, and the IBM Tioli Monitoring: AIX Premium Agent. To recycle the SPMI without rebooting: 1. All data SPMI consumers and DDSs must end. 2. Ensure that there are no Shared Memory IDs remaining that start with a key of 0x If so, run ipcrm -m id. 4. Run slibclean. 296 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

307 Table 7. Agent problems and solutions (continued) Problem Solution A configured and running instance of the monitoring agent is not displayed in the Tioli Enterprise Portal, but other instances of the monitoring agent on the same system do appear in the portal. Tioli Monitoring products use Remote Procedure Call (RPC) to define and control product behaior. RPC is the mechanism that allows a client process to make a subroutine call (such as GetTimeOfDay or ShutdownSerer) to a serer process somewhere in the network. Tioli processes can be configured to use TCP/UDP, TCP/IP, SNA, and SSL as the protocol (or deliery mechanism) for RPCs that you want. "IP.PIPE" is the name gien to Tioli TCP/IP protocol for RPCs. The RPCs are socket-based operations that use TCP/IP ports to form socket addresses. IP.PIPE implements irtual sockets and multiplexes all irtual socket traffic across a single physical TCP/IP port (isible from the netstat command). A Tioli process deries the physical port for IP.PIPE communications based on the configured, well-known port for the hub Tioli Enterprise Monitoring Serer. (This well-known port or BASE_PORT is configured by using the 'PORT:' keyword on the KDC_FAMILIES / KDE_TRANSPORT enironment ariable and defaults to '1918'.) The physical port allocation method is defined as (BASE_PORT *N), where N=0 for a Tioli Enterprise Monitoring Serer process and N={1, 2,..., 15} for a non-tioli Enterprise Monitoring Serer. Two architectural limits result as a consequence of the physical port allocation method: No more than one Tioli Enterprise Monitoring Serer reporting to a specific Tioli Enterprise Monitoring Serer hub can be actie on a system image. No more than 15 IP.PIPE processes can be actie on a single system image. A single system image can support any number of Tioli Enterprise Monitoring Serer processes (address spaces) if each Tioli Enterprise Monitoring Serer on that image reports to a different hub. By definition, there is one Tioli Enterprise Monitoring Serer hub per monitoring Enterprise, so this architecture limit has been simplified to one Tioli Enterprise Monitoring Serer per system image. No more than 15 IP.PIPE processes or address spaces can be actie on a single system image. With the first limit expressed aboe, this second limitation refers specifically to Tioli Enterprise Monitoring Agent processes: no more than 15 agents per system image. This limitation can be circumented (at current maintenance leels, IBM Tioli Monitoring V6.1, Fix Pack 4 and later) if the Tioli Enterprise Monitoring Agent process is configured to use the EPHEMERAL IP.PIPE process. (This process is IP.PIPE configured with the 'EPHEMERAL:Y' keyword in the KDC_FAMILIES / KDE_TRANSPORT enironment ariable). There is no limitation to the number of ephemeral IP.PIPE connections per system image. If ephemeral endpoints are used, the Warehouse Proxy Agent is accessible from the Tioli Enterprise Monitoring Serer associated with the agents using ephemeral connections either by running the Warehouse Proxy Agent on the same computer or by using the Firewall Gateway feature. (The Firewall Gateway feature relays the Warehouse Proxy Agent connection from the Tioli Enterprise Monitoring Serer computer to the Warehouse Proxy Agent computer if the Warehouse Proxy Agent cannot coexist on the same computer.) Workspace troubleshooting Table 8 on page 298 shows problems that might occur with workspaces. This chapter proides agent-specific troubleshooting information. See the IBM Tioli Monitoring Troubleshooting Guide for general troubleshooting information. Chapter 9. Troubleshooting 297

308 Table 8. Workspace problems and solutions Problem The process application components are aailable, but the Aailability status shows PROCESS_DATA_NOT_ AVAILABLE. The name of the attribute does not display in a bar chart or graph iew. You start collection of historical data but the data cannot be seen. Solution This problem occurs because the PerfProc performance object is disabled. When this condition exists, IBM Tioli Monitoring cannot collect performance data for this process. Perform the following steps to confirm that this problem exists and resole it: 1. Choose Run in the Windows Start menu. 2. perfmon.exe in the Open field of the Run window. The Performance window is displayed. 3. Click the plus sign (+) in the toolbar located aboe the right pane. The Add Counters window is displayed. 4. Look for Process in the Performance object pull-down menu. 5. Perform one of the following actions: If you see Process in the pull-down menu, the PerfProc performance object is enabled and the problem is coming from a different source. You might need to contact IBM Software Support. If you do not see Process in the pull-down menu, use the Microsoft utility from the following website to enable the PerfProc performance object: the-mystery-of-the-missing-process-performancecounter-in-perfmon.aspx The Process performance object becomes isible in the Performance object pull-down menu of the Add Counters windows, and IBM Tioli Monitoring is able to detect Aailability data. 6. Restart the monitoring agent. When a chart or graph iew that includes the attribute is scaled to a small size, a blank space is displayed instead of a truncated name. To see the name of the attribute, expand the iew of the chart until there is sufficient space to display all characters of the attribute name. Managing options for historical data collection: Basic historical data collection populates the Warehouse with raw data. This type of data collection is turned off by default. See the IBM Tioli Monitoring Administrator's Guide for information about managing this feature including how to set the interal at which data is collected. By setting a more frequent interal for data collection you reduce the load on the system incurred eery time data is uploaded. You use the Summarization and Pruning monitoring agent to collect specific amounts and types of historical data. Historical data is not displayed until the Summarization and Pruning monitoring agent begins collecting the data. By default, this agent begins collection at 2 AM daily. At that point, data is isible in the workspace iew. See the IBM Tioli Monitoring Administrator's Guide to learn how to modify the default collection settings. 298 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

309 Table 8. Workspace problems and solutions (continued) Problem Solution Historical data collection is unaailable because of incorrect queries in the Tioli Enterprise Portal. When you use a long process name in the situation, the process name is truncated. Regular (non-historical) monitoring data fails to be displayed. No row of data for 64-bit applications is displayed in the workspaces when the monitoring agent is running on a 64-bit operating system. Naigator items and workspace titles are labeled with internal names such as Kxx:KXX0000 or Kxx:KXX0000 rather than the correct names (such as Disk), where XX and xx represent the two-character agent code. The column, Sort By, Group By, and First/Last functions are not compatible with the historical data collection feature. Use of these adanced functions makes a query ineligible for historical data collection. Een if data collection has been started, you cannot use the time span feature if the query for the chart or table includes column functions or adanced query options (Sort By, Group By, First / Last). To ensure support of historical data collection, do not use the Sort By, Group By, or First/Last functions in your queries. See the IBM Tioli Monitoring Administrator's Guide or the Tioli Enterprise Portal online help for information about the Historical Data Collection function. Truncation of process or serice names for situations in the Aailability table in the portal display is the expected behaior. 100 bytes is the maximum name length. Check the formation of the queries you use to gather data. For example, look for inalid SQL statements. The Tioli Enterprise Portal shows data only for 32-bit applications. There is no solution for this problem at this time. Ensure that application support has been added on the monitoring serer, portal serer, and portal client. For more information and instruction on installing application support, see "Installing and enabling application support" in the IBM Tioli Monitoring Installation and Setup Guide. Situation troubleshooting This section proides information about both general situation problems and problems with the configuration of situations. See the IBM Tioli Monitoring Troubleshooting Guide for more information about troubleshooting for situations. General situation problems Table 9 lists general problems that might occur with situations. Table 9. General situation problems and solutions Problem Solution Monitoring actiity requires too much disk space. Monitoring actiity requires too many system resources. Check the RAS trace logging settings that are described in Setting RAS trace parameters on page 289. For example, trace logs grow rapidly when you apply the ALL logging option. Disk capacity planning for historical data on page 214 describes the performance impact of specific attribute groups. If possible, decrease your use of the attribute groups that require greater system resources. Chapter 9. Troubleshooting 299

310 Table 9. General situation problems and solutions (continued) Problem Solution A formula that uses mathematical operators appears to be incorrect. For example, if you were monitoring a Linux system, the formula that calculates when Free Memory falls under 10 percent of Total Memory does not work: LT # Linux_VM_Stats.Total_Memory / 10 You want to change the appearance of situations when they are displayed in the naigation tree. When a situation is triggered in the Eent Log attribute group, it remains in the Situation Eent Console as long as the eent ID entry is present in the Eent Log workspace. When this eent ID entry is remoed from the Eent Log workspace on the Tioli Enterprise Portal, the situation is also cleared een if the actual problem that caused the eent is not resoled, and the eent ID entry is also present in the Windows Eent Viewer. This formula is incorrect because situation predicates support only logical operators. Your formulas cannot hae mathematical operators. Note: The Situation Editor proides alternaties to math operators. Regarding the example, you can select the % Memory Free attribute and aoid the need for math operators. 1. Right-click an item in the naigation tree. 2. Select Situations in the menu. The Situation Editor window is displayed. 3. Select the situation that you want to modify. 4. Use the State pull-down menu in the lower right of the window to set the status and appearance of the Situation when it triggers. Note: The State setting is not related to seerity settings in IBM Tioli Enterprise Console. A timeout occurs on the cache of eents for the NT Eent Log group. Increase the cache time of Eent Log collection to meet your requirements by adding the following ariable and timeout alue to the KXXENV file for the agent: CDP_NT_EVENT_LOG_CACHE_TIMEOUT=3600 This ariable determines how long eents from the NT Eent Log are kept. Problems with configuration of situations Table 10 lists problems that might occur with configuring situations. This section proides information for troubleshooting for agents. Be sure to consult the IBM Tioli Monitoring Troubleshooting Guide for more general troubleshooting information. Table 10. Problems with configuring situations that you sole in the Situation Editor Problem Solution Note: To get started with the solutions in this section, perform these steps: 1. Launch the Tioli Enterprise Portal. 2. Click Edit > Situation Editor. 3. In the naigation tree, choose the agent whose situation you want to modify. 4. Choose the situation in the list. The Situation Editor iew is displayed. The situation for a specific agent is not isible in the Tioli Enterprise Portal. The monitoring interal is too long. Open the Situation Editor. Access the All managed serers iew. If the situation is absent, confirm that the monitoring serer has been seeded for the agent. If not, seed the serer, as described in the IBM Tioli Monitoring Installation and Setup Guide. Access the Situation Editor iew for the situation that you want to modify. Check the Sampling interal area in the Formula tab. Adjust the time interal as needed. 300 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

311 Table 10. Problems with configuring situations that you sole in the Situation Editor (continued) Problem Solution The situation did not actiate at Manually recycle the situation as follows: startup. 1. Right-click the situation and choose Stop Situation. 2. Right-click the situation and choose Start Situation. Note: You can permanently aoid this problem by placing a check mark in the Run at Startup option of the Situation Editor iew for a specific situation. The situation is not displayed. Click the Action tab and check whether the situation has an automated correctie action. This action can occur directly or through a policy. The situation might be resoling so quickly that you do not see the eent or the update in the graphical user interface. An Alert eent has not occurred Check the logs, reports, and workspaces. een though the predicate has been properly specified. A situation fires on an unexpected managed object. The product did not distribute the situation to a managed system. The situation does not fire. Confirm that you hae distributed and started the situation on the correct managed system. Click the Distribution tab and check the distribution settings for the situation. This problem can be caused when incorrect predicates are present in the formula that defines the situation. For example, the managed object shows a state that normally triggers a monitoring eent, but the situation is not true because the wrong attribute is specified in the formula. In the Formula tab, analyze predicates as follows: 1. Click the fx icon in the upper-right corner of the Formula area. The Show formula window is displayed. a. Confirm the following details in the Formula area at the top of the window: The attributes that you intend to monitor are specified in the formula. The situations that you intend to monitor are specified in the formula. The logical operators in the formula match your monitoring goal. The numeric alues in the formula match your monitoring goal. b. (Optional) Select the Show detailed formula check box in the lower left of the window to see the original names of attributes in the application or operating system that you are monitoring. c. Click OK to dismiss the Show formula window. 2. (Optional) In the Formula area of the Formula tab, temporarily assign numeric alues that immediately trigger a monitoring eent. The triggering of the eent confirms that other predicates in the formula are alid. Note: After you complete this test, you must restore the numeric alues to alid leels so that you do not generate excessie monitoring data based on your temporary settings. See the IBM Tioli Monitoring Troubleshooting Guide for additional information about situations that do not fire. Table 11. Problems with configuration of situations that you sole in the Workspace area Problem Solution Situation eents are not displayed in the Eents Console iew of the workspace. Associate the situation with a Naigator item. Note: The situation does not need to be displayed in the workspace. It is sufficient that the situation is associated with any Naigator item. Chapter 9. Troubleshooting 301

312 Table 11. Problems with configuration of situations that you sole in the Workspace area (continued) Problem Solution You do not hae access to a Note: You must hae administrator priileges to perform these steps. situation. 1. Select Edit > Administer Users to access the Administer Users window. 2. In the Users area, select the user whose priileges you want to modify. 3. In the Permissions tab, Applications tab, and Naigator Views tab, select the permissions or priileges that correspond to the user role. 4. Click OK. A managed system seems to be offline. 1. Select Physical View and highlight the Enterprise Leel of the naigator tree. 2. Select View > Workspace > Managed System Status to see a list of managed systems and their status. 3. If a system is offline, check network connectiity and the status of the specific system or application. Take Action commands troubleshooting Table 12 lists general problems that might occur with Take Action commands. When each Take Action command runs it generates the log file listed in Table 3 on page 287. This chapter proides agent-specific troubleshooting information. See the IBM Tioli Monitoring Troubleshooting Guide for general troubleshooting information. Table 12. Take Action commands problems and solutions Problem Solution Take Action commands often require seeral minutes to complete. Situations fail to trigger Take Action commands. Allow seeral minutes. If you do not see a message adising you of completion, try to run the command manually. Attempt to manually run the Take Action command in the Tioli Enterprise Portal. If the Take Action command works, look for configuration problems in the situation. See Situation troubleshooting on page 299. If the Take Action command fails, see IBM Tioli Monitoring Troubleshooting Guide for general information about troubleshooting Take Action commands. Discoery Library Adapter for the agent troubleshooting Table 13 contains a list of problems that might occur when the using the Discoery Library Adapter with AIX Premium Agent. For information about troubleshooting for the Discoery Library Adapter, see com.ibm.taddm.doc_7.2/welcome_page/welcome.html. Table 13. Discoery Library Adapter for AIX Premium Agent problems and solutions Problem Solution Tioli Business Serice Manager cannot load the AIX Premium Agent DLA. If you are running both the AIX Premium Agent and the AIX OS agent on the same machine, you may need to install Tioli Business Serice Manager V4.2.1 Fix Pack IBM Tioli Monitoring: AIX Premium Agent: User's Guide

313 Support information If you hae a problem with your IBM software, you want to resole it quickly. IBM proides the following ways for you to obtain the support you need: Online The following sites contain troubleshooting information: Go to the IBM Software Support site at support/probsub.html and follow the instructions. Go to the IBM Tioli Distributed Monitoring and Application Management Wiki at display/tiolimonitoring/home. Feel free to contribute to this wiki. IBM Support Assistant The IBM Support Assistant (ISA) is a free local software sericeability workbench that helps you resole questions and problems with IBM software products. The ISA proides quick access to support-related information and sericeability tools for problem determination. To install the ISA software, go to Chapter 9. Troubleshooting 303

314 304 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

315 Appendix A. IBM Tioli Enterprise Console eent mapping Each eent class corresponds to an attribute group in the IBM Tioli Enterprise Console. For a description of the eent slots for each eent class, see the lists in this appendix. For more information about mapping attribute groups to eent classes, see the IBM Tioli Monitoring Administrator's Guide. Generic eent mapping proides useful eent class and attribute information for situations that do not hae specific eent mapping defined. BAROC files are found on the Tioli Enterprise Monitoring Serer in the installation directory in TECLIB (that is, install_dir/cms/teclib for Windows systems and install_dir/tables/ TEMS_hostname/TECLIB for UNIX systems). IBM Tioli Enterprise Console eent synchronization proides a collection of ready-to-use rule sets that you can deploy with minimal configuration. Be sure to install IBM Tioli Enterprise Console eent synchronization to access the correct Sentry.baroc, which is automatically included during base configuration of IBM Tioli Enterprise Console rules if you indicate that you want to use an existing rule base. See the IBM Tioli Monitoring Installation and Setup Guide for details. Each of the eent classes is a child of KPX_Base and is defined in the kpx.baroc (ersion ) file. The KPX_Base eent class can be used for generic rules processing for any eent from the IBM Tioli Monitoring: AIX Premium Agent. For eents generated by situations in the Actie Memory Expansion attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_ACTIVE MEMORY EXPANSION class. This class contains the following slots: node: STRING timestamp: STRING ame_mode: INTEGER ame_mode_enum: STRING true_memory_size_mb: REAL target_memory_expansion_factor: REAL current_memory_expansion_factor: REAL effectie_memory_size_mb: REAL target_compressed_mem_size_mb: REAL max_compressed_mem_size_mb: REAL min_uncompressed_mem_size_mb: REAL compressed_mem_size_mb: REAL compressed_data_size_mb: REAL uncompressed_data_size_mb: REAL compressed_mem_inuse_mb: REAL compressed_mem_inuse_pct: REAL compressed_mem_pct: REAL compressed_mem_free_mb: REAL compressed_mem_free_pct: REAL compression_ratio: REAL compressed_mem_page_ins: INTEGER Copyright IBM Corp. 2007,

316 compressed_mem_page_outs: INTEGER compressed_num_working_pages: INTEGER uncompressed_mem_size_mb: REAL uncompressed_mem_inuse_mb: REAL uncompressed_mem_inuse_pct: REAL uncompressed_mem_free_pct: REAL uncompressed_true_mem_inuse_pct: REAL uncompressed_num_working_pages: INTEGER cpu_used_pct: REAL deficit_memory_mb: REAL deficit_expansion_factor: REAL For eents generated by situations in the Actie Users attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_ACTIVE USERS class. This class contains the following slots: node: STRING timestamp: STRING user_name: STRING tty: STRING login_date_time: STRING kpx_hostname: STRING idle_time: STRING jcpu: STRING pcpu: STRING current_process: STRING For eents generated by situations in the AMS Pool attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_AMS POOL class. This class contains the following slots: node: STRING timestamp: STRING ams_mode: INTEGER ams_mode_enum: STRING ams_pool_id: INTEGER ams_pool_id_enum: STRING ams_pool_size: REAL ams_physical_mem: REAL ams_mem_loaned: INTEGER ams_memory_entitlement: INTEGER ams_memory_ent_inuse: REAL hyperisor_page_ins: REAL hyperisor_page_ins_time: REAL For eents generated by situations in the CPU Detail attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_CPU DETAIL class. This class contains the following slots: node: STRING 306 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

317 timestamp: STRING cpu_number: STRING user_cpu_pct: INTEGER system_cpu_pct: INTEGER io_wait_cpu_pct: INTEGER idle_cpu_pct: INTEGER context_switches_per_sec: INTEGER syscalls_per_sec: INTEGER reads_per_sec: INTEGER writes_per_sec: INTEGER forks_per_sec: INTEGER execs_per_sec: INTEGER read_char_per_sec: INTEGER write_char_per_sec: INTEGER inode_lookup_per_sec: INTEGER path_name_lookup_per_sec: INTEGER dir_blk_scans_per_sec: INTEGER minor_page_faults: INTEGER major_page_faults: INTEGER interrupts: INTEGER inoluntary_context_switches: INTEGER run_queue: INTEGER logical_processor_affinity: INTEGER message_ops: INTEGER semaphore_ops: INTEGER blocks_read: INTEGER blocks_write: INTEGER logical_read_requests: INTEGER logical_write_requests: INTEGER physical_reads: INTEGER physical_writes: INTEGER logical_context_switches: INTEGER physical_consumption: REAL For eents generated by situations in the CPU Summary attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_CPU SUMMARY class. This class contains the following slots: node: STRING timestamp: STRING system_software_ersion: STRING number_of_cpus: INTEGER user_cpu_pct: INTEGER system_cpu_pct: INTEGER io_wait_cpu_pct: INTEGER idle_cpu_pct: INTEGER physical_consumption: REAL Appendix A. IBM Tioli Enterprise Console eent mapping 307

318 donation_enablement: INTEGER donated_idle_cycles_pct: REAL donated_busy_cycles_pct: REAL stolen_idle_cycles_pct: REAL stolen_busy_cycles_pct: REAL hyperisor_calls: INTEGER time_spent_in_hyperisor_pct: REAL donating_lpars: INTEGER aerage_operating_frequency_ghz: REAL aerage_operating_frequency_pct: INTEGER actual_aerage_physical_cpu_user: REAL actual_aerage_physical_cpu_system: REAL actual_aerage_physical_cpu_idle: REAL actual_aerage_physical_cpu_wait: REAL normalized_aerage_physical_cpu_user: REAL normalized_aerage_physical_cpu_system: REAL normalized_aerage_physical_cpu_idle: REAL normalized_aerage_physical_cpu_wait: REAL For eents generated by situations in the Defined Users attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_DEFINED USERS class. This class contains the following slots: node: STRING timestamp: STRING user_name: STRING roles: STRING account_locked: STRING expires: STRING loginretries: INTEGER For eents generated by situations in the Deices attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_DEVICES class. This class contains the following slots: node: STRING timestamp: STRING name: STRING parent: STRING type: STRING state: STRING kpx_class: STRING For eents generated by situations in the Disks attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_DISKS class. This class contains the following slots: node: STRING timestamp: STRING name: STRING 308 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

319 parent: STRING type: STRING actie_disk_pct: REAL transfers_bytes_per_sec: INTEGER transfers_kb_per_sec: INTEGER transfers_per_sec: INTEGER read_kb_per_sec: INTEGER written_kb_per_sec: INTEGER read_transfers_per_sec: INTEGER ag_read_transfer_ms: REAL min_read_serice_ms: REAL max_read_serice_ms: REAL read_timeouts_per_sec: INTEGER failed_read_per_sec: INTEGER write_transfers_per_sec: INTEGER ag_write_transfer_ms: REAL min_write_serice_ms: REAL max_write_serice_ms: REAL write_timeout_per_sec: REAL failed_writes_per_sec: INTEGER ag_request_in_waitq_ms: REAL min_request_in_waitq_ms: REAL max_request_in_waitq_ms: REAL ag_waitq_size: INTEGER ag_sericeq_size: INTEGER sericeq_full_per_sec: INTEGER For eents generated by situations in the File Systems attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_FILE SYSTEMS class. This class contains the following slots: node: STRING timestamp: STRING name: STRING mount_point: STRING olume_group_name: STRING size_mb: INTEGER free_mb: INTEGER used_mb: INTEGER free_pct: INTEGER used_pct: INTEGER For eents generated by situations in the Internet Protocol Detail attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_INTERNET PROTOCOL DETAIL class. This class contains the following slots: node: STRING timestamp: STRING Appendix A. IBM Tioli Enterprise Console eent mapping 309

320 name: STRING packets_receied_per_sec: INTEGER ioctet_receied_kb_per_sec: INTEGER input_errors_per_sec: INTEGER multicast_pkt_receied_per_sec: INTEGER input_packets_dropped_per_sec: INTEGER packets_transmitted_per_sec: INTEGER ioctet_transmitted_kb_per_sec: INTEGER output_errors_per_sec: INTEGER multicast_pkt_transmitted_per_sec: INTEGER For eents generated by situations in the Internet Protocol Summary attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_INTERNET PROTOCOL SUMMARY class. This class contains the following slots: node: STRING timestamp: STRING packets_receied_per_sec: INTEGER frag_receied_per_sec: INTEGER packets_forwarded_per_sec: INTEGER receied_datagrams_per_sec: INTEGER transmitted_datagrams_per_sec: INTEGER total_packets_reassembled_per_sec: INTEGER frag_output_packets_per_sec: INTEGER For eents generated by situations in the Logical Partition attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_LOGICAL PARTITION class. This class contains the following slots: node: STRING timestamp: STRING user_cpu_pct: INTEGER system_cpu_pct: INTEGER io_wait_cpu_pct: INTEGER idle_cpu_pct: INTEGER entitlement: REAL total_used_pct: INTEGER entitlement_used_pct: INTEGER lpar_number: INTEGER shared_mode: STRING capped_mode: STRING smt_mode: STRING number_of_physical_cpus: INTEGER number_of_irtual_cpus: INTEGER number_of_logical_cpus: INTEGER aailable_cpus_in_pool: INTEGER number_of_physical_cpus_in_shared_pool: INTEGER busy_pct: INTEGER 310 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

321 phys_busy_pct: INTEGER irt_context_cpu_switches_per_sec: INTEGER max_memory: INTEGER min_memory: INTEGER max_phys_cpus: INTEGER min_irt_cpus: INTEGER max_irt_cpus: INTEGER min_cpu_capacity: INTEGER max_cpu_capacity: INTEGER cpu_capacity_increment: INTEGER online_mem: INTEGER max_dispatch_latency: INTEGER unallocated_cpu_in_pool: INTEGER cpu_entitlement: INTEGER capacity_weight: INTEGER min_req_irt_cpu: INTEGER phantom_interrupts: INTEGER entitlement_pct: INTEGER num_hyperisor_calls_per_sec: INTEGER time_in_hyperisor_pct: INTEGER machine_id: STRING uptime: STRING kpx_hostname: STRING physical_cpu_units_used: REAL aailable_cpu_units_in_pool: REAL physical_cpu_size_of_shared_pool: REAL last_machine_id: STRING max_cpu_cap_used_pct: REAL poolid: INTEGER pool_entitlement: REAL maximum_pool_capacity: REAL smt_threads: INTEGER entitlement_2: REAL For eents generated by situations in the Logical Volumes attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_LOGICAL VOLUMES class. This class contains the following slots: node: STRING timestamp: STRING name: STRING state: STRING olume_group_name: STRING type: STRING mount_point: STRING size_mb: INTEGER Appendix A. IBM Tioli Enterprise Console eent mapping 311

322 For eents generated by situations in the MPIO Attributes attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_MPIO ATTRIBUTES class. This class contains the following slots: node: STRING timestamp: STRING deice_name: STRING attribute: STRING kpx_alue: STRING description: STRING user_settable: STRING For eents generated by situations in the MPIO Status attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_MPIO STATUS class. This class contains the following slots: node: STRING timestamp: STRING deice_name: STRING parent: STRING path_status: STRING kpx_status: STRING connection: STRING For eents generated by situations in the Network Adapters Rates attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_NETWORK ADAPTERS RATES class. This class contains the following slots: node: STRING timestamp: STRING name: STRING parent: STRING type: STRING bytes_sent_per_sec: INTEGER pkts_sent_per_sec: INTEGER pkts_sent_errors_per_sec: INTEGER sent_pkts_dropped_per_sec: INTEGER broadcast_pkts_sent_per_sec: INTEGER multicast_pkts_sent_per_sec: INTEGER sent_interrupts_per_sec: INTEGER bytes_recd_per_sec: INTEGER pkts_recd_per_sec: INTEGER pkts_rec_errors_per_sec: INTEGER bad_pkts_recd_per_sec: INTEGER rec_pkts_dropped_per_sec: INTEGER broadcast_pkts_recd_per_sec: INTEGER multicast_pkts_recd_per_sec: INTEGER rec_interrupts_per_sec: INTEGER transmitsq_per_sec: INTEGER max_transmitsq_per_sec: INTEGER 312 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

323 qoerflow_per_sec: INTEGER real_pkts_recd_per_sec: INTEGER real_pkts_bridged_per_sec: INTEGER real_pkts_consumed_per_sec: INTEGER real_pkts_fragmented_per_sec: INTEGER real_pkts_sent_per_sec: INTEGER real_pkts_dropped_per_sec: INTEGER irtual_pkts_recd_per_sec: INTEGER irtual_pkts_bridged_per_sec: INTEGER irtual_pkts_consumed_per_sec: INTEGER irtual_pkts_fragmented_per_sec: INTEGER irtual_pkts_sent_per_sec: INTEGER irtual_pkts_dropped_per_sec: INTEGER output_pkts_generated_per_sec: INTEGER output_pkts_dropped_per_sec: INTEGER output_pkts_failures_per_sec: INTEGER mem_alloc_failures_per_sec: INTEGER icmp_error_pkts_sent_per_sec: INTEGER non_ip_pkts_larger_than_mtu_per_sec: INTEGER threadq_oerflow_pkts_per_sec: INTEGER ha_keep_alie_pkts_per_sec: INTEGER ha_recoery_pkts_per_sec: INTEGER ha_notify_pkts_per_sec: INTEGER ha_limbo_pkts_per_sec: INTEGER ha_state: STRING ha_bridge_mode: STRING times_primary_per_sec: INTEGER time_backup_per_sec: INTEGER ha_mode: STRING priority: INTEGER adapter_protocol: STRING media_speed_running: STRING bandwidth_util_pct: REAL For eents generated by situations in the Network Adapters Totals attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_NETWORK ADAPTERS TOTALS class. This class contains the following slots: node: STRING timestamp: STRING name: STRING parent: STRING type: STRING bytes_sent: STRING pkts_sent: STRING pkts_sent_error: STRING sent_pkts_dropped: STRING Appendix A. IBM Tioli Enterprise Console eent mapping 313

324 broadcast_pkts_sent: STRING multicast_pkts_sent: STRING sent_interrupts: STRING bytes_recd: STRING pkts_recd: STRING pkts_rec_error: STRING bad_pkts_recd: STRING rec_pkts_dropped: STRING broadcast_pkts_recd: STRING multicast_pkts_recd: STRING rec_interrupts: STRING transmitsq: STRING max_transmitsq: STRING qoerflow: STRING real_pkts_recd: STRING real_pkts_bridged: STRING real_pkts_consumed: STRING real_pkts_fragmented: STRING real_pkts_sent: STRING real_pkts_dropped: STRING irtual_pkts_recd: STRING irtual_pkts_bridged: STRING irtual_pkts_consumed: STRING irtual_pkts_fragmented: STRING irtual_pkts_sent: STRING irtual_pkts_dropped: STRING output_pkts_generated: STRING output_pkts_dropped: STRING output_pkts_failures: STRING mem_alloc_failures: STRING icmp_error_pkts_sent: STRING non_ip_pkts_larger_than_mtu: STRING threadq_oerflow_pkts: STRING ha_keep_alie_pkts: STRING ha_recoery_pkts: STRING ha_notify_pkts: STRING ha_limbo_pkts: STRING ha_state: STRING ha_bridge_mode: STRING times_primary: STRING times_backup: STRING ha_mode: STRING priority: STRING 314 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

325 For eents generated by situations in the Network Interfaces attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_NETWORK INTERFACES class. This class contains the following slots: node: STRING timestamp: STRING name: STRING state: STRING ip_address: STRING mtu: STRING mask: STRING domain: STRING gateway: STRING nameserer: STRING For eents generated by situations in the NIM Resources attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_NIM RESOURCES class. This class contains the following slots: node: STRING timestamp: STRING name: STRING type: STRING kpx_class: STRING state: STRING serer: STRING location: STRING information: STRING For eents generated by situations in the Paging Space attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_PAGING SPACE class. This class contains the following slots: node: STRING timestamp: STRING total_size_mb: INTEGER free_mb: INTEGER used_mb: INTEGER free_pct: INTEGER used_pct: INTEGER pages_read_per_sec: INTEGER pages_written_per_sec: INTEGER For eents generated by situations in the Performance Object Status attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_PERFORMANCE OBJECT STATUS class. This class contains the following slots: node: STRING timestamp: STRING query_name: STRING object_name: STRING Appendix A. IBM Tioli Enterprise Console eent mapping 315

326 object_type: INTEGER object_type_enum: STRING object_status: INTEGER object_status_enum: STRING error_code: INTEGER error_code_enum: STRING For eents generated by situations in the Physical Memory attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_PHYSICAL MEMORY class. This class contains the following slots: node: STRING timestamp: STRING memory_size_mb: INTEGER free_memory_mb: INTEGER used_memory_mb: INTEGER free_memory_pct: INTEGER used_memory_pct: INTEGER non_comp_memory: INTEGER comp_memory: INTEGER decay_rate: INTEGER repaging_rate: INTEGER For eents generated by situations in the Physical Volumes attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_PHYSICAL VOLUMES class. This class contains the following slots: node: STRING timestamp: STRING name: STRING state: STRING olume_group_name: STRING number_of_logical_olumes: INTEGER number_of_stale_partitions: INTEGER size_mb: INTEGER free_mb: INTEGER used_mb: INTEGER free_pct: INTEGER used_pct: INTEGER unique_id: STRING For eents generated by situations in the Print Queues attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_PRINT QUEUES class. This class contains the following slots: node: STRING timestamp: STRING name: STRING deice: STRING state: STRING 316 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

327 description: STRING For eents generated by situations in the Processes Detail attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_PROCESSES DETAIL class. This class contains the following slots: node: STRING timestamp: STRING process_name: STRING process_id: INTEGER parent_process_id: INTEGER nice: INTEGER user_name: STRING repage_count_per_sec: INTEGER io_page_fault_per_sec: INTEGER non_io_page_fault_per_sec: INTEGER text_size: INTEGER resident_text_size: INTEGER resident_data_size: INTEGER page_space_used: INTEGER signals_in_per_sec: INTEGER oluntary_context_switches_per_sec: INTEGER process_group_id: INTEGER priority: INTEGER state: INTEGER state_enum: STRING process_uid: INTEGER thread_count: INTEGER process_core_size: INTEGER inoluntary_context_switches_per_sec: INTEGER total_cpu_time: INTEGER cpu_pct: REAL wpar_name: STRING wlm_name: STRING full_path: STRING For eents generated by situations in the Processes Summary attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_PROCESSES SUMMARY class. This class contains the following slots: node: STRING timestamp: STRING process_context_switches_per_sec: INTEGER run_queue_ag: INTEGER swap_queue_ag: INTEGER kern_procs_created_per_sec: INTEGER kern_procs_exit_per_sec: INTEGER load_ag: INTEGER Appendix A. IBM Tioli Enterprise Console eent mapping 317

328 utilization_ag: INTEGER total_num_processes: INTEGER For eents generated by situations in the Quality Of Serice attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_QUALITY OF SERVICE class. This class contains the following slots: node: STRING timestamp: STRING policy_rule_priority: INTEGER protocol: INTEGER source_ip_addr_start: STRING source_ip_addr_end: STRING dest_ip_addr_start: STRING dest_ip_addr_end: STRING source_port_start: INTEGER source_port_end: INTEGER dest_port_start: INTEGER dest_port_end: INTEGER serice_class: INTEGER serice_class_enum: STRING peak_rate: STRING aerage_rate: STRING bucket_depth: STRING guaranteed_rate: STRING slack_term: STRING tos_in: STRING tos_out: STRING max_packet_size: INTEGER min_packet_size: INTEGER num_connections: INTEGER bytes_xmited: STRING packets_xmited: STRING in_profile_bytes_xmited: STRING in_profile_packets_xmited: STRING For eents generated by situations in the System Call attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_SYSTEM CALL class. This class contains the following slots: node: STRING timestamp: STRING num_syscalls_per_sec: INTEGER reads_per_sec: INTEGER writes_per_sec: INTEGER forks_per_sec: INTEGER execs_per_sec: INTEGER 318 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

329 For eents generated by situations in the System IO attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_SYSTEM IO class. This class contains the following slots: node: STRING timestamp: STRING syscall_read_chars_per_sec: INTEGER syscall_write_chars_per_sec: INTEGER logical_blk_buffer_cache_reads_per_sec: INTEGER logical_blk_buffer_cache_writes_per_sec: INTEGER phys_blk_buffer_cache_reads_per_sec: INTEGER phys_blk_buffer_cache_writes_per_sec: INTEGER phys_raw_reads_per_sec: INTEGER phys_raw_writes_per_sec: INTEGER For eents generated by situations in the TADDM attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_TADDM class. This class contains the following slots: node: STRING timestamp: STRING cec_mfg: STRING cec_model: STRING cec_sn: STRING lpar_num: INTEGER For eents generated by situations in the TCP attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_TCP class. This class contains the following slots: node: STRING timestamp: STRING connections_initiated_per_sec: INTEGER connections_established_per_sec: INTEGER connections_closed_per_sec: INTEGER total_packets_sent_per_sec: INTEGER data_packets_sent_per_sec: INTEGER data_sent_kb_per_sec: INTEGER data_pkt_retransmitted_per_sec: INTEGER ack_only_pkt_sent_per_sec: INTEGER total_packets_receied_per_sec: INTEGER ack_pkt_receied_per_sec: INTEGER For eents generated by situations in the Top 50 CPU Processes attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_TOP 50 CPU PROCESSES class. This class contains the following slots: node: STRING timestamp: STRING name: STRING id: INTEGER cpu_pct: REAL Appendix A. IBM Tioli Enterprise Console eent mapping 319

330 memory_kb: INTEGER owner: STRING full_path: STRING For eents generated by situations in the Top 50 Memory Processes attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_TOP 50 MEMORY PROCESSES class. This class contains the following slots: node: STRING timestamp: STRING name: STRING id: INTEGER cpu_pct: REAL memory_kb: INTEGER owner: STRING full_path: STRING For eents generated by situations in the Virtual Memory Management attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_VIRTUAL MEMORY MANAGEMENT class. This class contains the following slots: node: STRING timestamp: STRING pages_read_per_sec: INTEGER pages_written_per_sec: INTEGER paging_space_read_per_sec: INTEGER paging_space_written_per_sec: INTEGER zero_fill_per_sec: INTEGER pagein_wait_per_sec: INTEGER page_fault_per_sec: INTEGER page_reclaim_per_sec: INTEGER steals_per_sec: INTEGER memory_not_pinned: INTEGER comp_repage_pct: INTEGER noncomp_repage_pct: INTEGER pending_client_pageout: INTEGER For eents generated by situations in the Volume Groups attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_VOLUME GROUPS class. This class contains the following slots: node: STRING timestamp: STRING name: STRING state: STRING number_of_logical_olumes: INTEGER number_of_physical_olumes: INTEGER number_of_actie_physical_olumes: INTEGER number_of_stale_physical_olumes: INTEGER size_mb: INTEGER 320 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

331 free_mb: INTEGER used_mb: INTEGER free_pct: INTEGER used_pct: INTEGER For eents generated by situations in the Workload Manager attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_WORKLOAD MANAGER class. This class contains the following slots: node: STRING timestamp: STRING class_name: STRING tier_num: INTEGER cpu_consumed_pct: INTEGER cpu_desired_pct: INTEGER cpu_total: INTEGER cpu_shares: INTEGER cpu_min: INTEGER cpu_soft_max: INTEGER cpu_hard_max: INTEGER mem_consumed_pct: INTEGER mem_desired_pct: INTEGER mem_total: INTEGER mem_shares: INTEGER mem_min: INTEGER mem_soft_max: INTEGER mem_hard_max: INTEGER disk_consumed_pct: INTEGER disk_desired_pct: INTEGER disk_total: INTEGER disk_shares: INTEGER disk_min: INTEGER disk_soft_max: INTEGER disk_hard_max: INTEGER For eents generated by situations in the WPAR CPU attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_WPAR CPU class. This class contains the following slots: node: STRING timestamp: STRING wpar_name: STRING user_cpu_pct: INTEGER system_cpu_pct: INTEGER num_cpus_consumed: INTEGER wpar_cpu_consumed_pct: INTEGER lpar_cpu_consumed_pct: INTEGER cpu_consumption_limit: INTEGER Appendix A. IBM Tioli Enterprise Console eent mapping 321

332 rc_cpu_limits_hard_max: INTEGER lpar_entitlement: INTEGER For eents generated by situations in the WPAR FileSystem attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_WPAR FILESYSTEM class. This class contains the following slots: node: STRING timestamp: STRING wpar_name: STRING mount_point: STRING deice_name: STRING fs_type: STRING node_name: STRING mount_options: STRING For eents generated by situations in the WPAR Information attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_WPAR INFORMATION class. This class contains the following slots: node: STRING timestamp: STRING wpar_name: STRING type: INTEGER type_enum: STRING state: INTEGER state_enum: STRING owner: STRING kpx_hostname: STRING home: STRING autostart: INTEGER autostart_enum: STRING shares_usr_dir: INTEGER shares_usr_dir_enum: STRING checkpointable: INTEGER checkpointable_enum: STRING wpar_application_path: STRING rc_is_actie: INTEGER rc_is_actie_enum: STRING rc_rset: STRING rc_cpu_shares: STRING rc_cpu_limits_min: STRING rc_cpu_limits_soft_max: STRING rc_cpu_limits_hard_max: STRING rc_memory_shares: STRING rc_memory_limits_min: STRING rc_memory_limits_soft_max: STRING rc_memory_limits_hard_max: STRING 322 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

333 rc_per_process_m_limit: STRING rc_max_processes: STRING rc_max_threads: STRING admin_operation: STRING admin_process_id: STRING admin_start_time: STRING ip_address: STRING For eents generated by situations in the WPAR Network attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_WPAR NETWORK class. This class contains the following slots: node: STRING timestamp: STRING wpar_name: STRING interface_name: STRING ip_address: STRING network_mask: STRING broadcast_ip: STRING For eents generated by situations in the WPAR Physical Memory attribute group, Tioli Enterprise Console eents are sent using the ITM_KPX_WPAR PHYSICAL MEMORY class. This class contains the following slots: node: STRING timestamp: STRING wpar_name: STRING memory_size_mb: INTEGER used_memory_mb: INTEGER free_memory_mb: INTEGER free_memory_pct: INTEGER used_memory_pct: INTEGER lpar_memory_used_pct: INTEGER rc_memory_limits_hard_max: INTEGER lpar_memory_size_mb: INTEGER Appendix A. IBM Tioli Enterprise Console eent mapping 323

334 324 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

335 Appendix B. Discoery Library Adapter for the AIX Premium monitoring agent About the DLA More information about DLAs Prerequisites This appendix contains information about the Discoery Library Adapter (DLA) for the IBM Tioli Monitoring: AIX Premium Agent. The Tioli Management Serices DLA discoers resources and relationships and creates a Discoery Library Book file. The discoery book follows the Discoery Library IDML schema and is used to populate the IBM Tioli Change and Configuration Management Database and IBM Tioli Business Serice Manager products. The Tioli Management Serices DLA discoers the operating system, the IBM Tioli Monitoring agent running on this LPAR, and the relationship of the agent with the CEC system that it irtualizes. For all AIX systems that are actie and online at the Tioli Enterprise Portal Serer, information is included in the discoery book for those resources. The Tioli Management Serices DLA discoers actie resources. It is run on demand and can be run periodically to discoer resources that were not actie during preious discoeries. The DLA discoers AIX Premium agent components. The following sources contain additional information about using the DLA program with all monitoring agents: The IBM Tioli Monitoring Administrator's Guide contains information about using the Tioli Management Serices Discoery Library Adapter. For information about using a DLA with Tioli Application Dependency Discoery Manager (TADDM), see the information center at com.ibm.taddm.doc_7.1/cmdb_welcome.html. For information about using a DLA with the Tioli Business Serice Manager product, see the information center at infocenter/tiihelp/3r1/topic/com.ibm.tioli.itbsm.doc/customization/ bsms_dscc_discoerylibraryeentmapping.html If you are using the DLA with Tioli Business Serice Manager and both the AIX Premium agent and AIX OS agent are running on the same system, you must hae the Tioli Business Serice Manager ersion Fix Pack 2 installed. DLA data model class types represented in CDM This section contains information about how the arious source application data objects map to classes in the Common Data Model (CDM) for the AIX Premium agent. The following information is proided for each class: Copyright IBM Corp. 2007,

336 CDM class name Class name for which the agent is proiding information Relationships CDM relationships (hierarchical) between currently identified model objects CDM attributes, agent attributes, descriptions, and examples CDM and agent attributes that are required to create an instance of a resource, descriptions of the attributes, and examples of the attributes LPAR class An LPAR is a logical partition of the physical hardware where an operating system instance can run. CDM class name sys.computersystem Relationships This class has no relationships. CDM attributes, agent attributes, descriptions, and examples CDM attribute: Name Agent attribute: KPX14LOGIC.HOSTNAME : The name for the computer system as it is commonly known in the data center. This attribute is used by internal mechanisms of IBM Tioli Application Dependency Discoery Manager. Example: p7e07 CDM attribute: ManagedSystemName Agent attribute: INODESTS.NODE : The name of the IBM Tioli Monitoring component that proides data for the management of the AIX Premium agent instance. Example: p7e07:px CDM attribute: Label Agent attribute: KPX14LOGIC.HOSTNAME : A system-generated, descriptie string used for displaying the instance. Example: p7e07 CDM attribute: SerialNumber Agent attribute: KPX56TADDM.CEC_SN : The serial number of the physical computer system, as it is proided by the manufacturer of the deice. Example: P CDM attribute: Manufacturer Agent attribute: KPX56TADDM.CEC_MFG : The name of the manufacturer of the physical computer system. Example: IBM CDM attribute: Model Agent attribute: KPX56TADDM.CEC_MODEL : The model number of the physical computer system, as it is proided by the manufacturer of the deice. Example: 9117-MMB CDM attribute: VMID 326 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

337 Agent attribute: KPX56TADDM.LPAR_NUM : The unique identifier for a irtual machine. This attribute is the ID for the LPAR. Example: 2 CDM attribute: Virtual : Set to true because this is a irtual computer system. Example: true CDM attribute: IsVMIDanLPAR : Set to true because this computer is a logical partition. Example: true AIX class The AIX class represents the operating system installed in each LPAR. CDM class name sys.aix.aix Relationships runson Source: KPX14LOGIC.HOSTNAME-AIX Target: KPX14LOGIC.HOSTNAME-LPAR Example: runson source="p7e07-aix" target="p7e07-lpar installedon Source: KPX14LOGIC.HOSTNAME-AIX Target: KPX14LOGIC.HOSTNAME-LPAR Example: installedon source="p7e07-aix" target="p7e07-lpar" CDM attributes, agent attributes, descriptions, and examples CDM attribute: Name : Formed by the host name of the IBM AIX operating system. Example: AIX CDM attribute: OSName : The operating system name. Example: AIX CDM attribute: OSVersion Agent attribute: KPX08CPUSU.SSV : The operating system ersion. Example: TMSAgent class The TMSAgent represents the Tioli Monitoring Serices Agent. CDM class name app.tmsagent Relationships monitors Source: INODESTS.NODE-TMSAgent Target: LP.HOSTNAME-LPAR Example: monitors source="p7e07:px-tmsagent" target="p7e07-lpar" CDM attributes, agent attributes, descriptions, and examples CDM attribute: ManagedSystemName Agent attribute: INODESTS.NODE Appendix B. Discoery Library Adapter for the AIX Premium monitoring agent 327

338 : The name of the IBM Tioli Monitoring component that proides data for the management of the AIX Premium agent instance. Example: p7e07:px CDM attribute: ManagedObjectName Agent attribute: : The name of the IBM Tioli Monitoring component that proides data for the management of the AIX Premium agent instance. Example: CDM attribute: SoftwareVersion Agent attribute: INODESTS.VERSION : The ersion of the AIX Premium agent. Example: CDM attribute: ProductCode Agent attribute: INODESTS.PRODUCT : The product code of the AIX agent. Example: PX CDM attribute: Affinity Agent attribute: INODESTS.AFFINITIES : The affinity of the AIX Premium agent. Example: yw0a7 CDM attribute: Label Agent attribute: INODESTS.NODE-AIX Premium : The label of the AIX Premium agent. Example: p7e07:px - AIX Premium 328 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

339 Appendix C. Documentation library AIX Premium Agent library Prerequisite publications This appendix contains information about the publications related to the AIX Premium Agent. These publications are listed in the following categories: AIX Premium Agent library Prerequisite publications Related publications See the IBM Tioli Monitoring, OMEGAMON XE, and Composite Application Manager products: Documentation Guide, SC , for information about accessing and using publications. You can find the Documentation Guide in the following information centers: IBM Tioli Monitoring and OMEGAMON XE IBM Tioli Composite Application Manager To open the Documentation Guide in the information center, select Using the publications in the Contents pane. To find a list of new and changed publications, click What's new on the Welcome page of the IBM Tioli Monitoring and OMEGAMON XE Information Center. To find publications from the preious ersion of a product, click Preious ersions under the name of the product in the Contents pane. There is one document specific to the AIX Premium Agent: IBM Tioli Monitoring: AIX Premium Agent User's Guide. This publication proides agent-specific information for configuring, using, and troubleshooting the AIX Premium Agent Use the configuration chapter in this guide with the IBM Tioli Monitoring Installation and Setup Guide to set up the software. Use the information in this guide with the Tioli Enterprise Portal User's Guide to monitor AIX resources. To use the information in this publication effectiely, you must hae some prerequisite knowledge, which you can obtain from the following IBM Tioli Monitoring publications: Exploring IBM Tioli Monitoring IBM Tioli Monitoring Administrator's Guide IBM Tioli Monitoring Agent Builder User s Guide IBM Tioli Monitoring Command Reference IBM Tioli Monitoring: Configuring Tioli Enterprise Monitoring Serer on z/os IBM Tioli Monitoring Installation and Setup Guide IBM Tioli Monitoring: Messages IBM Tioli Monitoring Troubleshooting Guide IBM Tioli Monitoring: Upgrading from Tioli Distributed Monitoring Copyright IBM Corp. 2007,

340 Related publications IBM Tioli Monitoring: Upgrading from V5.1.2 IBM Tioli Monitoring: i5/os Agent User's Guide IBM Tioli Monitoring: Linux OS Agent User's Guide IBM Tioli Monitoring: UNIX Log OS Agent User's Guide IBM Tioli Monitoring: UNIX OS Agent User's Guide IBM Tioli Monitoring: Windows OS Agent User's Guide IBM Tioli Monitoring Uniersal Agent User's Guide IBM Tioli Monitoring Uniersal Agent API and Command Programming Reference Guide Tioli Enterprise Portal User's Guide The following documents also proide useful information: IBM Tioli Enterprise Console Adapters Guide IBM Tioli Enterprise Console Eent Integration Facility User s Guide IBM Tioli Enterprise Console Reference Manual IBM Tioli Enterprise Console Rule Builder s Guide Other sources of documentation You can also obtain technical documentation about monitoring products from the following sources: Tioli Integrated Serice Management Library The Integrated Serice Management Library is an online catalog that contains integration documentation as well as other downloadable product extensions. Redbooks IBM Redbooks, Redpapers, and Redbooks Technotes proide information about products from platform and solution perspecties. Technotes Technotes proide the latest information about known product limitations and workarounds. You can find Technotes through the IBM Software Support website at Tioli wikis on the IBM deeloperworks website Tioli Wiki Central at tioli/home is the home for interactie wikis that offer best practices and scenarios for using Tioli products. The wikis contain white papers contributed by IBM employees, and content created by customers and business partners. 330 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

341 Two of these wikis are of particular releance to IBM Tioli Monitoring: Tioli Distributed Monitoring and Application Management Wiki at Home proides information about IBM Tioli Monitoring and related distributed products, including IBM Tioli Composite Application Management products. Tioli System z Monitoring and Application Management Wiki at Home proides information about the OMEGAMON XE products, Tioli NetView for z/os, Tioli Monitoring Agent for z/tpf, and other System z monitoring and application management products. Appendix C. Documentation library 331

342 332 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

343 Appendix D. Accessibility Accessibility features help users with physical disabilities, such as restricted mobility or limited ision, to use software products successfully. The major accessibility features in this product enable users to do the following: Use assistie technologies, such as screen-reader software and digital speech synthesizer, to hear what is displayed on the screen. Consult the product documentation of the assistie technology for details on using those technologies with this product. Operate specific or equialent features using only the keyboard. Magnify what is displayed on the screen. In addition, the product documentation was modified to include the following features to aid accessibility: All documentation is aailable in both HTML and conertible PDF formats to gie the maximum opportunity for users to apply screen-reader software. All images in the documentation are proided with alternatie text so that users with ision impairments can understand the contents of the images. Naigating the interface using the keyboard Standard shortcut and accelerator keys are used by the product and are documented by the operating system. See the documentation proided by your operating system for more information. Magnifying what is displayed on the screen You can enlarge information in the product windows using facilities proided by the operating systems on which the product is run. For example, in a Microsoft Windows enironment, you can lower the resolution of the screen to enlarge the font sizes of the text on the screen. See the documentation proided by your operating system for more information. Copyright IBM Corp. 2007,

344 334 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

345 Appendix E. Notices This information was deeloped for products and serices offered in the U.S.A. IBM may not offer the products, serices, or features discussed in this document in other countries. Consult your local IBM representatie for information on the products and serices currently aailable in your area. Any reference to an IBM product, program, or serice is not intended to state or imply that only that IBM product, program, or serice may be used. Any functionally equialent product, program, or serice that does not infringe any IBM intellectual property right may be used instead. Howeer, it is the user's responsibility to ealuate and erify the operation of any non-ibm product, program, or serice. IBM may hae patents or pending patent applications coering subject matter described in this document. The furnishing of this document does not gie you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drie Armonk, NY U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan, Ltd , Shimotsuruma, Yamato-shi Kanagawa Japan The following paragraph does not apply to the United Kingdom or any other country where such proisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement might not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-ibm websites are proided for conenience only and do not in any manner sere as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk. Copyright IBM Corp. 2007,

346 IBM may use or distribute any of the information you supply in any way it beliees appropriate without incurring any obligation to you. Licensees of this program who wish to hae information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation 2Z4A/ Burnet Road Austin, TX U.S.A. Such information may be aailable, subject to appropriate terms and conditions, including in some cases payment of a fee. The licensed program described in this document and all licensed material aailable for it are proided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equialent agreement between us. Any performance data contained herein was determined in a controlled enironment. Therefore, the results obtained in other operating enironments may ary significantly. Some measurements may hae been made on deelopment-leel systems and there is no guarantee that these measurements will be the same on generally aailable systems. Furthermore, some measurement may hae been estimated through extrapolation. Actual results may ary. Users of this document should erify the applicable data for their specific enironment. Information concerning non-ibm products was obtained from the suppliers of those products, their published announcements or other publicly aailable sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-ibm products. Questions on the capabilities of non-ibm products should be addressed to the suppliers of those products. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objecties only. All IBM prices shown are IBM's suggested retail prices, are current and are subject to change without notice. Dealer prices may ary. This information is for planning purposes only. The information herein is subject to change before the products described become aailable. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of indiiduals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrate programming techniques on arious operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to 336 IBM Tioli Monitoring: AIX Premium Agent: User's Guide

347 IBM, for the purposes of deeloping, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples hae not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, sericeability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of deeloping, using, marketing, or distributing application programs conforming to IBM s application programming interfaces. Each copy or any portion of these sample programs or any deriatie work, must include a copyright notice as follows: (your company name) (year). Portions of this code are deried from IBM Corp. Sample Programs. Copyright IBM Corp. _enter the year or years_. All rights resered. If you are iewing this information in softcopy form, the photographs and color illustrations might not be displayed. Trademarks IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and serice names might be trademarks of IBM or other companies. A current list of IBM trademarks is aailable on the Web at Copyright and trademark information at Adobe, Acrobat, PostScript and all Adobe-based trademarks are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States, other countries, or both. Cell Broadband Engine and Cell/B.E. are trademarks of Sony Computer Entertainment, Inc., in the United States, other countries, or both and is used under license therefrom. Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. IT Infrastructure Library is a registered trademark of the Central Computer and Telecommunications Agency which is now part of the Office of Goernment Commerce. ITIL is a registered trademark, and a registered community trademark of the Office of Goernment Commerce, and is registered in the U.S. Patent and Trademark Office. Jaa and all Jaa-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Linux is a trademark of Linus Toralds in the United States, other countries, or both. Appendix E. Notices 337