IBM Tivoli OMEGAMON XE on z/OS Version 5 Release 1 User’s Guide SC27-4028-00 IBM Tivoli OMEGAMON XE on z/OS Version 5 Release 1 User’s Guide SC27-4028-00 Note Before using this information and the product it supports, read the information in “Notices” on page 395. March 2012 This edition applies to version 5, release 1, modification 0 of IBM Tivoli OMEGAMON XE on z/OS (product number 5698-T01) and to all subsequent releases and modifications until otherwise indicated in new editions. © Copyright IBM Corporation 2004, 2012. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents Figures ...............ix z/OS Status DASD Issues report ....27 z/OS Status WLM Service Class Period Tables ...............xi report .............29 z/OS Utilization Common Storage report 32 z/OS Utilization LPAR Summary report . 35 Part 1. Getting started........1 z/OS Utilization LPAR Usage Summary report .............37 Chapter 1. Introducing IBM Tivoli z/OS Utilization Real Storage report . 39 OMEGAMON XE on z/OS .......3 Finding more information about historical data collection ..............41 How OMEGAMON XE on z/OS works .....3 Using Take Action commands ........42 Resources provided by OMEGAMON XE on z/OS . 5 Issuing OMEGAMON XE on z/OS commands 42 What you can do with OMEGAMON XE on z/OS . 6 Issuing UNIX commands .........43 Interoperability and integration with other products 9 Environment for issuing UNIX commands . 43 New in V5.1.0 ..............9 Redirecting UNIX commands output ....44 Support for IBM Tivoli Monitoring V6.2.3 and Running commands in the background . 44 self-describing agents ..........9 Testing commands ..........44 New workspaces for the OMEGAMON Enhanced Authorizing users to issue UNIX commands 44 3270 User Interface ...........9 Launching the RMF Monitor III data portal....45 OMEGAMON XE on z/OS Take Action Configuring the launch from Tivoli Enterprise commands..............10 Portal ...............45 Health check information .........10 Configuring the launch from the command line 45 UNIX System Services 64-bit I/O count attribute 10 Sysplex and CPC status and configuration information .............10 Chapter 3. Using the Inspect function 47 New classic minor commands .......10 Invoking the Inspect function ........47 New out-of-the-box defaults ........10 Modifying the template Inspect link ......47 Performance improvements ........11 The Inspect Address Space CPU Use workspace . 52 Understanding the Inspect data–an example . 53 Chapter 2. Using and customizing OMEGAMON XE on z/OS .......13 Chapter 4. Using dynamic links to Using the predefined workspaces .......13 OMEGAMON for MVS ........57 Sysplex and system managed system names . 14 How dynamic linking works ........57 Organization of the workspaces ......14 Product-provided links ..........58 Prerequisites for data reporting .......16 Creating new dynamic links .........59 Customizing workspaces .........17 Create the target workspace ........59 Using cross-product workspace links .....17 Modify the associated script ........61 Finding more information about workspaces . 18 Define the dynamic link .........63 Using the predefined situations........18 Assigning the Dynamic Link to 3270 query . 66 Activating situations ..........18 Distributing situations .........18 Part 2. Monitoring scenarios ....69 Starting situations ..........19 Modifying situations ..........19 Chapter 5. Monitoring shared DASD . 71 Migrating situations ..........20 Recreating or replacing z/OS Management Filtering collection of DASD device data.....71 Console situations ...........22 Requirements and restrictions for filter situations 72 Finding more information about situations . 22 Creating a filtering situation ........72 Using historical data collection and reporting . 23 Distributing the situation .........73 Configuring historical data collection .....23 Starting and stopping the situation .....74 Starting and stopping data collection .....24 Displaying messages for the situations you create 74 Reducing the impact of requests from large tables 24 Example situations ...........74 Tivoli Common Reporting reports ......25 Using shared DASD data collection to identify the Using the reports ..........25 cause of I/O delays............74 Typical types of reports available with Tivoli Getting situation event notification .....75 Common Reporting .........26 Analyzing I/O distribution ........75 OMEGAMON XE on z/OS reports ....27 Isolating the problem ..........75 © Copyright IBM Corp. 2004, 2012 iii Taking action to resolve a shared DASD problem 76 KM5 Enterprise CPC Status attributes ....133 KM5 Enterprise CPU Overview ......133 Chapter 6. Monitoring virtual storage KM5 Enterprise Exceptions attributes ....134 and missing jobs ..........77 KM5 LPAR Overview attributes ......136 KM5 Sysplex Configuration attributes ....138 Monitoring paging and virtual storage .....77 KM5 Top Consumers attribute group ....138 Activating the OS390_Local_PageDS_PctFull_Crit Report Classes attributes ........140 situation ..............77 Resource Groups attributes ........141 Using the Page Dataset Activity workspace to Service Class Address Spaces attributes....142 gather information ...........77 Service Class Enqueue Workflow Analysis Examining storage usage .........78 attributes ..............143 Evaluating your options .........78 Service Class I/O Workflow Analysis attributes 144 Monitoring critical started tasks .......78 Service Class Subsystem Workflow Analysis Creating the MissingTaskAlert situation ....78 attributes ..............145 Service Definition attributes .......147 Chapter 7. Monitoring service class Sysplex DASD attributes ........147 goals ...............81 Sysplex DASD Device attributes ......148 The scenario ..............81 Sysplex DASD Group attributes ......150 Creating the zOS_Critical_SvcClass_Missed_Goal Sysplex WLM Service Class Period attributes 151 situation ...............81 XCF Group attributes..........157 Defining the Take Action command ......86 XCF Members attributes.........157 Setting thresholds in the WLM Service Class XCF Paths attributes ..........158 Resources workspace ...........87 XCF System attributes .........160 Analyzing a problem ...........90 XCF System Statistics attributes ......161 System attribute groups ..........164 Chapter 8. Monitoring cryptographic Address Space Bottleneck attributes .....164 coprocessors ............93 Address Space Bottlenecks Portrait attributes 169 Validating your cryptography configuration . 93 Address Space ComStor Owned attributes. 169 Monitoring and improving cryptography Address Space ComStor Owned Detail performance ..............94 attributes ..............171 Checking service call performance ......94 Address Space ComStor Trends attributes . 172 Checking top user performance.......96 Address Space ComStor Unowned attributes 172 Improving performance .........96 Address Space CPU Utilization attributes . 173 Monitoring and improving cross-system ICSF Address Space IA Impact attributes .....177 performance ..............96 Address Space Real Storage attributes ....178 Address Space Summary attributes .....180 Chapter 9. Detecting CPU looping Address Space Virtual Storage attributes . 181 Channel Paths attributes.........182 address spaces ...........99 Common Storage attributes........184 Determining the intent of a job ........99 DASD MVS attributes .........185 The KM5_CPU_Loop_Warn situation .....100 DASD MVS Devices attributes.......186 Investigating and identifying looping jobs ....100 Enclave Detail attributes.........187 Enclave Table attributes .........190 Part 3. Reference .........115 Enqueue Conflicts attributes .......193 HiperDispatch Logical Processors attributes . 194 Chapter 10. Attributes ........117 HiperDispatch Management attributes ....195 Inspect Address Space CPU Use attributes. 196 Attributes and workspaces .........117 Integrated Cryptographic Services Facilities Attributes and queries ..........117 Subsystems (ICSF) attributes .......198 Attributes and situations .........117 KM5 Address Space Storage SubKey attributes 203 Sysplex attribute groups ..........117 KM5 Common Storage SubKey attributes . 204 CF Clients attributes ..........118 KM5 Health Check Messages attributes....205 CF Path attributes ...........119 KM5 Health Check Status attributes .....206 CF Policy attributes ..........120 KM5 Health Checks attributes .......207 CF Structures attributes .........120 KM5 Host Configuration attributes .....212 CF Structure to MVS attributes ......124 KM5 License Manager MSU WLM Cap....212 CF Systems attributes .........125 KM5 Spin Lock attributes ........214 DASD Device Collection Filtering attributes . 128 KM5 Storage Shortage Status attributes....215 Enterprise Global Enqueue attributes ....130 KM5 Suspend Lock attributes .......216 Global Enqueues attributes ........131 KM5 zFS Directory Cache attributes .....217 GRS attributes ............132 KM5 zFS Kernel attributes ........218 iv IBM Tivoli OMEGAMON XE on z/OS: User’s Guide KM5 zFS Metadata Cache attributes .....218 System situations ............272 KM5 zFS Storage attributes........219 Renamed situations ..........272 KM5 zFS User Cache attributes ......220 Check_Missing_UNIX_Mount_Point .....273 KM5 zFS User Cache Dataspaces attributes . 221 Crypto_CKDS_80PCT_Full ........274 LPAR Clusters attributes ........222 Crypto_CKDS_Access_Disabled ......274 Operator Alerts attributes ........225 Crypto_Internal_Error .........274 Page Dataset Activity