OMEGAMON II for CICS User s Guide V520 - IBM...

User’s GuideOMEGAMON II® for CICS

Version 520

GC32-9249-00

October 2001

Candle Corporation201 North Douglas Street

El Segundo, California 90245

2 OMEGAMON II for CICS User’s Guide, Version 520

Registered trademarks and service marks of Candle Corporation: AF/OPERATOR, AF/PERFORMER, AF/REMOTE, Availability Command Center, Candle, Candle Command Center, Candle Direct logo, Candle Electronic Customer Support, Candle logo, Candle Management Server, Candle Management Workstation, Candle Technologies, CL/CONFERENCE, CL/SUPERSESSION, CommandWatch, CT, CT/Data Server, CT/DS, DELTAMON, eBA*ServiceMonitor, eBA*ServiceNetwork, ETEWatch, IntelliWatch, IntelliWatch Pinnacle, MQSecure, MQView, OMEGACENTER, OMEGAMON, OMEGAMON/e, OMEGAMON II, OMEGAMON Monitoring Agent, OMEGAVIEW, OMEGAVIEW II, PQEdit, Solutions for Networked Applications, Solutions for Networked Businesses, and Transplex.Trademarks and service marks of Candle Corporation: Alert Adapter, Alert Adapter Plus, Alert Emitter, AMS, Amsys, AutoBridge, AUTOMATED FACILITIES, Availability Management Systems, Candle Alert, Candle Business Partner Logo, Candle Command Center/SentinelManager, Candle CommandPro, CandleLight, CandleNet, CandleNet 2000, CandleNet Command Center, CandleNet eBP, CandleNet eBP Access, CandleNet eBP Administrator, CandleNet eBP Broker Access, CandleNet eBP Configuration, CandleNet eBP Connector, CandleNet eBP File Transfer, CandleNet eBP Host Connect, CandleNet eBP Object Access, CandleNet eBP Object Browser, CandleNet eBP Secure Access, CandleNet eBP Service Directory, CandleNet eBP Universal Connector, CandleNet eBP Workflow Access, CandleNet eBusiness Assurance, CandleNet eBusiness Exchange, CandleNet eBusiness Platform, CandleNet eBusiness Platform Administrator, CandleNet eBusiness Platform Connector, CandleNet eBusiness Platform Connectors, CandleNet eBusiness Platform Powered by Roma Technology, CandleNet eBusiness Platform Service Directory, CandleNet Portal, CCC, CCP, CEBA, CECS, CICAT, CL/ENGINE, CL/GATEWAY, CL/TECHNOLOGY, CMS, CMW, Command & Control, Connect-Notes, Connect-Two, CSA ANALYZER, CT/ALS, CT/Application Logic Services, CT/DCS, CT/Distributed Computing Services, CT/Engine, CT/Implementation Services, CT/IX, CT/Workbench, CT/Workstation Server, CT/WS, !DB Logo, !DB/DASD, !DB/EXPLAIN, !DB/MIGRATOR, !DB/QUICKCHANGE, !DB/QUICKCOMPARE, !DB/SMU, !DB/Tools, !DB/WORKBENCH, Design Network, DEXAN, e2e, eBA, eBAA, eBAAuditor, eBAN, eBANetwork, eBAAPractice, eBP, eBusiness Assurance, eBusiness Assurance Network, eBusiness at the speed of light, eBusiness at the speed of light logo, eBusiness Exchange, eBusiness Institute, eBX, End-to-End, ENTERPRISE, Enterprise Candle Command Center, Enterprise Candle Management Workstation, Enterprise Reporter Plus, EPILOG, ER+, ERPNet, ESRA, ETEWatch Customizer, HostBridge, InterFlow, Candle InterFlow, Lava Console, MessageMate, Messaging Mastered, Millennium Management Blueprint, MMNA, MQADMIN, MQEdit, MQEXPERT, MQMON, NBX, NetGlue, NetGlue Extra, NetMirror, NetScheduler, OMA, OMC Gateway, OMC Status Manager, OMEGACENTER Bridge, OMEGACENTER Gateway, OMEGACENTER Status Manager, OMEGAMON Management Center, OSM, PC COMPANION, Performance Pac, PowerQ, PQConfiguration, PQScope, Response Time Network, Roma, Roma Application Manager, Roma Broker, Roma BSP, Roma Connector, Roma Developer, Roma FS/A, Roma FS/Access, RomaNet, Roma Network, Roma Object Access, Roma Secure, Roma WF/Access, Roma Workflow Access, RTA, RTN, SentinelManager, Somerset, Somerset Systems, Status Monitor, The Millennium Alliance, The Millennium Alliance logo, The Millennium Management Network Alliance, TMA2000, Tracer, Unified Directory Services, Volcano and ZCopy.Trademarks and registered trademarks of other companies: AIX, DB2, MQSeries and WebSphere are registered trademarks of International Business Machines Corporation. SAP is a registered trademark and R/3 is a trademark of SAP AG. UNIX is a registered trademark in the U.S. and other countries, licensed exclusively through X/Open Company Ltd. HP-UX is a trademark of Hewlett-Packard Company. SunOS is a trademark of Sun Microsystems, Inc. All other company and product names used herein are trademarks or registered trademarks of their respective companies.

Copyright © October 2001, Candle Corporation, a California corporation. All rights reserved. International rights secured.

Threaded Environment for AS/400, Patent No. 5,504,898; Data Server with Data Probes Employing Predicate Tests in Rule Statements (Event Driven Sampling), Patent No. 5,615,359; MVS/ESA Message Transport System Using the XCF Coupling Facility, Patent No. 5,754,856; Intelligent Remote Agent for Computer Performance Monitoring, Patent No. 5,781,703; Data Server with Event Driven Sampling, Patent No. 5,809,238; Threaded Environment for Computer Systems Without Native Threading Support, Patent No. 5,835,763; Object Procedure Messaging Facility, Patent No. 5,848,234; End-to-End Response Time Measurement for Computer Programs, Patent No. 5,991,705; Communications on a Network, Patent Pending; Improved Message Queuing Based Network Computing Architecture, Patent Pending; User Interface for System Management Applications, Patent Pending.

NOTICE: This documentation is provided with RESTRICTED RIGHTS. Use, duplication, or disclosure by the Government is subject to restrictions set forth in the applicable license agreement and/or the applicable government rights clause.This documentation contains confidential, proprietary information of Candle Corporation that is licensed for your internal use only. Any unauthorized use, duplication, or disclosure is unlawful.

Contents 3

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Documentation Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16Adobe Portable Document Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17Documentation Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18

What’s New . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21New Features and Enhancements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

Chapter 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25CUA Interface for Ease of Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26Logical Tuning Approach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28Batch Reporting Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30

Chapter 2. Learning About the CUA Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Panel Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32CUA Interface Panel Characteristics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33Action Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35Navigating. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38Using Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40Enter Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43Exiting from OMEGAMON II. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45

Chapter 3. Getting Started with OMEGAMON II . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47Logging Onto OMEGAMON II . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48Begin Your OMEGAMON II Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53Using the Region Status Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54Using the Actions Pull-down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60Using the GoTo Pull-down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61Using the Index Pull-down. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65Using the View Pull-down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67Using the Options Pull-down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72Dynamic Profile Update Facility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96Using the Help Pull-down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97

Chapter 4. CICS Problem-Solving Approaches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99Excessive CPU Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100Excessive Response Time for Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104Users Complaining about Bad Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108

Contents


New Application Experiencing Poor Response. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110Program’s Changes Not Being Reflected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115CICS Is Not Responding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122User Terminal Is Not Responding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126

Chapter 5. Monitoring Workloads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129Automatic Initiate Descriptors (AIDs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130Interval Control Elements (ICEs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135Response. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .140Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .145TranRate (Transaction Rate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .154UOWs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .156

Chapter 6. Monitoring Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163CPU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164DASD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167DB2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .170DBCTL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .173DL/I. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .175Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .177Journals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .182Local Shared Resources (LSR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .189MRO/ISC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .192Paging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .195Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .197Tapes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201TempStor (Temporary Storage) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .204TranData (Transient Data) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208Web Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213TCP/IP Socket Activity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214

Chapter 7. Monitoring Message Queueing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216CUA Panels for MQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217Implementing MQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .218MQ Monitoring Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .219Displaying Application Trace Data for MQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .226Resource Limiting of MQ Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .228

Chapter 8. Responding to Alerts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229Bottlenecks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230CICS Loop (CICS Time-of-Day Clock) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .234Dumps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .236Enqueues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .238I/O Rate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .241

Contents 5

VTAM ACB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .245XRF (Extended Recovery Facility) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .247

Chapter 9. Defining Response Time Groups for Monitoring . . . . . . . . . . . . . . . . . . . . . . . 251Importance of Defining Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .252How to Use This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .253Managing Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .254

Appendix A. OMEGAVIEW Enhanced Zoom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269Zooming from OMEGAVIEW to OMEGAMON II . . . . . . . . . . . . . . . . . . . . . . . . . . . .270Zoom Summary Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .271Default or First Zoom Destination Choice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .273Alternate Zoom Destinations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .274Usage Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .276

Appendix B. Fast Pathing in the CUA Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277Entering the Fast Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .278Fast Path Tables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .279

Appendix C. Transplex Navigation and Session Switching. . . . . . . . . . . . . . . . . . . . . . . . . . 289Session Switching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .290Transplex Navigation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .291Using Transplex Navigation with OMEGAMON II for CICS . . . . . . . . . . . . . . . . . . . . .293

Appendix D. CUA Actions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297Purpose. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .298Summary of Panel Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .302

Appendix E. Guide to Candle Customer Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317Base Maintenance Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .318Enhanced Support Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .322Customer Support Contact Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .323

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325


List of Tables 7

Table 1. Symbols in Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19Table 1. OMEGAVIEW to OMEGAMON II for CICS Zoom Summary. . . . . . . . . . . . . . . . . . . .271Table 2. CUA Panel Enhancements (CICS Release 2.1.2) . . . . . . . . . . . . . . . . . . . . . . . . . . . . .302Table 3. CUA Panel Enhancements (CICS Release 3.1.1 or 3.2.1) . . . . . . . . . . . . . . . . . . . . . .305Table 4. CUA Panel Enhancements (CICS Release 3.3.0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . .307Table 5. CUA Panel Enhancements (CICS Release 4.1.0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . .310Table 6. CUA Panel Enhancements (CICS Release 5.1.0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . .312Table 7. CUA Panel Enhancements (CICS Release 5.2.0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . .315

List of Tables


Figures 9

FIGURE 1. Typical CUA Interface Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32FIGURE 2. Action Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35FIGURE 3. Region Status Panel, Options Pull-Down (Prior to CICS 5.1.0) . . . . . . . . . . . . . . . . . . .36FIGURE 4. Date Format Selection Pop-up. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37FIGURE 5. Fast Pathing Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39FIGURE 6. Pushbutton Mnemonics on the Response Times Panel . . . . . . . . . . . . . . . . . . . . . . . . .39FIGURE 7. Help Pull-down Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40FIGURE 8. Sign On Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48FIGURE 9. Sign On Panel Showing Logon Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50

FIGURE 10. Region Status Panel (CICS/ESA Version 5.1.0). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54FIGURE 11. Region Status Panel (prior to CICS/ESA Version 5.1.0) . . . . . . . . . . . . . . . . . . . . . . . . .55FIGURE 12. Analyze DASD Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57FIGURE 13. AIDs Summary with Actions Pull-down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60FIGURE 14. GoTo Pull-down Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61FIGURE 15. CICS Tables Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62FIGURE 16. Task History Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63FIGURE 17. CICS Memory Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64FIGURE 18. Index Pull-down Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65FIGURE 19. Search Index Pop-up Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .66FIGURE 20. Typical View Pull-down Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67FIGURE 21. View Some Pop-up Showing Filter Criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68FIGURE 22. Tasks Panel with Filtered Tran IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69FIGURE 23. View Some Pop-up for the Task History Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70FIGURE 24. Region Status Panel, Options Pull-Down (Prior to CICS 5.1.0) . . . . . . . . . . . . . . . . . . .72FIGURE 25. Preferences Pop-up Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73FIGURE 26. Controls Pop-up Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75FIGURE 27. Session Defaults Pop-up Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76FIGURE 28. Screen Print Output Routing Options Pop-up Window . . . . . . . . . . . . . . . . . . . . . . . . .78FIGURE 29. Enable Authorized Commands Pop-up Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79FIGURE 30. Collection Controls Pop-up Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80FIGURE 31. Internal Bottleneck Collection Pop-up Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81FIGURE 32. Internal Bottleneck Display Controls Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82FIGURE 33. Response Time Collection Pop-up Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83FIGURE 34. Interval Recording Pop-up Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84FIGURE 35. Task History Collection Pop-up Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85FIGURE 36. CICS File/Database Collection Pop-up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86FIGURE 37. Resource Limiting Pop-up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87FIGURE 38. CICS Shutdown Option Pop-up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89FIGURE 39. Tasks Thresholds Pop-up Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90FIGURE 40. Userid Profiles Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .92

Figures


FIGURE 41. Region Profiles Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .94FIGURE 42. Help Pull-down Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97FIGURE 43. Region Status Panel (prior to CICS/ESA Version 5.1.0) . . . . . . . . . . . . . . . . . . . . . . . .100FIGURE 44. CPU Rates Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101FIGURE 45. Task Details Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102FIGURE 46. Task Details Panel Displaying Actions Pull-down . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103FIGURE 47. Region Status Panel with Critical Response Status Bar . . . . . . . . . . . . . . . . . . . . . . . .104FIGURE 48. Response Times Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105FIGURE 49. Internal Bottlenecks Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105FIGURE 50. External Contention Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106FIGURE 51. External Contention Details Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107FIGURE 52. Response Times Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108FIGURE 53. Response Time Detail for LU Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109FIGURE 54. Response Times Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110FIGURE 55. Response Time Details Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111FIGURE 56. Task History Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112FIGURE 57. Task History Details Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113FIGURE 58. Task History FCT. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114FIGURE 59. GoTo Pull-down Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115FIGURE 60. CICS Tables Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .116FIGURE 61. Programs Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117FIGURE 62. View Some Pop-up over Programs Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118FIGURE 63. Filtered Programs Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118FIGURE 64. Program Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .119FIGURE 65. Datasets Allocated to CICS Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120FIGURE 66. Datasets Allocated to CICS Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120FIGURE 67. Region Status with Critical Storage Status Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122FIGURE 68. CICS Storage Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123FIGURE 69. Storage Allocation by Components Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .124FIGURE 70. Storage Allocation by Tasks Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125FIGURE 71. Task Details Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126FIGURE 72. Task Time Analysis Panel (CICS Version 4.0 and above) . . . . . . . . . . . . . . . . . . . . . . .127FIGURE 73. AIDs Summary Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130FIGURE 74. Kill Confirmation Pop-up for a Single AID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131FIGURE 75. Kill Confirmation Pop-up for Multiple AIDs (Terminal). . . . . . . . . . . . . . . . . . . . . . . . .132FIGURE 76. Kill Confirmation Pop-up for Multiple AIDs (Transaction). . . . . . . . . . . . . . . . . . . . . . .133FIGURE 77. AID Details Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .133FIGURE 78. Analyze AID Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .134FIGURE 79. ICEs Summary Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135FIGURE 80. Kill Confirmation Pop-up for a Single ICE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .136FIGURE 81. Kill Confirmation Pop-up for Multiple ICEs (Terminal) . . . . . . . . . . . . . . . . . . . . . . . . .137FIGURE 82. Kill Confirmation Pop-up for Multiple ICEs (Transaction). . . . . . . . . . . . . . . . . . . . . . .137FIGURE 83. ICE Details Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138FIGURE 84. Analyze ICE Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139FIGURE 85. Response Times Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .141

Figures 11

FIGURE 86. Response Time Details Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .142FIGURE 87. Internal Bottlenecks Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143FIGURE 88. Analyze Response Time Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144FIGURE 89. Tasks Summary Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .145FIGURE 90. Purge Confirmation Pop-up for a Single Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147FIGURE 91. Force Purge Confirmation Pop-up for a Single Task. . . . . . . . . . . . . . . . . . . . . . . . . . .148FIGURE 92. Kill Confirmation Pop-up for a Single Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149FIGURE 93. Force Kill Confirmation Pop-up for a Single Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149FIGURE 94. Task Details Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .151FIGURE 95. Analyze Task Problems Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .153FIGURE 96. Transaction Rates Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .154FIGURE 97. Analyze Transaction Rate Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .155FIGURE 98. Analyze UOW Problems Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .157FIGURE 99. UOWs Panel Filtered for Shunted UOWs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .158

FIGURE 100. UOW Details Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .159FIGURE 101. UOW Links Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .160FIGURE 102. UOW Enqueues Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .161FIGURE 103. UOW Statistics Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .162FIGURE 104. CPU Rates Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164FIGURE 105. Analyze CPU Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166FIGURE 106. CICS DASD Performance Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167FIGURE 107. DASD Details for a Device Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .168FIGURE 108. Analyze DASD Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169FIGURE 109. DB2 Activity Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .170FIGURE 110. DB2 Transaction Details Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .171FIGURE 111. Analyze DB2 Problems Pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .172FIGURE 112. DBCTL Activity Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .173FIGURE 113. Analyze DBCTL Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .174FIGURE 114. DL/I Activity Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .175FIGURE 115. Analyze DL/I Problems Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .176FIGURE 116. Open VSAM Files Panel (CICS/ESA Version 4 and earlier . . . . . . . . . . . . . . . . . . . . . .177FIGURE 117. VSAM Details Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .178FIGURE 118. Analyze File Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .179FIGURE 119. Open VSAM Files Panel (CICS/ESA Version 5.1.0) . . . . . . . . . . . . . . . . . . . . . . . . . . .180FIGURE 120. Journals Panel (CICS/ESA Version 5.1.0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .182FIGURE 121. Journal Details Panel (CICS/ESA Version 5.1.0) . . . . . . . . . . . . . . . . . . . . . . . . . . . . .184FIGURE 122. Datasets Allocated to CICS Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .185FIGURE 123. File Details Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .186FIGURE 124. Analyze Journal Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .187FIGURE 125. LSR Pools Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .189FIGURE 126. LSR Buffer Pool Details Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .190FIGURE 127. Analyze LSR Problems Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .191FIGURE 128. Terminal Control Table System Entries Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .192FIGURE 129. TCT System Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .193FIGURE 130. Analyze MRO/ISC Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .194


FIGURE 131. Working Set Size and Paging Rates Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .195FIGURE 132. Analyze Paging Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .196FIGURE 133. CICS Storage Panel (CICS Version 4 and above) . . . . . . . . . . . . . . . . . . . . . . . . . . . .197FIGURE 134. CICS Storage Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .198FIGURE 135. Storage Allocation by Components Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .199FIGURE 136. Analyze Storage Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .200FIGURE 137. Tape Drives Pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201FIGURE 138. Tape Drive Details Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .202FIGURE 139. Analyze Tape Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .203FIGURE 140. Temporary Storage Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .204FIGURE 141. Temporary Storage Queues Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .205FIGURE 142. Analyze Temporary Storage Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .207FIGURE 143. Transient Data Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208FIGURE 144. Destination Control Table Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .210FIGURE 145. DCT Intrapartition Information Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211FIGURE 146. Analyze Transient Data Problems Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .212FIGURE 147. Web Interface panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213FIGURE 148. TCP/IP Thresholds. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214FIGURE 149. TCP/IP Socket Activity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214FIGURE 150. CICS File/Database Collection pop-up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .218FIGURE 151. Region Status Panel (CICS/ESA Versions 3.3 and 4.1) . . . . . . . . . . . . . . . . . . . . . . . .219FIGURE 152. Region Status Panel (CICS/ESA Version 5.1 and higher) . . . . . . . . . . . . . . . . . . . . . . .220FIGURE 153. MQ Thresholds Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221FIGURE 154. MQ Activity Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .222FIGURE 155. CICS Tasks using MQ Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .223FIGURE 156. MQ Statistics Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .224FIGURE 157. API Requests Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .225FIGURE 158. Application Trace panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .226FIGURE 159. Application Trace Entry panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .227FIGURE 160. Internal Bottlenecks Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230FIGURE 161. Internal Bottleneck Details Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .232FIGURE 162. Analyze Bottleneck Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .233FIGURE 163. CSA Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .234FIGURE 164. Analyze CICS Loop Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .235FIGURE 165. Dumps Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .236FIGURE 166. Analyze Dump Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .237FIGURE 167. Enqueues Pane . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .238FIGURE 168. Enqueue Details panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239FIGURE 169. Analyze Enqueue Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .240FIGURE 170. DASD I/O Rate Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .241FIGURE 171. DASD Details for a Device Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .243FIGURE 172. Analyze I/O Problems Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .244FIGURE 173. Terminal Control Table Prefix (TCTFX) Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .245FIGURE 174. Analyze VTAM Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .246FIGURE 175. XRF Information Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .247

Figures 13

FIGURE 176. System Console Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .249FIGURE 177. Analyze XRF Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .250FIGURE 178. Start Response Time Collection Pop-up. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .254FIGURE 179. Stop Response Time Collection Pop-up. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .255FIGURE 180. Response Time Groups Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .256FIGURE 181. Elements in a Group Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .260FIGURE 182. Element Manipulation Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .262FIGURE 183. Confirm Request to Delete a Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .265FIGURE 184. Confirm Request to Delete an Element . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .266FIGURE 185. Analyze AID Problems Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .273FIGURE 186. Open VSAM Files Panel (CICS/ESA Version 4 and earlier . . . . . . . . . . . . . . . . . . . . . .274FIGURE 187. Region Status Panel (prior to CICS/ESA Version 5.1.0) . . . . . . . . . . . . . . . . . . . . . . . .275FIGURE 188. Transplex Navigation Pushbutton . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .291FIGURE 189. Action Codes on the Programs Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .299FIGURE 190. Actions Pulldown Menu for the Program Entry Panel. . . . . . . . . . . . . . . . . . . . . . . . . .300FIGURE 191. Entry Fields on the Transaction Statistics Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .301


Preface 15

Preface

About this documentThis guide is an introduction to OMEGAMON II™ for CICS (hereafter referred to as OMEGAMON II). It describes the Common User Access (CUA) interface and gets you started monitoring the performance of your CICS system.

Who should use this guideThis guide is intended for data center personnel who are responsible for monitoring CICS performance, systems programmers and performance analysts who are responsible for a CICS system, and application programmers who wish to monitor their programs.

You can use this guide in conjunction with an OMEGAMON II session or read it by itself in order to become familiar with the capabilities of OMEGAMON II.

Note: This document refers to Version 2 of CICS as CICS/MVS, and Versions 3 and greater as CICS/ESA.

P

Documentation Set


Documentation Set

IntroductionCandle provides a complete set of documentation for OMEGAMON II for CICS. Each manual in this documentation set contains a specific type of information to help you use the product.

n OMEGAMON II for CICS Configuration and Customization Guide, document number C251-6363

Explains how to configure and customize OMEGAMON II after it is installed.

n OMEGAMON II for CICS User’s Guide, document number C254-6312

Provides a task-oriented guide to using OMEGAMON II. Explains basic features and navigation methods.

n OMEGAMON II for CICS Reference Manual, Volume I document number C253-6313

Provides comprehensive reference information about the features of OMEGAMON II and explains how to access OMEGAMON II data in the CUA interface.

n OMEGAMON II for CICS Reference Manual, Volume II document number C253-6314

Provides comprehensive reference information about the features of OMEGAMON II and explains how to access OMEGAMON II data in the menu system interface.

n OMEGAMON II for CICS Historical Reporting Manual, document number C299-6316

Describes how to use the SMF records created by OMEGAMON II to produce historical reports.

n OMEGAMON II for CICS Problem Determination Manual, document number C257-6315

Describes how to diagnose and solve problems that you may encounter with OMEGAMON II, get the best possible problem-solving help from Candle Support Services, and prevent or reduce the recurrence of problems.

n Messages Manual - OMEGAMON II/OMEGAVIEW, document numbers WO52-6238, WO52-6239, WO52-6240

Provides reference summary of all OMEGAMON II and OMEGAVIEW messages.

n End-to-End Response Time Feature (ETE) Version 500 Reference Manual, document number ET53-5586

Describes ETE planning and installation considerations and ETE commands; lists error messages, return codes, and sense codes.

Preface 17

Adobe Portable Document Format

Adobe Portable Document Format

Printing this bookCandle supplies documentation in the Adobe Portable Document Format (PDF). The Adobe Acrobat Reader will print PDF documents with the fonts, formatting, and graphics in the original document. To print a Candle document, do the following:

1. Specify the print options for your system. From the Acrobat Reader Menu bar, select File > Page Setup… and make your selections. A setting of 300 dpi is highly recommended as is duplex printing if your printer supports this option.

2. To start printing, select File > Print... on the Acrobat Reader Menu bar.

3. On the Print pop-up, select one of the Print Range options forn Alln Current pagen Pages from: [ ] to: [ ]

4. (Optional). Select the Shrink to Fit option if you need to fit oversize pages to the paper size currently loaded on your printer.

Printing problems?The print quality of your output is ultimately determined by your printer. Sometimes printing problems can occur. If you experience printing problems, potential areas to check are:n settings for your printer and printer driver. (The dpi settings for both your driver and

printer should be the same. A setting of 300 dpi is recommended.)n the printer driver you are using. (You may need a different printer driver or the Universal

Printer driver from Adobe. This free printer driver is available at www.adobe.com.)n the halftone/graphics color adjustment for printing color on black and white printers (check

the printer properties under Start > Settings > Printer). For more information, see the online help for the Acrobat Reader.

n the amount of available memory in your printer. (Insufficient memory can cause a document or graphics to fail to print.)

For additional information on printing problems, refer to the documentation for your printer or contact your printer manufacturer.

Contacting AdobeIf additional information is needed about Adobe Acrobat Reader or printing problems, see the Readme.pdf file that ships with Adobe Acrobat Reader or contact Adobe at www.adobe.com.

http://www.adobe.com



Documentation Conventions



IntroductionCandle documentation adheres to accepted typographical conventions for command syntax. Conventions specific to Candle documentation are discussed in the following sections.

Panels and figuresThe panels and figures in this document are representations. Actual product panels may differ.

Revision barsRevision bars (|) may appear in the left margin to identify new or updated material.

Variables and literalsIn examples of command syntax, uppercase letters are actual values (literals) that the user should type; lowercase letters are used for variables that represent data supplied by the user. Default values are underscored.

LOGON APPLID (cccccccc)

In the above example, you type LOGON APPLID followed by an application identifier (represented by cccccccc) within parentheses.

Note: In ordinary text, variable names appear in italics.

Preface 19


SymbolsThe following symbols may appear in command syntax:

Table 1. Symbols in Command Syntax

Symbol Usage

| The “or” symbol is used to denote a choice. Either the argument on the left or the argument on the right may be used. Example:

YES | NOIn this example, YES or NO may be specified.

[ ] Denotes optional arguments. Those arguments not enclosed in square brackets are required. Example:

APPLDEST DEST [ALTDEST]In this example, DEST is a required argument and ALTDEST is optional.

{ } Some documents use braces to denote required arguments, or to group arguments for clarity. Example:

COMPARE {workload} -REPORT={SUMMARY | HISTOGRAM}

The workload variable is required. The REPORT keyword must be specified with a value of SUMMARY or HISTOGRAM.

_ Default values are underscored. Example:

COPY infile outfile - [COMPRESS={YES | NO}]In this example, the COMPRESS keyword is optional. If specified, the only valid values are YES or NO. If omitted, the default is YES.



What’s New 21

What’s New

IntroductionThis section details the new features and enhancements incorporated into OMEGAMON II for CICS Version 520.

HighlightsOMEGAMON II for CICS Version 520 includes the following new features and enhancements:

n Allows printing a SNAPSHOT of a CICS region.

n Added the Exchange Logname Status exception.

n Added Transaction Server 1.3 Task Monitoring Data and Statistics

n Enhanced RLIM Interval Settings

n Added User Defined Event Monitoring

n Enhanced ADABAS statistics reporting

n Added support for ADABAS 7.1

The following features are no longer supported by OMEGAMON II for CICS Version 520:

n Support for CICS/ESA Version 3.x.x

n Documentation for BookManager no longer supported

W

New Features and Enhancements



Print SNAPSHOT of CICS RegionThe SNAP facility is composed of a sequence of pre-defined OMEGAMON II screens which contain every OMEGAMON Classic command you can use to report on the state and content of your CICS region.

This facility is now accessible in the C2/CUA interface to OMEGAMON II for CICS product. A new item was added to the Options/Controls pulldown which upon selection will route the output to the JES print queue under the common interface (Menu System) Job JCL.

Exchange Logname Status ExceptionExchange Logname status is a new OMEGAMON II for CICS exception added to the list of existing ones under the MRO/ISC. Once enabled the MRO/ISC light will alert users when the Exchange Log Name or XLN is ’Notdone’ between two, APPC type connected, CICS systems.

Online Global FacilityThe Online Global Facility is introduced to eliminate the requirement for re-assembly and linking of the product global data area module(s). Using the C2/CUA interface, this facility will enable users to SAVE the currently running global module to the library defined by the RKC2GLBL DD statement.

Using the Candle Installation/Configuration Assistance Tool (CICAT), users can edit and verify any of the existing global data area modules. Note that utilities are provided to migrate the previous versions of the global data area to the new format in V520. Refer to the OMEGAMON II for CICS Configuration and Customization Guide for more information.

What’s New 23


Transaction Server 1.3 Task Monitoring Data and StatisticsThe OMEGAMON II for CICS product has been enhanced to support the new performance monitoring data and statistics introduced in Transaction Server release 1.3. Non-3270 statistics such as WEB Send and Receive request counts are now displayable in active transactions as well as the Online History (ONDV) component.

The Task Time Analysis screens have been enhanced to include the newly introduced performance monitoring data such as JVM elapsed and suspend times, IMS(DBCTL) wait time, DB2 wait times, Socket I/O wait time, Global ENQ delay, among others. In addition, the Task Timings panels have been redesigned to display a categorical view of Timings attributed to a transaction or task.

Resource Limiting (RLIM) Interval SettingsThe Resource Limiting feature of OMEGAMON II for CICS product has been enhanced to introduce a set of user defined intervals. This enhancement will allow users to activate the previously defined rules based on a user modifiable interval. The new RLIM interval may be set in three different ways:

n By TIME.

n By the number of EXEC CICS calls made by a task.

n By the number of Database calls made by a task.

User Defined Event MonitoringThe User Defined Event Monitoring (USREVNT1) describes a way for application programmers to clock and count the number of requests being made to an in-house database, program or procedure. Similar to other Third Party Products such as ADABAS, DATACOM, IDMS and SUPRA, this facility may be enabled from the Options pulldown in the C2/CUA interface under the CICS File/Database collection option.



ADABAS Statistics ReportingADABAS statistics in the OMEGAMON II for CICS product have been traditionally based on DB ID and File number. With the specification of a new operand in the product’s global data area module, users may request OMEGAMON to collect statistics based on DB ID, File number, and Command Code.

Support for ADABAS V7.1The new release of ADABAS V7.1 supports DB IDs greater than 255. The relevant OMEGAMON II for CICS product panels were enhanced to display a 5-digit database ID.

Online DocumentationWith version 520, Candle Corporation has moved OMEGAMON II for CICS manuals from IBM BookMaster to Adobe FrameMaker. This move was made to better enable us to address our customers’ needs by providing tools that enhance productivity.

One of the results of the move is that it is no longer possible to create BookManager versions of the OMEGAMON II for CICS manuals. However, the manuals remain available online in the Adobe PDF version on CD-ROM and are also available on the Candle Corporation website at www.Candle.com.

The documentation CD being provided with this release has robust and easy-to-use search capabilities. You can search for information in multiple volumes, multiple versions, and across products. The CD also provides easy setup of search indexes with a single click of the mouse.

If you want to order printed copies of the documentation, please contact your Candle Support Services representative.

Introduction 25

Introduction

OverviewOMEGAMON II is a comprehensive software performance monitor for the IBM Customer Information Control System (CICS).

The OMEGAMON II realtime monitor alerts you to CICS response time degradation and overall system problems through color-coded status bars or through user-defined status words. Through online help, OMEGAMON II recommends corrective actions.

The OMEGAMON II historical facility collects transaction and resource-related information to enable you to meet service-level objectives and plan for system upgrades.

Chapter ContentsCUA Interface for Ease of Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Logical Tuning Approach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Batch Reporting Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

1

CUA Interface for Ease of Use


CUA Interface for Ease of UseThe OMEGAMON II realtime monitor includes two user interfaces: the Common User Access (CUA) interface and the menu system. This document focuses only on the CUA interface. For information on the menu system, see Part 2 of the OMEGAMON II for CICS Reference Manual.

The CUA interface of OMEGAMON II complies with the IBM SAA/CUA Systems Application Architecture/Common User Access guidelines, which promote ease of use in software interfaces. For more information about CUA, see the IBM Common User Access: Basic Interface Design Guide.

Accessed either directly or through OMEGAVIEW®, the OMEGAMON II CUA interface provides a high-level overview of and detailed information on the performance of CICS regions. With its CUA-compliant panels, color-coded status bars, and point-and-shoot navigation facility, the CUA interface is ideally suited for monitoring CICS regions and responding to a problem as soon as it occurs.

Introduction 27

Logical Tuning Approach

Logical Tuning ApproachAll of OMEGAMON II’s features and facilities are designed around the concept of a logical tuning approach. The logical tuning approach consists of the following activities:

n setting standards for CICS performance at your installationn monitoring your CICS to measure actual performance against these standardsn identifying the cause of performance problems and taking action to correct them

Setting Performance StandardsYou set standards for CICS performance in such areas as:

n transaction response timen transaction throughputn CPU utilizationn DASD response timen paging raten storage utilization

Monitoring PerformanceMonitoring CICS performance consists of asking two basic questions:

n Are your performance measurements within an acceptable range?n What are the problems in the system?

Identifying and Solving Performance ProblemsWhen you select a status bar next to a component on the Region Status panel, you can follow the status condition for the component that was indicated by a light of a particular color (for example, red). You follow the status condition by navigating through panels with the same color light until you reach a panel that has the information you need. You can then determine the nature of the problem and its appropriate solutions.

Features


FeaturesThe following features are available to help you manage the operation and performance of CICS:

n internal bottleneck collectionn CICS system analysisn external contention analysisn response time collection

The following sections provide brief descriptions of these features.

Internal Bottleneck CollectionA CICS task waits many times during normal processing. OMEGAMON II’s internal bottleneck collection feature monitors and categorizes the resources for which CICS tasks are waiting. Typical waits can be I/O events, VSAM buffer and string waits, enqueue waits, and short-on-storage conditions.

As the applications grow and change, so does the use of resources in the CICS system. By highlighting resources for which contention is greatest, OMEGAMON II enables you to focus your tuning efforts where they will do the most good.

CICS System AnalysisA CICS system at a typical installation is constantly undergoing change. OMEGAMON II displays control blocks, parameter settings, and current performance on such items as:

n AID/ICE activityn transient data usagen temporary storage usagen CICS table entriesn CICS control blocksn CICS storage usagen VSAM filesn DB2 connectionn DL/I activity and statusn DASD usagen CPU usage and pagingn CICS workload and task history

External Contention AnalysisOMEGAMON II’s external contention analysis feature identifies other workloads running on MVS that are impacting CICS by competing with it for MVS resources. These workloads can be batch jobs, started tasks, TSO users, or even other CICS regions. The displays not only identify the main sources of impact, but also show how CICS is being affected so you can take immediate action to address those areas that will result in the most significant improvement.

Introduction 29

Features

Response Time CollectionOMEGAMON II’s response time collection feature provides displays of CICS internal response time for transactions, terminals, and programs, as well as end-to-end response time for VTAM logical units (LUs). OMEGAMON II compares response time against user-specified performance standards for any of these resources or groups of resources.

Batch Reporting Methods


Batch Reporting MethodsYou can select from the following software to produce batch reports from System Management Facilities (SMF) records generated by OMEGAMON II:

n Statistical Analysis System (SAS)n OMEGAMON II historical reporter (formerly called EPILOG 1000)n User-written programs

SASSAS reporting allows you to use the OMEGAMON II historical component to generate historical reports based on your CICS performance data. Daily, weekly, and monthly reports display your data at varying levels of detail. As an alternative to the historical reporter for reporting SMF data, the SAS support package can help you identify potential performance problems and test the effects of your changes to CICS performance parameters. This facility is especially useful for reporting CICS performance to upper management and for making long-range CICS tuning decisions.

OMEGAMON II Historical ReporterThe OMEGAMON II historical reporter generates reports based on data that was collected from CICS regions, written to an SMF dataset, and converted to the reporter format.

You can request reports that analyze such areas of performance and capacity as:

n response timen transaction volume and resource usen program usagen usage by terminal

See the Historical Reporting Guide for more information.

User-written ProgramsYou can use the interval, system-related, and task-related records that OMEGAMON II writes to SMF in programs that you write to produce historical reports of your system’s performance.

See “SMF Considerations” in the OMEGAMON II for CICS Configuration and Customization Guide and “Collecting and Storing Historical Data” in the OMEGAMON II for CICS Reference Manual for information on how to start, stop, and limit the logging of these records to SMF.

Learning About the CUA Interface 31

Learning About the CUA Interface

IntroductionThis chapter acquaints you with the general features of the CUA interface panels and offers some guidelines for using these features.

If you are already familiar with the CUA interface, skip this chapter and proceed to “Getting Started with OMEGAMON II” on page 47.

Chapter ContentsPanel Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32CUA Interface Panel Characteristics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Action Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Navigating . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Using Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Enter Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Function Keys. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Exiting from OMEGAMON II . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

2

Panel Contents


Panel ContentsPanels within the CUA interface are composed of the elements described below. The following figure shows a typical panel.

FIGURE 1. Typical CUA Interface Panel

Action Bar An action bar (1) appears as the top line on each panel. The items on the action bar represent choices that, when selected, display pull-down menus. See “Action Bar” on page 35 for more information.

Panel Body Data is displayed in the body of the panel(2). The format of the data varies depending on its type. The panel body may contain status bars, tables, or graphs.

Some fields in the panel body are preceded by an underscore (_) to indicate that you can enter an action code for this field. See “Navigating” on page 38 for more information on entering action codes on panels.

Pushbuttons These are words that appear in angled brackets or parentheses, located near the bottom of the panel (3). You can use pushbuttons to move directly to the panel named within the brackets. Words within parentheses indicate the panel that you are currently viewing. (Pushbuttons do not appear on all panels.)

Function Keys Function keys that are active for the current panel are displayed at the bottom of the panel (4). See “Function Keys” on page 43 for more information.

____ Actions GoTo View Index Options Help 1 ----------------------------------------------------------- 05/24/93 16:05:50 KC2L01D Internal Bottlenecks Region: CICSPROD Fastpath: =AB Auto(60) +-----------------------------------------+---------------------------------+ | Group name . . . . . . PAYROLL_____ + | Samples taken . . . : 59 | | Collection interval : 1:00 MN | Elapsed time . . . . : 10 SEC | +-----------------------------------------+---------------------------------+ 2 Lines ___1 to 7 of 10 +------------+------------+-----------+-------------------------------------+ | Resource | Resource | Wait | Bottleneck | | Type | Name | Type | Ratio 0.....................100 | |------------|------------|-----------|-----------+------------!--!---------+ | _ RUNNING | RUNNING | CPU | 9% |----> | | _ FCIOWAIT | *TOTAL* | FILE | 6% |--> | | _ FCIOWAIT | FILEA | FILE | 4% |-> | | _ FCIOWAIT | FILEB8CH | FILE | 2% |> | | _ TSBUFFER | (NONE) | TEMPSTOR | 5% |--> | | _ PROGRAM | BIGPROG0 | LOADER | 3% |-> | | _ IRLINK | SYS2 | MRO | 1% |> | +------------+------------+-----------+-----------+-------------------------+ (Internal Bottlenecks) <External Contention> <Response Time Details> 3 F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status 4


CUA Interface Panel Characteristics

CUA Interface Panel CharacteristicsThis section describes the features of the CUA interface panels.

Status BarsThe panel body uses status bars to represent a set of thresholds applied against a CICS component. The color of the status bar indicates whether or not a problem exists and its severity:

On a monochrome terminal, words indicate the status of the component. You can specify the words you want to display in the status bars through the Session Defaults pop-up window of the Options pull-down. See “Controls” on page 75 for information on setting session defaults.

The default status words that display are as follows:

n Crit (critical status)n Warn (warning status)n OK (okay status)n Idle (component not being monitored)

Text and Field Colors and HighlightingAttributes such as color, highlighting, and underlining, as well as certain characters, are used in these panels to identify types of text and fields. On a color terminal, colors are used as follows:

Note: If you are using 3270 emulation hardware and software on a personal computer, various panel attributes (such as color, highlight, underline, and reverse video) may appear significantly different from the way they appear on an actual 3270 device. You may have to change definitions in your 3270 emulator to achieve desired color mapping. Refer to the appropriate 3270 emulator manuals or consult your system administrator.

Red Critical problem that requires immediate attention.

Yellow Warning of a potential problem.

Green Satisfactory performance.

Turquoise No data is being collected.

White Items that are available for selection. On a monochrome terminal, the field is the display color for that terminal.

Green with underscore or highlighted

Fields that accept input. On a monochrome terminal, the field is underscored. Entry fields followed by a plus (+) sign are used with the F4 key to see selection lists or to toggle between settings.

Blue Items that are unavailable for selection, either temporarily or permanently. On a monochrome terminal, an asterisk (*) appears as the first character of the selection.

Turquoise Items in nonselectable fields; default text.

CUA Interface Panel Characteristics


EllipsisAn ellipsis (...) following a selection indicates that further selection is required after you make the initial selection. You make selections from another menu or add data to complete the task.

ScrollingOn many panels, when more information is available than can be displayed on one panel, a scroll indicator is available as one of the following:

Displaying All Uppercase CharactersBy default, OMEGAMON II displays the data on its panels in both uppercase and lowercase letters. If any of your terminals reserve the lowercase codes for international characters, you must edit the KLVSYSIN member in the rhilev.RKANPAR dataset to specify all-uppercase displays for OMEGAMON II.

Add the following statement to KLVSYSIN:

UPPERDLG(Y)

Lines n to nn of nn

You can overtype this line to specify the line that you want to view (see Figure 1 on page 32). Just type the number of the line of information you want to see and press Enter.

Note: This line does not display on panels that have only one screen of data; such panels are not scrollable.

More Displayed on some panels in the upper right corner, this indicator is followed by a plus (+) sign, a minus (-) sign, or both. The plus (+) sign means that pressing F8 scrolls forward to display more data. A minus (-) sign means that pressing F7 scrolls backward to display more data. When both plus and minus display next to More, you can scroll forward or backward.


Action Bar

Action BarThe action bar is the first line at the top of a panel. See the following figure.

FIGURE 2. Action Bar

The first position of the action bar is the home position and is used for selecting action bar choices. The action bar choices are as follows:

Using the Action BarTo move the cursor to the home position of the action bar:

n Press F10. The cursor position is stored and the cursor is returned to the same position when you press F10 again.

n Press the Home key. The position of the cursor in the panel body is not retained.

To select from the action bar, do either of the following:

n Press the Tab key to move the cursor to the entry field of your choice and press Enter.n Type the first letter of the choice in the home position and press Enter.

Actions Act upon selected objects in the panel body; exit the panel to the previous panel. For more information on Actions, see “Using the Actions Pull-down” on page 60.

GoTo From the current area, transfer to a related panel of CICS monitoring. For more information on GoTo, see “Using the GoTo Pull-down” on page 61.

View Filter or sort the data displayed on applicable panels. For more information on View, see “Using the View Pull-down” on page 67.

Index Access panels by selecting either a subcategory or a panel title, or search the panel title index when you do not know a particular panel title. For more information on Index, see “Using the Index Pull-down” on page 65.

Options Customize the CUA interface. For more information on Options, see “Using the Options Pull-down” on page 72.

Help Access the various types of help available in the CUA interface. For more information about Help, see “Using Help” on page 40.

____ Actions GoTo View Index Options Help ----------------------------------------------------------- 05/31/93 08:02:34 KC2F01D Response Times Region: CICSPROD

Action Bar


Pull-down MenuWhen you make a selection from the action bar, a pull-down menu is displayed. A pull-down menu provides a list of further selections that you can make. For example, the Options pull-down menu is displayed when you select Options from the action bar, as shown below.

FIGURE 3. Region Status Panel, Options Pull-Down (Prior to CICS 5.1.0)

Although part of the underlying panel is visible, it is not usable while the pull-down menu is displayed. If you move the cursor outside the pull-down menu and press a key, the cursor returns to the pull-down menu.

o___ Actions GoTo Index Options Help ------------------------ +--------------------------------+ 05/24/93 21:05:16 KC2B01D | _ 1. Preferences | Region: CICSPROD | 2. Controls... | Auto(60) Select one component w | | S=Show details A=A | 3. Collection controls... | +------------------+---- | 4. CICS shutdown option | -----------------+ | Workloads | | | Alerts | |------------------|---- | 5. Thresholds... | -----------------| | _ AIDs Warn | _ C | 6. Response time groups |_ Bottlnck OK | | | | | | | _ ICEs OK | _ D | 7. Userid profiles |_ CICSloop OK | | | | 8. Region profiles | | | _ Response OK | _ D | |_ Dumps OK | | | | 9. Close print log | | | _ Tasks OK | _ D | |_ Enqueues OK | | | | F1=Help F12=Cancel | | | _ TranRate OK | _ DL+--------------------------------+_ I/O Rate OK | | | | | | | _ Files OK _ TempStor OK | _ VTAM ACB OK | | | | | | | _ Journals OK _ TranData OK | _ XRF Crit | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print


Action Bar

Pop-up WindowA pop-up window is displayed when you make a selection from a pull-down menu or press a function key. Pop-up windows prompt you for further selections, display help, or explain errors and how to correct them. Even though more than one pop-up window may appear at one time (overlapping each other), only the last pop-up window displayed accepts data.

FIGURE 4. Date Format Selection Pop-up

Although pop-up windows and pull-down menus share several features, you can distinguish them as follows:

n A pull-down menu appears when you make a selection from the action bar.n A pop-up window appears when additional information is required to complete a function

or when an error occurs.

o____ Actions GoTo Index Options Help ------------------ +---------------------------------------------------------+ KC2B01D | Preferences | | | Select one compo | Type any changes, then press Enter. | S=Show details | | +----------------- | Mnemonics . . . . . . . On + On/Off | | Workloads | Beep +-----------------------------------------------+ |----------------- | Pane | Date Format Selection | | _ AIDs | Time | | | | Func | Lines 1 to 6 of 13 | | _ ICEs | Impl | Move cursor to selection, then press Enter. | | | Nati | | | _ Response | Date | ____Date Format____ | | | | | | _ Tasks | Time | mm/dd/yy | | | Fo | dd.mm.yy | | _ TranRate | Se | Month dd, yyyy | | | Mo | Day, Month dd, yyyy | | | Af | dd/mm/yy | | | | yy/mm/dd | | | F1=Hel | | +----------------- +-------- | F1=Help F12=Cancel | +-----------------------------------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print

Navigating


NavigatingThe CUA interface gives you several ways to use OMEGAMON II’s features and functions.

Ways of Selecting ItemsUse one of the following methods to select an item from a panel, a pull-down menu, or a pop-up window:

n Move the cursor to the entry field of your selection and press Enter (provided Implicit Action is on in the Preferences option).

n Type the action code in the entry field and press Enter.n Type the number of the selection in the entry field of the first selection and press Enter.n If you are using a monochrome terminal, type the character in parentheses (called a

mnemonic) in the entry field and press Enter. (Mnemonics is turned on in the Preferences option).

n Tab to a pushbutton and press Enter or type a mnemonic in the home position to move directly to the panel named in the pushbutton.

For example, to select and display the pull-down menu for Options, enter O in the home position. The Options pull-down menu is displayed. You can then select a menu choice by typing its number in the entry field and pressing Enter.

Fast PathingFast pathing in the CUA interface allows you to quickly access pull-down menus, items on pull-down menus, and panels. You do this by entering a mnemonic in the action bar entry field (home position). The mnemonic can be a single character or a string. You can use fast paths to access all panels or, if the panel contains pushbuttons, only panels related to the one you are viewing.

All-Panel Fast Pathing

When you enter the fast path character, the equals sign (=), followed by a mnemonic, OMEGAMON II takes you directly to the panel represented by that mnemonic.

For example, to access the Tasks panel, follow these steps:

1. Type =WT in the action bar entry field. (The = stands for fast path, the W for Workloads, and the T for Tasks.)

2. Press Enter. The Tasks panel displays.

Note: In some cases an intermediate pop-up may appear so you can select from it before accessing the panel. The pop-up contains items related to the panel, such as transaction IDs, file IDs, task numbers, devices, and program IDs. After you select the item you want from the pop-up and press Enter, the panel appears.

The following figure shows how a fast path entry would appear on the action bar.


Navigating

FIGURE 5. Fast Pathing Entry

Note: You type the fast path character (=) as part of the entry only when navigating between panels, not pull-down menus.

The appendix titled “Fast Pathing in the CUA Interface” on page 277 lists the fast path mnemonics you can use to access panels in the OMEGAMON II CUA interface.

Pushbutton Fast Pathing

You can also fast path to the destinations specified in the pushbuttons. This type of fast pathing uses the left angle bracket (<) as the fast path character.

Each pushbutton has a highlighted character. To fast path to a particular pushbutton destination, type the fast path character followed by the highlighted character of the desired pushbutton. Then press Enter.

For example, in the panel shown below, you would enter <H to go to the Response Time History panel.

FIGURE 6. Pushbutton Mnemonics on the Response Times Panel

Transplex NavigationThrough Transplex™ navigation, you can follow a specific transaction from a panel in one OMEGAMON to a panel in another OMEGAMON that contains information corresponding to that transaction. You invoke this feature with a context-sensitive pushbutton that provides the mechanism to navigate between OMEGAMON panels. See “Transplex Navigation and Session Switching” on page 289 for more information.

=WT Actions GoTo View Index Options Help ----------------------------------------------------------- 05/31/93 08:02:34 KC2F01D Response Times Region: CICSPROD

| _ ADABAPGM | Prog| .3| 1.2| 1.3| .8| .3| .5| .9| 1.0| 2.5| | _ PRODTRAN | Tran| .1| .0| .0| .1| .0| .0| .0| .0| .0| | _ PRODTERM | Term| .1| .0| .0| .0| .0| .0| .0| 1.1| 1.2| | _ TESTTERM | Term| .1| .0| .0| .0| .0| .0| .0| 1.1| 1.3|+----------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+

Response Times) <Response Time History> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

Using Help


Using HelpHelp can be accessed from the Help pull-down, from a panel, and from fields on a panel.

The OMEGAMON II help system is comprehensive and contains everything from a glossary of terms and tuning considerations to guides for immediate action. Use the system as a detailed reference and for help in solving problems.

Action Bar HelpTo display help from the action bar, move the cursor to the help choice or type H in the home position. Then press Enter.

The Help pull-down menu is displayed, as shown in the following figure.

FIGURE 7. Help Pull-down Menu

To display a help topic, move the cursor to the entry field of your selection, or type its number or mnemonic in the entry field. Then press Enter.

H___ Actions GoTo Index Options Help --------------------------------- +-----------------------------+ /93 16:25:36 KC2B01D R | _ 1. Help for help... | n: CICSPROD + | 2. Extended help... | Auto(60) Select one component with a / o | 3. Keys help... | S=Show details A=Analyze pr | 4. Help index... | +------------------+------------- | 5. Tutorial... | -----------+ | Workloads | | 6. Glossary... | lerts | +------------------+------------- | 7. About... | -----------+ | _ AIDs Warn | _ CPU O | 8. User Information... | nck OK | | | | 9. New Features... | | | _ ICEs OK | _ DASD C | | oop OK | | | | F1=Help F12=Cancel | | | _ Response OK | _ DB2 O +-----------------------------+ OK | | | | | | _ Tasks OK | _ DBCTL Warn _ Storage OK | _ Enqueues OK | | | | | | _ TranRate OK | _ DL/I OK _ Tapes OK | _ I/O Rate OK | | | | | | | _ Files OK _ TempStor OK | _ VTAM ACB OK | | | | | | | _ Journals OK _ TranData OK | _ XRF Crit | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print


Using Help

The following selections are available from the Help pull-down menu:

Panel HelpTo see help for the panel that you are currently using, make sure the cursor is at the home position, then press F1. A topic describing the panel is displayed in a pop-up window.

When you have finished viewing Help, press F12 or F3 to exit.

Field HelpTo display help for an input field on a panel, position the cursor on the underscore of the field, then press F1. A topic defining the field is displayed in a pop-up window. When you have finished viewing Help, press F12 or F3 to exit.

Help for help Explains how to navigate through theOMEGAMON II help panels.

Extended help Panel level help for the current panel. This can also be accessed using F1 on any panel.

Keys help Describes the function keys used in the CUA interface

Help Index Provides an alphabetic index of help panels. Press F6 in the Help Index pop-up to see the Search Index pop-up, which you can use to search for specific help topics.

Tutorial Gives instruction on navigating around &OII., tells how to use the parts of the screen, and tells how to get help from fields, the glossary, and the help index. This selection also lists tips on using OMEGAMON II. These tips introduce you to new product features and advanced navigation techniques that will help you use the product more efficiently.

Glossary Defines words and phrases for components, functions, and features of CICS and OMEGAMON II. Press F6 in the Glossary pop-up to see the Search Glossary pop-up window. Use this pop-up to search for specific glossary terms.

About Shows logo, copyright, and product version information.

User Information Shows information about your current session, such as user ID, terminal ID, system ID, VTAM logmode name, and current ACB name.

New Features Describes the new features of this release.

Enter Key


Enter KeyPressing Enter tells the application to do one of the following:

n display the choice selected from a pull-down menu

n save changes or additions to entries made on a pop-up window; then exit

n save changes made to data on panels

n refresh data displayed on panels


Function Keys

Function KeysFunction keys are used to perform many tasks in OMEGAMON II. The keys and their uses are displayed at the bottom of each panel.

Only the function keys that are available for the current panel are displayed. For example, panels with data that may continue over several screens display the backward and forward function keys, F7 and F8, respectively, while single-screen panels do not display them.

To display descriptions of the function keys, select Keys help from the Help pull-down menu.

General Function KeysThe following keys are generally active throughout the CUA interface:

F1=Help Displays a help window for the current panel or window.

F2=Keys Toggles (turns on or off) the function key display at the bottom of the panel.

F3=Exit Returns to a higher level panel. From a help panel, returns to the panel where help was requested. Cancels changes made to a panel. From the Region Status panel, exits the CUA interface.

F4=Prompt Displays a list of valid selections for an input field. Promptable fields are indicated by the presence of a plus (+) sign. Where there are only two valid selections for an input field, such as yes/no or on/off, F4 acts as a toggle, switching between the two selections.

F5=Refresh Clears and updates the display panel data. From a data entry panel, restores the last saved value. If the cursor is on a field, the last saved value is restored for that field. If the cursor is not on a field, the last saved values for all fields are restored. From a help panel, displays the Glossary.

F6=Console Presents the System Console panel from which you can issue CICS, MVS, JES, and VTAM commands.

F7=Bkwd Scrolls backward if more lines exist than can be displayed on the current panel. If you are on the first panel, two asterisks (**) are displayed instead of the function key name.

F8=Fwd Scrolls forward if more lines exist than can be displayed on the current panel. If no additional information exists, two asterisks (**) are displayed instead of the function key name.

F9=Retrieve On the System Console panel, retrieves the previous command issued from the command line.

F10=Action Bar

Moves the cursor to the action bar at the top of the panel or back to where it was in the panel body the last time you pressed F10.

F11=Print Prints the screen. To route the screen to the printer, select the Options pull-down, then select Close print log. From a help panel, displays the Help index.

F12=Cancel Exits the current pull-down menu or pop-up window without saving entered data.

F15=Region Status

Returns directly to the Region Status panel.

Function Keys


F18=Defaults Displays default settings. If the cursor is on a field, the default is restored for that field. If the cursor is not on a field, the defaults for all fields will be restored. (Available in some pop-up windows.)

PA2=Default trigger key

Use to return from the OMEGAMON menu system. To change the key, select the Options pull-down, then Controls, then Session Defaults.


Exiting from OMEGAMON II

Exiting from OMEGAMON IITo exit from the CUA interface, follow these steps:

1. From the Region Status panel, press F3.

2. When the Exit Confirmation pop-up window displays, type X or 1.

3. Press Enter.

Exiting from OMEGAMON II


Getting Started with OMEGAMON II 47

Getting Started with OMEGAMON II

IntroductionOMEGAMON II for CICS allows you to see the status of a CICS region. Status bars displayed on the Region Status panel indicate the health of a particular region. Starting from this panel you can learn more about how a region is performing by navigating to show details for the region or to view problem analysis panels. You can also select from the action bar to:n see which action codes are valid for the panel you are viewingn navigate to panels related to the one you are viewingn filter the contents of a paneln select panels by categoryn customize the CUA interfacen see help topics in the help facility

This chapter tells how to log onto OMEGAMON II directly, describes the layout and use of the Region Status panel, and discusses each action bar choice available on it.

Chapter ContentsLogging Onto OMEGAMON II . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Begin Your OMEGAMON II Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Using the Region Status Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54Using the Actions Pull-down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Using the GoTo Pull-down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Using the Index Pull-down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Using the View Pull-down. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67Using the Options Pull-down . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72Dynamic Profile Update Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96Using the Help Pull-down. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97

3

Logging Onto OMEGAMON II


Logging Onto OMEGAMON IIAccess to the OMEGAMON II CUA interface is either direct or throughOMEGAVIEW. This section contains procedures for logging on directly and tells where to get information for logging on through OMEGAVIEW.

Logging on DirectlyYou can log onto OMEGAMON II directly by entering your VTAM application ID (applid).

Before logging on, be sure that the OMEGAMON II address space has been initialized. See the OMEGAMON II for CICS Configuration and Customization Guide for details on initializing the OMEGAMON II address space.

Entering Your VTAM Applid

To log on, issue the following command at a VTAM terminal (the OMEGAMON II address space must be initialized):

LOGON APPLID(aaaaaaaa)

where aaaaaaaa is the VTAM applid specified to the CL/Engine address space when it was started.

Finishing the Logon

After you’ve initiated the logon to OMEGAMON II, the Sign On panel displays to let you finish logging on. This panel validates you to your installation’s Logon Security system. The following figure shows the Sign On panel.

FIGURE 8. Sign On Panel

OMEGAMON II for CICS - V520 Sign On Panel Type the requested information, then press Enter. Identification Userid . . . . . . ________ Password . . . . . Change Password. . No_ + Yes/No Additional Information Group . . . . . . ________ Account . . . . . _____________________________________________ F1=Help F3=Exit F4=Prompt F6=Panel ID F11=Logon Options



To sign on, enter your user ID, which is described below:

You also may need to enter the following:

After you enter the signon information described above, you can begin your OMEGAMON II session unless you decide to specify logon options. See “Optional Step: Specifying Logon Options” on page 49 for that information, or see “Begin Your OMEGAMON II Session” on page 53.

Optional Step: Specifying Logon Options

Usually you can begin your OMEGAMON II session immediately after you have logged on through the Sign On panel and the system has initialized.

If, however, you want to verify defaults set up during customization, before you begin your session, access the Logon Options pop-up window (press F11 at the Sign On panel). Use this pop-up to specify startup information for the OMEGAMON II session you are starting.

The following figure shows the Sign On panel overlaid with the Logon Options pop-up.

User ID Enter your 1- to 8-character user ID. The user ID is mandatory even if your installation has no security system.

By default, you will use a userid profile with the same name as your user ID.

See “Defining a Different User ID Profile” on page 92 for more information.

Password Enter your 1- to 8-character password. The password is not visible as you type it. If you make a mistake, be sure to completely clear the field before retyping the password. The password is mandatory if a security system is in place.

Change Password

To change the current password, type Yes. The system prompts you for the new password information.

Group Used only if your system security administrator has implemented group level security. Enter a 1- to 8-character group ID.

Account Used only if your system security administrator has implemented account level security. Enter your installation security account number.



FIGURE 9. Sign On Panel Showing Logon Options

The default values for logon options are obtained from rhilev.RKANPAR(KC2IPAnn). These values were set up for your site during customization and display in this pop-up when you access it. (The user who installed and configured OMEGAMON II can tell you the high-level prefix for the dataset.)

Through the Logon Options pop-up, you can specify the following values:

OMEGAMON II userid profile

Enter the name of the OMEGAMON II userid profile you want to use for the current session.

If you have already supplied your userid on the OMEGAMON II Sign On panel, your default userid profile is displayed in this field. The default value is used as your OMEGAMON II userid profile.

To specify an alternate OMEGAMON II userid profile for this session, enter its name in this field. Press F4 to see a list of currently defined userid profiles.

See “Defining a Different User ID Profile” on page 92 for more information.

OMEGAMON common interface applid

Enter the 1- to 8-character VTAM application identifier for the OMEGAMON II for CICS common interface session you will use to monitor the CICS region.

KLVSGNON OMEGAMON II for CICS - V520 Sign On Panel Type the requested inf +-----------------------------------------------------+ | KC2LOGOP Logon Options | Identification | | Userid . . . . . . | Supply the appropriate logon options. | Password . . . . . | | Change Password. . | OMEGAMON II userid profile . . . . . ________ + | | | Additional Informati | OMEGAMON common interface applid . TDOCS21_ | Group . . . . . . | OMEGAMON common interface password. | Account . . . . . | CICS job name . . . . . . . . . . . TDOCS22_ | | CICS region profile . . . . . . . . TDOCS22_ + | | | | Migrate profile from OMEGAMON . . . No_ + (Yes/No) | | OMEGAMON profile to migrate from . /I | | Password for authorized commands . No_ + (Yes/No) | | Logical rows for menu system . . . 150_ (150-9999)| | | | Display Tip of the Day . . . . . . No_ + (Yes/No) | | | | Press F1 for more information on these fields. | | | | | | F1=Help F4=Prompt F12=Cancel | F1=Help F3=Exit F4=P +-----------------------------------------------------+



OMEGAMON common interface password

If desired, enter the 1- to 8-character password for the OMEGAMON II common interface (CANSOCnn) session you are trying to logon to.

Note: The nn variable in CANSOCnn designates an address space from 00-.55 in which to run the started task. For example, CANSOC03 specifies 03 as the address space.

This parameter is required only if security has been implemented for the OBVTAM subtask.

CICS job name Enter the 1- to 8-character MVS job (or started task) name of the CICS region you are monitoring. Or, if the started task has a stepname, then enter the stepname.

CICS region profile Enter the 1- to 8-character CICS region profile name to be used by the session you are defining.

The CICS region profile contains the OMEGAMON II thresholds settings for all performance measures.

If you specify a profile name in this field, it must have been previously defined in the OMEGAMON IICUA interface. Press F4 to see a list of currently defined CICS region profiles.

See “Defining A Different CICS Region Profile” on page 94 for more information.

Migrate profile from OMEGAMON

This option is a customization feature. See the OMEGAMON for CICS Configuration and Customization Guide for information.

OMEGAMON profile to migrate from

This option is a customization feature. See the OMEGAMON for CICS Configuration and Customization Guide for information.

Password for authorized commands

If you know that you will be using authorized commands, enter Yes and you will be prompted to set the password for the authorized commands used in OMEGAMON II displays.

Most OMEGAMON II displays use commands from theOMEGAMON II menu system. These commands can be protected by either a password or an external security exit which uses RACF or other security programs. Typically, commands are protected to prevent you from modifying the system or affecting other users (listing or changing memory, or killing a task, for example).

Once you enter a password, it is in effect until the end of your session or you reset it. To reset password authorization, use the Enable or Disable authorized commands option in the Options pull-down.



Logging on through OMEGAVIEWAn alternative method of logging onto OMEGAMON II is through OMEGAVIEW. See “OMEGAVIEW Enhanced Zoom” on page 269, for information on accessing OMEGAMON II through OMEGAVIEW.

Logical rows for menu system

Enter the number of logical rows for the virtual terminal that the OMEGAMON II CUA interface uses to obtain data from the menu system. This number can be from 150-9999.

If the number of logical rows specified is insufficient to hold the output for a command, the command output is truncated. If the CUA interface detects that command output has been truncated, it issues a warning message that the CUA display may contain incomplete data.

Increasing the logical rows size increases the amount of virtual storage used by the virtual session in the OMEGAMON II common interface (CANSOCnn address space.

Note.The nn variable in CANSOCnn designates an address space from 00-55 in which to run the started task. For example, CANSOC03 specifies 03 as the address space.

Display the Tip of the Day

Each time you start a direct logon session, you can select one of the following for the Tips option:

Yes Presents the Tip of the Day when you log on.

No Does not present the Tip of the Day at logon.

Wait Displays the Tip of the Day when you log on until you press Enter to cancel it. This selection gives you a longer time to read the tip.

If you leave this field blank, the default value you specified in KC2IPAnn of DDname RKANPAR is used for the Tips option.

A different tip appears on each day of the month.


Begin Your OMEGAMON II Session

Begin Your OMEGAMON II SessionAfter you have entered the required values on the Sign On panel and pressed Enter, the CICS Regions panel displays. This panel lists the available CICS regions that you can monitor. Select a region by typing an S in front of the CICS Jobname you want to monitor and press Enter. This displays the Region Status panel to begin your OMEGAMON II session. See “Using the Region Status Panel” on page 54 and the sections that follow it for introductory information you’ll need to know for a successful session.

If you would like an overview of what you might do during a typical session, see “CICS Problem-Solving Approaches” on page 99. This chapter contains scenarios that demonstrate typical situations you’ll encounter when using OMEGAMON II.

Using the Region Status Panel


Using the Region Status PanelThe Region Status panel is the first panel you see after you finish logging on. It provides a high-level overview of a particular CICS region, displaying status bars for workloads, resources, and alerts. The name of the CICS region being monitored is in the upper right corner of the panel.

The following figures show the Region Status panel for CICS/ESA Version 5.1.0 and all earlier CICS versions.

FIGURE 10. Region Status Panel (CICS/ESA Version 5.1.0)

The following figure shows the Region Status panel for all versions of CICS/ESA prior to 5.1.0.

_____ Actions GoTo Index Options Help ------------------------------------------------------------ 02/27/97 14:29:18 KC2B01D Region Status Region: TDOCS27 + Auto(Off) Select one component with a / or an action code. S=Show details A=Analyze problems L=Control +------------------+-------------------------------------+-------------------+ | Workloads | Resources | Alerts | +------------------+-------------------------------------+-------------------+ | AIDs OK | CPU OK MRO/ISC OK | Bottlnck Idle | | | | | | ICEs OK | DASD OK Paging OK | CICSloop OK | | | | | | Response OK | DB2 Idle Storage OK | Dumps OK | | | | | | Tasks OK | DBCTL Idle Tapes OK | Enqueues OK | | | | | | TranRate Idle | Files OK TCP/IP Idle | I/O Rate Idle | | | | | | UOWs OK | Journals OK TempStor OK | VTAM ACB OK | | | | | | | LSR OK TranData OK | XRF Idle | | | | | | | MQ Idle Web | | | | | | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print PA1=Switch



FIGURE 11. Region Status Panel (prior to CICS/ESA Version 5.1.0)

On the panel, the status bars are grouped into the following areas:

Workloads Indicates the status of the useful work CICS is currently performing.

See Chapter 5, “Monitoring Workloads” on page 129, for information on each component in the Workloads section of the Region Status panel.

Resources Indicates the status of resource usage.

See Chapter 6, “Monitoring Resources” on page 163, for information on each component in the Resources section of the Region Status panel.

Alerts Indicates the status of exceptional conditions that can degrade response time and that may require immediate action.See Chapter 7,“Responding to Alerts” on page 229, for information on each component in the Alerts section of the Region Status panel.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:10:03 KC2B01D Region Status Region: CICSPROD + Auto(60) Select one component with a / or an action code. S=Show details A=Analyze problems L=Control +------------------+-------------------------------------+-------------------+ | Workloads | Resources | Alerts | +------------------+-------------------------------------+-------------------+ | _ AIDs OK | _ CPU Crit _ LSR OK | _ Bottlnck Crit | | | | | | _ ICEs OK | _ DASD Crit _ MRO/ISC OK | _ CICSloop OK | | | | | | _ Response Crit | _ DB2 OK _ Paging OK | _ Dumps OK | | | | | | _ Tasks OK | _ DBCTL Warn _ Storage Crit | _ Enqueues OK | | | | | | _ TranRate OK | _ DL/I OK _ Tapes OK | _ I/O Rate OK | | | | | | | _ Files OK _ TempStor OK | _ VTAM ACB OK | | | | | | | _ Journals OK _ TranData Crit | _ XRF Idle | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print



Status Bar IndicatorsStatus bar indicators report the current status of each CICS component on the Region Status panel, based upon thresholds set to measure performance.

On Color Terminals

On color terminals, the status bars contain lights that represent a component’s status, as follows:n Red for criticaln Yellow for warningn Green for normaln Turquoise for not monitoring or data unavailable

Status words also display on a color terminal. The default status words are:

n Crit (for critical status)n Warn (for warning status)n OK (for normal status)n Idle (for not monitoring)

You can change the status words on a color terminal by using the Session Defaults pop-up window of the Controls option on the Options pull-down menu. Enter up to five alphabetic or numeric characters. (Enter fast path OCS.)

On Monochrome Terminals

On monochrome terminals, words display in place of colors. The default words that display are as follows:n Crit (for critical status)n Warn (for warning status)n OK (for normal status)n Idle (for not monitoring)

You can change the default words that display on a monochrome terminal by using the Session Defaults pop-up window of the Controls option on the Options pull-down menu. Enter up to five alphabetic or numeric characters. (Enter fast path OCS.)

Showing Details/Analyzing ProblemsYou can get more information on the status of a component by entering S next to a status bar to show details or A to analyze problems.

Enter S to Show Details

If a status bar for a component indicates that it is performing well (either green or characters indicate an OK condition), or indicates a warning or a critical condition, you can enter action code S (Show details) to get more information about the component being monitored. In most instances, a panel showing summary information for the component displays.



Enter A to Analyze Problems

If the color of a status bar for a component indicates that it is performing poorly (you see yellow or red, or characters indicate a warning or critical condition), you can enter action code A to analyze the problem by displaying the performance measures and thresholds values that have been exceeded. A panel then displays listing one or more problems for the component. The following figure shows a problem analysis panel.

FIGURE 12. Analyze DASD Problems Panel

Note: You should enter A next to a status bar only if its color or characters indicate the component is having problems. If you enter A next to a healthy status bar, you will get an error message such as the one shown below.

DASD is not currently experiencing any problems

Viewing the Frequency of Data CollectionEnter action code L (control data collection) next to a component to display a Thresholds pop-up window that shows the performance measures and thresholds for the component and the frequency of data collection. This field indicates how often OMEGAMON II collects data for the Region Status panel. Setting the frequency of data collection gives you control over resource usage.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:30:15 KC2B02D Analyze DASD Problems Region: CICSPROD Auto(60) +--------------------------------------+-----------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | +--------------------------------------+-----------+------------+------------+ | _ Response time for 0328 (OMON24) | 34ms | 30ms | 40ms | | _ Response time for 031C (OMON23) | 33ms | 30ms | 40ms | | _ Response time for 0319 (OMON30) | 31ms | 30ms | 40ms | +--------------------------------------+-----------+------------+------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status



Switching to Another CICS RegionThe name of the CICS region currently being monitored displays in the Region field of the Region Status panel (see Figure 11 on page 55). If you want to monitor another CICS region, you can switch to it by overtyping the name displayed in the field. A different region will then be monitored.

Note: If you are running OMEGAMON II under OMEGAVIEW, you cannot switch to another CICS region by changing the name in the Region field on the Region Status panel. You can change regions by using the OMEGAVIEW Switch Session key. See “Transplex Navigation and Session Switching” on page 289 for information on using this key.

When you switch regions, OMEGAMON II searches for the region profile in the following order:

1. It looks for a profile with the same name as the region name.2. If it does not find a profile with the same name as the region, and there is a region profile

specified in member KC2IPAnn, it uses that name.3. If it does not find a region profile specified in member KC2IPAnn (from dataset

rhilev.RKANPAR), it uses $DEFAULT.If you need to see the list of CICS regions that you can monitor, press F4. The CICS Region pop-up window displays. Tab to the desired region and press Enter.

Date/Time StampThe Region Status panel displays the current date and current time. You can specify the format of the date and time that display through the Preferences pop-up of the Options pull-down. See “Using the Options Pull-down” on page 72 for details. (Enter fast path OP.)

Auto Refresh IntervalThe auto refresh interval, which indicates the elapsed time, in seconds, before the screen automatically refreshes, is displayed on the Region Status panel. To change the length of the interval, use the Session Defaults pop-up on the Options pull-down. (Enter fast path OCS.)



Region Status Panel Function KeysThe following keys are available for the Region Status panel:

F1=Help Displays help for the Region Status panel or fields on the panel.

F2=Keys (This notation does not display but the key may be used)

Toggles (turns on or off) the function key display at the bottom of the panel.

F3=Exit From the Region Status panel, exits the CUA interface.

F4=Prompt Displays the list of CICS regions that you can monitor, when the cursor is on the Region input field.

F5=Refresh Clears and updates the data on the panel.

F6=Console Presents the System Console panel from which you can issue CICS, MVS, JES, and VTAM commands.

F10=Action Bar Moves the cursor to the action bar at the top of the panel or back to where it was in the panel body the last time you pressed F10.

F11=Print Prints the screen. To route the screen to the printer, select the Options pull-down, then select Close print log. (Enter fast path OL.)

Using the Actions Pull-down


Using the Actions Pull-downThe Actions pull-down menu enables you to choose an action for an item selected on a data panel or for the object described on a detail panel. Use the Actions pull-down menu when you need to see which action codes are available for the item you’ve selected. If you do not need to see the available action codes, enter the desired action code directly in a selectable field.

On a color terminal, actions colored blue are currently unavailable for selected items. On a monochrome terminal, an asterisk (*) appears as the first character of the selection.

To use the Actions pull-down, follow these steps:

1. Enter / on the panel next to the item you want. Press Enter. The Actions pull-down menu displays. The following figure shows an example.

FIGURE 13. AIDs Summary with Actions Pull-down

2. In the Actions pull-down menu, do one of the following:n move your cursor to the item and press Enter (see “Implicit Action” on page 74).

n type the number of the item and press Enter

n type the underlined letter and press Enter

n on monochrome terminals, type the letter in parentheses and press Enter

The action you selected from the Actions pull-down takes place.

____ Actions GoTo View Index Options Help---+-------------------------------------------------------05/27/93 12:09:59KC | _ 1. Show details |(AIDs) Region: CICSPRODFa | 2. Kill AID | Auto(60)+--| 3. Kill all AIDs for terminal |------------------------------+| | 4. Kill all AIDs for transaction | |+--| |------------------------------+ | 5. Exit F3 | Lines ___1 to 9 of 42+--| |---+------------+-------------+| | F1=Help F12=Cancel |l | Owning | AID || +------------------------------------------+ | System | Type |+-------------+----------+----------+-------------+------------+------------+| / DF001F8D | MSA1 | LV01 | Acq Ins | TDOCS12 | IC Init || _ DF001F8E | MSA1 | LV46 | Acq Ins | TDOCS12 | ICP Sch || _ DF001F8F | PRNT | PRT1 | Acq Ins | TDOCS12 | TDP Sch || _ DF001F90 | CEMT | LV33 | Rel Ins | TDOCS12 | BMS Sch || _ DF002F93 | CEMT | LV0 | Rel Ins | TDOCS12 | IC Init || _ DF002F94 | CEMT | CNSA | Ins | TDOCS12 | ICP Sch || _ DF002F95 | OUTP | PRT2 | Acq Ins | TDOCS12 | TDP Sch || _ DF002FA3 | CSP | M046 | Acq Ins | TDOCS12 | BMS Sch || _ FRED | MSA1 | MY03 | Ins | CICSNY01 | Rem Del |+-------------+----------+----------+-------------+------------+-------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status


Using the GoTo Pull-down

Using the GoTo Pull-downThe GoTo pull-down menu lets you navigate to an area of CICS monitoring related to the current panel. The choices on this pull-down vary for each panel. You can access this menu by entering G in the action bar entry field.

On Region Status, the GoTo serves a different purpose. It allows you to navigate to panels that cannot be reached through status bars.

The following figure shows the GoTo pull-down from the Region Status panel.

FIGURE 14. GoTo Pull-down Menu

For maps of the panels you can navigate to from this pull-down, see the navigation flowcharts appendix in the OMEGAMON II for CICS Reference Manual.

g___ Actions GoTo Index Options Help------------+-----------------------------------------+---- 05/14/93 16:34:35KC2B01D | _ 1. CICS Tables | Region: CICSPROD + | 2. Task History | Auto(60) Select on | 3. CICS Memory | S=Show | |+-----------| 4. Zoom to OMEGAMON II menu system |--+-------------------+| Workl | | | Alerts ||-----------| F1=Help F12=Cancel |--|-------------------|| _ AIDs +-----------------------------------------+ | _ Bottlnck OK || | | || _ ICEs OK | _ DASD Warn _ MRO/ISC OK | _ CICSloop OK || | | || _ Response OK | _ DB2 OK _ Paging OK | _ Dumps OK || | | || _ Tasks OK | _ DBCTL Warn _ Storage OK | _ Enqueues OK || | | || _ TranRate OK | _ DL/I OK _ Tapes OK | _ I/O Rate OK || | | || | _ Files OK _ TempStor OK | _ VTAM ACB OK || | | || | _ Journals OK _ TranData OK | _ XRF Crit |+------------------+-------------------------------------+-------------------+

F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print



Access CICS TablesThrough this pull-down you can access CICS Tables, which represents a selection of CICS control blocks that are not directly associated with other specific monitoring functions. Selecting CICS Tables from the GoTo pull-down causes the following panel to display.

FIGURE 15. CICS Tables Panel

See the chapter on CICS tables in the OMEGAMON II for CICS Reference Manual for more information on the panels you can access from here.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/14/93 16:36:13 KC2P01D CICS Tables Region: CICSPROD Fastpath: =C Auto(60)

+-------------------------------------+--------------------------------------+ | _ AID Automatic initiators | _ PROG Programs | | _ CSA CICS common system area | _ SIT System initialization table| | _ DCT Destinations | _ TCB CICS TCBs | | _ DDIR DL/I database directory | _ TCT Terminals | | _ DL/I DL/I control blocks | _ TCTFX TCT prefix | | _ DUMP Dumps | _ TCTSE TCT system entries | | _ ENQ Enqueues | _ TD Transient data | | _ EXITS Exit points and programs | _ TRACE Trace | | _ FCT Files | _ TRAN Transactions | | _ ICE Interval control elements | _ TS Temporary storage | | _ JOUR Journal models | _ TSQ Temporary storage queues | | _ LSR Local shared resources | _ TST Temporary storage table | | _ MCT Monito control table | _ XRF Extended recovery facility | | _ PDIR DL/I PSB directories | | +-------------------------------------+--------------------------------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status PA1=Switch



Access Task HistoryYou can access Task History information through the GoTo pull-down on the Region Status panel. Task History presents the historical data collected for all completed transactions in a CICS region. Further details for each completed transaction are available by selecting a row of the Task History panel.

The following figure shows the Task History panel.

FIGURE 16. Task History Panel

See the chapter on task history in the OMEGAMON II for CICS Reference Manual for more information.

Access CICS MemoryYou can access the CICS Memory panel through the GoTo pull-down menu. The CICS Memory panel displays storage in the CICS address space and is useful for looking at the unformatted contents of virtual storage in the address space.

Areas not formatted by other panels can be examined here. You can also scan virtual storage or chase control block chains to look for specific strings.

Enter action codes in the fields of the Contents section of the panel to select the processing you want. The available action codes are displayed above the table on the panel, and are also listed on the Actions pull-down menu. Also, press Enter in the input field next to any address to display memory at that address.

The following figure shows the CICS Memory panel.

Actions GoTo View Index Options Help ------------------------------------------------------------ 07/20/95 18:33:29 KC2T01D Task History Region: TDOCS60 Fastpath: =H Auto(Off) +---------------------------------------------------------------------------+ | Search range . . 00/00/00 00:00:00 to 00/00/00 00:00:00 | | Display range . . 07/17/95 11:39:16 to 07/17/95 12:02:29 | +---------------------------------------------------------------------------+ More: + +------------+------+--------+------+------+-------+---------+-------+------+ | Task | Tran | Task | Term | CPU | Resp | Storage | File | Abend| | End Time | ID | Number | ID | Time | Time | HWM | I/O | Code| +------------+------+--------+------+------+-------+---------+-------+------+ | _ 11:39:16 | OMEG | 34 | M498 | .3 | 2.6| 0 | 0 | | | _ 11:59:17 | CRSR | 37 | A21 | .0 | 1.0| 0 | 0 | | | _ 12:02:26 | CLS2 | 38 | n/a | .0 | 0.4| 0 | 0 | | | _ 12:02:26 | CLS1 | 39 | -ABP | .0 | 0.1| 0 | 0 | | | _ 12:02:26 | CLS2 | 40 | -ABO | .0 | 0.1| 0 | 0 | | | _ 12:02:29 | CATA | 41 | n/a | .0 | 0.0| 0 | 0 | | | _ 12:02:29 | CQRY | 42 | 3831 | .0 | 0.0| 0 | 0 | | | _ 12:02:29 | CQRY | 42 | 3831 | .0 | 0.0| 0 | 0 | | +------------+------+--------+------+------+-------+---------+-------+------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status PA1=Switch



FIGURE 17. CICS Memory Panel

For more information, see the chapter on CICS memory in the OMEGAMON II for CICS Reference Manual.

Zooming to the Menu SystemSelect this choice on the GoTo pull-down to access the facilities provided by the OMEGAMON II menu system. A pop-up window prompts you to specify an OMEGAMON II screen space to which to zoom. Enter the fast path for the topic to which to zoom. To see a list of fast paths for the menu system, press F1 on the Zoom to OMEGAMON Menu System pop-up, or see the appendix containing menu system fast paths in the OMEGAMON II for CICS Reference Manual.

To return to the CUA interface from the OMEGAMON II menu system, you use the trigger key that you specify through the Session Defaults selection on the Controls pop-up window. Follow these steps to specify the trigger key:

1. Select the Options pull-down menu.

2. Select Controls. The Controls pop-up window displays.

3. Select Session Defaults. The Session Defaults pop-up window displays.

4. Specify the trigger key in the Trigger Key to Return from Zoom field. Enter either of the following:n any key between PA1 and PA3 inclusive

n any function key between F1 and F24 inclusive

____ Actions Tools GoTo Index Options Help ------------------------------------------------------------ 06/24/93 12:16:02 KC2U01D CICS Memory Region: CICSPROD Fastpath: =M Auto(60) Type address (or symbol) to display . . . 00000000____________________________ ?=31-bit indirect %=24-bit indirect I=Indirect N=Scan C=Chase chain Z=Zap Y=Address symbol definition Offset 0000 to 0070 of 0800 +--------+----+---------------------------------------------+----------------+ |Address |Off.| Contents | Translated | +--------+----+---------------------------------------------+----------------+ |00000000|0000| _ 040C0000 _ 8125BF68 _ 00000000 _ 00000000 |....a...........| |00000010|0010| _ 00FD47D8 _ 00000000 _ 070C0000 _ 80FFB89C |...Q............| |00000020|0020| _ 078D2000 _ 800557BA _ 070C3000 _ 80063C3C |................| |00000030|0030| _ 00000000 _ 00000000 _ 070E0000 _ 00000000 |................| |00000040|0040| _ 00000000 _ 00000000 _ 00000000 _ 00FD47D8 |...............Q| |00000050|0050| _ 00000000 _ 00000000 _ 040C0000 _ 81252338 |............a...| |00000060|0060| _ 040C0000 _ 80FF2580 _ 04080000 _ 80B04368 |................| |00000070|0070| _ 00080000 _ 88F8F8F0 _ 040C0000 _ 81254580 |....h880....a...| +--------+----+---------------------------------------------+----------------+ (CICS Memory) <OCII Memory> <CEMT> <CICS Dataspaces> <OCII Dataspaces> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status


Using the Index Pull-down

Using the Index Pull-downThe Index pull-down menu allows you to access panels within OMEGAMON II without going through normal navigation paths. Using this pull-down menu, you can access a panel by selecting a subcategory to which the panel belongs or a panel name. You can also use this pull-down to search the panel title index.

In addition, the fast path mnemonics you use to navigate directly to all panels are based on the choices available through this menu. For example, the fast path for the Response Times panel, =WR, stands for the navigation path that starts at the Workloads selection on the Index pull-down, then goes to the Response selection on the Workloads menu, then to the Response Time selection on the Response menu, then to the Response Times panel.

See “Fast Pathing in the CUA Interface” on page 277 for a list of available fast path mnemonics.

The following figure shows the Index pull-down menu.

FIGURE 18. Index Pull-down Menu

Select Search for on the Index pull-down to display the Search Index pop-up window. The following figure shows the pop-up.

i___ Actions GoTo Index Options Help ----------------- +----------------------------+----------- 05/19/93 11:30:58 KC2B01D | _ 1. Workloads... | Region: CICSPROD + | 2. Resources... | Auto(60) Select one comp | 3. Alerts... | . S=Show detail | | +---------------- | 4. CICS Tables... | --------+-------------------+ | Workloads | 5. Task History | | Alerts | +---------------- | 6. CICS Memory... | --------+-------------------+ | _ AIDs OK | | | _ Bottlnck OK | | | 7. Search for... | | | | _ ICEs OK | | OK | _ CICSloop OK | | | F1=Help F12=Cancel | | | | _ Response OK +----------------------------+ OK | _ Dumps OK | | | | | | _ Tasks OK | _ DBCTL Warn _ Storage OK | _ Enqueues OK | | | | | | _ TranRate OK | _ DL/I OK _ Tapes OK | _ I/O Rate OK | | | | | | | _ Files OK _ TempStor OK | _ VTAM ACB OK | | | | | | | _ Journals OK _ TranData OK | _ XRF Idle | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print

Using the Index Pull-down


FIGURE 19. Search Index Pop-up Window

This pop-up lets you perform a search of the panel title index for all panels containing the specified text in their titles. This selection helps you find information about a particular feature of CICS when you do not know the relevant panel title.

To perform a search,

1. Select Search for from the Index pull-down. The Search Index pop-up window displays.

2. Enter one or more words on the Search field, making sure the word or words you enter are contained in the title of the panel you want to see. For example, if you enter Address Space, a list of the names of all panels that contain the phrase Address Space in their titles will appear in the Search Argument pop-up window.

3. Move the cursor to the panel title that matches the panel you want to see. Press Enter.The panel you searched for displays.

is Actions GoTo Index Options Help ------------------+---------------------------------------------------------+ KC2B01D | KC2SRCH Search Index | + | | Select one comp | Type the partial or full name of a panel title, | S=Show detail | then press Enter. | | | +---------------- | Search field . . cics____________________________ | | Workloads | | +---------------- | F1=Help F12=Cancel | | _ AIDs OK +---------------------------------------------------------+ | | | | | _ ICEs OK | _ DASD Crit _ MRO/ISC OK | _ CICSloop OK | | | | | | _ Response OK | _ DB2 Idle _ Paging OK | _ Dumps OK | | | | | | _ Tasks OK | _ DBCTL Idle _ Storage OK | _ Enqueues OK | | | | | | _ TranRate OK | _ DL/I Idle _ Tapes OK | _ I/O Rate OK | | | | | | | _ Files OK _ TempStor OK | _ VTAM ACB OK | | | | | | | _ Journals OK TranData OK | _ XRF OK | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print


Using the View Pull-down

Using the View Pull-downUse the View pull-down menu to filter and sort items displayed on the panel you are viewing. The choices on this pull-down allow you to filter the contents of a panel to see All, Some, and, in some cases, Problem items. You can also sort by specific columns on the panel, and sort the items in the columns in ascending or descending order.

The View pull-down menu is not available on all panels of OMEGAMON II.

The following figure shows a typical View pull-down menu.

FIGURE 20. Typical View Pull-down Menu

Selecting AllSelect All from the View pull-down to display all currently available data on the panel. If you set the default view in Session Defaults to show only problems, selecting All will cause all available data for the panel to display instead. See “Controls” on page 75 for information on setting session defaults.

Selecting SomeSelect Some from the View pull-down to display the View Some pop-up window. This section tells you how to use the View Some selection with all panels except Task History or how to use it with Task History.

V___ Actions GoTo View Index Options Help ----------------- +---------------------------------+------ 05/24/93 21:05:54 KC2C01D | 1 1. All | Region: CICSPROD Fastpath: =WT | - 2. Some... | Auto(60) +---------------- | 3. Problems | -+---------------------+ | All tasks . . | | |NonDispatchble: 20 | | _ Highest % of | 1 1. Sort by task number | | _ % of AMXT : 0% | +---------------- | - 2. Sort by transaction ID | -+---------------------+ | 3. Sort by facility ID | Lines ___1 to 8 of 20 +------------+--- | 4. Sort by CPU time | +----------+-----------+ | Task | Tr | 5. Sort by task state | | Resource | Resource | | Number | I | 6. Sort by resource type | | Type | Name | +------------+--- | 7. Sort by resource name | +----------+-----------+ | _ SM | SM | | | SMSYSTEM | (none) | | _ TI | TI | Sort order | | TIEXPIRY | DS_NUDGE | | _ 2 | CS | 1 1. Ascending | | TCP_NORM | DFHZDSP | | _ 4 | CS | - 2. Descending | | (none) | (none) | | _ 5 | CS | | | ICMIDNTE | DFHAPTIM | | _ 6 | CS | F1=Help F12=Cancel | | ICEXPIRY | DFHAPTIX | | _ 7 | CS +---------------------------------+ | ICWAIT | (none) | | _ 8 | CSSY | | 0.000s | Suspend | JCJASUSS | JABSUTOK | +------------+------+----------+-----------+----------+----------+-----------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status



Using View Some with All Panels Except Task History

Use the View Some pop-up to enter filtering criteria so only specific information displays on the panel. For example, to exclude specific Tran IDs from displaying on the Tasks panel, follow the steps described below:

1. Select Some from the View pull-down on the Tasks panel. The View Some pop-up displays, overlaying the panel.

2. On the pop-up, move the cursor to the Transaction ID field and enter NE (not equal) in the Operator column.

3. In the Value column, enter the name of the Tran ID you do not want to see displayed on the panel. In this case, enter CSSY.

The View Some pop-up then appears as follows.

FIGURE 21. View Some Pop-up Showing Filter Criteria

4. After you’ve finished entering the filter criteria, press Enter. The Tasks panel redisplays, showing all Tran IDs except CSSY.

The following figure shows the panel.

VS__ Actions GoTo View Index Options Help ----------------- +-------------------------------------------------------+ 54 KC2C01D | KC2C01VF View Some | OD Fastpath: =WT | | 0) +---------------- | Type any changes, then press Enter. | - | All tasks . . | | | | _ Highest % of | Field Operator + Value | | +---------------- | ----------------- ---------- -------- | -+ | Task number . . . EQ *_____ | 8 +------------+--- | Transaction ID . NE CSSY | -+ | Task | Tr | Facility ID . . . EQ *____ | | | Number | I | CPU time . . . . EQ *_ . ___ (ss.ttt) | | +------------+--- | Task state . . . EQ *_______ + | -| | _ SM | SM | Resource type . . EQ *_______ + | | | _ TI | TI | Resource name . . EQ *_______ | | | _ 2 | CS | | | | _ 4 | CS | F1=Help F4=Prompt F5=Refresh F12=Cancel | | | _ 5 | CS +-------------------------------------------------------+ | | _ 6 | CSSY | | 0.265s | Suspend | ICEXPIRY | DFHAPTIX | | _ 7 | CSSY | | 0.365s | Suspend | ICWAIT | (none) | | _ 8 | CSSY | | 0.000s | Suspend | JCJASUS | JABSUTOK | +------------+------+----------+-----------+----------+----------+-----------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status



FIGURE 22. Tasks Panel with Filtered Tran IDs

Promptable Fields and Columns

Some values on the View Some pop-up may have a plus sign (+) at the end of the field. This means you can display a list of choices by tabbing to the field and pressing F4. Similarly, to see a list of valid comparative operators, move the cursor to the Operator column and press F4. Valid comparative operators are as follows:

n EQ (equal)n NE (not equal)n LE (less than or equal)n LT (less than)n GE (greater than or equal)n GT (greater than)

Asterisks in the Value Column

An asterisk in the Value column of View Some means all values will display. You can use the asterisk as the last character of a string, for example, JOB*, and only the data that starts with JOB will be displayed.

Two or More Search Criteria

When you specify two or more search criteria, all specified search criteria must match for the data to be displayed.

____ Actions GoTo View Index Options Help ------------------------------------------------------------ 05/24/93 21:06:37 KC2C01D Tasks Region: CICSPROD Fastpath: =WT Auto( 60)+---------------------------+----------------------+-------------------------+| All tasks . . . : 20 | Dispatchable: 0 | NonDispatchble: 20 || _ Highest % of CMXT: 0% | _ % of MXT . : 63% | _ % of AMXT . . : 0% |+---------------------------+----------------------+-------------------------+ Lines ___1 to 8 of 9+------------+------+----------+-----------+----------+----------+-----------+| Task | Tran | Facility | CPU | Task | Resource | Resource || Number | ID | ID | Time | State | Type | Name |+------------+------+----------+-----------+----------+----------+-----------+| _ SM | SM | | | Suspend | SMSYSTEM | (none) || _ TI | TI | | | Suspend | TIEXPIRY | DS_NUDGE || _ 2 | CSTP | | 0.566s | Suspend | TCP_NORM | DFHZDSP || _ 4 | CSNE | | 0.015s | Suspend | (none) | (none) || _ 27 | CSNC | | 0.011s | Suspend | CSNC | MROQUEUE || _ 32 | OSRV | | 0.002s | Suspend | (none) | (none) || _ 33 | OSEC | | 0.002s | Suspend | (none) | (none) || _ 48 | CEDA | M387 | 0.000s | Suspend | KCCOMPAT | TERMINAL |+------------+------+----------+-----------+----------+----------+-----------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status



Saving Filter Criteria and Restoring Values

Filter criteria are saved when you press Enter. You can press F5 on any input field to restore the last saved value. If you press F5 on any non-input field, all values are restored.

Using View Some with the Task History Panel

Unlike the View Some pop-up for all other panels, the pop-up for the Task History panel differs primarily as follows:

n in its layoutn its comparative operators, GE and EQ, are not selectablen you can specify inclusion and exclusion criteria

Like the View Some pop-up used with other panels, however, you use this pop-up to specify filter criteria that limit the information displayed. Users of file-based data stores can sort the Task History panel with the most recent records displayed first (that is, in descending order of task start time).

The View Some pop-up is shown in the following figure:

FIGURE 23. View Some Pop-up for the Task History Panel

For example, to display tasks that had response times of at least 0.5 seconds, type the following in the Response Time field:

Response time GE ___ .5 (sss.t)

v Actions GoTo View Index Options Help+----------------------------------------------------------------------------+| KC2T01VF View Some || || Type any changes, then press Enter. || Records to scan ________ || Response time GE ___.__ (sss.t) CPU time . . GE ___ . __ (sss.t) || Dispatch time GE ___.__ (sss.t) Suspend time GE ___ . __ (sss.t) || Storage HWM . GE ______ File . . . . GE ___ . __ || DL/I . . . . GE ______ DB2 . . . . . GE ________ || ADABAS . . . GE ______ DATACOM . . . GE ________ || IDMS . . . . GE ______ SUPRA . . . . GE ________ || MQ. . . . . . GE ______ USREVNT1. . . GE ________ || || Inclusion Criteria Exclusion Criteria || Tran ID . . . EQ __________ + Tran ID . . . EQ _____________ + || Terminal ID . EQ __________ + Terminal ID . EQ _____________ + || UserID . . . EQ __________ + UserID . . . EQ _____________ + || Group name . EQ __________ + Group name . EQ _____________ + || || Abend code . EQ ____ Abending tasks only ____ + (Yes/No) || UOW ID. . . . EQ __________ || TRGID . EQ 1910E4E2C3C1C3D6FCF14BC3C9C3E2D9F7F7B47A73C2DD153201000 || || F1=Help F4=Prompt F5=Refresh F12=Cancel |+----------------------------------------------------------------------------+



When you specify two or more search criteria in the fields on the upper part of the pop-up window (Response Time through SUPRA), they must all be met (ANDed) in order for a task to be displayed on the Task History panel. For example, to display tasks that had response times of at least 2 seconds and used at least 4K of storage at any time, type the following:

Response time GE ___2 .0 (sss.t)

Storage HWM . GE 4096___

The inclusion and exclusion criteria filters on the lower part of the pop-up (Tran ID, Terminal ID, User ID, Group Name, Abend Code, Unit of Work ID, and Transaction Group ID) allow you to determine which tasks will or will not be displayed (search criteria are ORed). Exclusion criteria take precedence over inclusion criteria. For example, to include tasks that

n had tran IDs starting with the characters “GO”, orn were associated with terminals starting with the character “M”,

type the following in the Inclusion Criteria column:

Tran ID . . EQ GO*__

Terminal ID . EQ M*___

Selecting ProblemsSelect Problems from the View pull-down to display only those items that have exceeded their thresholds. If you set the default view in Session Defaults to show all data available, selecting Problems will cause only problems to display for the panel instead. See “Controls” on page 75 for information on setting session defaults.

Using the Options Pull-down


Using the Options Pull-downWhen you log onto OMEGAMON II for the first time, it loads a copy of the default set of options.

The Options pull-down menu contains choices to help you customize the CUA interface options. The following figure shows the menu.

FIGURE 24. Region Status Panel, Options Pull-Down (Prior to CICS 5.1.0)

Using this menu you can

n change controls for your OMEGAMON II session; for example, the status of collection subtasks, and display and print options

n set thresholds for all panelsn set preferences such as date and time formats, mnemonics, and function key displays

After changing various values in the Options pull-down,OMEGAMON II prompts you to save them for the duration of the current CUA interface session or to save them in either the region profile or the userid profile. The values you saved for the current session will be discarded when you log off.

The Options menu choices are described below.

o___ Actions GoTo Index Options Help ------------------------ +--------------------------------+ 05/24/93 21:05:16 KC2B01D | _ 1. Preferences | Region: CICSPROD | 2. Controls... | Auto(60) Select one component w | | S=Show details A=A | 3. Collection controls... | +------------------+---- | 4. CICS shutdown option | -----------------+ | Workloads | | | Alerts | |------------------|---- | 5. Thresholds... | -----------------| | _ AIDs Warn | _ C | 6. Response time groups |_ Bottlnck OK | | | | | | | _ ICEs OK | _ D | 7. Userid profiles |_ CICSloop OK | | | | 8. Region profiles | | | _ Response OK | _ D | |_ Dumps OK | | | | 9. Close print log | | | _ Tasks OK | _ D | |_ Enqueues OK | | | | F1=Help F12=Cancel | | | _ TranRate OK | _ DL+--------------------------------+_ I/O Rate OK | | | | | | | _ Files OK _ TempStor OK | _ VTAM ACB OK | | | | | | | _ Journals OK _ TranData OK | _ XRF Crit | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print



PreferencesSelect this option to set standard defaults for your displays. The following figure shows the selections available.

FIGURE 25. Preferences Pop-up Window

Mnemonics

When Mnemonics is on, an input field displays to allow the entry of fast path mnemonics for quick access to the various pull-down menus. When Mnemonics is off, the input field no longer displays and you must tab to your selection and then press Enter. The default setting is On.

Beep

When Beep is on, the terminal alarm sounds for input errors that are detected by OMEGAMON II. A beep also sounds whenever you press a function key that is not currently available. When Beep is off, the terminal alarm does not sound. The default setting is On.

Panel ID

Displaying the panel ID may be useful if you have to report any problems with the current panel. The default setting is Off.

O___ Actions GoTo Index Options Help ------------------ +---------------------------------------------------------+ KC2B01D | Preferences | | | Select one compo | Type any changes, then press Enter. | S=Show details | | +----------------- | Mnemonics . . . . . . . On_ + On/Off | | Workloads | Beep . . . . . . . . . On_ + On/Off | +----------------- | Panel ID. . . . . . . . Off + On/Off | | _ AIDs Warn | Time/Date Display . . . On_ + On/Off | | | Function Key Area . . . On_ + On/Off | | _ ICEs OK | Implicit Action . . . . On_ + On/Off | | | National Language . . . English__________________ + | | _ Response OK | Date Format . . . . . . mm/dd/yy___________ + | | | | | _ Tasks OK | Time | | | Format . . . . . . . 24 + 12/24 hour | | _ TranRate OK | Separator character . : | | | Morning indicator . . AM | | | Afternoon indicator . PM | | | | | | F1=Help F4=Prompt F12=Cancel | +----------------- +---------------------------------------------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print



Time/Date Display

When Time/Date Display is on, the current time and date display on the right side of the action bar separator line. When off, the current time and date do not display. The default setting is On. Press F4 to toggle between On and Off.

Function Key Area

When Function Key Area is on, the currently available function keys display on the bottom one or two lines of the panel. When off, the function key area does not display. In some cases, this allows you to see more information on the panel. The default setting is On. Press F4 to toggle between On and Off.

Implicit Action

When Implicit Action is on, you can simply position the cursor in the entry field of a panel selection and press Enter for an implicit action to occur. The implicit action is panel dependent. When Implicit Action is off, you must type an explicit action code in the entry field. The default setting is On.

Exit Confirmation

When Exit Confirmation is on, a prompt displays to confirm an exit from the current application.

The default setting is On. Press F4 to toggle between On and Off.

Delete Confirmation

When Delete Confirmation is on, a prompt displays to confirm a delete action that you requested.

The default setting is On. Press F4 to toggle between On and Off.

National Language

Press F4 to see a list of available languages.

Date Format

Select the date format you want to use for the current date at the top of each panel. The default format is mm/dd/yy. Press F4 to see a list of available formats.

The only valid date formats used within panels are mm/dd/yy and dd.mm.yy.



Time

Select the time format you want to use for the current time at the top of each panel. You can select the following:

The only valid time format used within panels is 24-hour format, hh:mm:ss.

ControlsSelect this option to specify such administrative details as settings for session defaults, the routing of screen print output, and the enabling or disabling of your Authorized Command Facility password. The following figure shows the pop-up window that displays.

FIGURE 26. Controls Pop-up Window

Format Select either the 12 or 24 to specify the 12- or 24-hour time format. The default format is 24.

Separator character

The character that displays between the hours, minutes, and seconds portion of the time stamp. The default character is a colon. Any character is valid.

Morning indicator

The two-character code that indicates morning hours when the 12-hour time format is selected. The default value is AM. Any two characters are valid.

Afternoon indicator

The two-character code that indicates hours after 11:59:59 in the morning, when the 12-hour time format is selected. The default value is PM. Any two characters are valid.

o Actions GoTo Index Options Help -------------------------+--------------------------------------------------+ KC2B01D | KC2QCTL Controls | | | Select one component w | Select one of the following, then press Enter. | S=Show details A=A | | +----------------------- | _ 1. Session defaults | | Workloads | | 2. Screen print output routing options | +------------------+---- | 3. Enable authorized commands | | AIDs OK | C | 4. Disable authorized commands | | | | 5. Print SNAPSHOT of CICS region | | ICEs OK | D | | | | | F1=Help F12=Cancel | | Response OK | D +--------------------------------------------------+ | | | | | Tasks OK | DBCTL Warn Storage Crit | Enqueues OK | | | | | | TranRate Crit | DL/I OK Tapes OK | I/O Rate OK | | | | | | | Files OK TempStor OK | VTAM ACB OK | | | | | | | Journals OK TranData Crit | XRF Crit | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print



A pop-up window displays for each selection on the Controls pop-up window. The following pop-up windows display:

n Sessions Defaultsn Screen Print Output Routing Optionsn Enable Authorized Commandsn Print SNAPSHOT of CICS Region

Session Defaults

The following figure shows the Session Defaults pop-up.

FIGURE 27. Session Defaults Pop-up Window

o Actions GoTo Index Options Help --------+--------------------------------------------------------------------+ KC2B01D | KC2QSES Session Defaults | | | Selec | Type any changes, then press Enter. | S=S | | +------ | Auto refresh interval . . . . . 60 s (5-999 / Off) | | W | Trigger to return from zoom . . PA2_ (PA1-PA3 / F1-F24) | +------ | Default view . . . . . . . . . All_____ + (All/Problems) | | AID | Fold terminal ID input fields . Yes_+ (Yes/No) | | | | | ICE | Use status words . . . . . . . Yes + (Yes/No) | | | Critical status word . . . . Crit_ | | Res | Warning status word . . . . . Warn_ | | | OK status word . . . . . . . OK___ | | Tas | Idle status word . . . . . . Idle_ | | | | | Tra | F1=Help F4=Prompt F12=Cancel F18=Default | | +--------------------------------------------------------------------| | | | | | | Files OK TempStor OK | VTAM ACB OK | | | | | | | Journals OK TranData OK | XRF OK | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print



This pop-up allows you to specify the session controls described below.

Saving Your Session Default Settings

After changing settings, OMEGAMON II prompts you to save them for the duration of the current session or to save them in the userid profile.

Screen Print Output Routing Options

This pop-up window lets you set up the destination information for screen prints. The following figure shows the pop-up.

Auto Refresh Interval

This field indicates the elapsed time, in seconds, before the screen is automatically refreshed.

The default for this option is no auto refresh (Off).

Trigger to Return from Zoom

This field indicates which key will act as a trigger to return from the OMEGAMON II menu system interface to the CUA interface of OMEGAMON II.

Valid options are the function keys 1-24 and the PA keys 1-3. See “Zooming to the Menu System” on page 64 for the procedure to follow to set a trigger key.

Default View This field indicates the default view of data panels.

Use Status Words

This field indicates whether status words are displayed on the Region Status panel.

Status characters reflect the threshold status.

Enter Yes in this field if you are using a monochrome terminal, or if you want to display characters as well as color on a color terminal.

To toggle between Yes and No, press F4.

Critical Status Word

The alphanumeric critical status word used on the Region Status panel when the critical threshold has been exceeded.

Warning Status Word

The alphanumeric warning status word used on the Region Status panel when the warning threshold has been exceeded.

OK Status Word The alphanumeric OK status word used on the Region Status panel when no thresholds have been exceeded.

Idle Status Word The alphanumeric idle status word used on the Region Status panel when no data is being collected for a component.

To toggle between All and Problems, press F4.

The default view is in effect until you select a view different from the default on the View pull-down menu.

All Displays all of the available data.

Problems Displays only those items that have exceeded their thresholds.



FIGURE 28. Screen Print Output Routing Options Pop-up Window

The following fields display on the pop-up:

Sysout Class The sysout class that you normally use for your print jobs.

Copies Enter the number of copies to be printed. Specify 1-999.

Destination Enter your printer destination. This field can contain up to 17 characters, and you can choose between two forms to specify the destination. The first form is node.name, which is generally used to specify remote printers. The components of this form, node and name, can each be up to 8 characters long. These components are delimited by the period. The second form of the destination lets you specify just the name of the printer. In this case, the destination can be only 8 characters long.

Form name If desired, enter a print form name.

Hold output Indicate whether you want the print output held in the input queue before it is printed. Press F4 to toggle between Yes and No.

Fold to uppercase

Indicate whether you want the print output in uppercase. Press F4 to toggle between Yes and No.

Routing information

You may enter a description in this field. Your logon ID will be specified automatically.

o Actions GoTo Index Options Help ---------------+-------------------------------------------------------------+ KC2B01D | KC2QPRT Screen Print Output Routing Options | | | Select one c | Type any changes, then press Enter. | S=Show det | | +------------- | Sysout class . . . . _ | | Workload | Copies . . . . . . . 1 (1-99) | |------------- | Destination . . . . ___________________ | | AIDs O | Form name . . . . . ____ | | | Hold output . . . . No_ + (Yes/No) | | ICEs O | Fold to uppercase . No_ + (Yes/No) | | | | | Response O | Routing information __________________________________ | | | | | Tasks O | F1=Help F4=Prompt F12=Cancel F18=Default | | +-------------------------------------------------------------| | TranRate OK | DL/I Idle Tapes OK | I/O Rate OK | | | | | | | Files OK TempStor OK | VTAM ACB OK | | | | | | | Journals OK TranData OK | XRF OK | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print



Enable Authorized Commands

This pop-up window allows you to enter the OMEGAMON II Authorized Command Facility password. The following figure shows the pop-up.

FIGURE 29. Enable Authorized Commands Pop-up Window

If you try to navigate and receive a message saying you are not authorized to view the information, then you need to enter the OMEGAMON II password. Once you type the password and press Enter, you will be able to display information and take actions that are password protected. Once you enter a password, it is in effect until the end of your session.

Disable Authorized Commands

To prevent the display of password-protected information, select Disable Authorized Commands from the Controls pop-up. A message displays stating that the command was successfully reset.

Print SNAPSHOT of CICS Region

Selecting Print SNAPSHOT of CICS region from the Controls pop-up will cause a SNAPSHOT to be taken for the current CICS region. The resulting output is written to the OMEGAMON II for CICS log file, then is automatically routed to the JES Print Queue under the OMEGAMON II for CICS address space job JCL. An informational message is displayed upon successful completion of the SNAPSHOT function.

o Actions GoTo Index Options Help -------------------------+--------------------------------------------+ :16:16 KC2B01D | KC2QPWD Enable Authorized Commands | CS22 + | | to(60) Select one component w | Type the OMEGAMON II Authorized Command | S=Show details A=A | Facility password, then press Enter. | +------------------+---- | The password will not be displayed. | -----+ | Workloads | | | | |------------------|---- | Password . . . | -----| | AIDs OK | C | | le | | | | F1=Help F12=Cancel | | | ICEs OK | D +--------------------------------------------+ | | | | | | Response OK | DB2 Idle Paging OK | Dumps OK | | | | | | Tasks OK | DBCTL Idle Storage OK | Enqueues OK | | | | | | TranRate OK | DL/I Idle Tapes OK | I/O Rate OK | | | | | | | Files OK TempStor OK | VTAM ACB OK | | | | | | | Journals OK TranData OK | XRF OK | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print



Collection ControlsThis option allows you to manage the collection of performance data for CICS regions, set internal bottleneck display controls, and predetermine the amount of CICS resources a task may use (resource limiting). Data collection can be managed for the following:

n internal bottlenecksn interval recordingn response timen task historyn CICS file and database statistics

The following figure shows the Collection Controls pop-up window:

FIGURE 30. Collection Controls Pop-up Window

The following sections describe the collection controls.

Internal Bottleneck Collection

The Internal Bottleneck Collection pop-up window enables you to control the collection of internal resource bottleneck information for the current CICS region. Internal bottleneck analysis identifies the various reasons why tasks in your CICS region are waiting.

Bottleneck data is collected in a common area for each CICS region. This information is shared by all OMEGAMON II sessions monitoring that region.

Use this pop-up to see the current status of the bottleneck collector and to change collection options. The following figure shows the Internal Bottleneck Collection pop-up.

Collection Controls Select one of the following, then press Enter. 1. Internal Bottleneck Collection 2. Internal Bottleneck Display 3. Response Time Collection 4. Interval Recording 5. Task History Collection 6. CICS File/Database Collection 7. Resource Limiting... 8. Monitoring Control 9. VSAM Analysis 10. Storage Violation Analysis 11. Dump Analysis 12. Application Trace Facilty F1=Help F12=Cancel



FIGURE 31. Internal Bottleneck Collection Pop-up Window

You can display the collected internal bottleneck data by selecting the Bottleneck status bar on the Region Status panel. The status bar indicates when the percentage of wait time for any resource exceeds the bottleneck threshold.

For more information on the Internal Bottleneck Collection pop-up, see the OMEGAMON II for CICS Reference Manual.

Internal Bottleneck Display Controls

Internal bottleneck analysis is a realtime facility that looks over a short-term time interval and identifies the various reasons why CICS tasks in your CICS region are waiting.

The Internal Bottleneck Display Controls panel shows all the possible internal bottlenecks that may exist in your CICS region. The following figure shows the panel.

Actions GoTo Index Options Help +----------------------------------------------------------------------------+ | KC2QDEX Internal Bottleneck Collection | | | | Type any changes, then press Enter. | | | | Collection status . . . : Active | | Collection start date . : 08/26/93 Collection start time : 2:38:20 | | Interval elapsed time . : 1:00 MN Number of samples . . : 31 | | | | New collection status . . Active__ + (Active/Inactive) | | | | Minimum displayed ratio . 10 % (0-99) | | | | Clear the accumulators . . No_ + (Yes/No) | | | | Changing either of the following fields will clear the accumulators. | | | | Collection interval . . . 10 min (0-999) | | Sample frequency . . . . . 2.0 sec (0.1-9.9) | | | | F1=Help F4=Prompt F5=Refresh F12=Cancel F18=Default | +----------------------------------------------------------------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print



FIGURE 32. Internal Bottleneck Display Controls Panel

For more information on internal bottlenecks, see the OMEGAMON II for CICS Reference Manual.

Response Time Collection

The Response Time Collection pop-up window enables you to control the collection of response time information. The following figure shows the pop-up.

____ View Index Options Help ------------------------------------------------------------ 07/20/93 10:12:14 KC2L03D Internal Bottleneck Display Controls Region: CICSPROD Auto(60) Lines 1 to 13 of 114 +--------------+--------------+----------------------------+-----------------+ | Resource Type| Resource Name| Description | Display State + | |--------------|--------------|----------------------------|-----------------| | (none) | (none) | DU: Dump dataset I/O | Off | | (none) | (none) | TI: Timer service rq | Off | | (none) | DLCNTRL | DBCTL: Work element | On_ | | (none) | DLCONECT | DBCTL: Connection | On_ | | (none) | DMWTQUEU | DM: Work queue | On_ | | (none) | LMQUEUE | LM: Lock request | On_ | | ALLOCATE | (varies) | TC: Session allocate | On_ | | any_MBCB | (varies) | TD: I/O Buffers | On_ | | any_MRCB | (varies) | TD: VSAM String | On_ | | AP_INIT | CSADLECB | AP: DLI Restart | On_ | | AP_INIT | ECBTCP | AP: TCP Synchronize | On_ | | AP_INIT | SIPDMTEC | AP: DM Synchronize | On_ | | AP_INIT | TCTVCECB | AP: TC Restart | On_ | +--------------+--------------+----------------------------+-----------------+ F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status



FIGURE 33. Response Time Collection Pop-up Window

Response time data is collected into a common area for each CICS region. This information is shared by all OMEGAMON II sessions monitoring that region.

For more information on the response time collection, see the OMEGAMON II for CICS Reference Manual.

Interval Record Collection

The Interval Recording pop-up window enables you to control the collection of interval records. Use this pop-up to see the current status of the interval record collector and to change collection options. The following figure shows the pop-up.

Actions GoTo Index Options Help +----------------------------------------------------------------------------+ | KC2QRTA Response Time Collection | | | | Type any changes, then press Enter. | | | | Current subtask status : Active | | Subtask start date . . : 08/26/93 Subtask start time . . : 8:13:43 | | | | New subtask status . . . Active__ + (Active/Inactive) | | | | F1=Help F4=Prompt F12=Cancel | |------------------+-------------------------------------+-------------------| | Response OK | DB2 CRIT Paging OK | Dumps OK | | | | | | Tasks OK | DBCTL WARN Storage WARN | Enqueues OK | | | | | | TranRate CRIT | DL/I OK Tapes OK | I/O Rate OK | | | | | | | Files OK TempStor OK | VTAM ACB OK | | | | | | | Journals OK TranData OK | XRF CRIT | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print



FIGURE 34. Interval Recording Pop-up Window

The interval record collector analyzes each CICS region at a specified interval, collecting response time, bottleneck, and resource information. This data is then formatted and written to SMF for later analysis.

For more information on interval recording, see the OMEGAMON II for CICS Reference Manual and the OMEGAMON II for CICS Historical Reporting Guide.

Task History Collection

The Task History Collection pop-up window enables you to control the collection of task history information. The following figure shows the pop-up.

Actions GoTo Index Options Help +----------------------------------------------------------------------------+ | KC2QINR Interval Recording | | | | Type any changes, then press Enter. | | | | Current subtask status : Active | | Subtask start time . . : 2:38:17 Subtask start date . . : 08/26/93 | | Last function performed: Report Reason for termination : n/a | | SMFID . . . . . . . . : 255 Initialize performed . : Yes | | Records since activate : 1741 Records since initialize: 402 | | Last record time . . . : 9:54:03 | | | | New subtask status . . . Active__ + (Active/Inactive) | | | | Depth of analysis . . . 50 DASD devices | | Recording interval . . . 1 min (1-255) | | | | F1=Help F4=Prompt F5=Refresh F12=Cancel F18=Default | |------------------+-------------------------------------+-------------------| | | Files OK TempStor OK | VTAM ACB OK | | | | | | | Journals OK TranData OK | XRF CRIT | |------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print



FIGURE 35. Task History Collection Pop-up Window

Task history data is collected into a separate dataspace or file for each CICS region. This information is shared by all OMEGAMON II sessions monitoring that region.

For more information on the Task History pop-up, see the Collection Controls section in the OMEGAMON II for CICS Reference Manual.

Collection of CICS File/Database Information

The CICS File/Database Collection pop-up window enables you to dynamically control the collection of statistics for VSAM, DB2, DL/I, and third-party database products. The following figure shows the pop-up.

Actions GoTo Index Options Help +----------------------------------------------------------------------------+ | KC2QHIS Task History Collection | | | | Type any changes, then press Enter. | | | | Current subtask status : Active | | Subtask start date . . : 08/26/93 Subtask start time . . : 2:38:22 | | Data store type . . . : Dataspace Data store size . . . . : 956K | | Data store size (recs) : 912 Records received . . . : 113 | | Data store wraparounds : 0 Cross memory posts . . : 0 | | Cycle time . . . . . . : 2 Display requests . . . : 0 | | | | New subtask status . . . Active__ + (Active/Inactive) | | | | F1=Help F4=Prompt F12=Cancel | |------------------+-------------------------------------+-------------------| | TranRate CRIT | DL/I OK Tapes OK | I/O Rate OK | | | | | | | Files OK TempStor OK | VTAM ACB OK | | | | | | | Journals OK TranData OK | XRF CRIT | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print



FIGURE 36. CICS File/Database Collection Pop-up

For VSAM, task statistics are always collected if CICS Monitoring is active. You also have the option to collect file statistics.

For DB2, only task statistics may be collected.

For the other products, you can decide whether you want to collect only summary statistics at the task level, or if you also want to collect detailed statistics for each file or database.

See the OMEGAMON II for CICS Reference Manual for more information.

Resource Limiting

Resource limiting allows you to predetermine the amount of CICS resources that a task may use. Any tasks exceeding these thresholds will be abended by OMEGAMON II. Thresholds can be set for the following resources used by a task:

n CPU timen elapsed timen number of file and database requestsn current amount of CICS task storage in use

The following figure shows the Resource Limiting pop-up window.

Actions GoTo Index Options Help ------------+----------------------------------------------------------------+ KC2B01D | KC2QCOL CICS File/Database Collection | | | Select on | Type any changes, then press Enter. | S=Show | | +-----------| Product Task-level File-level Write to Write to | | Workl | Type Monitor Monitor Data Store SMF | |---------- | -------- ---------- ----------- ---------- -------- | | AIDs | VSAM On On_ + On_ + On_ + | | | DB2 On_ + | | ICEs | DL/I On_ + On_ + On_ + On_ + | | | IDMS Off + Off + Off + Off + | | Respons | ADABAS Off + Off + Off + Off + | | Respons | SUPRA Off + Off + Off + Off + | | Respons | DATACOM Off + Off + Off + Off + | | | USREVNT1 On + On + On + Off + | | | | | Tasks | F1=Help F4=Prompt F5=Refresh F12=Cancel F18=Default | | +------+-------------------------------------+-------------------| | TranRate CRIT | DL/I OK Tapes OK | I/O Rate OK | | | | | | | Files OK TempStor OK | VTAM ACB OK | | | | | | | Journals OK TranData OK | XRF CRIT | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print



FIGURE 37. Resource Limiting Pop-up

For more information, see the OMEGAMON II for CICS Reference Manual.

Monitoring Control

The Monitoring Control pop-up lets you change the levels of monitoring within a CICS region that is being monitored. You can select an Active or Inactive state for monitoring CICS, OMEGAMON, and SMF data collection.

CICS monitoring produces performance monitoring data. When the SIT parameters, MN and MNPER, are both active, CICS produces the performance data in the form of SMF records. CICS must be active to produce SMF data. To suppress SMF data, either CICS monitoring must be inactive, or OMEGAMON monitoring must be active.

OMEGAMON monitoring is provided by the OMEGAMON global user exits inside CICS. These exits report on task history, interval record collection, response time analysis, and SMF data suppression. CICS must be active for the global user exits to be active.

o Actions GoTo Index Options Help -----------------+-----------------------------------------------------------+ KC2B01D | KC2QRL01 Resource Limiting | | | Select one com | Select one of the following, then press Enter. | S=Show detai | | +--------------- | 1. Resource Limiting Status | | Workloads | 2. Reource Limits | |--------------- | 3. Resource Limiting Interval | | AIDs OK | | | | F1=Help F12=Cancel | | ICEs OK +-----------------------------------------------------------| | | | | | Response OK | DB2 Idle Paging OK | Dumps OK | | | | | | Tasks OK | DBCTL Idle Storage OK | Enqueues OK | | | | | | TranRate OK | DL/I Idle Tapes OK | I/O Rate OK | | | | | | | Files OK TempStor OK | VTAM ACB OK | | | | | | | Journals OK TranData OK | XRF OK | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print



The following table shows the effect of the different setting combinations for monitoring.

VSAM Analysis

The VSAM Analysis pop-up lets you control the interval of time for collecting VSAM statistics. This setting controls the collection interval of statistics for

n VSAM CA splitsn CI splitsn extentsn RLS timeouts

You can specify a value between 0-1440 minutes. A value of zero collects and evaluates statistics every time the Region Status or VSAM panels are refreshed.

Changing these settings affects all OMEGAMON II sessions monitoring the current CICS region.

Storage Violation Analysis

The Storage Violation Analysis pop-up lets you control the floating time interval for storage violation analysis. It also lets you reset the current count and restart the interval clock.

Changing these settings affects all OMEGAMON II sessions monitoring the current CICS region. To make a permanent change to the interval, use the VIOLATIONS_MONITORING_INTERVAL parameter of the EXCEPTION_ANALYSIS_INTERVALS parameter in the global data area module.

Dump Analysis

The Dump Analysis pop-up lets you control the interval of time over which dump counts are collected. It also lets you reset the current count.

Changing these settings affects all OMEGAMON II sessions monitoring the current CICS region. To make a permanent change to the interval, use the DUMPS_MONITORING_INTERVAL parameter in the global data area module.

Monitoring States Result

All monitoring is Active. OMEGAMON global user exits are active, and SMF records are written.

SMF data collection is Inactive, CICS and OMEGAMON monitoring are Active.

OMEGAMON global user exits are active, but SMF records are suppressed.

OMEGAMON monitoring is Inactive, CICS monitoring and SMF data collection are Active.

OMEGAMON global user exits are inactive, and SMF records are written without OMEGAMON data.

Only CICS monitoring is Active. An error results. SMF records are suppressed.



Application Trace Facility

The Application Trace Control panel lets you activate or deactivate the collection of application trace data within CICS/ESA systems. It also lets you add, modify, or delete application trace filters.

When activated, the application trace is in effect for all transactions running within the CICS region that have a filter defined. If no filters are defined, the application trace is in effect for all transactions that are running in the CICS region.

The OMEGAMON application trace facility is independent of an trace features in CICS. For more information, see the OMEGAMON II for CICS Reference Manual.

CICS Shutdown OptionThis option allows you to specify whether or not to purge waiting conversational tasks in CICS at CICS shutdown, or to prompt the MVS console operator so they can determine whether to terminate waiting conversational tasks. The following figure shows the pop-up.

FIGURE 38. CICS Shutdown Option Pop-up

Actions GoTo In ex Options Help -----------------------------------------------------------------------------+ KC2B01D | KC2QSHU CICS Shutdown Option | | | Select one | Type any changes, then press Enter. | S=Show d | | +------------| CICS shutdown task purge option . . Nopurge_ + | | Worklo | | |----------- | F1=Help F4=Prompt F5=Refresh F12=Cancel F18=Default | | AIDs +-----+-------------------------------------+-------------------| | | | | | ICEs OK | DASD CRIT MRO/ISC OK | CICSloop OK | | | | | | Response OK | DB2 CRIT Paging OK | Dumps OK | | | | | | Tasks OK | DBCTL WARN Storage WARN | Enqueues OK | | | | | | TranRate CRIT | DL/I OK Tapes OK | I/O Rate OK | | | | | | | Files OK TempStor OK | VTAM ACB OK | | | | | | | Journals OK TranData OK | XRF CRIT | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print



ThresholdsYou can use this option to set performance measures (service level indicators such as CPU rate or response time) for workloads, resources, and alerts. Each CICS component on the Region Status panel has one or more performance measures with warning and critical thresholds. When one of the thresholds has been reached, the status bar on the Region Status panel changes color. Moreover, on panels, many fields show highlighting depending on the status of thresholds set for the component.

This option also allows you to indicate how often OMEGAMON II collects data for the Region Status panel. Setting the frequency of data collection gives you control over resource usage. As an example of how to set warning or critical thresholds for performance measures and the frequency for data collection, follow these steps:

1. Select Thresholds on the Options pull-down. Press Enter. The Thresholds selection menu displays.

2. Select Workloads. Press Enter. The Workloads Thresholds selection menu displays.

3. Select Tasks. The Tasks Thresholds pop-up window displays, showing this component’s performance measures and threshold values.

The following figure shows the thresholds pop-up for Tasks.

FIGURE 39. Tasks Thresholds Pop-up Window

Each performance measure has warning and critical threshold settings, as well as an option to have OMEGAMON II monitor the measure.

otwt_ Actions GoTo Index Options Help - +----------------------------------------------------------------------------+ K | KC2QTAS4 Tasks Thresholds | | | | Type any changes, then press Enter. | | | +-| Performance Measure Warning Critical Monitor + | | | ----------------------------------- --------- --------- ------- | +-| CMXT % of limit . . . . . . . . . . > _80 % > _90 % Yes | | | MXT % of limit . . . . . . . . . . > _80 % > _90 % Yes | | | | | | System at MXT limit . . . . . . . . Off + On_ + Yes | | | Class at CMXT limit . . . . . . . . On_ + Off + No | | | | | | Frequency of data collection. . . . 1 (1-99) | | | | | | F1=Help F4=Prompt F5=Refresh F12=Cancel F18=Default | | +----------------------------------------------------------------------------+ | | | | | | _ Files OK _ TempStor OK | _ VTAM ACB OK | | | | | | | _ Journals OK _ TranData Crit | _ XRF Idle | +------------------+-------------------------------------+---------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print



4. Overtype these settings to conform to your service level agreements. For the Warning and Critical fields, enter numeric values and On and Off. For the Monitor field in the pop-up, specify Yes or No to have OMEGAMON II monitor specific performance measures. To start monitoring, move the cursor to the field, then press F4 to toggle the setting to Yes. Press Enter.

5. Enter a number from 1-99 in the Frequency of data collection field to indicate how often OMEGAMON II should collect data for the Region Status panel. Press Enter.

After changing any threshold values, you are prompted to save them for the duration of the current CUA interface session or to save them in the region profile.

Response Time GroupsThis option allows you to access the Response Time Groups panel, which shows you all the groups currently defined. You can use the panel to change the attributes of existing groups or to create new groups.

Response time thresholds may be set for transaction, program, terminal, or LU elements belonging to one or more groups.

Response time and bottleneck data collection and interval recording collect data by groups. If the response time collection subtask has been activated, the groups you’ve defined or changed will display in the Response Times panel (only if there has been activity).

For more information, see “Defining Response Time Groups for Monitoring” on page 251.

Userid ProfilesThis option shows you all the userid profiles currently defined. It allows you to manage your userid profiles by copying, printing, or deleting them, or by switching to another profile from the current profile. You can create new userid profiles and delete all the profiles listed except the default profile. The following figure shows the panel that displays through this selection.

Important

If you select No for all performance measures, the status bar on the Region Status panel will show Idle. (The detailed panel can still be viewed, however, if the information is available.)

You may want to select No for conditions your site considers unimportant. Setting the Monitor fields to No saves overhead on the Region Status panel.



FIGURE 40. Userid Profiles Panel

Defining a Different User ID Profile

OMEGAMON II allows you to enter a userid profile when you log on. The userid profile contains the settings from the Preferences selection on the Options pull-down menu, and from two subcategories of the Controls selection on the Options pull-down, Screen Output Routing Options and Session Defaults.

If the default userid profile does not suit your needs, you can define a different userid profile. You can enter the profile in the OMEGAMON II Userid Profile field of the Logon Options pop-up when you log onto OMEGAMON II.

To define a different userid profile, follow these steps:

1. Copy an existing userid profile:A. Log onto OMEGAMON II using the default user ID profile.B. Access the Options pull-down menu on the Region Status panel.C. Select Userid Profiles. Press Enter. The Userid Profiles panel displays.D. Type C next to an existing profile to copy that profile to the profile you will name.

Press Enter. The Copy a Profile pop-up window displays.

____ Actions Index Options Help ------------------------------------------------------------ 09/02/93 11:17:21 Userid Profiles Region: CICSPROD Auto(60) Overtype to change the current profile and press Enter. +----------------------------------------------------------------------------+ | Current userid profile . . . $DEFAULT | +----------------------------------------------------------------------------+ Type an action code and press Enter. C=Copy D=Delete P=Print Lines 1 to 6 of 46 +------------------+---------------------------------------------------------+ | Userid Profile | Description | +------------------|---------------------------------------------------------| | _ $DEFAULT | Default userid profile | | _ TSAB1 | Profile for user Mary Rogers | | _ TSTX1 | Profile for user John Jones | | _ TSTX2 | Profile for user Ellen Adams | | _ TSTX4 | Profile for user Wayne Smith | | _ TSUK7 | Profile for user George Masters | +------------------+---------------------------------------------------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status



2. Specify a name for a new user ID profile:A. At the Copy a Profile pop-up, specify a unique name for the userid profile you want to

create.B. Type 1-8 characters on the New Profile Name field, then tab to the New Profile

Description field and type a description of the profile. Press Enter. The user ID profile name you specified is added to the list of profiles in the Userid Profiles panel.

3. Change settings in Preferences and Controls.A. Access the Options pull-down menu.B. At this point make changes to settings in the Preferences option and in Controls

through the Session Defaults and Screen Output Routing Options selections. Be sure to press Enter after each change you make. When you change a setting, the Save Userid Options pop-up window displays.

C. Press 2 to save the changes you are making to your profile. D. When finished changing settings in Preferences, Session Defaults, and Screen Output

Routing Options, return to the Options pull-down menu. Press F12. The underlying panel redisplays.

Your profile now contains the changes you made in Preferences, Session Defaults, and Screen Output Routing Options.

Region ProfilesThis option displays all currently defined region profiles. It enables you to copy, delete, print, export, import, and migrate specified profiles using action codes or the Actions pull-down menu.

You can also use this option to switch to another profile from the current profile. The following figure shows the Region Profiles panel.



FIGURE 41. Region Profiles Panel

For more information about the actions you can perform on the Region Profiles panel, see the “Region Profiles” section in the OMEGAMON II for CICS Reference Manual.

Defining A Different CICS Region Profile

The region profile contains the threshold settings for all performance measures for a given CICS region. This profile is used by all userids that monitor a specific region.

If the default region profile does not suit your needs, you can define a different region profile. You can enter this profile in the CICS Region Profile field of the Logon Options pop-up when you log onto OMEGAMON II.

To define a different region profile, follow these steps:

1. Copy an existing region profile:A. Log onto OMEGAMON II using the default region profile.B. Access the Options pull-down menu on the Region Status panel.C. Select Region Profiles. The Region Profiles panel displays.D. Type C next to an existing region profile to copy it to the profile you will name. Press

Enter. The Copy a Profile pop-up window displays.

____ Actions Index Options Help ------------------------------------------------------------ 09/02/93 11:17:38 Region Profiles Region: CICSPROD Auto(60) Overtype to change the current profile and press Enter. +----------------------------------------------------------------------------+ | Current region profile . . . $DEFAULT | +----------------------------------------------------------------------------+ Type an action code and press Enter. C=Copy D=Delete P=Print E=Export +------------------+---------------------------------------------------------+ | Region Profile | Description | +------------------|---------------------------------------------------------| | _ $DEFAULT | Default region profile | | _ CICSTEST | Profile for region CICSTEST | | _ CICSAOR | Profile for region CICSAOR | | _ CICSTOR | Profile for region CICSTOR | | _ CICSROR | Profile for region CICSROR | | _ CICSPROD | Profile for region CICSPROD | +------------------+---------------------------------------------------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status



2. Specify a name for a new region profile:A. At the Copy a Profile pop-up, enter 1-characters on the New Profile Name field to

specify a name for a new region profile.B. Tab to the New Profile Description field and enter a description of the profile. Press

Enter. The new profile name is added to the list of profiles in the panel.

3. Change threshold settings for the component you want:A. Return to the Options pull-down menu.B. Elect Thresholds. The Thresholds pop-up window displays.C. Select a category from the Thresholds pop-up. For example do the following:

a. Select Workloads. Press Enter. The Workloads Thresholds pop-up window displays.

b. Select a component from the Workloads Thresholds pop-up. For example, select AIDs. Press Enter. The AIDs Thresholds pop-up window displays showing the current threshold settings for the component.

c. Change as many threshold settings for the component as you want. Press Enter after each change. The Save Region Options pop-up displays.

d. Enter 2 to save the threshold changes to your profile. Press Enter. The Workloads Thresholds pop-up redisplays.

e. Press F12 to exit the Workloads pop-up. The Thresholds pop-up redisplays.f. Press F12 to exit the Thresholds pop-up. The Options pull-down menu redisplays.

D. You can continue to change threshold settings for as many components as you want by repeating this procedure starting from step 3. Be sure to press Enter after changing each setting.

Close Print LogThis option allows you to close the screen print dataset that contains screens you’ve selected for printing using the F11 key, and it routes the screens to be printed.

Dynamic Profile Update Facility


Dynamic Profile Update FacilityThe Dynamic Profile Update Facility allows users to export and import individual CUA profiles dynamically to and from a partitioned dataset. This facility can be invoked externally through an MVS console command.

Observe these considerations when using the import and export dialogs:

n Invoke KC2EXP and KC2IMP by using the MVS Modify command.n Use KC2EXP to export a profile to a partitioned dataset and KC2IMP to import a profile

from a partitioned dataset.n When you export a profile, its data is written in a standard format to a partitioned dataset

member.n The partitioned dataset should be allocated as fixed blocked, LRECL of 80, and BLKSIZE

of 8880, with an appropriate number of directory blocks.n Make sure KC2PROC, the OMEGAMON II for CICS started task name, has write

authority to the partitioned dataset.n Importing reverses the above process, and recreates a profile based on the exported

information.

The MVS Modify command for exporting a profile is as follows:

/F KC2PROC,NTD KC2EXP ’PDSNAME MEMBER PROFILE’

Where PDSNAME is the name of the target partitioned dataset, MEMBER is the target partitioned dataset member, and PROFILE is the source profile.

The MVS Modify command for importing a profile is as follows:

/F KC2PROC,NTD KC2IMP ’PDSNAME MEMBER PROFILE’

Where PDSNAME is the name of the source partitioned dataset, MEMBER is the source partitioned dataset member, and PROFILE is the target profile.

After exporting a profile to a PDS, do not modify the PDS member. Otherwise unpredictable results may occur when importing the profile.

If you want to see messages indicating success or failure in the MVS SYSLOG, be sure you have WTO(Y) specified in the KC2SYSIN parameter member in the RKANPAR dataset. The messages are as follows:

KC2EXP00 - Profile profile was exported successfully.

KC2EXPFF - Export failed for profile profile.

KC2IMP00 - Profile profile was imported successfully.

KC2IMPFF - Import failed for profile profile.

For more information on these messages, see the OMEGAMON II for CICS Messages Manual.


Using the Help Pull-down

Using the Help Pull-downThe OMEGAMON II help system is comprehensive and contains everything from a glossary of terms and tuning considerations to guides for immediate action. Use the system as a detailed reference and for help in solving problems.

One way to access the help system is through the Help pull-down menu. Simply move the cursor to the Help choice on the action bar or type H. in the home position. Then press Enter. The Help pull-down menu displays, as shown in the following figure.

FIGURE 42. Help Pull-down Menu

To display a help topic, move the cursor to the entry field of your selection, or type its number or mnemonic in the entry field. Then press Enter.

For an explanation of each selection on the Help pull-down, see “Action Bar Help” on page 40.

Online help can also be accessed through panels and panel fields with the F1 key. See “Panel Help” on page 41 and “Field Help” on page 41 for details.

H___ Actions GoTo Index Options Help --------------------------------- +-----------------------------+ /93 16:25:36 KC2B01D R | _ 1. Help for help... | n: CICSPROD + | 2. Extended help... | Auto(60) Select one component with a / o | 3. Keys help... | S=Show details A=Analyze pr | 4. Help index... | +------------------+------------- | 5. Tutorial... | -----------+ | Workloads | | 6. Glossary... | lerts | +------------------+------------- | 7. About... | -----------+ | _ AIDs Warn | _ CPU O | 8. User Information... | nck OK | | | | 9. New Features... | | | _ ICEs OK | _ DASD C | | oop OK | | | | F1=Help F12=Cancel | | | _ Response OK | _ DB2 O +-----------------------------+ OK | | | | | | _ Tasks OK | _ DBCTL Warn _ Storage OK | _ Enqueues OK | | | | | | _ TranRate OK | _ DL/I OK _ Tapes OK | _ I/O Rate OK | | | | | | | _ Files OK _ TempStor OK | _ VTAM ACB OK | | | | | | | _ Journals OK _ TranData OK | _ XRF Crit | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print

Using the Help Pull-down


CICS Problem-Solving Approaches 99

CICS Problem-Solving Approaches

Introduction This chapter provides examples of how to use OMEGAMON II to identify and solve the following typical CICS problems:

n excessive CPU usagen excessive response time for usersn users complaining about bad responsen new application experiencing poor responsen program’s changes not being reflectedn CICS is not respondingn User terminal is not responding

Chapter ContentsExcessive CPU Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100Excessive Response Time for Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104Users Complaining about Bad Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108New Application Experiencing Poor Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110Program’s Changes Not Being Reflected. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115CICS Is Not Responding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122User Terminal Is Not Responding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126

4

Excessive CPU Usage


Excessive CPU UsageThe CPU status bar on the Region Status panel indicates a critical problem for the resource, CPU.


To determine the nature of the problem, type S (Show Details) next to CPU. The following panel then displays.



Excessive CPU Usage

FIGURE 44. CPU Rates Panel

This panel shows all the tasks in the CICS region. You can see that the BURN transaction is using excessive CPU time. To see more detail on this transaction, type S next to BURN. The Task Details panel displays.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:23:22 KC2X01D CPU Rates Region: CICSPROD Fastpath: =RC Auto( 60)+----------+-----------------------------------------------------------------+| | % CPU Util 0................................................100||----------+-------------+--!--!-----------------------------!--!------------|| TCB | 55% |-------------------------> || SRB | 1% |> || Total | 56% |--------------------------> |+----------+-------------+---------------------------------------------------+ Tasks by CPU Consumption Lines 1 to 5 of 21+------------+---------+-----------------------------------------------------+|Task Number | Tran ID | CPU Time 0.......................................3 ||------------+---------+-----------+------!-------------------!--------------|| _ 52 | BURN | 2.767s |-----------------------------------> ||_ 19 | CSSY | 1.925s |-------------------------> ||_ 216 | DECV | 1.395s |-----------------> || _ 27 | CSNC | 0.093s |> || _ 4 | CSNE | 0.049s |> |+------------+---------+-----------+-----------------------------------------+ (CPU) <Paging> <ASID> <Job> <TCBs> <Modules> <MVS Resources> <XRF> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd

Excessive CPU Usage


FIGURE 45. Task Details Panel

From the Task Details panel, you can confirm that the BURN transaction is not giving up control to other transactions. (Look at the Task State field; the status remains as RUNNING.)

You suspect that the transaction may be in a loop and needs to be terminated. Enter A (Actions) at the top of the panel to select the Purge task choice from the Actions pull-down menu.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 06/30/94 16:45:16 KC2C02D Task Details Region: CICSPROD Fastpath: =WTD Auto( 60) +-------------------------------------+--------------------------------------+ | Task number . . . . . 52___ + | Transaction ID . . . . : BURN | | _ Facility ID . . . . : M552 | _ CICS transaction ID . : BURN | | Facility type . . . : Term | Originating tran ID . : BURN | | Task state . . . . . : RUNNING | _ First CICS program ID : BURNA100 | | Task queue . . . . . : Executbl | _ Current CICS program ID: BURNA100 | | Resource type . . . : RUNNING | | | Resource name. . . . : RUNNING | Storage used above 16M : 17K | | Userid . . . . . . . : CICSUSER | Storage used below 16M : 2K | | _EXEC CICS command . : x’100A’ | | | Attach time. . . . . : 12:24:16 | Purgeable suspend . . : Yes | | CPU time . . . . . . : 2.767s | Purgeable status . . : No purge | | Task elasped time. . : 15.771 | Suspend timeout due. . : None | | Time of suspend . . : 16:45:00 | Suspend type . . . . . : Suspend | | Time in suspend . . : 0:00:15 | UOW state . . . . . . : Inflight | | | | +-------------------------------------+--------------------------------------+(Details) <Addresses> <Files> <Remote> <Statistics> <Storage> <Timings><GoTo DB2> <GoTo Remote CICS> <Umbrella> <FEPI>F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action BarF11=Print F15=Region Status


Excessive CPU Usage

FIGURE 46. Task Details Panel Displaying Actions Pull-down

After typing P or 2 in the entry field on the Actions pull-down menu, a confirmation pop-up window will display so you can confirm that the task is to be terminated. At the window, verify that the number of the task to be purged is correct and then press Enter. To cancel the purge, press F12.

Once the task is purged, other transactions can run normally again.

a___ Actions GoTo View Index Options Help -- +---------------------------------- -------------------- 05/24/93 15:27:22 KC | _ 1. Show details | tails Region: CICSPROD Fa | 2. Purge task | Auto(60) +--| 3. Force purge task | -------------------------------------+ | | 4. Kill task | Transaction ID . . . . : BURN | | | 5. Force kill task | _ CICS transaction ID . : BURN | | | | Originating tran ID . : BURN | | | 6. Exit F3 | _ First CICS program ID : BURNA100 | | | | _ Current CICS program ID: BURNA100 | | | F1=Help F12=Cancel | | | +----------------------------------+ Storage used above 16M : 304K | | _EXEC CICS command . : x’110A’ | Storage used below 16M : 448L | | | | | Attach time. . . . . : 12:24:16 | Purgeable suspend. . . : No | | CPU time . . . . . . : 2.767s | Purge status . . . . . : No purge | | Task elapsed time. . : 15.771 | Suspend timeout due. . : None | | Time of suspend . . : 15:26:00 | Suspend type . . . . . : Suspend | | Time in suspend . . : 0:00:15 | UOW state . . . . . . : Inflight | | | | +-------------------------------------+--------------------------------------+ (Details) <Addresses> <Files> <Remote> <Statistics> <Storage> <Timings> <Return to DB2> <Umbrella> F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

Excessive Response Time for Users


Excessive Response Time for UsersOn the Region Status panel, you see that the Response status bar indicates a critical problem. The Region Status panel is shown below.

FIGURE 47. Region Status Panel with Critical Response Status Bar

To determine the cause of the problem, type S in the entry field next to Response (in the Workloads section) to show details. The Response Times panel then displays.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:30:03 KC2B01D Region Status Region: CICSPROD Auto(60) Select one component with a / or an action code. S=Show details A=Analyze problems L=Control +------------------+-------------------------------------+-------------------+ | Workloads | Resources | Alerts | |------------------+-------------------------------------+-------------------| | _ AIDs OK | _ CPU Crit _ LSR OK | _ Bottlnck Crit | | | | | | _ ICEs OK | _ DASD Crit _ MRO/ISC OK | _ CICSloop OK | | | | | | _ Response Crit | _ DB2 OK _ Paging OK | _ Dumps OK | | | | | | _ Tasks OK | _ DBCTL Warn _ Storage Crit | _ Enqueues OK | | | | | | _ TranRate OK | _ DL/I OK _ Tapes OK | _ I/O Rate OK | | | | | | | _ Files OK _ TCP/IP OK | _ VTAM ACB OK | | | | | | | _ Journals OK _ TempStor OK | _ XRF Idle | | | | | | | _LSR Idle _ TranData Crit | | | | | | | | _ Web OK | | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print



FIGURE 48. Response Times Panel

From the Response Times panel, you can see that the Payroll group is experiencing poor response time. To determine what factors may be affecting those transactions belonging to the group, enter a B (for Bottlenecks) next to Payroll in the Group Name column. The Internal Bottlenecks panel displays.

FIGURE 49. Internal Bottlenecks Panel

____ Actions GoTo View Index Options Help ----------------------------------------------------------- 05/24/93 15:30:34 KC2F01D Response Times Region: CICSPROD Fastpath: =WR Auto(60) S=Show details B=Bottlenecks Lines __1 to 10 of 30 +----------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+ | Group |Group| Curr| Curr| Curr| Curr| Curr| Curr| Curr| Curr| Curr| | Name | Type| Min| -1| -2| -3| -4| -5| -6| -7| -8| |----------------|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----| | _ PAYROLL | Tran| 9.5| 9.1| 8.0| 8.0| 9.5| 9.3| 9.4| 11.5| 9.8| | _ DEVTRAN | Tran| 1.4| 1.5| 1.4| 1.5| 1.3| 1.2| 1.4| 1.9| 1.4| | _ DATAAPGM | Prog| 1.3| 1.5| 1.1| 1.0| 1.5| 1.3| 1.5| 1.1| 1.1| | _ NYTERMS | Term| 1.1| 1.1| 1.9| 1.2| 1.9| 1.1| 1.9| 1.9| 1.5| | _ REMOTE LUS | LU | 1.1| .9| 1.1| 1.0| 1.0| 1.2| 1.9| 1.0| 1.2| | _ APP1NODE | LU | .9| .9| 1.1| 1.6| 1.0| .9| 1.9| 1.0| 0.8| | _ ADABAPGM | Prog| .3| 1.2| 1.3| .8| .3| .5| .9| 1.0| 2.5| | _ PRODTRAN | Tran| .1| .0| .0| .1| .0| .0| .0| .0| .0| | _ PRODTERM | Term| .1| .0| .0| .0| .0| .0| .0| 1.1| 1.2| | _ TESTTERM | Term| .1| .0| .0| .0| .0| .0| .0| 1.1| 1.3| +----------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+ (Response Times) <Response Time History> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

____ Actions GoTo View Index Options Help ------------------------------------------------------------ 05/24/93 15:31:03 KC2L01D Internal Bottlenecks Region: CICSPROD Fastpath: =AB Auto(60) +-----------------------------------------+----------------------------------+ | Group name . . . . . . PAYROLL_____ + | Samples taken . . . : 25 | | Collection interval : 1:00 MN | Elapsed time . . . . : 48 SEC | +-----------------------------------------+----------------------------------+ +------------+------------+-----------+--------------------------------------+ | Resource | Resource | Wait | Bottleneck | | Type | Name | Type | Ratio 0......................100 | |------------+------------+-----------+------------------------!--!----------| +----------------------------------------------------------------------------+

(Internal Bottlenecks) <External Contention> <Response Time Details> F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status



Looking at the Internal Bottlenecks panel, you see that all is well. No bottlenecks have been detected within the CICS region that are affecting the Payroll group. You then decide to see if external bottlenecks might be affecting the group, so you select the External Contention pushbutton at the bottom of the panel. (Tab the cursor to the pushbutton and press Enter.) The External Contention panel displays.

FIGURE 50. External Contention Panel

From this panel, you can see that there is a batch job called TESTPAY that is competing with CICS. If you want to find out what resources are being contended by TESTPAY, select it by placing an S next to the address space and pressing Enter. The External Contention Details panel then displays.

____ Actions GoTo View Index Options Help ------------------------------------------------------------ 05/24/93 15:31:54 KC2L04D External Contention Region: CICSPROD Fastpath: =ABC Auto( 60) +-----------------------------------+----------------------------------------+ | CICS productive time . : 0% | Cycle time for analysis . . : 1:00m | | Total contention time . : 25% | Elapsed time into cycle . . : 13s |+-----------------------------------~----------------------------------------+

+-------------+------------+-------------------------------------------------+ | Address | Performance| Contention | | Space | Group | Factor 0.................................100 | |-------------|------------|-----------+-------------------------------------| | _ TESTPAY | 500 | 25% |--------> | +-------------+------------+-----------+-------------------------------------+ <Internal Bottlenecks> (External Contention) <Response Time Details> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status



FIGURE 51. External Contention Details Panel

From this panel, you can see that the resource being contended is VOL054, a volume needed by CICS. You realize this is a batch job that is normally run during nonpeak periods, and you can now take steps to cancel it.

_____ GoTo Index Options Help ---------------------------------------------------------- 05/24/93 15:32:12 KC2L05D1 External Contention Details Region: CICSPROD Fastpath: =ABCD Auto(60) +-------------------------------------+------------------------------------+ | Address space . . . . TESTPAY_ + | Performance group . . : 500 | | CICS address space . . No | | | | | | Start date . . . . . . 5/24/93 | Start time . . . . . . . 9:00:00 | | CICS release . . . . . 3.2.1 | CICS applid . . . . . . CICSRGN1| +-------------------------------------~------------------------------------+ +---------------+---------+-------+---------+------------------------------+ | Contended |Contended|Device | Enqueue |Contention | | Resource | DASD |Address| Name | Factor 0...............100 | |---------------|---------|-------|---------|----------+-------------------| | TOTAL | | | | 25% |----> | |---------------|---------|-------|---------|----------+-------------------| | DASD | VOL054 | 0322 | | 25% |----> | +---------------+---------+-------+---------+----------+-------------------= F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action BarF11=Print F15=Region Status

Users Complaining about Bad Response


Users Complaining about Bad ResponseYou have received several calls from users in a remote office complaining about poor response time. The Response status bar on the Region Status panel indicates a critical problem. You enter an S next to Response to find out what may be happening. The Response Times panel is displayed.


The users calling are all from the same office. A network problem is indicated by the high response times for the first LU group and by the subsecond internal response times for the group types Prog, Tran, and Term.

You enter S next to the LU group associated with the users (Remote LUs). A panel showing response times for all the LUs in the selected group appears.

____ Actions GoTo View Index Options Help ----------------------------------------------------------- 05/24/93 16:02:34 KC2F01D Response Times Region: CICSPROD Fastpath: =WR Auto(60) S=Show details B=Bottlenecks Lines __1 to 10 of 30 +----------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+ | Group |Group| Curr| Curr| Curr| Curr| Curr| Curr| Curr| Curr| Curr| | Name | Type| Min| -1| -2| -3| -4| -5| -6| -7| -8| |----------------|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----| | _ REMOTE LUS | LU | 29.1| 29.0| 28.1| 27.0| 27.0| 28.2| 27.9| 27.0| 27.2| | _ APP1NODE | LU | .9| .9| 1.1| 1.6| 1.0| .9| 1.9| 1.0| .8| | _ PAYROLL | Tran| .5| .1| .0| .0| .5| .3| .4| .5| .8| | _ DEVTRAN | Tran| .4| .5| .4| .5| .3| .2| .4| .9| .4| | _ NYTERMS | Term| .4| .1| .9| .2| .9| .1| .8| .8| .5| | _ DATAAPGM | Prog| .3| .5| .1| .0| .5| .3| .5| .1| .1| | _ ADABAPGM | Prog| .3| .2| .3| .8| .3| .5| .9| 1.0| 2.5| | _ PRODTRAN | Tran| .1| .0| .0| .1| .0| .0| .0| .0| .0| | _ PRODTERM | Term| .1| .0| .0| .0| .0| .0| .0| 1.1| 1.2| | _ TESTTERM | Term| .1| .0| .0| .0| .0| .0| .0| 1.1| 1.3| +----------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+ (Response Times) <Response Time History> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status


Users Complaining about Bad Response

FIGURE 53. Response Time Detail for LU Group

This panel breaks down all the elements of a group, in this case the VTAM LUs, and gives you the required detail to determine the cause of your response time problem. Here, you can see that the problem is indeed in the network since response time there is over 15 seconds and the host time is subsecond. Because of this detail, you have not wasted time trying to determine if there was an application or MVS problem when your problem was in the network.

____ Actions GoTo View Index Options Help ----------------------------------------------------------- 05/24/93 16:03:10 KC2F02D Response Time Details Region: CICSPROD Fastpath: =WRD Auto(60) +----------------------------------------------------------------------------+ | Group name . . . . REMOTE LUS__ + | +----------------------------------------------------------------------------+ Lines __1 to 8 of 21 +-------------+--------+-----+-----+-----+-----+-----+-----+-----+-----+-----+ | Element | Elem | Curr| -1| -2| -3| -4| -5| -6| -7| -8| | ID | Type | Min| Min| Min| Min| Min| Min| Min| Min| Min| +-------------|--------|-----|-----|-----|-----|-----|-----|-----|-----|-----| | R103C00 | LU | 30.3| 26.0| 25.5| 22.9| 32.4| 27.0| 27.0| 26.5| 23.4| | (Net) | LU | 29.5| 25.3| 25.0| 22.1| 31.5| 26.4| 26.3| 25.9| 22,7| | (Host) | LU | 0.8| 0.7| 0.5| 0.8| 0.9| 0.6| 0.7| 0.6| 0.7| | R616A64 | LU | 31.8| .0| 22.9| .0| .0| 31.1| 27.1| .0| .0| | (Net) | LU | 31.3| .0| 22.6| .0| .0| 29.9| 26.2| .0| .0| | (Host) | LU | 0.5| .0| 0.3| .0| .0| 1.2| 0.9| .0| .0| | R109C02 | LU | 31.0| 31.1| 29.9| 30.1| 29.9| 31.1| 31.5| 32.5| .0| | (Net) | LU | 30.5| 29.2| 29.1| 29.3| 29.0| 30.8| 31.0| 31.1| .0| +-------------+--------+-----+-----+-----+-----+-----+-----+-----+-----+-----+ <Internal Bottlenecks> <External Contention> (Response Time Details) F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status

New Application Experiencing Poor Response


New Application Experiencing Poor ResponseThe Response status bar on the Region Status panel indicates a critical problem with response times. You select Response by entering S next to it on the Region Status panel. The Response Times panel then displays.


You see here that the group INVNTORY is experiencing poor response time. You know that transactions in this group invoke new programs recently put into production. It had subsecond response time in the test environment, but is experiencing 20- to 30-second response time in production.

You can look at this group in more detail by entering an S in the entry field next to it.

____ Actions GoTo View Index Options Help----------------------------------------------------------- 03/22/93 08:02:34KC2F01D Response Times Region: CICSPRODFastpath: =WR Auto(60) S=Show details B=Bottlenecks Lines __1 to 11 of 30 +----------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+ | Group |Group| Curr| Curr| Curr| Curr| Curr| Curr| Curr| Curr| Curr| | Name | Type| Min| -1| -2| -3| -4| -5| -6| -7| -8| +----------------|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----| | _ INVNTORY | Tran| 21.1| 15.1| 20.1| 21.4| 24.3| 22.2| 23.2| 25.1| 24.2| | _ PAYROLL | Tran| 5.1| 5.2| 5.1| 4.3| 4.1| 3.2| 3.1| 3.9| 3.0| | _ DEVTRAN | Tran| 5.1| 3.1| 3.6| 3.6| 3.4| 3.0| 3.1| 3.2| 3.7| | _ NYTERMS | Term| 2.1| 2.2| 2.1| 2.2| 2.2| 2.1| 2.3| 2.2| 2.1| | _ APP1NODE | LU | 2.0| 2.1| 2.1| 2.6| 2.1| 2.1| 2.3| 1.1| 2.2| | _ APP2NODE | LU | 1.2| 1.3| 1.2| 2.0| 1.1| 1.5| 1.1| .9| .9| | _ DATAAPGM | Prog| 1.1| 2.1| 1.1| 1.2| 1.3| 1.2| 1.1| 1.1| 1.1| | _ ADABAPGM | Prog| .2| .4| .3| .8| .2| .3| .9| .1| .5| | _ PRODTRAN | Tran| .1| .0| | .1| | | | | | | _ PRODTERM | Term| | | | | | | | 1.1| 1.2| | _ TESTTERM | Term| | | | | | | | 1.1| 1.3| +----------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+ (Response Times) <Response Time History> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status



FIGURE 55. Response Time Details Panel

From the Response Time Details panel for the inventory application, it seems that one transaction, ASMA, is having a problem and, because of it, application performance is being degraded. Therefore, you may want to see detailed historical data for this transaction ID. To do so, enter an S next to ASMA to show details. The Task History panel displays

____ Actions GoTo View Index Options Help ----------------------------------------------------------- 03/22/93 08:02:34 KC2F02D Response Time Details Region: CICSPROD Fastpath: =WRD Auto(60) +----------------------------------------------------------------------------+ | Group name . . . . INVNTORY____ + | +----------------------------------------------------------------------------+ Lines __1 to 8 of 19 +-------------+--------+-----+-----+-----+-----+-----+-----+-----+-----+-----+ | Element | Elem | Curr| -1| -2| -3| -4| -5| -6| -7| -8| | ID | Type | Min| Min| Min| Min| Min| Min| Min| Min| Min| +-------------|--------|-----|-----|-----|-----|-----|-----|-----|-----|-----| | _ ASMA | Tran | 30.4| 30.2| 31.4| 31.2| 31.7| 26.4| 27.8| 20.2| 30.4| | _ ASM1 | Tran | 4.7| | 3.8| | | 6.1| 5.7| | | | _ ASN2 | Tran | .8| | .8| | | .6| .7| | | | _ ASN1 | Tran | 1.4| | 2.7| | | 3.2| 4.8| | | | _ ASBA | Tran | 3.1| | 7.5| | | 5.1| 6.0| | | | _ ASBD | Tran | .7| | .8| | | .9| .7| | | | _ ASBE | Tran | .1| | | | | | | 1.1| | | _ A* | Tran | 12.3| 30.2| 9.9| 31.2| 31.7| 12.1| 11.5| 2.5| 30.4| +-------------+--------+-----+-----+-----+-----+-----+-----+-----+-----+-----+ <Internal Bottlenecks> <External Contention> (Response Time Details) F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status



FIGURE 56. Task History Panel.

From the Task History summary panel for the ASMA transaction, you see that all occurrences of the transaction have an unusually high file I/O. As all occurrences of ASMA are essentially the same in this regard, enter an S next to any Task Start Time field to obtain still more detailed information. The Task History Details panel displays.

____ Actions GoTo View Index Options Help ------------------------------------------------------------ 03/22/93 08:02:34 KC2T01D Task History Region: CICSPROD Fastpath: =H Auto(60) +----------------------------------------------------------------------------+ | Display range . . 03/22/93 7:53:34 to 03/22/93 8:02:34 | +----------------------------------------------------------------------------+ More: - ++------------+------+--------+------+------+------+---------+--------+-------+

| Task | Tran | Task | Term | CPU | Resp | Storage | File | Abend | | Start Time | ID | Number | ID | Time | Time | HWM | I/O | Code | |------------|------|--------|------|------|------|---------|--------|-------| | _ 8:02:34 | ASMA | 272 | M244 | .1 | 26.1| 21184 | 116204 | | | _ 8:01:48 | ASMA | 301 | M244 | .2 | 28.2| 28160 | 116692 | | | _ 8:00:56 | ASMA | 346 | M848 | .2 | 26.4| 25248 | 116205 | | | _ 7:59:56 | ASMA | 354 | M848 | .1 | 28.6| 25248 | 118017 | | | _ 7:57:54 | ASMA | 366 | M848 | .2 | 26.9| 27840 | 117823 | | | _ 7:54:57 | ASMA | 382 | M329 | .1 | 26.8| 21584 | 116543 | | | _ 7:54:57 | ASMA | 391 | 0A76 | .1 | 29.7| 21360 | 117260 | | | _ 7:53:53 | ASMA | 402 | 0A76 | .2 | 27.2| 21264 | 116596 | | | _ 7:53:34 | ASMA | 416 | 0A76 | .1 | 29.5| 23248 | 116596 | | +------------+------+--------+------+------+------+---------+--------+-------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status



FIGURE 57. Task History Details Panel

From the Task History Details panel, you see the large number of FCT requests the transaction has made. To see which files have been accessed, enter an S in the entry field next to FCT requests to show details. The Task History FCT panel displays.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 03/22/93 08:02:34 KC2T02D Task History Details Region: CICSPROD Auto(60) +-------------------------------------+--------------------------------------+ | Task number . . . . : 402 | Transaction ID . . . . : ASMA | | _ Facility ID . . . . : 0A76 | _ CICS transaction ID . : ASMA | | Facility type . . . : Term | _ Primary program ID . . : ASMAPRO | | VTAM netname . . . . : USCACO01 | | | Userid . . . . . . . : CICSUSER | | | | HWM storage used >16M : 22K | | | HWM storage used >16M : 22K | | CPU time . . . . . . : 0.1895s | | | | Response time . . . . : 27.1945s | | _ FCT requests . . . . : 116596 | | | _ DL/I requests . . . : n/a | DL/I elapsed time . . : n/a | | _ DB2 requests . . . . : n/a | DB2 elapsed time . . . : n/a | | _ ADABAS requests . . : n/a | ADABAS elapsed time . : n/a | | _ IDMS requests . . . : n/a | IDMS elapsed time . . : n/a | | _ DATACOM requests . . : n/a | DATACOM elapsed time . : n/a | | _ SUPRA requests . . . : n/a | SUPRA elapsed time . . : n/a | | _ USREVNT1 requests. . : 10 | USREVNT1 elapsed time. : 41.034 | +-------------------------------------+--------------------------------------+ (Details) <Storage> <Timings> <Statistics> <Umbrella> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print



FIGURE 58. Task History FCT

From this panel, it can be seen that the majority of file requests have been issued against a file called ASMF02A. You can use this fact to isolate the cause of the problem within the application program.

Note: VSAM file-level statistics are collected by OMEGAMON only when a file request invokes the EXEC interface program, DFHEIP. Detailed statistics will not be collected for a file, therefore, for any transaction that does not access the file through an EXEC CICS call. For example, detailed statistics for file DFHCSD are not available for transaction CEDA.

____ Actions GoTo Index Options Help ----------------------------------------------------------- 03/22/93 08:02:34 KC2T10D Task History FCT Region: CICSPROD Auto(60) +-------------------------------------+-------------------------------------- | Task number . . . . . : 402 | Transaction ID . . . . : ASMA | | Browses . . . . . . . : 0 | Browse time . . . . . . : 0 | | Deletes . . . . . . . : 25392 | Delete time . . . . . . : 6.802s | | Reads . . . . . . . . : 45923 | Read time . . . . . . . : 9.832s | | Updates . . . . . . . : 45251 | Update time . . . . . . : 10.054s | | Writes . . . . . . . : 30 | Write time . . . . . . : 0.014s | | Miscellaneous requests: 10 | Misc request time . . . : 0 |

+-------------------------------------+--------------------------------------+ Lines ___1 to 2 of 5 +-------------+-----------+-----------+--------------------------------------+ | File ID | Requests | Time | %Response 0.....................100 |

|-------------|-----------|-----------|-----------^------------------------- | | _ ASMF02A | 115995 | 26:170 | 95% |-----------------------> | | _ ASMF01A | 601 | 0:532 | 2% |> |

+-------------+-----------+-----------+-----------~--------------------------+ (FCT) <DL/I> <DB2> <ADABAS> <IDMS> <DATACOM> <SUPRA> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status


Program’s Changes Not Being Reflected

Program’s Changes Not Being ReflectedOne of your applications has caused storage violations because of a coding error in one of its programs. You know that this program, LARM001, was changed last night to correct this problem. But you have been contacted and told that storage violations are still occurring in CICS production, and you suspect LARM001. So you want to check to make sure that the new copy of LARM001 is the one being executed in your CICS production region.

At the Region Status panel, enter G in the entry field on the action bar to select the GoTo pull-down menu.

FIGURE 59. GoTo Pull-down Menu

Then, from the GoTo pull-down menu, select 1 for CICS Tables. The following figure shows the CICS Tables panel.

g___ Actions GoTo Index Options Help------------+-----------------------------------------+---- 05/14/93 16:34:35KC2B01D | _ 1. CICS Tables | Region: CICSPROD + | 2. Task History | Auto(60) Select on | 3. CICS Memory | S=Show | |+-----------| 4. Zoom to OMEGAMON II menu system |--+-------------------+| Workl | | | Alerts ||-----------| F1=Help F12=Cancel |--|-------------------|| _ AIDs +-----------------------------------------+ | _ Bottlnck OK || | | || _ ICEs OK | _ DASD Warn _ MRO/ISC OK | _ CICSloop OK || | | || _ Response OK | _ DB2 OK _ Paging OK | _ Dumps OK || | | || _ Tasks OK | _ DBCTL Warn _ Storage OK | _ Enqueues OK || | | || _ TranRate OK | _ DL/I OK _ Tapes OK | _ I/O Rate OK || | | || | _ Files OK _ TempStor OK | _ VTAM ACB OK || | | || | _ Journals OK _ TranData OK | _ XRF Crit |+------------------+-------------------------------------+-------------------+

F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print



FIGURE 60. CICS Tables Panel

You want to look at the Program entries. OMEGAMON II allows you to see the load library from which the program represented by a Program entry was loaded. To display the Programs panel, enter S next to PROG. The Programs panel displays.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/14/93 16:36:13 KC2P01D CICS Tables Region: CICSPROD Fastpath: =C Auto(60)

+-------------------------------------+--------------------------------------+ | _ AID Automatic initiators | _ PROG Programs | | _ CSA CICS common system area | _ SIT System initialization table| | _ DCT Destinations | _ TCB CICS TCBs | | _ DDIR DL/I database directory | _ TCT Terminals | | _ DL/I DL/I control blocks | _ TCTFX TCT prefix | | _ DUMP Dumps | _ TCTSE TCT system entries | | _ ENQ Enqueues | _ TD Transient data | | _ EXITS Exit points and programs | _ TRACE Trace | | _ FCT Files | _ TRAN Transactions | | _ ICE Interval control elements | _ TS Temporary storage | | _ JOUR Journal models | _ TSQ Temporary storage queues | | _ LSR Local shared resources | _ TST Temporary storage table | | _ MCT Monito control table | _ XRF Extended recovery facility | | _ PDIR DL/I PSB directories | | +-------------------------------------+--------------------------------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status PA1=Switch



FIGURE 61. Programs Panel

Since you have many programs in the CICS region, you decide to limit the search for the program you want. To limit the search, type V on the action bar to see the View pull-down menu. Then type S on the menu to use the View Some filter.

_____ Actions GoTo View Index Options Help ------------------------------------------------------------ 02/01/96 15:04:41 KC2P37D Programs Region: CICSPROD Fastpath: =CP Auto(Off) Lines 18 to 37 of 303 +------------+----------+-----------+----------+---------+---------+---------+ | Program | Program | Program | Program | Program | Current | Total | | ID | Status | Language | Location | Length | Usage | Usage | |------------|----------|-----------|----------|---------|---------|---------| | DFHACP | Enabled | Assembler | | 5880 | 0 | 0 | | DFHAKP | Enabled | Assembler | DSA | 3824 | 0 | 1 | | DFHAMP | Enabled | Assembler | | 0 | 0 | 0 | | DFHBRCP | Enabled | Assembler | | 0 | 0 | 0 | | DFHCCMF | Enabled | Assembler | | 0 | 0 | 0 | | DFHCMON | Enabled | Assembler | | 0 | 0 | 0 | | DFHCPY | Enabled | Assembler | | 0 | 0 | 0 | | DFHCRNP | Enabled | Assembler | Private | 0 | 2 | 1 | | DFHCRP | Enabled | Assembler | | 0 | 0 | 0 | | DFHCRQ | Enabled | Assembler | DSA | 784 | 0 | 10 | | DFHCRR | Enabled | Assembler | DSA | 1040 | 1 | 1 | | DFHCRS | Enabled | Assembler | | 0 | 0 | 0 | | DFHCRSP | Enabled | Assembler | DSA | 1400 | 0 | 1 | | DFHCSSC | Enabled | Assembler | | 0 | 0 | 0 | | DFHCWTO | Enabled | Assembler | | 0 | 0 | 0 | | DFHDBMS | Enabled | Assembler | | 0 | 0 | 0 | | DFHDBP1$ | Enabled | Assembler | | 0 | 0 | 0 | | DFHDBP2$ | Enabled | Assembler | | 0 | 0 | 0 | | DFHDLG | Enabled | Assembler | | 1456 | 0 | 0 | | DFHDLS | Enabled | Assembler | | 648 | 0 | 0 | +------------+----------+-----------+----------+---------+---------+---------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F7=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status



FIGURE 62. View Some Pop-up over Programs Panel

Using View Some, you can filter the contents of the Programs panel to see only the programs you want to view. In this case, you type LARM001 next to the Program ID field of View Some, then press Enter. The filtered Programs panel displays.

FIGURE 63. Filtered Programs Panel

Now, type S in the Program ID column next to LARM001. The Program Entry panel then displays, giving you detailed information about the selected program.

v___ Actions GoTo View Index Options Help --------- +------------------------------------------------------------------+ KC2P37D | KC2P37VF View Some | Fastpath: | | | Type any changes, then press Enter. | +-------- | | | Progr | Field Operator + Value | | ID | ------------------ ---------- -------- | |-------- | Program ID . . . . EQ LARM001_ | | _ ACCT0 | Program status . . EQ *_______ + (Enabled/Disabled) | | _ ACFAE | Program language . EQ *________ + | | _ ACFAE | Program location . EQ *_______ + | | _ AIDPG | Program length . . EQ *_______ | | _ AIDPG | Current usage . . EQ *_______ | | _ BUFWA | Total usage . . . EQ *_______ | | _ BUFWA | | | _ BUFWA | F1=Help F4=Prompt F5=Refresh F12=Cancel | | _ BUFWA +------------------------------------------------------------------+ | _ BUFWAIT4 | Enabled | Assembler | | 600 | 1 | 11 | | _ BUFWAIT5 | Enabled | Assembler | | 600 | 0 | 2 | | _ BUFWAIT6 | Enabled | Assembler | | 600 | 2 | 2 | | _ BURNCPU | Enabled | Assembler | | 0 | 1 | 49 | | _ CANZATDX | Enabled | Assembler | | 0 | 3 | 13 | +------------+----------+-----------+----------+---------+---------+---------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status

____ Actions GoTo View Index Options Help ------------------------------------------------------------ 05/14/93 16:36:47 KC2P37D Programs Region: CICSPROD Fastpath: =CP Auto(60) +------------+----------+-----------+----------+---------+---------+---------+ | Program | Program | Program | Program | Program | Current | Total | | ID | Status | Language | Location | Length | Usage | Usage | |------------|----------|-----------|----------|---------|---------|---------| | _ LARM001 | Enabled | Assembler | | 7048 | 1 | 36 | +------------+----------+-----------+----------+---------+---------+---------+

F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status



FIGURE 64. Program Entry Panel

This panel displays the name of the problem program, LARM001, in its Program ID field. You can see from this panel that LARM001 is being loaded from an RPL dataset called CICSPROD.APPL.LOAD, but you know that this is not the dataset that contains the new version of the program.

To see where CICSPROD.APPL.LOAD is in the RPL concatenation, type G in the action bar entry field to select the GoTo pull-down menu. When the menu displays, type 4 to select Datasets Allocated to CICS. The Datasets Allocated to CICS panel displays, showing an overview of datasets allocated to the CICS region.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/14/93 16:37:16 KC2P38D Program Entry Region: CICSPROD Fastpath: =CPE Auto(60) +--------------------------------------+-------------------------------------+ | Program ID . . . . . . . LARM001_ +| _ Entry address . . . . : 06063378 | | Status . . . . . . . . : Enabled | Definition type. . . . : Catalog | | Defined language . . . : Assembler | Program attribute . . : Reusable | | Deduced language . . . : NotDed | Current use count . . : 1 | | Length . . . . . . . . : 1960 | Total use count . . . : 36 | | AMODE . . . . . . . . : Any | Total load count . . . : 1 | | RMODE . . . . . . . . : n/a | Current copies . . . . : 1 | | CEDF allowed . . . . . : Yes | Load status . . . . . : Loaded | | Load point . . . . . . : 05FB5690 | _ Entry point . . . . . : 85FB56B0 | | Loaded from . . . . . : RPL | Program location . . . : n/a | | Data location. . . . . : Below | Exec key . . . . . . . : USER | | Use count . . . . . . : 36 | | | Fetch count . . . . . : 1 | Deletes by compression : 0 | | Statistics last reset : 9:46:32 | Refreshes . . . . . . : 0 | +--------------------------------------+-------------------------------------+ | _ RPL dataset . . . . . : CICSPROD.APPL.LOAD | +----------------------------------------------------------------------------+ F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status



FIGURE 65. Datasets Allocated to CICS Panel

At this panel, type RPL in the Dataset Type field. The Datasets Allocated to CICS panel displays.


____ Actions GoTo View Index Options Help ------------------------------------------------------------ 05/14/93 16:37:42 KC2H02D Datasets Allocated to CICS Region: CICSPROD Fastpath: =RJ Auto( 60) +----------------------------------------------------------------------------+ | Dataset type . . . *______ + | +----------------------------------------------------------------------------+ Lines ___1 to 9 of 59 +------------+--------------------------------------------+------+-----------+ | DDname |Dataset Name |Volume| Attribute | |------------|--------------------------------------------|------|-----------| | _ SYSIN |TDCICS1.TOC.TDOCS22.SYSIN |OMON30| Disp=shr | | _ STEPLIB |TDCICS1.CICS.V321.TABLOAD |OMON24| Blk=06144 | | _ STEPLIB |CICS.V321.SDFHAUTH |PPSMP3| Blk=06144 | | _ STEPLIB |CICS.V321.SDFHLOAD |PPSMP3| Blk=06144 | | _ STEPLIB |TDCICS1.C2050FIX.LOAD |OMON20| Blk=06144 | | _ STEPLIB |TDCICS1.C2050STG.LOAD |OMON20| Blk=06144 | | _ STEPLIB |TDCICS1.C2050REL.LOAD |OMON20| Blk=06144 | | _ STEPLIB |TDCICS1.C2050BAS.LOAD |OMON20| Blk=06144 | | _ DFHRPL |TDCICS1.CICS.V321.TABLOAD |OMON24| Blk=06144 | +------------+--------------------------------------------+------+-----------+ <Open VSAM> (Datasets) <String Waits> <Buffer Waits> <LSR> F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status

____ Actions GoTo View Index Options Help ------------------------------------------------------------ 05/14/93 16:38:24 KC2H02D Datasets Allocated to CICS Region: CICSPROD Fastpath: =RJ Auto( 60) +----------------------------------------------------------------------------+ | Dataset type . . . RPL____ + | +----------------------------------------------------------------------------+ +------------+--------------------------------------------+------+-----------+ | DDname |Dataset Name |Volume| Attribute | |------------|--------------------------------------------|------|-----------| | _ DFHRPL |TDCICS1.CICS.V321.TABLOAD |OMON24| Blk=06144 | | _ DFHRPL |CICS.V321.SDFHAUTH |PPSMP3| Blk=06144 | | _ DFHRPL |CICS.V321.SDFHLOAD |PPSMP3| Blk=06144 | | _ DFHRPL |CICSPROD.APPL.LOAD |OMON20| Blk=06144 | | _ DFHRPL |CICSPROD.AR.LOAD |OMON20| Blk=06144 | | _ DFHRPL |CICSPROD.GL.LOAD |OMON20| Blk=06144 | | _ DFHRPL |TDCICS1.C2050BAS.LOAD |OMON20| Blk=06144 | | _ DFHRPL |TDCICS1.CMDEVTST.LOAD |OMON30| Blk=06144 | | _ DFHRPL |TDCICS1.CM000BAS.LOAD |TSO002| Blk=06144 | |------------+--------------------------------------------+------+-----------+ <Open VSAM> (Datasets) <String Waits> <Buffer Waits> <LSR> F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar



In this panel, CICSPROD.APPL.LOAD is shown fourth in the concatenation order. If the new version of the program is in CICSPROD.AR.LOAD or CICSPROD.GL.LOAD, the new version will not be loaded by CICS because it finds the old version in the dataset that was concatenated earlier. With this information available, you can choose to delete the old version from CICSPROD.APPL.LOAD.

CICS Is Not Responding


CICS Is Not RespondingThe Storage status bar on the Region Status panel indicates a critical problem with the Storage component.

FIGURE 67. Region Status with Critical Storage Status Bar

To determine the cause of the problem, type S next to the Storage status bar in the Resources section of Region Status. The CICS Storage panel (for CICS Version 3) displays.

____ Actions GoTo Index Options Help------------------------------------------------------------ 05/24/93 15:10:03 KC2B01D Region Status Region: CICSPROD Auto(60) Select one component with a / or an action code. S=Show details A=Analyze problems L=Control +------------------+-------------------------------------+-------------------+ | Workloads | Resources | Alerts | |------------------|-------------------------------------|-------------------| | _ AIDs Warn | _ CPU OK _ LSR OK | _ Bottlnck OK | | | | | | _ ICEs OK | _ DASD Crit _ MRO/ISC OK | _ CICSloop OK | | | | | | _ Response OK | _ DB2 OK _ Paging OK | _ Dumps OK | | | | | | _ Tasks OK | _ DBCTL Warn _ Storage Crit | _ Enqueues OK | | | | | | _ TranRate OK | _ DL/I OK _ Tapes OK | _ I/O Rate OK | | | | | | | _ Files OK _ TempStor OK | _ VTAM ACB OK | | | | | | | _ Journals OK _ TranData OK | _ XRF Crit | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print



FIGURE 68. CICS Storage Panel

This panel shows that storage is constrained in the DSA. To determine what is causing the constraint, select DSA in the Area column on the panel and navigate to the Storage Allocation by Components panel.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:10:26 KC2G011D CICS Storage Region: CICSPROD Fastpath: =RS Auto(60) +--------------------------------------+-------------------------------------+ | _ Storage violations . . : 2 | Storage recovery option: Yes | | Storage notifies . . . : 18 | Total times SOS . . . : 3 | | | | | Largest free LSQA . . . : 5052K | Working set size . . . : 2472K | | _ Free OSCOR . . . . . . : 2312K | Largest free OSCOR . . : 2304K | +--------------------------------------+-------------------------------------+ +----------+----------+----------+-----+-------------------------------------+ | Area | Size | Free | SOS | % Alloc 0......................100 | |----------|----------|----------|-----|----------+--------------------------| | _ DSA | 1536K | 52K | No | 96% |-----------------------> | | _ EDSA | 16384K | 13140K | No | 20% |----> ! ! | +----------+----------+----------+-----+----------+--------------------------+




FIGURE 69. Storage Allocation by Components Panel

While viewing this panel, you see that task storage is at the critical level. To determine which tasks are using excessive storage, type S in the entry field next to the word Task in the Components column. The Storage Allocation by Tasks panel then displays.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:10:39 KC2G03D Storage Allocation by Components Region: CICSPROD Fastpath: =RSC Auto(60) +---------------+----------------+---------------+---------------------------+ | Area DSA__ + | Size: 1536K | Free: 52K | Largest free : 40K | +---------------+----------------+---------------+---------------------------+ +-------------------------+-------------+------------------------------------+ | Components | Allocated | % Allocated 0.................100 | |-------------------------+-------------+--------------+-!!------!--!--------| | Total | 1484K | 96% |------------------> | | _ AP domain | 8K | 0% | | | _ Files | 4K | 0% | | | _ Loader domain | 272K | 17% |---> | | _ Monitor domain | 0K | 0% | | | _ Task | 1104K | 71% |--------------> | | _ Temporary storage | 4K | 0% | | | _ Terminal control | 4K | 0% | | | _ Transient data | 8K | 0% | | | _ Other | 80K | 5% |> | +-------------------------+-------------+--------------+---------------------+ (Components) <PAM> <Details> <Allocations> F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status



FIGURE 70. Storage Allocation by Tasks Panel

This panel shows that the transaction TAPP is using an excessive amount of storage, possibly due to an application coding error. At this point, you can purge the task and disable the transaction so that the problem can be resolved before the transaction is again invoked.

____ Actions GoTo View Index Options Help ------------------------------------------------------------ 05/24/93 15:11:20 KC2G08D Storage Allocation by Tasks Region: CICSPROD Fastpath: =RSCT Auto(60) Lines 1 to 12 of 20 +---------------+--------------+--------------+--------------+---------------+ | Task | Tran | Current | Allocated | Allocated | | Number | ID | Elements | below 16M | above 16M | |---------------|--------------|--------------|--------------|---------------| | _ 140 | TAPP | 35 | 1012K | 8K | | _ 25 | CSSY | 2 | 20K | 4K | | _ 26 | CSSY | 2 | 20K | 4K | | _ 23 | CSSY | 2 | 12K | 4K | | _ 24 | CSSY | 2 | 12K | 4K | | _ 112 | CECI | 6 | 4K | 28K | | _ 22 | CSSY | 2 | 8K | 4K | | _ 94 | CECI | 6 | 4K | 28K | | _ 72 | CEDA | 7 | 4K | 28K | | _ 33 | OMEG | 1 | 4K | 0 | | _ 32 | OMEG | 1 | 4K | 0 | | _ 5 | CSSY | 0 | 0 | 0 | +---------------+--------------+--------------+--------------+---------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status

User Terminal Is Not Responding


User Terminal Is Not RespondingYou use CICS/ESA Version 4 and above and you would like to know why your terminal has not responded yet. At the Task summary panel, you select the task that corresponds to the user terminal (see the Facility ID column) and navigate to the Task Details panel. The following figure shows the panel.


At this panel, you see that the task is running, but the task elapsed time is only a few seconds. You also notice that the task attach time is a few minutes ago. You then select the Timings pushbutton on Task Details and navigate to the Task Time Analysis panel for CICS Version 4 and above. The following figure shows this panel.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 06/30/94 16:45:16 KC2C02D Task Details Region: CICSPROD Fastpath: =WTD Auto( 60)+-------------------------------------+--------------------------------------+

| Task number . . . . . 52___ + | Transaction ID . . . . : BURN | | _ Facility ID . . . . : M552 | _ CICS transaction ID . : BURN | | Facility type . . . : Term | Originating tran ID . : BURN | | Task state . . . . . : RUNNING | _ First CICS program ID : BURNA100 | | Task queue . . . . . : Executbl | _ Current CICS program ID: BURNA100 | | Resource type . . . : RUNNING | | | Resource name. . . . : RUNNING | Storage used above 16M : 17K | | Userid . . . . . . . : CICSUSER | Storage used below 16M : 2K | | _EXEC CICS command . : x’100A’ | | | Attach time. . . . . : 12:24:16 | Purgeable suspend . . : Yes | | CPU time . . . . . . : 2.767s | Purgeable status . . : No purge | | Task elasped time. . : 15.771 | Suspend timeout due. . : None | | Time of suspend . . : 16:45:00 | Suspend type . . . . . : Suspend | | Time in suspend . . : 0:00:15 | | | | | +-------------------------------------+--------------------------------------+ (Details) <Addresses> <Files> <Remote> <Statistics> <Storage> <Timings> <Return to DB2> <GoTo Remote CICS> <Umbrella> <FEPI> <Task Terminal>F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action BarF11=Print F15=Region Status



FIGURE 72. Task Time Analysis Panel (CICS Version 4.0 and above)

On this panel you see that the 1st Dispatch Delay interval was a few minutes. You can then look at the first three items in the Wait Time Description column to determine whether the delay was due to a transaction class delay (TCLASS), the system being at the maximum task limit (MXT) or some other delay.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 06/30/94 9:34:04 KC2C08D Task Time Analysis Region: CICSPROD Fastpath: =WTI Auto(60) +------------------------------------+----------------------------------------+ | Task number. . . . . . ___27 + | Transaction ID . .: TES2 | | CPU time . . . . . . : 0.252s | Total wait time . .: 5.322s | | Task elasped time. . : 8.468s | Dispatch time . . .: 3.146s | | Overall elapsed time : 0.000s | 1st dispatch delay.: 0.000s | +------------------------------------+----------------------------------------+ Lines 1 to 5 of 17 +-----------------------------------+----------+------------------------------+ | Wait Time Description |Task time | %Task 0...............100 | |-----------------------------------+----------+----------+-------------------| | 1st dispatch delay -- Other | 0.000s | | | | 1st dispatch delay due to TCLASS | 0.000s | | | | 1st dispatch delay due to MXT | 0.000s | | | | Terminal I/O wait | 2.030s | 25% |----> | | Journal wait | 1.372s | 14% |--> | +-----------------------------------+----------+----------+-------------------+<Details> <Addresses> <Files> <Remote> <Statistics> <Storage> <Timings> <GoTo Remote CICS> <Umbrella> <FEPI> <Task Terminal> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F7=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status



Monitoring Workloads 129

Monitoring Workloads

IntroductionThis chapter discusses the Workloads portion of the Region Status panel. Workloads, the amount of work CICS performs on behalf of transactions, can be selected for further information on system performance, or analyzed for CICS problem-solving. The Region Status panel of OMEGAMON II allows you to see details or analyze problems for the following workloads:

n automatic initiate descriptors (AIDs)

n interval control elements (ICEs)

n response times

n tasks

n transaction rates

The following sections discuss the various workloads and their usage in OMEGAMON II.

Chapter ContentsAutomatic Initiate Descriptors (AIDs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130Interval Control Elements (ICEs). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135Response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145TranRate (Transaction Rate) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154UOWs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

5

Automatic Initiate Descriptors (AIDs)


Automatic Initiate Descriptors (AIDs)The Automatic Initiate Descriptors (AIDs) panel displays summary information on all the AIDs in the CICS region. It shows you the work waiting on terminals and remote systems.

The AIDs summary panel allows bottlenecks involving terminals or printers to be identified. For example, a request to start a task connected to a printer appears as an AID when the target printer is not available. If many AIDs have accumulated, response time may be adversely affected because CICS attempts to start each AID on every dispatch of the terminal control program.

The AIDs panels allow you to analyze AIDs problems, display information about a specific AID, or request that an AID be removed from the system.

Select AIDs from the Region StatusBy selecting AIDs from the Region Status panel (type S to show details) you can see a summary of all the AIDs in the CICS region.

The following figure shows the AIDs summary panel.

FIGURE 73. AIDs Summary Panel

____ Actions GoTo View Index Options Help ------------------------------------------------------------05/24/93 16:26:08 KC2R01D Automatic Initiate Descriptors (AIDs) Region: CICSPROD Fastpath: =WA Auto(60) +----------------------------------------------------------------------------+ | Total number of AIDs : 42 | +----------------------------------------------------------------------------+ Lines ___1 to 9 of 42 +-------------+----------+----------+-------------+------------+-------------+ | Request | Tran | Term | Terminal | Owning | AID | | ID | ID | ID | Status | System | Type | |-------------|----------|----------|-------------|------------|-------------| | _ DF001F8D | MSA1 | LV01 | Acq Ins | CICSPLDA | IC Init | | _ DF001F8E | MSA1 | LV46 | Acq Ins | CICSPLDA | ICP Sch | | _ DF001F8F | PRNT | PRT1 | Acq Ins | CICSPLDA | TDP Sch | | _ DF001F90 | CEMT | LV33 | Rel Ins | CICSPLDA | BMS Sch | | _ DF002F93 | CEMT | LV0 | Rel Ins | CICSPLDA | IC Init | | _ DF002F94 | CEMT | CNSA | Ins | CICSPLDA | ICP Sch | | _ DF002F95 | OUTP | PRT2 | Acq Ins | CICSPLDA | TDP Sch | | _ DF002FA3 | CSP | M046 | Acq Ins | CICSPLDA | BMS Sch | | _ FRED | MSA1 | MY03 | Ins | CICSNY01 | Rem Del | +-------------+----------+----------+-------------+------------+-------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status




Use the View pull-down to filter the contents of the AIDs summary panel by selecting Some. Sort the contents of the panel using one of the following:

n Sort by request IDn Sort by transaction IDn Sort by terminal IDn Sort by terminal statusn Sort by owning systemn Sort by AID type

Terminating AID(s)

You can terminate AIDs in your CICS region when they accumulate due to a printer, terminal, or remote connection error. The AIDs component allows you to terminate

n a single AID

n all AIDs for a terminal

n all AIDs for a transaction

Note: The action codes used in the following procedures are not case sensitive.

Terminate a Single AID

To terminate a single AID, do one of the following:

n On the AIDs summary panel, type K in the entry field next to the AID you want to kill. Then press Enter.

n On the AIDs summary panel, type / next to an AID to see the Actions pull-down. At the Actions pull-down type K or 2 in the entry field. Press Enter.

n On the AID Details panel, type A in the home position to access the Actions pull-down, then type K or 2. Press Enter.

The following Confirm Request pop-up appears when you attempt to kill a single AID. From this window you can either continue processing the request for termination (enter 1 or P), or cancel the request for termination (enter 2 or C).

FIGURE 74. Kill Confirmation Pop-up for a Single AID

+---------------------------------------------------------------+| KC2CONF Confirm Request || || Confirm kill for AID for transaction MSA1 terminal LV01 || _ 1. Process request || 2. Cancel request || || F1=Help F12=Cancel |+---------------------------------------------------------------+



Terminate All AIDs for a Terminal

To terminate all AIDs for a particular terminal, do one of the following:

n On the AIDs summary panel, type m in the entry field next to the AID you want to kill. Press Enter.

n On the AIDs summary panel, type / next to an AID and press Enter to see the Actions pull-down. On the Actions pull-down menu, type m or 3 in the entry field. Press Enter.

n On the AID Details panel, type A in the home position to access the Actions pull-down, then type m or 3. Press Enter.

The following Confirm Request pop-up appears when you attempt to kill multiple AIDs for a terminal. From this window you can either continue processing the request for termination (enter 1 or P), or cancel the request for termination (enter 2 or C).

FIGURE 75. Kill Confirmation Pop-up for Multiple AIDs (Terminal)

Terminate All AIDs for a Transaction

To terminate all AIDs for a particular transaction, do one of the following:

n On the AIDs summary panel, type n in the entry field next to the AID you want to kill. Then press Enter.

n On the AIDs summary panel, type / next to an AID and press Enter to see the Actions pull-down menu. On the Actions pull-down menu, type n or 4 in the entry field. Press Enter.

n On the AID Details panel, type A in the home position to access the Actions pull-down, then type n or 4. Press Enter.

The following Confirm Request pop-up appears when you attempt to kill multiple AIDs for a transaction. From this window you can either continue processing the request for termination (enter 1 or P), or cancel the request for termination (enter 2 or C).

+------------------------------------------------+| KC2CONF Confirm Request || || Confirm kill for all AIDs for terminal LV01 || || _ 1. Process request || 2. Cancel request || || F1=Help F12=Cancel |+------------------------------------------------+



FIGURE 76. Kill Confirmation Pop-up for Multiple AIDs (Transaction)

Note: If OMEGAMON II internal security restricts you from accessing the kill facility, a pop-up will appear indicating that you must enter the OMEGAMON II password (via the Options pull-down) to use the facility (see “Enable Authorized Commands” on page 79 for more information).

Select an AID for Details

After viewing the AIDs in the summary panel, you can select a specific AID and gain further information. To do this, enter S in the entry field next to the AID in question.

The following figure shows the AID Details panel.

FIGURE 77. AID Details Panel

+---------------------------------------------------+| KC2CONF Confirm Request || || Confirm kill for all AIDs for transaction MSA1 || || _ 1. Process request || 2. Cancel request || || F1=Help F12=Cancel |+---------------------------------------------------+

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 16:27:42 KC2R02D AID Details Region: CICSPROD Fastpath: =WAD Auto(60) +--------------------------------------+-------------------------------------+ | Request ID . . . . . . : DF00448C | _ AID address . . . . . : 06168810 | | _ Transaction ID . . . . : MSA1 | Userid . . . . . . . . : CICSUSER | | _ Supplementary data . . : n/a | Owning sysid . . . . . : TDOCS22 | | AID type . . . . . . . : IC Init | | +--------------------------------------+-------------------------------------+ +----------------------------------------------------------------------------+ | AID status : Waiting for target terminal to free up | +----------------------------------------------------------------------------+ Target Terminal Information +--------------------------------------+-------------------------------------+ | _ Terminal ID . . . . . . : 8522 | _ TCTTE address . . . . : 06161228 | | _ Active transaction ID . : CEMT | _ Task number . . . . . : 150 | | Terminal type . . . . . : LU2 | Terminal model . . . . : 2 | | Session status . . . . : Acquired | VTAM netname . . . . . : L0048522 | | Service status . . . . : Ins | Session create status : Nocreate | | Initiate status . . . . : Ati Tti | Paging status . . . . : Page | +--------------------------------------+-------------------------------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status



The AID Details panel helps you analyze the target terminal so that you can determine why the AID is delayed. On this panel, you can select the following fields:

n Transaction ID

n Supplementary data

n Terminal ID

n Active transaction ID

n TCTTE address

n Task number

For more information on the AIDs panels, see the OMEGAMON II for CICS Reference Manual.

Analyze AIDs Problems from the Region StatusYou can analyze problems for AIDs when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or the default thresholds) have been exceeded. Enter A in the entry field next to AID to view the Analyze AID Problems panel, shown in the following figure.

FIGURE 78. Analyze AID Problems Panel

This panel does not refresh on entry so you can continue to see conditions that caused a problem on the Region Status panel.

Select the Number of AIDs field to display a list of all AIDs in the system.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/14/93 16:42:31 KC2B02D Analyze AID Problems Region: CICSPROD Auto(60) +--------------------------------------+-----------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | |--------------------------------------+-----------+------------+------------| | _ Number of AIDs | 175 | 100 | 300 | +--------------------------------------+-----------+------------+------------+



Interval Control Elements (ICEs)

Interval Control Elements (ICEs)Interval control elements (ICEs) represent tasks that CICS is scheduled to start after a specified time interval or at a certain time of day. Upon expiration of this interval, CICS starts the task or creates an AID, pending the availability of some resource.

The ICEs component allows you to identify scheduled work in the system.

Through the ICE panels you can analyze ICE problems, display a summary list of all ICEs in the system, display detailed information about a specific ICE, or request that an ICE be removed from the system.

Select ICEs from the Region StatusBy selecting ICEs from the Region Status panel (enter S to show details) you can see a summary of all the ICEs in the CICS region.

The following figure shows the ICEs summary panel.

FIGURE 79. ICEs Summary Panel

Select an ICE in the Request ID column to navigate to the ICE Details panel.


Use the View pull-down to filter the contents of the ICEs summary panel by selecting Some. Sort the contents of the panel using one of the following:

n Sort by request IDn Sort by transaction IDn Sort by terminal IDn Sort by expiry timen Sort by expiry daten Sort by ICE type

____ Actions GoTo View Index Options Help ------------------------------------------------------------ 05/14/93 16:44:28 KC2R03D Interval Control Elements (ICEs) Region: CICSPROD Fastpath: =WI Auto(60)+----------------------------------------------------------------------------+

| Total number of ICEs : 2 | +----------------------------------------------------------------------------+ +-------------+----------+----------+-------------+-------------+------------+ | Request | Tran | Term | Expiry | Expiry | ICE | | ID | ID | ID | Time | Date | Type | |-------------+----------+----------+-------------+-------------+------------| | _ DF000001 | SHUT | | 19:00:00 | 05/14/93 | IC Init | | _ DF0025E4 | CRSQ | | 21:45:02 | 05/14/93 | IC Init | +-------------+----------+----------+-------------+-------------+------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status



Terminating ICE(s)

You can terminate ICEs in your CICS region when you determine that the scheduled event should not start. The ICEs component allows you to terminate

n a single ICE

n all ICEs for a particular terminal

n all ICEs for a particular transaction

Note: The action codes used in the following procedures are not case sensitive.

Terminate a Single ICE

To terminate a single ICE, do one of the following:

n On the ICEs summary panel, type K in the entry field next to the ICE you want to kill. Then press Enter.

n On the ICEs summary panel, type / next to an ICE to see the Actions pull-down and press Enter. At the Actions pull-down type K or 2 in the entry field. Press Enter.

n On the ICE Details panel, type A to access the Actions pull-down, then type K or 2. Press Enter.

The following Confirm Request pop-up appears when you use the Kill ICEs feature for a single ICE. From this window you can either continue processing the request for termination (enter 1 or P), or cancel the request for termination (enter 2 or C).

FIGURE 80. Kill Confirmation Pop-up for a Single ICE

Terminate All ICEs for a Terminal

To terminate all ICEs for a particular terminal, do one of the following:

n On the ICEs summary panel, type m in the entry field next to the ICE you want to kill. Then press Enter.

n On the ICEs summary panel, type / next to an ICE and press Enter to see the Actions pull-down. On the Actions pull-down menu, type m or 3 in the entry field. Press Enter.

n On the ICE Details panel, type A to access the Actions pull-down, then type m or 3. Press Enter.

+-----------------------------------------------+| KC2CONF Confirm Request || || Confirm kill for ICE DF001FB0 || || _ 1. Process request || 2. Cancel request || || F1=Help F12=Cancel |+-----------------------------------------------+



The following Confirm Request pop-up appears when you attempt to kill all ICEs for a terminal. From this window you can either continue processing the request for termination (enter 1 or P), or cancel the request for termination (enter 2 or C).

FIGURE 81. Kill Confirmation Pop-up for Multiple ICEs (Terminal)

Terminate All ICEs for a Transaction

To terminate all ICEs for a particular transaction, do one of the following:

n On the ICEs summary panel, type n in the entry field next to the ICE you want to kill. Then press Enter.

n On the ICEs summary panel, type / next to an ICE and press Enter to see the Actions pull-down menu. On the Actions pull-down menu, type n or 4 in the entry field. Press Enter.

n On the ICE Details panel, type A in the home position to access the Actions pull-down, then type n or 4. Press Enter.

The following Confirm Request pop-up appears when you attempt to kill all ICEs for a transaction. From this window you can either continue processing the request for termination (enter 1 or P), or cancel the request for termination (enter 2 or C).

FIGURE 82. Kill Confirmation Pop-up for Multiple ICEs (Transaction)

Note: If OMEGAMON II internal security restricts you from accessing the kill facility, a pop-up will appear indicating that you must enter the OMEGAMON II password (via the Options pull-down) to use the facility (see “Enable Authorized Commands” on page 79 for more information).

+------------------------------------------------+| KC2CONF Confirm Request || || Confirm kill for all ICEs for terminal None || || _ 1. Process request || 2. Cancel request || || F1=Help F12=Cancel |+------------------------------------------------+

+--------------------------------------------------+| KC2CONF Confirm Request || || Confirm kill for all ICEs for transaction SHUT || || _ 1. Process request || 2. Cancel request || || F1=Help F12=Cancel |+--------------------------------------------------+



Select an ICE for Details

After viewing the ICEs in the summary panel, you can select a specific ICE and gain further information for problem analysis. To do this, on the summary panel enter S in the entry field of the Request ID column next to the ICE in question.

The following figure shows the ICE Details panel.

FIGURE 83. ICE Details Panel

This panel displays detailed information for the selected ICE. For Wait and Post type ICEs, information on the waiting task is also displayed.

On this panel, you can select the following fields:

n Transaction ID

n Terminal ID

n ICE address

n Transaction ID

n Task number

For more information on the ICE panels, see the OMEGAMON II for CICS Reference Manual.

____ Actions GoTo Index Options Help ------------------------------------------------------------05/14/93 16:46:59 KC2R04D ICE Details Region: CICSPROD Fastpath: =WID Auto(60) +--------------------------------------+-------------------------------------+ | _ Transaction ID . . . . : DEGV | _ ICE address . . . . . : 00144321 | | _ Terminal ID . . . . . . : LV12 | Userid . . . . . . . . : CICS | | Expiry time . . . . . . : 16:47:00 | Timer event area . . . : None | | Expiry date . . . . . . : 05/14/93 | Request ID . . . . . . : DF001765 | | ICE type . . . . . . . : Wait | | +--------------------------------------+-------------------------------------+ +----------------------------------------------------------------------------+ | ICE status : Awaiting expiration | +----------------------------------------------------------------------------+ Waiting Task Information +--------------------------------------+-------------------------------------+ | _ Transaction ID . . . . : DEGV | _ Task number . . . . . : 123456 | | Task elapsed time . . . : 2:26:49 | Task state . . . . . : Suspend | | Suspend elapsed time . : 0:00:00 | | +--------------------------------------+-------------------------------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status



Analyze ICE Problems from the Region StatusYou can analyze problems for ICEs when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to ICE to view the Analyze ICE Problems panel, shown in the following figure.

FIGURE 84. Analyze ICE Problems Panel


Select the Number of ICEs field to display a list of all ICEs in the system.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/14/93 16:50:28 KC2B02D Analyze ICE Problems Region: CICSPROD Auto(60) +--------------------------------------+-----------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | +--------------------------------------+-----------+------------+------------| | _ Number of ICEs | 175 | 100 | 300 | |--------------------------------------+-----------+------------+------------+


Response


ResponseOMEGAMON II collects, analyzes, and displays CICS response time for predefined groups of transactions, terminals, and programs. It also collects end-to-end response time data for logical unit (LU) groups, when the End-to-End™ (ETE) feature is active.

Response time is the elapsed time difference calculated by subtracting the start time from the end time of a CICS logical unit of work. End-to-end response time is the elapsed time between the user sending a request to CICS and receiving a response at the terminal.

The Response Time component of OMEGAMON II collects response times at the element level for the previous 9 minutes of activity, and also for every time slot defined to OMEGAMON II. This provides the Response Time panels with response time details at the element level and group level for the current minute and last 8 minutes, and for the previous 24-hour period.

To collect and analyze response time data, you may define one or more response time groups and their thresholds, or you can use the predefined groups shipped with OMEGAMON II. You have the option of changing one or more groups and their thresholds permanently or only for the duration of an OMEGAMON II session. See “Defining Response Time Groups for Monitoring” on page 251for information on changing response time groups for the duration of a session, and the OMEGAMON II for CICS Configuration and Customization Guide for information on changing them permanently.

Select Response from the Region StatusBy selecting Response from the Region Status panel (enterS to show details), you display a summary of recent response times in your CICS region.

Response times can only be reviewed when the Response Time collector is active. To display or change the status of the collector, select the Response Time Collection panel, accessible through the Collection Controls item of the Options menu, and turn on collection using the New Subtask Status field. See “Response Time Collection” on page 82 for more information.

The following figure shows the Response Times summary panel.


Response


This summary display includes transaction, terminal, program, and VTAM logical unit groups for the previous 9 minutes of activity in the system. Response time outside of this 9-minute range is included in the Response Time History panel.

Enter S next to a group in the Group Name column to see the Response Time Details panel (see“Select a Response Time Group for Details” on page 142), or enter B next to a group to see the Internal Bottlenecks panel (see“Select a Response Time Group for Bottlenecks” on page 143).


Use the View pull-down to filter the contents of the Response Times summary panel by selecting Some or Problems. Sort the contents of the panel using one of the following:

n Sort by group name

n Sort by group type

n Sort by current minute

Response Times Pushbutton

The pushbutton at the bottom of the Response Times panel navigates to the Response Time History panel, which shows response times over the previous 24-hour period for the current region.

____ Actions GoTo View Index Options Help ----------------------------------------------------------- 05/24/93 15:30:34 KC2F01D Response Times Region: CICSPROD Fastpath: =WR Auto(60) S=Show details B=Bottlenecks Lines __1 to 10 of 30 +----------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+ | Group |Group| Curr| Curr| Curr| Curr| Curr| Curr| Curr| Curr| Curr| | Name | Type| Min| -1| -2| -3| -4| -5| -6| -7| -8| |----------------|-----|-----|-----|-----|-----|-----|-----|-----|-----|-----| | _ PAYROLL | Tran| 9.5| 9.1| 8.0| 8.0| 9.5| 9.3| 9.4| 11.5| 9.8| | _ DEVTRAN | Tran| 1.4| 1.5| 1.4| 1.5| 1.3| 1.2| 1.4| 1.9| 1.4| | _ DATAAPGM | Prog| 1.3| 1.5| 1.1| 1.0| 1.5| 1.3| 1.5| 1.1| 1.1| | _ NYTERMS | Term| 1.1| 1.1| 1.9| 1.2| 1.9| 1.1| 1.9| 1.9| 1.5| | _ REMOTE LUS | LU | 1.1| .9| 1.1| 1.0| 1.0| 1.2| 1.9| 1.0| 1.2| | _ APP1NODE | LU | .9| .9| 1.1| 1.6| 1.0| .9| 1.9| 1.0| 0.8| | _ ADABAPGM | Prog| .3| 1.2| 1.3| .8| .3| .5| .9| 1.0| 2.5| | _ PRODTRAN | Tran| .1| .0| .0| .1| .0| .0| .0| .0| .0| | _ PRODTERM | Term| .1| .0| .0| .0| .0| .0| .0| 1.1| 1.2| | _ TESTTERM | Term| .1| .0| .0| .0| .0| .0| .0| 1.1| 1.3| +----------------+-----+-----+-----+-----+-----+-----+-----+-----+-----+-----+ (Response Times) <Response Time History> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

Response


Select a Response Time Group for Details

After viewing the response times for the current minute through the previous 8 minutes in the Response Times summary panel, you can select a specific group name to analyze the response times for all elements within the group. To do this, enter S in the entry field next to the group name in question, then press Enter. The Response Time Details panel displays, shown in the following figure.

FIGURE 86. Response Time Details Panel

This panel displays response time in seconds for all elements within the specified group that have recorded activity for the last 9 minutes. You can enter an asterisk (*), in the Group Name field to view active elements for all groups.

For transactions, programs, and terminals, OMEGAMON II displays the internal CICS response time. For logical units, OMEGAMON IIdisplays the end-to-end response time.

You can select only transaction and terminal type elements for further detail (the Task History panel displays). Programs and logical units may not be selected.

For more information on the Response panels, see the OMEGAMON II for CICS Reference Manual.


Use the View pull-down to filter the contents of the Response Time Details panel by selecting Some or Problems. Sort the contents of the panel using one of the following:n Sort by element IDn Sort by element typen Sort by current minute

____ Actions GoTo View Index Options Help ----------------------------------------------------------- 03/22/93 08:02:44 KC2F02D Response Time Details Region: CICSPROD Auto(60) +----------------------------------------------------------------------------+ | Group name . . . . INVNTORY____ + | +----------------------------------------------------------------------------‘ Lines __1 to 8 of 19 +-------------+--------+-----+-----+-----+-----+-----+-----+-----+-----+----- | Element | Elem | Curr| -1| -2| -3| -4| -5| -6| -7| -8| | ID | Type | Min| Min| Min| Min| Min| Min| Min| Min| Min| +-------------+--------+-----+-----+-----+-----+-----+-----+-----+-----+-----| | _ ASMA | Tran | 30.4| 30.2| 31.4| 31.2| 31.7| 26.4| 27.8| 20.2| 30.4| | _ ASM1 | Tran | 4.7| | 4.8| | | 3.9| 5.7| | | | _ ASN2 | Tran | 3.9| | 3.8| | | 4.2| 4.5| | | | _ ASN1 | Tran | 3.8| | 2.7| | | 2.7| 2.8| | | | _ ASBA | Tran | 2.1| | 1.6| | | 1.5| 1.6| | | | _ ASBD | Tran | .5| | .6| | | .4| .3| | | | _ ASBE | Tran | .1| | | | | | | 1.1| | +-------------+--------+-----+-----+-----+-----+-----+-----+-----+-----+-----+ <Internal Bottlenecks> <External Contention> (Response Time Details) F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status


Response

Response Time Details Pushbuttons

Pushbuttons at the bottom of the Response Time Details panel navigate to the panels listed below.

n Internal Bottlenecksn External Contention

Select a Response Time Group for Bottlenecks

In addition to viewing the response time details for a specific group, you can also view the bottlenecks affecting a specific group. To do this, enter B next to a group name in the Group Name column of the Response Times summary panel, then press Enter. The Internal Bottlenecks panel displays.


This panel shows either all of the detected bottlenecks in the target CICS region, or just those impacting the specified group. The bottlenecks are displayed in descending bottleneck ratio order. Most resource types have an associated resource name, which is the name of the resource causing the bottleneck.

You can select a particular resource type on the panel to see bottleneck details by group. The Internal Bottlenecks Details panel displays.

For more information on Internal Bottlenecks, see the OMEGAMON II for CICS Reference Manual.

____ Actions GoTo View Index Options Help ----------------------------------------------------------- 05/24/93 16:05:50 KC2L01D Internal Bottlenecks Region: CICSPROD Fastpath: =AB Auto(60) +-----------------------------------------+---------------------------------+ | Group name . . . . . . PAYROLL_____ + | Samples taken . . . : 59 | | Collection interval : 1:00 MN | Elapsed time . . . . : 10 SEC | +-----------------------------------------+---------------------------------+ Lines ___1 to 7 of 10 +------------+------------+-----------+-------------------------------------+ | Resource | Resource | Wait | Bottleneck | | Type | Name | Type | Ratio 0.....................100 | |------------+------------+-----------+-----------+------------!--!---------| | _ RUNNING | RUNNING | CPU | 9% |----> | | _ FCIOWAIT | *TOTAL* | FILE | 6% |--> | | _ FCIOWAIT | FILEA | FILE | 4% |-> | | _ FCIOWAIT | FILEB8CH | FILE | 2% |> | | _ TSBUFFER | (NONE) | TEMPSTOR | 5% |--> | | _ PROGRAM | BIGPROG0 | LOADER | 3% |-> | | _ IRLINK | SYS2 | MRO | 1% |> | +------------+------------+-----------+-----------+-------------------------+ (Internal Bottlenecks) <External Contention> <Response Time Details> F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

Response



Use the View pull-down to filter the contents of the Internal Bottlenecks panel by selecting Some or Problems. Sort the contents of the panel using one of the following:

n Sort by resource type

n Sort by resource name

n Sort by wait type

n Sort by bottleneck ratio

Pushbuttons for Internal Bottlenecks

Pushbuttons at the bottom of Internal Bottlenecks take you to the panels listed below:

n External Contention

n Response Time Details

Analyze Response Time Problems from Region StatusYou can analyze response time problems when the Response status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to Response to view the Analyze Response Time Problems panel, shown in the following figure.

FIGURE 88. Analyze Response Time Problems Panel


Select any group to display its Response Time details.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/14/93 16:47:00 KC2B02D Analyze Response Time Problems Region: CICSPROD Auto(60) +--------------------------------------+-----------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | |--------------------------------------+-----------+------------+------------| | _ Group INVNTORY response time | 30.4s | 2.0s | 4.0s | | _ Group REMOTE LUS response time | 2.8s | 1.0s | 2.0s | +--------------------------------------+-----------+------------+------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status


Tasks

TasksThe Tasks component of OMEGAMON II allows you to monitor currently running CICS tasks and see an instantaneous display of system activity. As tasks complete, OMEGAMON II saves pertinent resource usage data for online viewing and batch reporting. (For information on batch reporting, see“Batch Reporting Methods” on page 30.) The statistical information available for analysis is collected both by CICS and OMEGAMON II.

The task analysis panels allow you to display the current workload of a CICS region and how close it is running to capacity, display information about a specific transaction, and request that a task be removed from the system.

Select Tasks from the Region StatusBy selecting Tasks from the Region Status panel (type S to show details) you can see a summary of all the tasks in the CICS region.

The following figure shows the Tasks summary panel.

FIGURE 89. Tasks Summary Panel

Note:n The % of AMXT field does not appear on the panel for CICS Version 4 and above.

n The CPU Time field is not highlighted for excluded tasks. See the GLOBAL_OPTIONS parameters section in the OMEGAMON II for CICS Configuration and Customization Guide for information on excluding tasks.

____ Actions GoTo View Index Options Help ------------------------------------------------------------ 06/30/94 16:44:47 KC2C01D Tasks Region: CICSPROD Fastpath: =WT Auto(60) +---------------------------+-----------------------+------------------------+ | All tasks . . . : 24 | Dispatchable : 0 | NonDispatchble: 24 | | _ Highest % of CMXT: 0% | _ % of MXT . : 75% | _ % of AMXT . . : 60% | +---------------------------+-----------------------+------------------------+ P=Purge K=Kill Lines 1 to 8 of 24 +------------+------+----------+-----------+----------+----------+-----------+ | Task | Tran | Facility | CPU | Task | Resource | Resource | | Number | ID | ID | Time | State | Type | Name | |------------+------+----------+-----------+----------+----------+-----------| | _ 17889 | CEDA | M376 | 0.000s | Suspend | KCCOMPAT | TERMINAL | | _ 10167 | CECI | 7A90 | 0.000s | Suspend | KCCOMPAT | TERMINAL | | _ 71 | WORX | | 7.987s | Suspend | ICWAIT | (none) | | _ 70 | WORK | 7143 | 0.000s | Suspend | KCCOMPAT | TERMINAL | | _ 63 | CEMT | 3A70 | 0.000s | Suspend | KCCOMPAT | TERMINAL | | _ 59 | CEMT | M412 | 0.000s | Suspend | KCCOMPAT | TERMINAL | | _ 39 | OSEC | | 0.002s | Suspend | (none) | (none) | | _ 38 | OSRV | | 0.002s | Suspend | (none) | (none) | +------------+------+----------+-----------+----------+----------+-----------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status

Tasks


This panel displays the current workload of the CICS address space and how close it is running to the task limits.

You can select the following fields on this panel:

n Highest % of CMXT

n % of MXT

n % of AMXT (not available in CICS Version 4 and above)

n Task Number

By analyzing the wait resource type and name you may be able to determine the existence and cause of bottlenecks that are degrading performance. For CICS/ESA wait reasons, see the IBM CICS Problem Determination Guide; for additional CICS/ESA wait reasons provided by OMEGAMON II, press F1 to see online help for the Tasks summary panel.


Use the View pull-down to filter the contents of the Tasks summary panel by selecting Some or Problems. Sort the contents of the panel using one of the following:

n Sort by task number

n Sort by transaction ID

n Sort by facility ID

n Sort by CPU time

n Sort by task state



Terminating Tasks

You can perform the following actions to terminate tasks:

n Purge task

n Force purge task

n Kill task

n Force kill task

Candle recommends trying the Purge task or Force purge task actions before you try to kill a task. Purge and Force Purge are CICS transactions and the best choices to terminate a task.

Caution

You should consider the risks of losing data integrity or terminating CICS when you choose to force purge, kill, or force kill a task. To prevent unauthorized use, OMEGAMON II is shipped with these facilities secured by default. See the OMEGAMON II for CICS Configuration and Customization Guide for more information on authorized commands.


Tasks

Purge a Task

The CICS Purge feature terminates the task you select. Termination occurs only when the system and data integrity can be maintained. You may want to consider purging a task when, for example, a task

n loopsn consumes excessive resourcesn holds locks that are preventing other tasks from runningn causes a short-on-storage condition

To terminate a task, do one of the following:

n On the Tasks summary panel, type P in the entry field next to the task you want to purge. Then press Enter.

n On the Tasks summary panel, type / next to the task to see the Actions pull-down. On the Actions pull-down, type P or 2. Then press Enter.

n On the Task Details panel, type A in the home position to access the Actions pull-down, then type P or 2. Press Enter.

When you specify a purge action, a confirmation pop-up window will be presented before the task is purged. From this window, you can either continue processing the request for termination (enter1 or P), or cancel the request for termination (enter 2 or C).

The following Confirm Request pop-up appears when you specify a purge action.

FIGURE 90. Purge Confirmation Pop-up for a Single Task

Force Purge a Task

Use the Force purge action to initiate the immediate termination of the selected task, even when it is not certain that system and data integrity can be maintained.

Important

If you select this option, data integrity is not guaranteed.

+------------------------------------+| KC2CONF Confirm Request || || Confirm purge of task 71 (WORX) || || _ 1. Process Request || 2. Cancel Request || || F1=Help F12=Cancel |+------------------------------------+

Tasks


To force purge a task, do one of the following:

n On the Tasks summary panel, type O in the entry field next to the task you want to kill. Then press Enter.

n On the Tasks summary panel, type / next to the task to see the Actions pull-down. On the Actions pull-down, type an O or 3. Then press Enter.

n On the Task Details panel, type A in the home position to access the Actions pull-down, then type O or 3. Press Enter.

When you specify a force purge action, a confirmation pop-up window will be presented before the task is purged. From this window, you can either continue processing the request for termination (enter 1 or P), or cancel the request for termination (enter 2 or C).

The following Confirm Request pop-up appears when you specify a force purge action.

FIGURE 91. Force Purge Confirmation Pop-up for a Single Task

Kill a Task

Before killing a task, try using the Purge or Force Purge actions to terminate a task. The CICS Kill feature terminates the task you select. Termination occurs only when the system and data integrity can be maintained.

To kill a task, do one of the following:

n On the Tasks summary panel, type K in the entry field next to the task you want to kill. Then press Enter.

n On the Tasks summary panel, type / next to the task to see the Actions pull-down. On the Actions pull-down, type K or 4. Then press Enter.

n On the Task Details panel, type A in the home position to access the Actions pull-down, then type K or 4. Press Enter.

When you specify a kill action, a confirmation pop-up window will be presented before the task is killed. From this window, you can either continue processing the request for termination (enter 1 or P), or cancel the request for termination (enter 2 or C).

The following Confirm Request pop-up appears when you specify a kill action.

+----------------------------------------+| KC2CONF Confirm Request || || Confirm force purge of task 71 (WORX) || || _ 1. Process Request || 2. Cancel Request || || F1=Help F12=Cancel |+----------------------------------------+


Tasks

FIGURE 92. Kill Confirmation Pop-up for a Single Task

Force Kill a Task

Before using force to kill a task, try the Purge, Force Purge, or Kill actions to terminate the task. The Force Kill action initiates the immediate termination of the selected task, even when it is not certain that system and data integrity can be maintained.

To force kill a task, do one of the following:

n On the Tasks summary panel, type F. in the entry field next to the task you want to kill. Then press Enter.

n On the Tasks summary panel, type / next to the task to see the Actions pull-down. On the Actions pull-down, type an F or 5. Then press Enter.

n On the Task Details panel, type A in the home position to access the Actions pull-down, then type F or 5. Press Enter.

When you specify a force kill action, a confirmation pop-up window will be presented before the task is killed. From this window, you can either continue processing the request for termination (enter 1 or P), or cancel the request for termination (enter 2 or C).

The following Confirm Request pop-up appears when you specify a force kill action.

FIGURE 93. Force Kill Confirmation Pop-up for a Single Task

Important

If you select this option, data integrity is not guaranteed.

+------------------------------------+| KC2CONF Confirm Request || || Confirm kill of task 71 (WORX) || || _ 1. Process Request || 2. Cancel Request || || F1=Help F12=Cancel |+------------------------------------+

+----------------------------------------+| KC2CONF Confirm Request || || Confirm force kill of task 71 (WORX) || || _ 1. Process Request || 2. Cancel Request || || F1=Help F12=Cancel |+----------------------------------------+

Tasks


Abends Issued After Task Termination

Depending on your release of CICS and what state the task is in, OMEGAMON II issues an OCKC, S0C6, or EIKI abend when a task is purged or killed.OMEGAMON II issues these abends under the conditions listed in the following table.

Select a Task for Details

OMEGAMON II collects detailed task statistics using exit facilities in CICS/MVS. For CICS/ESA, OMEGAMON II uses exit facilities and the CICS Monitoring Facility.

From the Task summary panel, you can select a specific task for further analysis. To do this, enter S in the entry field next to the task number in question and press Enter. The Task Details panel, shown in the following figure, displays.

Abend CICS Version Task Condition

OCKC CICS/MVS Suspended tasks; KCP not waiting

S0C6 CICS/MVS Task currently running or KCP waiting on VSAM I/O

EIKI CICS/ESA Tasks waiting, but not in VSAM I/O

S0C6 CICS/ESA Currently running task (QR, RO, CO TCB only; the FEPI TCB, ZS, is not checked.)

-- CICS/ESA When a task is waiting on file I/O, OMEGAMON II issues a force purge


Tasks


Note: The CPU Time field is not highlighted for excluded tasks. See the GLOBAL_OPTIONS parameter section in the OMEGAMON II for CICS Configuration and Customization Guide for information on excluding tasks.

This panel displays detailed information about a CICS task. You can select the following fields:

n Task number

n Facility ID

n CICS transaction ID

n First CICS program ID

n Current CICS program ID

Task Details Pushbuttons

Pushbuttons at the bottom of Task Details take you to the panels listed below.

This Pushbutton: Leads to this Panel:

Addresses Task Addresses

Files Task File Statistics

Remote Task Remote Information

____ Actions GoTo Index Options Help ------------------------------------------------------------ 06/30/94 16:45:16 KC2C02D Task Details Region: CICSPROD Fastpath: =WTD Auto( 60) +-------------------------------------+--------------------------------------+ | Task number . . . . . 52___ + | Transaction ID . . . . : BURN | | _ Facility ID . . . . : M552 | _ CICS transaction ID . : BURN | | Facility type . . . : Term | Originating tran ID . : BURN | | Task state . . . . . : RUNNING | _ First CICS program ID : BURNA100 | | Task queue . . . . . : Executbl | _ Current CICS program ID: BURNA100 | | Resource type . . . : RUNNING | | | Resource name. . . . : RUNNING | Storage used above 16M : 17K | | Userid . . . . . . . : CICSUSER | Storage used below 16M : 2K | | _EXEC CICS command . : x’100A’ | | | Attach time. . . . . : 12:24:16 | Purgeable suspend . . : Yes | | CPU time . . . . . . : 2.767s | Purgeable status . . : No purge | | Task elasped time. . : 15.771 | Suspend timeout due. . : None | | Time of suspend . . : 16:45:00 | Suspend type . . . . . : Suspend | | Time in suspend . . : 0:00:15 | UOW state . . . . . . : Inflight | | | | +-------------------------------------+--------------------------------------+(Details) <Addresses> <Files> <Remote> <Statistics> <Storage> <Timings><GoTo DB2> <GoTo Remote CICS> <Umbrella> <FEPI>F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action BarF11=Print F15=Region Status

Tasks


Note: Pushbuttons that allow transplex navigation (for example, GoTo DB2, GoTo DBCTL, and GoTo Remote CICS) appear on the Task Details panel only when the following conditions are met:

– You are running OMEGAMON II under OMEGAVIEW. with the appropriate level of maintenance.

– For the GoTo DB2 and GoTo DBCTL pushbuttons, the task is currently processing a request in DB2 and DBCTL.

See “Transplex Navigation and Session Switching” on page 289 for more information on transplex navigation.

For more information on the Task panels, see the OMEGAMON II for CICS Reference Manual.

Analyze Task Problems from Region StatusYou can analyze problems for Tasks when the Tasks status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to Tasks to view the Analyze Task Problems panel, shown in the following figure.

Statistics Task Statistics Information

Storage Task Storage

Timings Task Time Analysis

Umbrella Task Umbrella Data

FEPI (Appears if you use FEPI with CICS)

Front End Programming Interface

Task Terminal Task Terminal Statistics



Tasks

FIGURE 95. Analyze Task Problems Panel


You may select any of the problems listed to display the Tasks panel.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/14/93 16:47:00 KC2B02D Analyze Task Problems Region: CICSPROD Auto(60) +--------------------------------------+-----------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | |--------------------------------------+-----------+------------+------------| | _ Class 7 at CMXT limit | Yes | No | Yes | | _ Percentage of CMXT 7 limit | 120% | 80% | 90% | | _ Percentage of MXT limit | 75% | 70% | 85% | +--------------------------------------+-----------+------------+------------+


TranRate (Transaction Rate)


TranRate (Transaction Rate)The transaction rate is a good indicator of CICS system throughput. OMEGAMON II calculates the number of CICS transactions executed per second or per minute, depending on the transaction rate unit you set previously through the Transaction Rate Thresholds panel.

Select Transaction Rates from Region StatusBy selecting TranRate from the Region Status panel (type S to show details) you can see the total transaction attach rate and individual transaction dispatch rates for the current 1-minute interval.

The following figure shows the Transaction Rates panel.

FIGURE 96. Transaction Rates Panel

You can use this panel to monitor the activity level in CICS.

In the figure, the scale on the graph varies depending on the setting of the critical transaction rate high threshold. When you set this threshold in the Transaction Rates Thresholds pop-up, excessive transaction rates are flagged on the Transaction Rates and Region Status panels, and consequently in OMEGAVIEW.

None of the fields on this panel can be selected to navigate to any other panel.

Transaction Interval

The transaction rates displayed are not for the minute immediately preceding the last time the panel was updated. Rather, the rates are based on the number of transactions that have been dispatched since the current minute interval began. At the end of the current minute interval, all rate counters are reset to zero and the rates are recalculated.

For transactions that average less than 60 per minute, you may want to change the transaction rate unit setting from per second to per minute. To change the unit setting, press

____ GoTo View Index Options Help ------------------------------------------------------------ 05/14/93 16:53:16 KC2Y01D Transaction Rates Region: CICSPROD Fastpath: =WN Auto(60) +-----------+----------------------------------------------------------------+ | Tran ID | Rate 0...............................................100 | |-----------+------------+!!------------------!-----------------!------------| | Total | 49 /sec |--------------------> | |-----------+------------+--------------------!-----------------!------------| | DEGV | 20 /sec |----------> | | PAYR | 9 /sec |----> | | MSTR | 8 /sec |----> | | DTRN | 7 /sec |---> | | PILT | 5 /sec |--> | +-----------|------------+---------------------------------------------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print

F15=Region Status


TranRate (Transaction Rate)

F4 on the Transaction Rate Unit field of the Transaction Rates Threshold pop-up to toggle between second and minute, then press Enter.


Use the View pull-down to filter the contents of the Transaction Rates panel by selecting Some. Sort the contents of the panel using one of the following:

n Sort by transaction ID

n Sort by transaction rate

Analyze Transaction Rate Problems from Region StatusYou can analyze problems for Transaction Rate when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to TranRate to view the Analyze Transaction Rate Problems panel, shown in the following figure.

FIGURE 97. Analyze Transaction Rate Problems Panel

Note: This figure shows all the items that can appear on the panel, and is not a typical panel.


Select any problem listed to display the Transaction Rates panel.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/14/93 16:54:07 KC2B02D Analyze Transaction Rate Problems Region: CICSPROD Auto(60) +--------------------------------------+-----------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | |--------------------------------------+-----------+------------+------------| | _ Transaction rate low | 10/s | 20/s | 5/s | | _ Transaction rate high | 300/s | 100/s | 200/s | +--------------------------------------+-----------+------------+------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

UOWs


UOWs You can access the information available in the CICS recovery manager (CICS/ESA Version 5.1.0). You can inquire about the Unit of Work (UOW) management of a CICS region. OMEGAMON II for CICS displays the workload, UOWs on the Region Status panel, and supplies four thresholds to track and display information about UOWs:

n Shunted UOWs

n Total time UOWs shunted

n Forced heuristic decisions

n Enqueue failures per UOW

You can use the path from the UOWs workload to

n identify shunted UOW problems, analyzing the shunted UOWs and total time UOWs shunted thresholds

n identify UOW enqueue failures

n identify forced heuristic decisions

User authority requiredFor CUA function level security, the resource cicsname.KC2.MEM.CEMT controls user authorization for the UOW actions. For menu system security, user authorization for the UOW actions is controlled by restricting access to the CMT command.

Setting thresholdsTo reset your UOW threshold settings

n From the Region Status panel, enter L next to the UOWs workload.

Result: The UOW Thresholds panel displays. Modify existing settings as required.

Identifying Shunted UOW ProblemsYou can display an overview of the recovery manager and all the UOWs in the region that is currently being managed. An authorized user can perform these actions against shunted UOWs:

n Force commit

n Force backout

n Force defined action

If a shunted UOW causes a problem by, for example, holding a lock resulting in enqueue failures, you can use the COMMIT or BACKOUT action to commit or back out the shunted UOW. To force a backout or commit as specified in the transaction definition for the UOW, use the FORCE action.


UOWs

Analyze UOW Problems

To access the Analyze UOW Problems panel:

n From the Region Status panel, enter A next to UOW.

FIGURE 98. Analyze UOW Problems Panel

List UOWS

To list UOWs, access the UOWs panel:

n From the Analyze UOW Problems panel, enter S next to Shunted UOWs or Total time UOWs shunted.

Result: The UOWs panel, filtered for shunted UOWs and sorted in descending shunt time, is displayed.

_____ Actions GoTo Index Options Help------------------------------------------------------------ 09/03/96 11:00:31KC2B02D Analyze UOW Problems Region: CICSPROD Auto(Off) +--------------------------------------+-----------+-------------------------+| | | Thresholds || Problem Description | Value | Warning Critical ||--------------------------------------+-----------+------------+------------|| - Enq failures for AD6A74A894C0A001 | 2 | 0 | 1 || - Total time UOWs shunted (minutes) | 21 | 0 | 1 || - Forced heuristic decisions | 2 | 0 | 1 || - Shunted UOWs | 1 | 0 | 1 |+--------------------------------------+-----------+------------+------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

UOWs


FIGURE 99. UOWs Panel Filtered for Shunted UOWs

This panel displays an overview of the Recovery Manager domain and all the UOWs in the region. From this panel, you can:

n Enter C, B, or F next to the UOW ID for which you want to force an action.

n Enter S next to the UOW ID for which you want more detail.

n Enter S next to the Highest enqueue failures field to display the UOW enqueues panel. Go to“Identifying UOW Enqueue Failures” on page 160 for more information.

n Use the UOW Statistics pushbutton to display UOW statistics. Go to“Identifying Forced Heuristic Decisions” on page 161 for more information about this panel.

UOW Details

Action code S on the UOWs panel accesses this panel which provides detailed information about a particular UOW known to the recovery manager.

_____ Actions GoTo View Index Options Help ----------------------------------------------------------- 10/26/96 11:00:31 KC2W02D UOWs Region: CICSPROD Fastpath: =WU Auto(Off) +--------------------------------------+-------------------------------------+ | _ Highest enqueue failures: 2 | Shunted UOWs . . . . . : 1 | | Forced decisions . . . : 1 | Total time UOWs shunted: 22m | +--------------------------------------+-------------------------------------+ C=Commit B=Backout F=Force +--------------------+-----------+-------+-----------+-----------+-----------+ | UOW | UOW | Tran | Wait | Time | Enqueue | | ID | State | ID | State | Shunted | Failures | |--------------------+-----------+-------+-----------+-----------+-----------| | _ AC8EFDB7DA72F601 | Indoubt | AUPD | Shunted | 22m | 2 | +--------------------+-----------+-------+-----------+-----------+-----------+ (UOWs) <UOW Statistics> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status


UOWs

FIGURE 100. UOW Details Panel

From this panel, you can

n Use the UOW Enqueues pushbutton, if displayed, to view the UOW Enqueues panel. Go to“Identifying UOW Enqueue Failures” on page 160 for more information.

n Enter S next to UOW address to display the contents of storage at that address.

n Use the UOW Links pushbutton, if displayed, to display information about links. Go to “UOW Links” on page 159 for more information about the UOW Links panel.

UOW Links

The UOW Links panel displays a list of other CICS systems or resource managers, when applicable, that are involved in a unit of work. A link is the association between a UOW and a connection to a remote system or resource manager.

To access UOW Links:

n Use the UOW Links pushbutton from the UOW Details panel.

Result: If a connection has been discarded, you can delete a link by entering D next to the Link ID.

_____ Actions GoTo Index Options Help ----------------------------------------------------------- 10/26/96 11:00:31 KC2W03D UOW Details Region:CICSPROD Fastpath: =WUD Auto(Off) +--------------------------------------+-------------------------------------+ | UOW ID . . . . AC8EFDB7DA72F601 + | Originating task number: 66 | | Status . . . : Indoubt | Originating tran ID . : AUPD | | _ UOW address . : 09497970 | Originating terminal ID: M371 | | Netname . . . : ATERM371 | Originating userid . . : CICSUSER | | | | | UOW shunted . : Yes | Indoubt timeout intervl: 1441m | | Wait state . : Shunted | Indoubt timeout effctve: Yes | | | First UOW for tran . . : Yes | | Age . . . . . : 34m | Force purge protected : Yes | | | Transaction suspended : No | |--------------------------------------+-------------------------------------| | NetUOWid(char): USCACO01.ATERM371.....6.. | | _NetUOWid(hex) : EECCCDFF4CECDDFFF8FBD7F00 | | 42313601B13594371ED7A2601 | +----------------------------------------------------------------------------+ (UOW Details) <UOW Links> <UOW Enqueues> F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

UOWs


FIGURE 101. UOW Links Panel

Identifying UOW Enqueue FailuresYou can display information about locks held by a shunted UOW. If the unit of work is shunted in-doubt, all locks are retained. If it is shunted because of a commit or backout failure, only the locks on the failed resources are retained. Retained locks cause other transactions to receive a condition that usually results in an abend (locked response), while other lock conflicts cause the transaction to suspend.

If a shunted UOW causes a problem by, for example, holding a lock resulting in enqueue failures, you can use the COMMIT or BACKOUT action to commit or back out the shunted UOW. To force a backout or commit as specified in the transaction definition for the UOW, use the FORCE action.

UOW Enqueues

To access information about UOW Enqueue failures:

1. From the Region Status panel, enter A next to UOW to display the Analyze UOW Problems panel.

2. Enter S next to the Enq failures problem description.

_____ Actions GoTo View Index Options Help------------------------------------------------------------ 09/04/96 10:15:10KC2W04D UOW Links Region: CICSPRODFastpath: =WUL Auto(Off)+----------------------------------------------------------------------------+| UOW ID . . AD6B9549CA9D7400 + |+----------------------------------------------------------------------------+ D=Delete+-------------------+------------------+------------------+------------------+| Link ID | Link | Client | Role ||-------------------+------------------+------------------+------------------|| _ 01020000 | DFHINDSP | IND | Coordinator |+-------------------+------------------+------------------+------------------+ <UOW Details> (UOW Links) <UOW Enqueues> F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status


UOWs

FIGURE 102. UOW Enqueues Panel

This panel displays the locks held by a shunted UOW:

Fields display on this panel as follows:

Identifying Forced Heuristic DecisionsYou can display the UOW statistics panel to view statistics for the Recovery Manager domain. This panel provides a summary of the number of times heuristic decisions have been applied to resolve in-doubt UOWs. To prevent data integrity exposures, it is recommended that you avoid forced heuristic decisions, when possible.

Type Resource type for which the lock is held.

Fails When highlighted, the item exceeds the enqueue failures per UOW threshold.

Dataset Dataset name and record identifier.

ExecENQ EXEC enqueue argument.

AddrExecENQ Address of EXEC enqueue argument.

File File name and record identifier.

TDQueue TD queue name and FROMQ or TOQ.

TSQueue TS queue name.

Non Default Varies.

_____ Actions GoTo View Index Options Help------------------------------------------------------------ 09/04/96 10:36:00KC2W05D UOW Enqueues Region: CICSPRODFastpath: =WUQ Auto(Off)+----------------------------------------------------------------------------+| UOW ID . . AD6B9549CA9D7400 + |+----------------------------------------------------------------------------+ +---------------+--------------------------------------------+-------+-------+| Type | Resource | Qual | Fails ||---------------+--------------------------------------------+-------+-------|| _ TDQueue |TDQNAME | | 1 || _ File |FILENAME | KEYFLD| 0 |+---------------+--------------------------------------------+-------+-------+ <UOW Details> <UOW Links> (UOW Enqueues) F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

UOWs


UOW Statistics

To access UOW Statistics:

1. From the Region Status panel, enter A next to UOW to display the Analyze UOW Problems panel.

2. From the Analyze UOW Problems panel, enter S next to Forced heuristic decisions.

FIGURE 103. UOW Statistics Panel

This panel displays statistics from the Recovery Manager domain.

For more information about enqueue failures, enter S in the input field to display the UOW Enqueues panel.

_____ Actions Goto Index Options Help ------------------------------------------------------------ 08/21/96 11:00:05 KC2W01D UOW Statistics Region:CICSPROD Fastpath: =WUS Auto(Off) +--------------------------------------+--------------------------------------+ | _ Highest enqueue failures: 2 | Shunted UOWs . . . . . : 1 | | Forced decisions . . . : 1 | Total time UOWs shunted: 33m | | Forward commits . . . . : 27 | Backward commits . .. : 3 |+--------------------------------------+--------------------------------------+

Forced Heuristic Decisions +--------------------------------------+--------------------------------------+ | Forced by Reason | Forced by UOW Client | |--------------------------------------+--------------------------------------| | Transaction definition : 0 | Transient data . . . . : 0 | | Timeout . . . . . . . . : 1 | LU6.1 . . . . . . . . : 0 | | Operator . . . . . . . : 0 | MRO . . . . . . . . . : 0 | | Other . . . . . . . . . : 0 | RMI . . . . . . . . . : 0 | | | Other . . . . . . . . : 0 | +--------------------------------------+--------------------------------------+ <UOWs> (UOW Statistics) F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status PA1=Switch

Monitoring Resources 163

Monitoring Resources

IntroductionThe Resources portion of the Region Status panel lists CICS resources that you can select for further information on system performance. When a status bar indicates a warning or critical condition, you may select it to display a problem analysis panel.

The Resources portion of the panel gives you information such as

n how much CPU time each task is using

n storage usage and storage problems for the CICS region

n response times for DASD

n file usage

The following sections describe each component in the Resources portion of the Region Status panel.

Chapter ContentsCPU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164DASD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167DB2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170DBCTL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173DL/I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177Journals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182Local Shared Resources (LSR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189MRO/ISC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192Paging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195Storage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Tapes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201TempStor (Temporary Storage). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204TranData (Transient Data) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208Web Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213TCP/IP Socket Activity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214

6

CPU


CPUSelecting CPU from the Region Status panel (enter S to show details) displays the CPU Rates panel, which shows the CPU consumption for all tasks. The following figure shows the panel.

FIGURE 104. CPU Rates Panel

Note: The CPU Time field is not highlighted for excluded tasks. See the GLOBAL_OPTIONS parameter section in the OMEGAMON II for CICS Configuration and Customization Guide for information on excluding tasks.

See CPU Usage for the CICS RegionThe CPU Rates panel shows current CPU usage for this CICS region. At the top, you can see task control block (TCB) usage, system request block (SRB) usage, and current overall CPU usage for the region (TCB and SRB added together). Current tasks are listed in descending CPU time order. For each task, you can see the task number, transaction ID, and CPU usage.

This panel allows you to identify those tasks using excessive or unusually high amounts of CPU time and which may possibly be looping. If a CICS region is using excessive CPU, the tasks are displayed in descending order of CPU usage.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:23:22 KC2X01D CPU Rates Region: CICSPROD Fastpath: =RC Auto( 60)+----------+-----------------------------------------------------------------+| | % CPU Util 0................................................100||----------+-------------+--!--!-----------------------------!--!------------|| TCB | 55% |-------------------------> || SRB | 1% |> || Total | 56% |--------------------------> |+----------+-------------+---------------------------------------------------+ Tasks by CPU Consumption Lines 1 to 5 of 21+------------+---------+-----------------------------------------------------+|Task Number | Tran ID | CPU Time 0.......................................3 ||------------+---------+-----------+------!-------------------!--------------|| _ 52 | BURN | 2.767s |-----------------------------------> ||_ 19 | CSSY | 1.925s |-------------------------> ||_ 216 | DECV | 1.395s |-----------------> || _ 27 | CSNC | 0.093s |> || _ 4 | CSNE | 0.049s |> |+------------+---------+-----------+-----------------------------------------+ (CPU) <Paging> <ASID> <Job> <TCBs> <Modules> <MVS Resources> <XRF> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd


CPU

CPU Rates Pushbuttons

Pushbuttons at the bottom of CPU Rates navigate to the following panels:

For more information on each of the above panels, see the OMEGAMON II for CICS Reference Manual.

Select a Task for Details

You may obtain details of any task by selecting the appropriate Task Number field on the CPU Rates panel. The Task Details panel displays.

At the Task Details panel, you can purge a task that you suspect is looping. See “Terminating Tasks” on page 146 for procedure on how to do this.

For more information on all the CPU panels, see the OMEGAMON II for CICS Reference Manual.

Analyze CPU Problems from the Region StatusYou can analyze problems concerning CPU usage when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to CPU to view the Analyze CPU Problems panel, shown in the following figure.

This Pushbutton: Leads to This Panel:Paging Working Set Size and Paging RatesASID CICS Address Space InformationJob CICS Job InformationTCBs CICS Address Space TCBsModules MVS Loaded ModulesMVS Resources MVS ResourcesXRF XRF Information

CPU


FIGURE 105. Analyze CPU Problems Panel


Select any problem to display the CPU Rates panel.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 21:05:15 KC2B02D Analyze CPU Problems Region: CICSPROD Auto( 60) +--------------------------------------+-----------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | |--------------------------------------|-----------|------------+------------| | _ Low CPU rate | 1% | 10% | 5% | +--------------------------------------+-----------+------------+------------+



DASD

DASDBy selecting DASD from the Region Status panel (enter S to show details), you display the CICS DASD Performance panel.

See How Devices Respond to CICS DemandsOn the CICS DASD Performance panel, you can obtain information about DASD devices allocated to CICS. You can use this information to observe how devices respond to the demands of CICS as it competes with the rest of the jobs in the system. The panel that displays after you select DASD is shown in the following figure.

FIGURE 106. CICS DASD Performance Panel

This panel lists DASD devices by volume in descending response time order. The response time is measured in milliseconds. The panel also displays the percent&hyphen.busy measurement (in graphical form) for each device. The number of CICS DASDs that are dropped ready or that are not responding are also included. You can get more information for CICS DASDs that are dropped ready or not responding by entering S next to the fields in the top box of the panel. The CICS DASD Status panel then displays.


You can filter the contents of the CICS DASD Performance panel by selecting Some or Problems on the View pull-down menu. Sort the panel using the following selections:n sort by devicesn sort by volumen sort by response timen sort by percent busy

____ Actions GoTo View Index Options Help ------------------------------------------------------------ 05/24/93 15:29:55 KC2K01D CICS DASD Performance Region: CICSPROD Fastpath: =RD Auto(60) +------------------------------------+---------------------------------------+ | _ CICS DASD not ready . . : 0 | _ CICS DASD not responding : 0 | +------------------------------------+---------------------------------------+ Lines ___1 to 9 of 209 +--------+------+-------------------------------+----------------------------+ | Device |Volume|Response 0.................60 |%Busy 0.................100 | |--------+------+---------+------!----!---------+-------+-----!--!-----------| | _ 0328 |OMON24| 34 |----------> | 2% |> | | _ 031C |OMON23| 33 |----------> | 30% |-------> | | _ 0319 |OMON30| 31 |---------> | 1% |> | | _ 0338 |OMON20| 21 |------> | 5% |> | | _ 0153 |OMON29| 17 |----> | 0% |> | | _ 014B |OMON27| 12 |---> | 3% |> | | _ 0169 |TSO002| 9 |--> | 0% |> | | _ 030C |PPSMP3| 7 |-> | 0% |> | +--------+------+---------+---------------------+-------+--------------------+ (Performance) <I/O Rate> <Statistics> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status

DASD


CICS DASD Performance Pushbuttons

Pushbuttons available at the bottom of the CICS DASD Performance panel are listed below.

Select a Device for Details

To see more information for a particular device, enter S next to an item listed in the Device column on the CICS DASD Performance panel. Doing this navigates to the DASD Details for a Device panel, which allows you to see a breakdown of DASD response time. By pressing F4 at either the Device or Volume field on this panel, you can see a list of devices or volumes from which to select.

Note: If both the Device and Volume fields are entered and there is a discrepancy, Device takes precedence over Volume.

The following figure shows the DASD Details for a Device panel.

FIGURE 107. DASD Details for a Device Panel

Entering S in the CICS Open DCBs field on the DASD Details for a Device panel navigates to the CICS Datasets on a DASD Volume panel.

For more information on the DASD panels, see the OMEGAMON II for CICS Reference Manual.

This Pushbutton: Leads to This Panel:I/O Rate DASD I/O RateStatistics DASD Statistics

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:29:58 KC2K05D DASD Details for a Device Region: CICSPROD Fastpath: =RDE Auto(60) +-------------------------------------+--------------------------------------+ | Device . . . . . . . . . 0156_+ | Volume . . . . . . . . . OMON30_+ | | Total open DCBs . . . : 95 | Total I/Os per second . : .6 | | _ CICS open DCBs . . . . : 8 | CICS I/Os per second . : 0 | | I/O queue . . . . . . : 0 | % busy . . . . . . . . : 35% | | DASD not ready . . . : No | DASD not responding . . : No | | Status . . . . . . . . : Online | Dynam. I/O configuration: Static | | Type . . . . . . . . . : 3380 | Response time period . : 4:13 MN |+-------------------------------------+--------------------------------------+

+--------------+-------------------------------------------------------------+ | Component | Response 0...............................................60 | |--------------+----------+-------------------!-----------!------------------| | IOS queue | 20ms|----------------> | | Pending | 25ms|--------------------> | | Connect | 7ms|-----> | | Disconnect | 25ms|--------------------> | | Total | 79ms|------------------------------------------------>>| +--------------+----------+--------------------------------------------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status


DASD

Analyze DASD Problems from the Region StatusYou can analyze DASD problems when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to DASD to view the Analyze DASD Problems panel, shown in the following figure.

FIGURE 108. Analyze DASD Problems Panel


Selecting Unit Not Responding and DASD Dropped Ready problems will display the CICS DASD Status panel. Selecting Response Time and DASD Busy problems will display the DASD Details panel for the device.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:30:15 KC2B02D Analyze DASD Problems Region: CICSPROD Auto(60) +--------------------------------------+-----------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | +--------------------------------------+-----------+------------+------------+ | _ Response time for 0328 (OMON24) | 34ms | 30ms | 40ms | | _ Response time for 031C (OMON23) | 33ms | 30ms | 40ms | | _ Response time for 0319 (OMON30) | 31ms | 30ms | 40ms | +--------------------------------------+-----------+------------+------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

DB2


DB2By selecting DB2 from the Region Status panel (enter S to show details), you display the DB2 Activity panel.

Determine the DB2 Attachment Status and See Transaction StatisticsOn the DB2 Activity panel, you can learn the current status of the DB2 attachment to the CICS region and see statistical information for transactions that are currently accessing DB2 databases. The following figure shows the panel that displays.

FIGURE 109. DB2 Activity Panel

On this panel, you can select the following fields:

n Active MVS subtasksn All the error messages destinationsn Statistics destinationFor information on each field and on all DB2 panels, see the OMEGAMON II for CICS Reference Manual.

____ Actions GoTo View Index Options Help ----------------------------------------------------------- 05/24/93 15:30:59 KC2I11D DB2 Activity Region: CICSPROD Fastpath: =RB Auto(60) +--------------------------------------+---------------------------------------+| DSNCRCT name . . . . . : DSNCRCTE | CICS authorization name: CICS17AA || _ Active MVS subtasks . . : 1 | DB2 subsystem name . . : DB2 || Maximum threads . . . . : 8 | Thread purge interval : 30 seconds || _ Error MSG dest ID 1 . . : CSMT | Trace ID 1 . . . . . . : 192 || _ Error MSG dest ID 2 . . : CSMT | Trace ID 2 . . . . . . : 193 || _ Error MSG dest ID 3 . . : CSMT | Trace ID 3 . . . . . . : 194 || _ Statistics destination : ABCD | DB2 attached at shutdwn: Yes |+--------------------------------------+---------------------------------------+ Transactions with Active Threads Lines __1 to 3 of 21 +---------+---------+--------+----------+------------+-----------+-------------+| Tran | Number | % of | % of | Max Active | % Threads | % Threads || ID |of Calls | Waits | Aborts | Threads | Used HWM | In Use ||---------+---------+--------+----------+------------+-----------+-------------|| _ DSL3 | 100 | 0% | 2% | 5 | 10% | 30% || _ DSNC | 8 | 12% | 0% | 2 | 4% | 2% || _ POOL | 16 | 80% | 12% | 5 | 38% | 67% |+---------+---------+--------+----------+------------+-----------+-------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status


DB2


Use the View pull-down to filter the contents of the DB2 Activity panel by selecting Some or Problems. Sort the contents of the panel using one of the following selections:

n Sort by transaction IDn Sort by number of callsn Sort by % of waitsn Sort by % of abortsn Sort by max. active threadsn Sort by % threads used HWMn Sort by % threads in use

Select a Transaction for Details

Each field in the Tran ID column on the DB2 Activity panel is selectable and navigates to the DB2 Transaction Details panel. The following figure shows that panel.

FIGURE 110. DB2 Transaction Details Panel

This panel shows details for a specific transaction. None of the fields on the panel is selectable. You can, however, overtype the Transaction ID field. Press F4 at the field to see a list of the available IDs.

____ GoTo Index Options Help ----------------------------------------------------------- 05/24/93 15:31:09 KC2I12D DB2 Transaction Details Region: CICSPROD Fastpath: =RBD Auto(60) +--------------------------------------+-------------------------------------+ | Transaction ID . . . . . DSL3 + | Entry type . . . . . . : TXID | | Plan name . . . . . . . : DSN8CH13 | Plan exit name . . . . : EXITPGM3 | | Thread TCB priority . . : Low | Thread wait . . . . . : Pool | | Rollback on deadlock . : No | | |--------------------------------------+-------------------------------------| | Authorization options . : (User,Term,*) | +----------------------------------------------------------------------------+ +--------------------------------------+-------------------------------------+ | Calls . . . . . . . . . : 100 | % of threads in use . : 30% | | % of waits . . . . . . : 0% | Maximum active threads : 5 | | % of aborts . . . . . . : 2% | Thread subtasks started: 2 | | Authorizations . . . . : 0 | % of threads used HWM : 10% | | Commits . . . . . . . . : 17 | Maximum threads . . . : 8 | | RO commits . . . . . . : 12 | | +--------------------------------------+-------------------------------------+ F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

DB2


Analyze DB2 Problems from the Region StatusYou can analyze problems for DB2 when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to DB2 to view the Analyze DB2 Problems panel, shown in the following figure.

FIGURE 111. Analyze DB2 Problems Pane


Select any problem listed on this panel to see the DB2 Transaction Details panel.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:31:18 KC2B02D Analyze DB2 Problems Region: CICSPROD Auto(60) +-------------------------------------+------------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | |-------------------------------------+------------+------------+------------| | _ DB2 % threads in use for tran 2DB2| 95% | 70% | 90% | | _ Tran QBCD % aborts for threads | 45% | 40% | 40% | | _ Tran 2DBX % waits for threads | 55% | 50% | 50% | +-------------------------------------+------------+------------+------------+



DBCTL

DBCTLBy selecting DBCTL on the Region Status panel (enter S to show details), you can see the DBCTL Activity panel.

Monitor DBCTL ActivityThrough the panel you can see the status of the DBCTL attachment to the CICS region. The DBCTL Activity panel also identifies the DBCTL address space. The following figure shows the panel.

FIGURE 112. DBCTL Activity Panel

None of the fields in the panel is selectable. You can set thresholds for only one field, DBCTL interface status.

For more information on the DBCTL panels, see the OMEGAMON II for CICS Reference Manual.

Analyze DBCTL Problems from the Region StatusYou can analyze problems for DBCTL when the status bar indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to DBCTL to view the Analyze DBCTL Problems panel, shown in the following figure.

____ GoTo Index Options Help ----------------------------------------------------------- 05/24/93 15:31:59 KC2I09D DBCTL Activity Region: CICSPROD Fastpath: =RL Auto(60) +-------------------------------------+--------------------------------------+| DBCTL jobname . . . . . : DBCTLPRD | DBCTL ASID . . . . . . . : A2 || DBCTL JES job number . : STC00105 | DBCTL identification . . : DBCT || DBCTL interface status : Ready | Startup table suffix . . : XX || Minimum threads . . . . : 2 | Session number . . . . . : 32 || Maximum threads . . . . : 8 | DBCTL CMD recognition ID : 6C || Disconnect type . . . . : Orderly | Successful PSB schedules : 1 || Active thread rmcalls . : 1 | Control Txn area address : 00A3EC52 |+-------------------------------------+--------------------------------------+ Previous DBCTL Session +-------------------------------------+--------------------------------------+| Minimum thread hits . . : 2 | Maximum thread hits . . : 1 || Time at thread maximum : 00:00:20 | Thread usage (HWM) . . . : 1 |+-------------------------------------+--------------------------------------+ (Activity) <DBCTL tasks> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

DBCTL


FIGURE 113. Analyze DBCTL Problems Panel


After viewing the problems listed on the panel, you can further analyze a particular problem by selecting it (enter S next to it.)

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:32:50 KC2B02D Analyze DBCTL Problems Region: CICSPROD Auto(60) +-------------------------------------+------------+-------------------------+| | | Thresholds || Problem Description | Value | Warning Critical ||-------------------------------------+------------+------------+------------|| _ DBCTL inactive | On | On | Off |+-------------------------------------+------------+------------+------------+

F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=PrintF15=Region Status


DL/I

DL/I Selecting DL/I on the Region Status panel (enter S to show details) allows you to see the DL/I Activity panel.

Monitor DL/I ActivityThrough the DL/I Activity panel, you can see information about local DL/I activity, including resource usage within the three IMS pool types: DMB, PSB, and ENQ. You can also see statistics on thread usage. The following figure shows the panel.

FIGURE 114. DL/I Activity Panel

For more information on the DL/I panels, see the OMEGAMON II for CICS Reference Manual.

____ GoTo Index Options Help ----------------------------------------------------------- 05/24/93 15:30:59 KC2I01D DL/I Activity Region: CICSPROD Fastpath: =RI Auto(60)+-------+----------+----------+----------+-----------------------------------+| Pool | Size | Used | Waits | % Used 0......................100 ||-------+----------+----------+----------+--------+--------------------------|| DMB | 2048 | 1048 | 10 | 50% |-----------> ! || PSB | 2048 | 1048 | 10 | 24% |------> ! ! || ENQ | 2048 | 1048 | | 90% |----------------------> |+-------+----------+----------+----------+--------+--------------------------+ +--------------------------------------+-------------------------------------+| Active DL/I calls . . . : 5 | DL/I threads % in use . : 20% || Active DL/I calls (HWM) : 10 | DL/I threads . . . . . : 10 || | DL/I threads in use . . : 3 || DB monitor . . . . . . . : On | DL/I thread waits . . . : 5 || ENQ pool % used (HWM) . : 99% | DL/I thread average . . : 3 || ECBs currently waiting . : 2 | |+--------------------------------------+-------------------------------------+ (Activity) <DL/I Tasks> <Config> <Buffers> <Addresses> <ECBs> <DBDs>F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action BarF11=Print F15=Region Status

DL/I


DL/I Pushbuttons

Pushbuttons at the bottom of the DL/I Activity panel take you to the panels listed below.

Analyze DL/I Problems from the Region StatusYou can analyze problems for DL/I when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to DL/I to view the Analyze DL/I Problems panel, shown in the following figure.

FIGURE 115. Analyze DL/I Problems Panel

This panel does not refresh on entry so you can continue to see the conditions that caused a problem on the Region Status panel.

After viewing the problems listed on the panel, you can further analyze a particular problem by selecting it (enter S) next to it).

This Pushbutton: Leads to This Panel:

DL/I Tasks CICS Tasks Using DL/IConfig DL/I ConfigurationBuffers DL/I OSAM BuffersAddresses DL/I Interface AddressesECBs DL/I Interface ECBsDBDs DL/I Databases

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:04:30 KC2B02D Analyze DL/I Problems Region: CICSPROD Auto(60) +-------------------------------------+------------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | |-------------------------------------+------------+------------+------------| | _ DL/I PSB pool % in use | 85% | 70% | 90% | | _ DL/I DMB pool % in use | 72% | 70% | 90% | | _ DL/I threads % in use | 90% | 70% | 90% | | _ DL/I ENQ pool % in use | 87% | 70% | 90% | +-------------------------------------+------------+------------+------------+



Files

FilesBy selecting Files on the Region Status panel (enter S to show details), you display the Open VSAM Files panel, which shows a summary of all open VSAM files for the CICS region.

Monitor File AccessFile access is often the most significant component of CICS response time and therefore should be monitored and well tuned. See the chapter called “File Analysis,” in the OMEGAMON II for CICS Reference Manual for more information on VSAM files. The following figure shows the Open VSAM Files panel.

FIGURE 116. Open VSAM Files Panel (CICS/ESA Version 4 and earlier

Data in the last six columns refers to the interval of time ending at “Time of last analysis” for the duration:”Splits/extents interval”.


Use the View pull-down menu to filter the contents of the Open VSAM Files panel by selecting Some or Problems. Sort the contents of the panel by selecting the following:

n Sort by file ID

n Sort by current string waits

n Sort by % string waits per I/O

n Sort by % current strings in use

n Sort by data CA splits/interval

____ Actions GoTo View Index Options Help ------------------------------------------------------------ 05/24/93 16:04:32 KC2H01D Open VSAM Files Region: CICSPROD Fastpath: =RF Auto(60)+-------------------------------------+--------------------------------------+| Splits/extents interval : 5 min | Time of last analysis . : 16:00:00 |+-------------------------------------+--------------------------------------+ Lines 1 to 7 of 30+------------+------+------+-------+------+------+------+------+------+------+| File | Curr.|String|Current| Data | Data | Data | Index| Index|Index || ID |String|Waits/|Strings| CA | CI | | CA | CI | || |Waits | I/O |in Use |Splits|Splits|Extnts|Splits|Splits|Extnts||------------+------+------+-------+------+------+------+------+------+------|| _ DFHLCD | | | | 0 | 0 | 0 | 0 | 0 | 0 || _ DFHXRCTL | | | | | | 0 | | | || _ DFHXRMSG | | | | | | 0 | | | || _ FILEA | 3 | 45% | 75% | 0 | 4 | 0 | 0 | 0 | 0 || _ DFHRSD | | | | 0 | 0 | 0 | 0 | 0 | 0 || _ DFHJACD | | | | 0 | 0 | 0 | 0 | 0 | 0 || _ DFHTEMP | 0 | | 20% | | | 2 | | | |+------------+------+------+-------+------+------+------+------+------+------+(Open VSAM) <Datasets> <String Waits> <Buffer Waits> <LSR> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

Files


n Sort by data CI splits/interval

n Sort by data extents/interval

n Sort by index CA splits/interval

n Sort by index CI splits/interval

n Sort by index extents/interval

Pushbuttons on Open VSAM Files Panel

Pushbuttons at the bottom of the Open VSAM Files panel take you to the following panels:

Select a File for Details

You can select a particular file ID at this panel to see details for the file. The VSAM Details panel then displays.

FIGURE 117. VSAM Details Panel

This Pushbutton: Leads to This Panel:

Datasets Datasets Allocated to CICSString Waits VSAM String WaitsBuffer Waits LSR Buffer WaitsLSR Local Shared Resources Pools

____ Actions GoTo Index Options Help ------------------------------------------------------------05/24/93 16:04:59 KC2H06D VSAM Details Region: CICSPROD Fastpath: =RFV Auto(60)+----------------------------------------------------------------------------+| DDname . . . . . . . . . PAYROLL1 + || File organization . . . : KSDS || Dataset name . . . . . . TDCICS1.FCTFILE.APPLMIS.CICSPRD.PAYMSTR_____ + || _ Data component name . . : TDCICS1.FCTFILE.APPLMIS.CICSPRD.PAYMSTR.DATA || _ Index component name . : TDCICS1.FCTFILE.APPLMIS.CICSPRD.PAYMSTR.INDX |+----------------------------------------------------------------------------++--------------------------------------+-------------------------------------+| _ Volume serial number. . : OMON35 | _ Share control . . . . : LSRPOOL5 || Creation date . . . . . : 05/21/93 | Expiration date . . . : None || LSR pool act strings HWM: 1 | LSR pool active strings: 0 || LSR pool strings . . . : 3 | FCT file . . . . . . . : Yes || Splits/extents interval : 5 min | Time of last analysis. : 12:33:30 || Data extents/interval . : 0 | Index extents/interval : 1 || Data CA splits/interval : 1 | Index CA splits/intrvl : 0 || Data CI splits/interval : 37 | Index CI splits/intrvl : 1 |+--------------------------------------+-------------------------------------+ (Details) <FCTE> <FCTE Statistics> <FCTE Logging> <FCTE Data Table> F1=Help F2=Keys F3=Exit F4= Prompt F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status


Files

On this panel, you can overtype data in the DDname and Dataset Name fields. You can navigate to other panels for more information by selecting these fields:

n Data component name

n Index component name

n Volume serial number

n Share control

The fields displayed vary depending on the file organization (that is, on whether it is KSDS, ESDS, or RRDS), and on Share control (LSR or NSR).

See the OMEGAMON II for CICS Reference Manual for more information on the Files panels.

Analyze Files Problems from the Region StatusYou can analyze problems for Files when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A. in the entry field next to Files to view the Analyze Files Problems panel, shown in the following figure.

FIGURE 118. Analyze File Problems Panel


Selecting any problem associated with strings will display the Open VSAM Files panel. Any other problem will display the relevant VSAM Details panel.

____ Actions GoTo Index Options Help ----------------------------------------------------------- 05/24/93 16:05:56 Analyze File Problems Region: CICSPROD Auto(60) +-------------------------------------+------------+-------------------------+| | | Thresholds || Problem Description | Value | Warning Critical ||-------------------------------------+------------+------------+------------|| _ Strings % in use, FILEA | 93% | 85% | 95% |+-------------------------------------+------------+------------+------------+

F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status

Files


Monitoring VSAM Record Level Sharing (RLS) DatasetsCICS/ESA Version 5.1.0 supports record level sharing of VSAM datasets between multiple CICS systems. Record level sharing allows multiple CICS systems to concurrently update the same VSAM dataset directly, without the use of a CICS file owning region, with full integrity.

You can display the datasets that have been opened by the monitored CICS region for RLS access and check the activity against those datasets. To access information about RLS datasets:

n From the Region Status panel, enter S next to FILES.

Result: The Open VSAM Files panel displays.

FIGURE 119. Open VSAM Files Panel (CICS/ESA Version 5.1.0)

From the Open VSAM Files panel you can:

n view the number of RLS timeouts that have occurred during the displayed interval. Information on RLS timeouts is collected on the VSAM analysis interval that appears at the top of the panel.

n select details for any of the files by using S(elect) or the pushbuttons

The count of RLS timeouts is incremented when a request for exclusive control of a record in an RLS dataset fails because the record is already held by another task.

_____ Actions GoTo View Index Options Help------------------------------------------------------------ 10/08/96 14:17:23KC2H015D Open VSAM Files Region: CICSPRODFastpath: =RF Auto(Off)+-----------------------------------------------------------------------------+| Interval displayed . . . Last + (Current/Last) || VSAM analysis interval : 15 min End of last interval . : 14:17:06 |+-----------------------------------------------------------------------------+ +------------+------+------+--------+---------------+-----------------+-------+| File |Currnt|String|Current | Data | Index | RLS || ID |String|Waits/|Strings | CA CI New | CA CI New | Time || |Waits | I/O |in Use |Splt Splt Extnt| Splt Splt Extnt | Outs ||------------|------|------|--------|---------------|-----------------|-------|| DFHLCD | | | | 0 0 0| 0 0 0 | || DFHGCD | | | | 0 0 0| 0 0 0 | || DFHTEMP | 0 | | 0% | 0| | || DFHINTRA | 0 | | 0% | 0| | || FILE01 | | | 0% | | | 0 || FILE02 | | | 0% | | | 0 || FILE03 | | | 0% | | | 0 || FILE04 | | | 0% | | | 0 || FILE05 | | | 0% | | | 0 || FILE05X | | | 0% | | | 0 |+------------+------+------+--------+---------------+-----------------+-------+ (Open VSAM Files) <Datasets> <String Waits> <Buffer Waits> <LSR> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status PA1=Switch


Files

Because multiple CICS regions may be accessing the RLS dataset, it is possible that the task holding the record is running in a CICS region other than the one you are monitoring.

RLS timeouts can indicate an application design problem. If, for example, your application uses a single control record in an RLS dataset, which is updated by every task that runs, and the control record was being held for update for excessive periods of time, you might see the RLS timeouts increasing.

Messages in the CICS log will indicate the task that owns the record causing the RLS timeout. RLS datasets will have strings allocated, beyond the FCT definition, as required to process file requests. This may cause the Current Strings in Use exception to trip, with little perceptible effect on the performance of RLS datasets.

Journals


JournalsSelect Journals from the Region Status panel to display the Journals panel if you are using OMEGAMON II for CICS to manage a CICS/ESA Version 5.1.0 region. (The Datasets Allocated to CICS panel are displayed if you are using OMEGAMON II for CICS to manage earlier versions of CICS.)

View the Journals Panel (CICS/ESA Version 5.1.0)The Journals panel displays a summary of the usage and status of the system log and general logs. This panel is shown in the following figure.

FIGURE 120. Journals Panel (CICS/ESA Version 5.1.0)

On this panel, an authorized user can enter an action code (E, I, F, or r) in the entry field preceding the journal name to perform the following actions against a journal:

n Enable journal

n Disable journal

n Flush journal

n Reset journal

For CUA function level security, resource cicsname.KC2.MEM.CEMT controls user authorization for the actions.

For menu system security, user authorization for the actions is controlled by restricting access to the CMT command.

_____ Actions GoTo View Index Options Help ---------------------------------------------------------- 10/17/95 14:34:09 KC2J01D Journals Region: CICSPROD Fastpath: =RJ Auto(Off) E=Enable I=Disable F=Flush R=Reset +------------+----------+----------+---------+-----------------------------+ | Journal | Journal | System | Journal | MVS Log | | Name | Status | Log | Type | Stream Name | |------------+----------+----------+---------+-----------------------------| | _ DFHJ04 | Ena Disc | No | MVS | TDOCS27.TDOCS27.DFHJ04 | | _ DFHLGLOG | Ena Conn | No | MVS | TDOCS27.TDOCS27.DFHLGLOG | | _ DFHLOG | Ena Disc | Yes | MVS | TDOCS27.TDOCS27.DFHLOG | | _ DFHJ08 | Failed | No | MVS | TDOCS27.TDOCS27.DFHJ08 | | _ USER01 | Disabled | No | SMF | | | _ USER99 | Ena Conn | No | Dummy | | | | | | | | | | | | | | +------------+----------+----------+---------+-----------------------------+ (Journals) <Log Streams> <Journal Models> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status PA1=Switch


Journals

To see whether a journal has experienced a log stream failure, check the Journal Status column.

You can use the View pull-down to sort the display. See “Sort the Journals Panel Contents” on page 183 for more information.

To see details on a particular journal name, enter S in the Journal Name column and press Enter. The Journal Details panel appears, which is described in the section titled “See Details on a CICS Journal (CICS/ESA Version 5.1.0)” on page 183.

Sort the Journals Panel Contents

To filter the contents of the Journals panel, use the View pull-down menu and select Some or Problems. Sort the contents of the panel by selecting one of the following:

n Sort by journal name

n Sort by journal status

n Sort by system log

n Sort by journal type

n Sort by log stream name

Pushbuttons on the Journals Panel

The following pushbuttons available at the bottom of the Journals panel navigate to a panel of the same name.

To navigate to these panels, position the cursor on the pushbutton you want and press Enter.

See the OMEGAMON II for CICS Reference Manual for details on these panels.

See Details on a CICS Journal (CICS/ESA Version 5.1.0)To see detailed information on a journal, you can select a specific journal on the Journals panel. The Journal Details panel then appears, as shown in the following figure.

This Pushbutton: Leads to This Panel:Log Streams Log StreamsJournal Models Journal Models

Journals


FIGURE 121. Journal Details Panel (CICS/ESA Version 5.1.0)

To see details for a different journal, overtype the Journal Name field, or press F4 to see a list of journal names.

You can see whether or not a journal has experienced a log stream failure in the Journal Status field of this panel. Journal status may be one of the following:

n Ena Conn (Enabled Connected)

n Ena Disc (Enabled Disconnected)

n Disabled

n Failed

View a Summary of Journal Datasets (Prior to CICS/ESA Version 5.1.0)In CICS versions prior to 5.1.0, the Datasets Allocated to CICS panel displays a summary of the datasets defined to the CICS region. When you navigate to this panel, it is filtered to show only journal datasets.

_____ Actions GoTo Index Options Help------------------------------------------------------------ 03/10/97 17:56:41KC2J02D Journal Details Region: TDOCS27Fastpath: =RJD Auto(Off)+-------------------------------------+--------------------------------------+| Journal name . . . . . DFHLOG +| System log . . . . . . : Yes || Journal status . . . : Ena Disc | Journal type . . . . . : MVS ||-------------------------------------+--------------------------------------|| MVS log stream name . : TDOCS27.TDOCS27.DFHLOG || Failure reason . . . : n/a |+----------------------------------------------------------------------------+ Statistics+-------------------------------------+--------------------------------------+| Writes . . . . . . . : 0 | Total bytes written . . : 0 || Buffer flushes . . . : 0 | Statistics last reset . : 13:12:02 |+-------------------------------------+--------------------------------------+

F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action BarF11=Print F15=Region Status PA1=Switch


Journals


Note: If you are using CICS/ESA Version 5.1.0, the fast path for this panel is =RFA.

You can overtype the Dataset Type field in the upper portion of the panel. To see a pop-up window containing a list of valid dataset types, press F4. To see all datasets allocated to CICS, enter an asterisk (*) in the field. To navigate to the File Details panel, which is described in the section titled “Select a DDname for Details (Prior to CICS/ESA Version 5.1.0)” on page 186, select a ddname in the lower portion of the panel.

The Attribute column contains the most pertinent information about the file at the time of display. If a file qualifies for more than one attribute, only the first one in the list is displayed. For an explanation of the contents of the Attribute column, see the Dataset Attribute table in the OMEGAMON II for CICS Reference Manual.

Sort the Datasets Allocated to CICS Panel Contents

To filter the contents of the Datasets Allocated to CICS panel, use the View pull-down menu and select Some or Problems. Sort the contents of the panel by selecting one of the following:

n Sort by DDname

n Sort by dataset name

n Sort by volume

See “Using the View Pull-down” on page 67 for more information on sorting panel contents.

____ Actions GoTo View Index Options Help------------------------------------------------------------ 05/24/93 16:11:24KC2H02D Datasets Allocated to CICS Region: CICSPRODFastpath: =RJ Auto( 60)+----------------------------------------------------------------------------+| Dataset type . . . JCT____ + |+----------------------------------------------------------------------------+

+------------+--------------------------------------------+------+-----------+| DDname |Dataset Name |Volume| Attribute ||------------+--------------------------------------------+------+-----------|| _ DFHJ01A |TDCICS1.TOC.TDOCS22.DFHJ01A |OMON29| Closed || _ DFHJ01B |TDCICS1.TOC.TDOCS22.DFHJ01B |OMON29| In use || _ DFHJ02A |TDCICS1.TOC.TDOCS22.DFHJ02A |OMON29| In use || _ DFHJ02B |TDCICS1.TOC.TDOCS22.DFHJ02B |OMON30| Closed || _ DFHJ03A |TDCICS1.TOC.TDOCS22.DFHJ03A |OMON29| In use || _ DFHJ03B |TDCICS1.TOC.TDOCS22.DFHJ03B |OMON29| Closed || _ DFHJ04A |TDCICS1.TOC.TDOCS22.DFHJ04A |OMON30| Closed || _ DFHJ04B |TDCICS1.TOC.TDOCS22.DFHJ04B |OMON30| Closed |+------------+--------------------------------------------+------+-----------+ <Open VSAM> (Datasets) <String Waits> <Buffer Waits> <LSR> F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

Journals


Pushbuttons on Datasets Allocated to CICS

The pushbuttons available at the bottom of the Datasets Allocated to CICS panel are as follows:

To navigate to these panels, position the cursor on the pushbutton you want and press Enter.

See the OMEGAMON II for CICS Reference Manual for details on these panels.

Select a DDname for Details (Prior to CICS/ESA Version 5.1.0)To see the File Details panel, you can select a ddname listed on the Datasets Allocated to CICS panel. An illustration of the File Details panel appears as shown in the following figure.

FIGURE 123. File Details Panel

This panel presents detailed information for closed VSAM and non-VSAM datasets. You can overtype both the DDname field (and, if applicable, its concatenation index, +nnn) and the Dataset Name fields. If you overtype both of these fields, the data in the DDname field takes precedence over that in the Dataset Name field.

This Pushbutton: Leads to This Panel:Open VSAM Files Open VSAMString Waits VSAM String WaitsBuffer Waits LSR Buffer WaitsLSR Local Shared Resources (LSR) Pools

____ Actions GoTo Index Options Help------------------------------------------------------------ 05/24/93 16:11:46KC2H05D File Details Region: CICSPRODFastpath: =RFD Auto(60)+----------------------------------------------------------------------------+| DDname . . . . . . . . : DFHJ01A_ + Concatenation index . . : 1______ || Dataset name . . . . . : TDCICS1.TOC.TDOCS22.DFHJ01A_________________ + ||--------------------------------------+-------------------------------------|| _ Volume serial . . . . . : OMON29 | Primary allocation . . : Trk( 1) || Device address . . . . : 0153 | Secondary allocation . : Trk( 0) || Organization . . . . . : PS | Allocated extents . . . : 1 || Record format . . . . . : U | Disposition . . . . . . : Shr || Record length . . . . . : 0 | Creation date . . . . . : 02/14/93 || Blocksize . . . . . . . : 2048 | Expiration date . . . . : None || EXCP count . . . . . . : 2 | |+--------------------------------------+-------------------------------------+ Related Information+----------------------------------------------------------------------------+| _ Dataset is the CICS system journal (Extent A) . . . . . . . . : Closed |+----------------------------------------------------------------------------+

F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action BarF11=Print F15=Region Status


Journals

When you select the Volume Serial field on the panel, OMEGAMON II navigates to the DASD Details for a Device panel.

The Related Information box gives a brief description of the function of the journal dataset displayed within it. One of the following journal dataset attributes is also displayed:

n Closed

n Switch

n In use

n Tapelog

n Waiting

To display detailed information on the journal dataset, enter S in the field. The Journal Control Table Entry panel appears.

Note: The Related Information box also displays information for the following types of datasets:

n RPL

n trace

For more information on all the Journals panels, see the OMEGAMON II for CICS Reference Manual.

Analyze Journal Problems from the Region StatusYou can analyze Journal problems when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to Journals to view the Analyze Journal Problems panel, as shown in the following figure.

FIGURE 124. Analyze Journal Problems Panel

Note: This panel is used for CICS/ESA Version 5.1.0 and earlier versions of CICS.

____ Actions GoTo Index Options Help------------------------------------------------------------ 05/24/93 16:12:06KC2B02D Analyze Journal Problems Region: CICSPROD Auto(60)

+-------------------------------------+------------+-------------------------+| | | Thresholds || Problem Description | Value | Warning Critical ||-------------------------------------+------------+------------+------------|| _ Journal 04 waiting for WTOR | On | On | Off |+-------------------------------------+------------+------------+------------+

F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=FwdF10=Action Bar F11=Print F15=Region Status

Journals



If you are using CICS/ESA Version 5.1.0, this panel displays all the journals that have experienced log stream failure. You can then select a journal to see detailed information. The Journal Details panel appears.

If you are using earlier supported versions of CICS, select any problem listed on the Analyze Journal Problems panel to display a summary of all journal datasets defined to this region. The Datasets Allocated to CICS panel appears.


Local Shared Resources (LSR)

Local Shared Resources (LSR)By selecting LSR from the Region Status panel (enter S to show details) you display the Local Shared Resources Pools panel.

See a Summary of LSR Pools Built in CICSThe Local Shared Resources (LSR) Pools panel shows summary information about current and past usage of LSR pools that have been built in CICS for both VSAM files and local DL/I databases. The panel includes both CICS and VSAM information.

The following figure shows the Local Shared Resources (LSR) Pools panel.

FIGURE 125. LSR Pools Panel

The Pool ID column in the panel lists all LSR pools defined to the system, including those not yet built. You can also get more information on Open LSR Files and on Open Files not Using LSR by entering S in the entry fields next to them. After you select either of the fields, the system navigates to the File Control Table (FCT) panel.


Use the View pull-down menu to filter the contents of the panel to see Some or Problems. Sort the contents of the panel using one of the following selections:

n Sort by pool ID

n Sort by open ACBs

n Sort by % active strings

____ Actions GoTo View Index Options Help----------------------------------------------------------- 05/24/93 16:30:59KC2H11D Local Shared Resources (LSR) Pools Region: CICSPRODFastpath: =RL Auto(60)+-------------------------------------+--------------------------------------+| _ Open LSR files . . . . . : 11 | _ Open files not using LSR . : 1 |+-------------------------------------~--------------------------------------+ +------+----------+--------+-------+---------+----------+----------+---------+| Pool | Pool | Open |%Active| Tasks |Successful| Buffer |Lookaside|| ID | Status | ACBs |Strings| Waiting |Lookasides| Reads | Ratio ||------|----------|--------|-------|---------|----------|----------|---------|| _ 01 | Created | 1 | 0% | 0 | 1 | 8 | 11% || _ 02 | Notbuilt | | | | | | || _ 03 | Notbuilt | | | | | | || _ 04 | Created | 1 | 0% | 0 | 63 | 6 | 91% || _ 05 | Created | 9 | 55% | 0 | 5176 | 2713 | 66% || _ 06 | Notbuilt | | | | | | || _ 07 | Notbuilt | | | | | | || _ 08 | Notbuilt | | | | | | ||------~----------~--------~-------~---------~----------~----------~---------+<Open VSAM> <Datasets> <String Waits> <Buffer Waits> (LSR)F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=FwdF10=Action Bar F11=Print F15=Region Status



n Sort by tasks waiting

n Sort by successful lookasides

n Sort by buffer reads

n Sort by buffer lookaside ratios

Pushbuttons on LSR Pools

Pushbuttons at the bottom of the LSR Pools panel navigate to the panels listed below.

Select a Pool for Details

You can get more information on a particular pool by entering S next to a pool ID on the LSR Pools panel. The LSR Buffer Pool Details panel then displays. The following figure shows the panel.

FIGURE 126. LSR Buffer Pool Details Panel

This pushbutton: Leads to this panel:Open VSAM Open VSAM FilesDatasets Datasets Allocated to CICSString Waits VSAM String WaitsBuffer Waits LSR Buffer Waits

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 12:43:12 LSR Buffer Pool Details Region: CICSPROD Auto(60) +--------------------------------------+-------------------------------------+ | Pool ID . . . . . . . . . 01__+ | Pool status . . . . . : Created | | _ Open files for this pool: 1 | Location . . . . . . . : >16M | | | | | % active strings . . . : 0% | Tasks waiting . . . . : 0 | | Total strings . . . . . : 2 | Total string waits . . : 0 | | Current active strings : 0 | String waits (HWM) . . : 0 | | Active strings (HWM) . : 1 | Maximum keylength . . : 22 | | | | | Time pool created . . . : 12:26:03 | Time pool deleted . . : n/a | +--------------------------------------+-------------------------------------+ Buffer Counts +--------------------------------------+-------------------------------------+ | Data buffers . . . . . : n/a | Hiperspace data buffers: n/a | | Index buffers . . . . . : n/a | Hiperspace index buffrs: n/a | | _ Compound buffers . . . : 17 | _ Hiperspace compound bfs: n/a | | Total buffers . . . . . : 17 | Buffer lookaside ratio : 0% | +--------------------------------------+-------------------------------------+ F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status



This panel shows detailed information about the selected LSR pool utilization and the buffers belonging to the pool.

Overtype the Pool ID to select another LSR pool. Press F4 to see a list of available LSR pools. The Open Files for this Pool field is selectable and navigates to the File Control Table (FCT) panel. The Compound Buffers field is selectable and navigates to the LSR Compound Buffers panel.

For more information on all LSR panels, see the OMEGAMON II for CICS Reference Manual.

Analyze LSR Problems from the Region StatusYou can analyze LSR problems when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to LSR to view the Analyze LSR Problems panel, shown in the following figure.

FIGURE 127. Analyze LSR Problems Panel


Select any of the problems listed to display the LSR Buffer Pool Details panel for the desired pool.

____ Actions GoTo Index Options Help------------------------------------------------------------ 05/24/93 16:31:06 Analyze LSR Problems Region: CICSPROD Auto(60)

+-------------------------------------+------------+-------------------------+| | | Thresholds || Problem Description | Value | Warning Critical ||-------------------------------------+------------+------------+------------|| _ Active strings for LSR pool 7 | 80% | 75% | 90% || _ Buffer lookaside ratio for pool 7 | 10% | 25% | 5% |+-------------------------------------+------------+------------+------------+


MRO/ISC


MRO/ISCBy selecting MRO/ISC (multiregion operation/intersystem communication) from the Region Status panel (enter S to show details) you can see the Terminal Control Table System Entries panel. The following figure shows the panel.

FIGURE 128. Terminal Control Table System Entries Panel

XLN Status

The XLN Status column indicates whether an Exchange Logname Status exception has occurred or not. This exception is enabled or disabled by entering L before MRO/ISC on the Region Status panel, and indicates that an LU 6.2 connection between two CICS regions has failed.

See a List of All Remote SystemsThe Terminal Control Table System Entries panel displays a list of all remote systems to which this system has access. The status and type of each connection is displayed with statistics showing current and past availability.


Use the View pull-down to filter the contents of the panel by selecting Some or Problems. Sort the contents of the panel using one of the following selections:

n Sort by system ID

n Sort by VTAM netname

n Sort by system status

____ Actions GoTo View Index Options Help------------------------------------------------------------ 05/24/93 16:31:30KC2P45D Terminal Control Table System Entries Region: CICSPRODFastpath: =RM Auto(60)

+--------+----------+----------+------------+----------+---------+-----------+| System | VTAM | System | Connection | XLN | % Links | Waits || ID | Netname | Status | Type | Status | in Use | for Links ||--------+----------+----------+------------+----------+---------+-----------|| _ CICS | TDOCS22 | Ins | Local | | | 0 || _ CS02 | TDOCS02 | Ins | MRO | | 5% | 0 || _ CS23 | TDOCS23 | Ins | MRO | | 5% | 0 || _ CS40 | TDOCS40 | Rel Ins | LU 6.2 | Xnotdone | 0% | 0 || _ CS43 | TDOCS43 | Ins | MRO | | 0% | 0 || _ CS46 | TDOCS46 | Ins | MRO | | 0% | 0 || _ XM30 | TDOCS30 | Ins | MRO | | 0% | 0 || _ XM57 | TDOCS57 | Ins | MRO | | 0% | 0 |+--------+----------+----------+------------+----------+---------+-----------+



MRO/ISC

n Sort by connection type

n Sort by % links in use

n Sort by waits for links

n Sort by XLN status

Select a System for Details

To see more information for a particular system listed in the System ID column on the panel, enter S in the entry field next to the desired ID. The TCT System Entry panel then displays. The following figure shows the panel.

FIGURE 129. TCT System Entry Panel

For more information on all panels accessible through MRO/ISC, see the OMEGAMON II for CICS Reference Manual.

____ Actions GoTo Index Options Help------------------------------------------------------------ 06/16/93 16:50:32KC2P46D TCT System Entry Region: CICSPRODFastpath: =RME Auto(60)+-------------------------------------+--------------------------------------+| System ID . . . . . . . CS40 + | _ TCTSE address . . . . . : 0606E288 || Connection type . . . : System | Terminal model . . . . : None || Session status . . . : Released | VTAM netname . . . . . : TDOCS40 || Service status . . . : Ins | Session create status . : n/a |+-------------------------------------+--------------------------------------+ System Information+-------------------------------------+--------------------------------------+| Connection Type . . . : ISC/LU62 | Bind SEC operative . . : n/a || CONNNECT=ALL specified: No | Bind SEC specified . . : No || XRF system name . . . : None | Exchange Logname status : Xnotdone |+-------------------------------------+--------------------------------------+ ISC Link Information+-------------------------------------+--------------------------------------+| % links in use . . . : 0% | Waits for links . . . . : 0 |+-------------------------------------+--------------------------------------+

(TCTSE) <TCTSE Statistics>F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action BarF11=Print F15=Region Status

MRO/ISC


Analyze MRO/ISC Problems from the Region StatusYou can analyze problems for MRO/ISC when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to MRO/ISC to view the Analyze MRO/ISC Problems panel. This panel lists the problems discovered, their current state, and the warning and critical thresholds. The following figure shows the Analyze MRO/ISC Problems panel.

FIGURE 130. Analyze MRO/ISC Problems Panel


Select any problem listed to display details for the connection that has exceeded its threshold.

____ Actions GoTo Index Options Help------------------------------------------------------------ 05/24/01 16:33:31KC2B02D Analyze MRO/ISC Problems Region: CICSPROD Auto(60)

+-------------------------------------+------------+-------------------------+| | | Thresholds || Problem Description | Value | Warning Critical ||-------------------------------------+------------+------------+------------|| _ MRO/ISC links to CI23 % in use | 8% | 75% | 90% || _ Total waits for links to CS40 | 20 | 5 | 115 || _ Exchange Logname status | On | On | Off |+-------------------------------------+------------+------------+------------+

F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd


Paging

PagingBy selecting Paging on the Region Status panel (enter S to show details) you display the Working Set Size and Paging Rates panel.

See CICS Address Space StatisticsThe Working Set Size and Paging Rates panel presents statistics about the private and common areas of a CICS address space. The following figure shows the panel.

FIGURE 131. Working Set Size and Paging Rates Panel

The paging rate of your region is important because CICS transactions wait until page faults are resolved. Some paging is normal, but excessive paging can cause response time degradation. The type of processor you have determines whether the paging rate is excessive.

If your CICS region is defined in a performance group where storage isolation is in effect, you can see its minimum, maximum, and target working set size values. For more information on working set size, see the IBM MVS Initialization and Tuning Guide and the IBM CICS Performance Guide.

____ GoTo Index Options Help------------------------------------------------------------ 05/24/93 16:50:14KC2X02D Working Set Size and Paging Rates Region: CICSPRODFastpath: =RP Auto(60)+-------+-----------+-----------+ +--------+----------------+----------------+| | Private | Common | | | Private | Common || |Working Set|Working Set| | |Page-in/CPU-sec |Page-in/CPU-sec ||-------|-----------|-----------| |--------|----------------|----------------||Actual | 1188K | None | |Page-in | 4.02 | None ||Target | None | None | |PGRT min| None | None ||Minimum| None | 1024K | |PGRT max| None | None ||Maximum| None | None | | | | ||Real | 1128K | | | | | ||Expand | 60K | | | | | |+-------+-----------+-----------+ +--------+----------------+----------------+ +----------------------------------------------------------------------------+| Total page-in/CPU-sec 0................................................7 ||-------------------------+-------------------!-------------!----------------|| 4.02 |-----------------------------> |+-------------------------+--------------------------------------------------+

<CPU> (Paging) <ASID> <Job> <TCBs> <Modules> <MVS Resources> <XRF>F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=PrintF15=Region Status

Paging


Working Set Size and Paging Rates Pushbuttons

Pushbuttons at the bottom of the panel navigate to the following panels:

For more information on the Paging panels, see the OMEGAMON II for CICS Reference Manual.

Analyze Paging Problems from the Region StatusYou can analyze Paging problems when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to Paging to view the Analyze Paging Problems panel, shown in the following figure.

FIGURE 132. Analyze Paging Problems Panel


Selecting a problem on this panel will display the Working Set Size and Paging Rates panel.


CPU CPU RatesASID CICS Address Space InformationJob CICS Job InformationTCBs CICS Address Space TCBsModules MVS Loaded ModulesMVS Resource MVS ResourcesXRF XRF Information

____ Actions GoTo Index Options Help------------------------------------------------------------ 05/24/93 16:51:12KC2B02D Analyze Paging Problems Region: CICSPROD Auto(60)

+-------------------------------------+------------+-------------------------+| | | Thresholds || Problem Description | Value | Warning Critical ||-------------------------------------+------------+------------+------------|| _ Page-in rate | 4/s | 2/s | 5/s |+-------------------------------------+------------+------------+------------+

F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=FwdF10=Action Bar F11=Print F15=Region Status


Storage

StorageBy selecting Storage from the Region Status panel (enter S to show details) you display the CICS Storage panel.

See Overview of Storage Usage and Storage ProblemsThe CICS Storage panel provides overview information about storage usage and storage problems in the CICS region. The following figure shows the panel for CICS Version 4.

FIGURE 133. CICS Storage Panel (CICS Version 4 and above)

This figure shows the panel for a CICS/ESA Version 3.2.1 region.

_____ Actions GoTo Index Options Help ------------------------------------------------------------ 03/14/94 18:02:52 KC2G014D CICS Storage Region: CICSPROD Fastpath: =RS Auto(60) +--------------------------------------+-------------------------------------+ | _ Storage violations . . : 0 | Storage recovery option: Yes | | Storage protection . . : Yes | Transaction isolation : No | | Storage notifies . . . : 0 | Total times SOS . . . : 0 | | | | | Largest free LSQA . . . : 1520K | Working set size . . . : 1500K | | _ Free OSCOR . . . . . . : 1666K | Largest free OSCOR . . : 1520K | +--------------------------------------+-------------------------------------+ +--------+---------+---------+---------+-----+-------------------------------+ | Area | Limit | Alloc. | In use | SOS | % Used 0.................100 | |--------+---------+---------+---------+-----+---------+---------------------| | _ DSA | 5120K | 1024K | 1024K | No | 20% |---> | | _ EDSA | 20480K | 6144K | 5120K | No | 25% |----> | |--------+---------+---------+------+--+-----+---------+---------------------| | _ CDSA _ UDSA _ SDSA _ RDSA | _ ECDSA _ EUDSA _ ESDSA _ ERDSA | +-----------------------------------+----------------------------------------+


Storage


FIGURE 134. CICS Storage Panel

Different fields display on the CICS Storage panel depending on the version of CICS you use. For CICS/ESA Version 3.3, there are five distinct DSA areas:

n CDSA

n UDSA

n ECDSA

n EUDSA

n ERDSA

For CICS/ESA Version 4 and above, there are three additional areas:

n RDSA

n SDSA

n ESDSA

For CICS/MVS versions, these additional fields display on the panel:

n Program compressions

n OSCOR requested

n Total GETMAINS above 16M

n Global storage above 16M

n Task storage above 16M

The Storage Violations field is selectable and navigates to the Storage Violations panel. This panel lists all transactions and terminals for which storage violations have been recorded.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:10:26 KC2G011D CICS Storage Region: CICSPROD Fastpath: =RS Auto(60) +--------------------------------------+-------------------------------------+ | _ Storage violations . . : 2 | Storage recovery option: Yes | | Storage notifies . . . : 18 | Total times SOS . . . : 3 | | | | | Largest free LSQA . . . : 5052K | Working set size . . . : 2472K | | _ Free OSCOR . . . . . . : 2312K | Largest free OSCOR . . : 2304K | +--------------------------------------+-------------------------------------+ +----------+----------+----------+-----+-------------------------------------+ | Area | Size | Free | SOS | % Alloc 0......................100 | |----------|----------|----------|-----|----------+--------------------------| | _ DSA | 1536K | 52K | No | 96% |-----------------------> | | _ EDSA | 16384K | 13140K | No | 20% |----> ! ! | +----------+----------+----------+-----+----------+--------------------------+



Storage

The Free OSCOR field is also selectable and navigates to the Address Space Storage panel, which displays a virtual storage map of the CICS address space.

Select a Storage Area for Details

Storage areas listed in the Area column of CICS Storage are selectable. For versions of CICS prior to 4, CICS Storage navigates to the appropriate version of the Storage Allocation by Components panel. This panel displays a summary of storage broken down by component. The following figure shows this panel for CICS/ESA Version 3.

FIGURE 135. Storage Allocation by Components Panel

Pushbuttons on Storage Allocation by Components. Pushbuttons at the bottom of the panel navigate as follows:

For CICS Version 4 and above, selecting the DSA and EDSA storage areas from CICS Storage causes the panel to navigate to the DSA Storage panel. Selecting any of the storage areas other than DSA or EDSA on this panel causes it to navigate to the Storage Allocation by Components panel.

For more information on the Storage panels, see the OMEGAMON II for CICS Reference Manual.

This Pushbutton: Leads to this Panel:PAM Page Allocation MapDetails Storage DetailsAllocations Allocations (CICS/ESA Version 4 and above)

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:10:39 KC2G03D Storage Allocation by Components Region: CICSPROD Fastpath: =RSC Auto(60) +---------------+----------------+---------------+---------------------------+ | Area DSA__ + | Size: 1536K | Free: 52K | Largest free : 40K | +---------------+----------------+---------------+---------------------------+ +-------------------------+-------------+------------------------------------+ | Components | Allocated | % Allocated 0.................100 | |-------------------------+-------------+--------------+-!!------!--!--------| | Total | 1484K | 96% |------------------> | | _ AP domain | 8K | 0% | | | _ Files | 4K | 0% | | | _ Loader domain | 272K | 17% |---> | | _ Monitor domain | 0K | 0% | | | _ Task | 1104K | 71% |--------------> | | _ Temporary storage | 4K | 0% | | | _ Terminal control | 4K | 0% | | | _ Transient data | 8K | 0% | | | _ Other | 80K | 5% |> | +-------------------------+-------------+--------------+---------------------+ (Components) <PAM> <Details> <Allocations> F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

Storage


Analyze Storage Problems from the Region StatusYou can analyze Storage problems when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to Storage to view the Analyze Storage Problems panel, shown in the following figure.

FIGURE 136. Analyze Storage Problems Panel


Selecting any problem listed displays a related panel to assist in further diagnosis of the problem.

____ Actions GoTo Index Options Help------------------------------------------------------------ 05/24/93 15:14:52KC2B02D Analyze Storage Problems Region: CICSPROD Auto(60)

+-------------------------------------+------------+-------------------------| | | Thresholds || Problem Description | Value | Warning Critical ||-------------------------------------+------------+------------+------------|| _ System short on storage | On | Off | On || _ Storage violations | 4 | 1 | 2 |+-------------------------------------+------------+------------+------------+



Tapes

TapesBy selecting Tapes from the Region Status panel (enter S to show details) you display the Tape Drives panel.

See All Online Tape DevicesThe Tape Drives panel displays all online tape devices, whether they are allocated to CICS or not. The following figure shows the panel.

FIGURE 137. Tape Drives Pane

The top box in this panel displays information on CICS devices only; the bottom box displays information on all tape devices.


Use the View pull-down menu to filter the contents of the Tape Drives panel by selecting Some or Problems. Sort the panel using one of the following selections:

n Sort by device

n Sort by volume

n Sort by user

n Sort by status

n Sort by I/Os

n Sort by permanent errors

n Sort by temporary errors

____ Actions GoTo View Index Options Help ----------------------------------------------------------- 05/24/93 15:15:23 KC2K10D Tape Drives Region: CICSPROD Fastpath: =RA Auto(60) +------------------------------------+--------------------------------------+ | CICS tapes dropped ready: 0 | CICS tapes not responding: 0 | | CICS tapes mount pending: 0 | | +------------------------------------+--------------------------------------+ +--------+--------+----------+---------------+---------+----------+---------+ | Device | Volume | User | Status | I/Os | Permanent|Temporary| | | | | | | Errors | Errors | |--------+--------+----------+---------------+---------+----------+---------| | _ 0B89 | | $DFHSMG | Free | 42 | | | | _ 0B8A | | | Free | 37307 | | | +--------+--------+----------+---------------+---------+----------+---------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

Tapes



To see more information on a device listed in the Device column of the Tape Drives panel, enter S next to that device. The Tape Drive Details panel then displays, as shown in the following figure.

FIGURE 138. Tape Drive Details Panel

Operators and systems programmers can use these panels to determine which drives are causing delays in CICS due to device errors or to see if an operator needs to intervene. For more information on the Tapes panels, see the OMEGAMON II for CICS Reference Manual.

Analyze Tape Problems from the Region StatusYou can analyze problems for Tapes when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to Tapes to view the Analyze Tape Problems panel, shown in the following figure.

____ GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:15:59 KC2K11D Tape Drive Details Region: CICSPROD Fastpath: =RAD Auto(60) +-------------------------------------+--------------------------------------+ | Device . . . . . . . . 0B89+ | User . . . . . . . . . : $DFHSMG | | Volume . . . . . . . : None | CICS waiting for mount : 0 | +-------------------------------------+--------------------------------------+ +-------------------------------------+--------------------------------------+ | Device type . . . . : 3490X | Permanent errors . . . : 0 | | | | | File number . . . . : n/a | Temporary errors . . . : 0 | | | | | Label type . . . . . : n/a | Ready for CICS . . . . : n/a | | | | | I/O count . . . . . : 37851 | Responding to CICS . . : n/a | | | | | | Configuration state . . : I-Static | +-------------------------------------+--------------------------------------+

F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status


Tapes

FIGURE 139. Analyze Tape Problems Panel


Selecting any problem listed displays the Tape Drives panel.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:16:35 KC2B02D Analyze Tape Problems Region: CICSPROD Auto(60) +-------------------------------------+------------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | |-------------------------------------+------------+------------+------------| | _ Mount pending on 0B83 | On | On | Off | | _ Tape unit 0B82 not responding | On | On | Off | | _ Tape dropped ready at 0B12(1P3492)| On | Off | On | +-------------------------------------+------------+------------+------------+


TempStor (Temporary Storage)


TempStor (Temporary Storage)By selecting TempStor from the Region Status panel (enter S to show details) you display the Temporary Storage panel.

See Status of CICS Temporary StorageThe Temporary Storage panel presents status information about the current use of CICS temporary storage. CICS uses temporary storage for basic mapping support (BMS), diagnostic information review, dynamic log spill, message switching, and MRO/ISC local queuing. Applications use temporary storage for scratchpad, data transfer, and queuing.

Use this panel to determine whether any of your tasks are waiting due to contention for temporary storage resources and to diagnose the cause of the bottleneck.

FIGURE 140. Temporary Storage Panel

Only one field, Tasks Suspended Now, is selectable on this panel. Selecting the field causes the Tasks panel to display with its contents filtered by tasks waiting for temporary storage.

For more information on the Temporary Storage panels, see the OMEGAMON II for CICS Reference Manual.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:17:31 KC2O01D Temporary Storage Region: CICSPROD Fastpath: =RO Auto(60) +--------------------------------------+-------------------------------------+ | Current queues . . . . : 3 | Number of queues (HWM) : 4 | | | | | Main storage used . . . : 560 | Main storage used (HWM): 560 | | Records PUT(Q) to main : 10 | Records GET from main : 0 | | | | | _ Tasks suspended now . . : Yes | Total tasks suspended : 0 | | Records PUT(Q) to aux . : 154 | Records GET from aux . : 4 | +--------------------------------------+-------------------------------------+ +----------------+---------------+--------------------------------------------+ | Resource | Current Waits | % in Use 0........................100| |----------------+---------------+----------------+---------------------------| | Buffers | 3 | 100 % |-------------------------->| | CIs | N/A | 20 % |----> ! ! | | Strings | 0 | 50 % |------------> ! | +----------------+---------------+----------------+---------------------------+ (General) <Queues> <Auxiliary> <Statistics> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status



Push buttons on Temporary Storage

The push buttons at the bottom of the Temporary Storage panel allow you to navigate to the following panels:

Using the Temporary Storage Queues PanelThe Temporary Storage Queues panel displays when you select the Queues push button on the Temporary Storage panel. The following figure shows the panel.

FIGURE 141. Temporary Storage Queues Panel

This panel lists all the temporary storage queues that exist in this CICS system. For each queue, information such as the name of the queue, its type (that is, its location), and the number of items in the queue is shown.

This Push button: Leads to this Panel:Queues Temporary Storage QueuesAuxiliary Auxiliary Temporary StorageStatistics Temporary Storage Statistics

____ Actions GoTo View Index Options Help ------------------------------------------------------------ 06/30/94 12:23:08 KC2O02D Temporary Storage Queues Region: CICSPROD Fastpath: =ROQ Auto(60) Lines __1 to 7 of 40 +-----------------+--------+------------+---------+----------+----------+------+ | | Queue | Items in | Current | Queue | Overlgth | Rcv | | Queue ID | Type | Queue | Item | Size | Items | Opt | |-----------------+--------+------------+---------+----------+----------+------| | _ ESCICHC1 | Main | 1 | 1 | 10K | | No | | _ ESCICHC2 | Main | 12 | 11 | 20K | | No | | _ ESCICHC3 | Main | 123 | 109 | 30K | | No | | _ ESCICHC4 | Aux | 1234 | 12 | 40K | 11 | Yes | | _ ESCICHC5 | Main | 12345 | 432 | 50K | 11 | Yes | | _ ESCICHC6 | Aux | 123456 | 1542 | 60K | 11 | Yes | | _ ESCICHC7 | Aux | 1234567 | 1234567 | 70K | 11 | Yes | +-----------------~--------~------------~---------~----------~----------~------+ <General> (Queues) <Auxiliary> <Statistics> F1=Help F3=Exit F5=Refresh F7=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status



Select Character or Hexadecimal Format for the Queue Display

The queue IDs listed on the Temporary Storage Queues panel can be displayed in character or hexadecimal format. You set the format in which the queues display by following these steps:

1. Access the Temporary Storage Thresholds pop-up through the Options pull-down (enter fast path OTRO). Press Enter. The Temporary Storage Thresholds pop-up displays.

2. Move the cursor to the Display Queue ID As field.

3. Press F4 to select either Char or Hex. Press Enter. The Save Region Options pop-up displays.

4. Type S to save the change only for this session; type P to save the change to the region profile. Press Enter.

Deleting Temporary Storage Queues

If you are authorized, you can use this panel to delete queues. (The default security level prohibits users with general authority from deleting temporary storage queues.)

To delete a queue, do one of the following:

1. type D next to a queue in the Queue ID column. Then press Enter. A confirmation pop-up displays so you can confirm the deletion.

2. type / next to a queue in the Queue ID column, then press Enter. When the Actions pull-down displays, select Delete Queue, then press Enter. A confirmation pop-up displays so you can confirm the deletion.

Analyze Temporary Storage Problems from the Region StatusYou can analyze Temporary Storage problems when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to TempStor to view the Analyze Temporary Storage Problems panel, shown in the following figure.



FIGURE 142. Analyze Temporary Storage Problems Panel


Select any of the problems listed to display the Auxiliary Temporary Storage panel.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:19:25 KC2B02D Analyze Temporary Storage Problems Region: CICSPROD Auto(60) +--------------------------------------+-----------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | |--------------------------------------+-----------+------------+------------| | _ TS CIs % in use | 75% | 70% | 85% | | _ TS strings % in use | 85% | 80% | 90% | | _ TS buffers % in use | 82% | 80% | 90% | +--------------------------------------+-----------+------------+------------+


TranData (Transient Data)


TranData (Transient Data)By selecting TranData from the Region Status panel (enter S to show details) you display the Transient Data panel.

See Capacity and Use Statistics for DatasetThe Transient Data panel displays statistics about the capacity and current use of the CICS Transient Data VSAM dataset, including buffer and string information and the percentage of CIs in use. The following figure shows the panel.

FIGURE 143. Transient Data Panel

CICS uses transient data to build queues of data for later processing, put messages on system queues for printing, initiate tasks based on a queue trigger level, and request logging for recovery.

You can select the four fields in the top box of the panel to get more information. Selecting the Intrapartition Queues or Extrapartition Queues field on the panel navigates to the Destination Control Table (DCT) panel, filtered to display those queues.

Selecting the Queues Over Trigger Level or Queues Over Length Limit fields leads to the Destination Queues Over Limits panel.

You can select the Statistics pushbutton at the bottom of the panel to navigate to the Intrapartition Transient Data Statistics panel.

____ Actions GoTo Index Options Help ------------------------------------------------------------05/24/93 15:19:59 KC2N01D Transient Data Region: CICSPROD Fastpath: =RN Auto(60) +--------------------------------------+------------------------------------| | _ Intrapartition queues . . : 6 | _ Extrapartition queues . : 4 | | _ Queues over trigger level : 2 | _ Queues over length limit : 0 | +--------------------------------------+------------------------------------+ +----------------+---------------+------------------------------------------| | Resource | Current Waits | % in Use 0.....................100 | |----------------+---------------+----------------+-------------------------| | Buffers | 3 | 100% |-----------------------> | | CIs | | 20% |----> ! ! | | Strings | 0 | 50% |-----------> ! | +----------------+---------------+----------------+-------------------------+ (General) <Statistics> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status



Deleting Intrapartition Transient Data QueuesIf you are authorized, you can delete intrapartition transient data queues when you no longer need them. Deleting them frees upspace in the intrapartition dataset and makes the space available to other queues.

You can delete an indirect queue if the physical queue associated with the indirect queue is of type intrapartition. Similarly, you can delete remote queues if the associated queue is defined as intrapartition in the remote system. If you attempt to delete an indirect or remote queue that is associated with an extrapartition queue, an error message will display explaining that extrapartition queues cannot be deleted.

A queue should be manually deleted when

n it is associated with an out-of-service devicen it was created in errorn records in the queue contain an error as a result of a bug in the application that wrote the

recordsTo delete a queue, do one of the following:

n enter D next to an ID with queue type Intra, Indirect, or Remote on the Destination Control Table panel (shown below), then press Enter. A confirmation pop-up displays after you select a queue, so you can confirm the deletion.

n enter / next to an ID with queue type Intra, Indirect, or Remote on the Destination Control Table panel, then press Enter. The Actions pull-down displays so you can select Delete Queue. After you press Enter, a confirmation pop-up displays so you can confirm the deletion.



FIGURE 144. Destination Control Table Panel

An authorized user can delete a transient data queue from the detailed panel for a particular queue type by navigating from the Destination Control Table panel to one of the following panels:

n DCT Intrapartition Information

n DCT Indirect Information

n DCT Remote Information panel

Enter A to display the Actions pull-down, then select D (for Delete Queue) to delete the queue displayed on the panel. A confirmation pop-up displays after you select Delete Queue, so you can confirm the deletion.

The following figure shows a detailed panel for the intrapartition queue.

____ Actions GoTo View Index Options Help ------------------------------------------------------------ 10/04/94 16:16:18 KC2P12D Destination Control Table (DCT) Region: CICSPROD Fastpath: =CD Auto(60) Lines ___1 to 12 of 25 +-----------+-----------+----------+----------+----------+---------+---------+ | Queue | Queue | Queue | Indirect | ATI | ATI | Trigger | | ID | Type | Status | Queue | Facility | Tran ID | Level | |-----------+-----------+----------+----------+----------+---------+---------| | _ CADL | Indirect | | CSSL | | | | | _ CDBC | Indirect | | CSSL | | | | | _ CDUL | Indirect | | CSSL | | | | | _ CPLD | Indirect | | CPLI | | | | | _ CPLI | Extra | Ena Ope | | | | | | _ CRDI | Indirect | | CSSL | | | | | _ CSCS | Indirect | | CSSL | | | | | _ ATDQ | Intra | Ena | | Term | PRT1 | 2 | | _ CSFL | Indirect | | CSSL | | | | | _ CSML | Indirect | | CSSL | | | | | _ CSMT | Indirect | | CSSL | | | | | _ CSSL | Extra | Ena Ope | | | | | +-----------+-----------+----------+----------+----------+---------+---------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status



FIGURE 145. DCT Intrapartition Information Panel

For more information on the Transient Data panels, see the OMEGAMON II for CICS Reference Manual.

Analyze Transient Data Problems from the Region StatusYou can analyze Transient Data problems when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to TranData to view the Analyze Transient Data Problems panel, shown in the following figure.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 10/04/94 16:19:38 KC2P15D DCT Intrapartition Information Region: CICSPROD Fastpath: =CDP Auto(60) +-------------------------------------+--------------------------------------+ | Queue ID . . . . . . . L55E + | _ DCTE address . . . . . : 05E94D18 | | Queue status . . . . : Enabled | Use count . . . . . . . : 0 | | Queue type . . . . . : Intra | Resource security level : n/a | +-------------------------------------+--------------------------------------+ Intrapartition Information +-------------------------------------+--------------------------------------+ | Trigger level . . . . : 1 | Queue start RBA . . . . : 00000000 | | Queue length . . . . : 0 | Input RBA . . . . . . . : 00000000 | | Recovery . . . . . . : None | Output RBA . . . . . . : 00000000 | | _ ATI transaction ID . : DEGV | _ Address of input TCA . : None | | _ ATI facility ID . . . : L55E | _ Address of output TCA . : None | | Facility type . . . . : Terminal | | +-------------------------------------+--------------------------------------+




FIGURE 146. Analyze Transient Data Problems Panel


Selecting a problem listed displays either the Transient Data Statistics panel or the DCT Intrapartition Information panel as appropriate.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 12:21:04 KC2B02D Analyze Transient Data Problems Region: CICSPROD Auto(60) +-------------------------------------+------------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | |-------------------------------------+------------+------------+------------| | _ TD buffers % in use | 100% | 75% | 85% | | _ TD buffers current waits | 2 | 2 | 5 | | _ TD strings % in use | 75% | 75% | 85% | | _ Dest L55E records over trigger | 5 | 5 | 10 | +-------------------------------------+------------+------------+------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status


Web Interface

Web InterfaceA Web-status light has been added to the Region Status panel allowing you to navigate to the Web Interface panel. Details about Web access are displayed here. The new panel lets you know if the interface is enabled or disabled. If the interface is disabled, the system informs you of this.

The new status light is available in CICS version 5.2 and above.

Following is a sample Web Interface panel.

FIGURE 147. Web Interface panel

The interface status exists in one of these states:

n Enabledn Disabledn Normal disabledn Immediate disablen Not disabledn Not installedThe External Security exists in one of these states:

n N/A n Nonen EnabledThe Trace Status exists in one of these states:

n N/A n Startedn Stopped

____ Actions GoTo Index Options Help ------------------------------------------------------------ MM/DD/YY 12:21:04 KC2E01D Web Interface Region: CICSPROD Fastpath: =RW Auto(60) +----------------------------------------------------------------------------+| Interface status . . . : Enabled || Host IP address . . . : 198.210.51.162 || Local IP name . . . . : sp13.candle.com |+----------------------------------------------------------------------------++----------------------------------------------------------------------------+| Port number . . . . . : 3001 External security . : None || Backlog . . . . . . : 10 _Analyzer name . . . : DFHWBADX || CWBM userid . . . . . : CICSUSER Default userid . . : CICSUSER || Trace status . . . . : n/a _Web anchor block . : 09EF600 || _ HTTP global work area : 00046004 |+----------------------------------------------------------------------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status PA1=Switch

TCP/IP Socket Activity


TCP/IP Socket ActivityA new status light has been added to the Region Status panel. From this status light, you can see the current status of the TCP/IP Socket Interface. The new status light is based on the following thresholds:

FIGURE 148. TCP/IP Thresholds

The new TCP/IP Socket Activity panel displays the details of the TCP/IP connection and the tasks using the TCP/IP sockets user exit.

Following is a sample TCP/IP Socket Activity panel:

FIGURE 149. TCP/IP Socket Activity

+---------------------------------------------------------------------+| KC2TCPT TCP/IP Thresholds || || Type any changes, then press Enter. || || Performance Measure Warning Critical Monitor + || ---------------------------- ------- -------- --------- || TCP/IP user exit not enabled . . . On + Off + No || TCP/IP listener failed . . . . . . On + Off + No || TCP/IP application waitig . . . . On + Off + No || || Frequency of data collection . . . 5 (1-99) || || F1=Help F4=Prompt F5=Refresh F12=Cancel F18=Default |+---------------------------------------------------------------------+

____ Actions GoTo View Index Options Help------------------------------------------------------------- MM/DD/YY 12:21:04 KC2S01D TCP/IP Sockets Activity Region: CICSPROD Fastpath: =RT Auto(60)+-----------------------------------------------------------------------------+| TCP/IP address space: TCPIP13 | _Global work area : 0045004 || _TRUE module . . . . : EZACIC01 | User exit status : Enabled || Number of listeners : 3 | _Error messages queue: TCPM |+-----------------------------------------------------------------------------+ CICS Tasks Using TCP/IP+-----------------------------------------------------------------------------+| Task | Tran | | Current | Return | Appl | Listener || Number | ID | Socket | Request | Code | Status | Status |+-----------------+--------+----------------+--------+--------+---------------+| _ 80 | CSKL | 0 | READ | | Active | Process || _ 81 | LST2 | 0 | GIVESOCKET | 37 | Active | Process || _ 82 | LST3 | 1 | SELECTX | | Waiting| Select || _ 83 | LST4 | 2 | CONNECT | 61 | Waiting| Error || _ 106 | TCPT | 1 | GETHOSTBYNAME | | Active | || _ 107 | AAAB | 3 | TAKESOCKET | | Active | || | | | | | | || | | | | | | |+-----------------------------------------------------------------------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status PA1=Switch

Monitoring Message Queueing 215

Monitoring Message Queueing

IntroductionThis chapter describes the facility for monitoring Message Queueing (MQ) for OMEGAMON II for CICS.

The purpose of this facility provides the OMEGAMON II for CICS user with statistics about the MQ activity within a CICS region.

Chapter ContentsOverview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216CUA Panels for MQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 217Implementing MQ. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218MQ Monitoring Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219Displaying Application Trace Data for MQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226Resource Limiting of MQ Requests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228

7

Overview


OverviewThe facility provides:

n An MQ status light on the OMEGAMON II for CICS Region Status panel.

n Common User Interface (CUA) panels in OMEGAMON II for CICS, on which the user can display statistics about CICS tasks using MQ.

n CUA panels for specifying MQ monitoring options including:

– Specifying thresholds for controlling the MQ status light.

– Specifying how often MQ statistics relating to CICS task activity are collected.

– Identifying where statistics are stored (the OMEGAMON II for CICS task history collector data store for online task history display and/or System Management Facility (SMF) for batch reporting).

– Turning MQ statistics collection on and off.

This facility also provides an enhancement to the DATABASE_COLLECTION parameter for specifying MQ monitoring options as an alternative to using the CUA panels in OMEGAMON II for CICS.

RequirementsThe MQ status light on the Region Status panel and the CICS-MQ connection statistics panels are available for CICS/ESA Version 3.3 and higher regions. The MQ task history panels with clocks and counters data are available for CICS/ESA Version 4.1 and higher regions.


CUA Panels for MQ

CUA Panels for MQ

Panel AvailabilityThe following CUA panels contain the MQ-related information for CICS/ESA, Version 3.1 and higher:

n Region Status

n MQ Thresholds

n MQ Activity

n CICS Tasks using MQ

n MQ Statistics

n API Requests

All of these panels are new with the exception of the Region Status panel.

Implementing MQ


Implementing MQ

Configuration requirements for MQBefore you can use MQ, you must perform the following configuration steps

1. Define an event monitoring point (EMP) in the CICS monitoring control table (MCT).

2. Specify a parameter name for MQ in the USER_EVENT_MONITORING parameter.

3. Specify a parameter name for MQ in the DATABASE_COLLECTION parameter.

See the OMEGAMON II for CICS Configuration and Customization Guide for these detailed instructions.

Controlling the collection of MQ file-level statisticsYou can control collection of MQ file-level statistics online from the CICS File/Database Collection pop-up. The fastpath to this pop-up shown below is OOF.

FIGURE 150. CICS File/Database Collection pop-up

+----------------------------------------------------------------+| KC2QCOL CICS File/Database Collection || || Type any changes, then press Enter. || || Product Task-level File-level Write to Write to || Type Monitor Monitor Data Store SMF || -------- ---------- ----------- ---------- -------- || VSAM On Off + Off + Off + || DB2 On_ + || DL/I On_ + Off + Off + Off + || MQ On_ + On_ + On_ + Off + || ADABAS Off + Off + Off + Off + || DATACOM Off + Off + Off + Off + || IDMS Off + Off + Off + Off + || SUPRA Off + Off + Off + Off + || USREVNT1 On_ + On_ + On_ + Off + | | || F1=Help F4=Prompt F5=Refresh F12=Cancel F18=Default |+----------------------------------------------------------------+


MQ Monitoring Functions


Region Status PanelThere are two versions of the OMEGAMON II for CICS Region Status panel with an MQ status light, depending on the version of CICS/ESA you are monitoring:

n One for CICS/ESA Versions 3.3 and 4.1

n One for CICS/ESA Version 5.1 and higher

These panels are shown below and on the following page.

FIGURE 151. Region Status Panel (CICS/ESA Versions 3.3 and 4.1)

_____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/15/97 10:02:01 KC2B01D Region Status Region: TDOCS56 + Auto(Off) Select one component with a / or an action code. S=Show details A=Analyze problems L=Control +------------------+-------------------------------------+-------------------+ | Workloads | Resources | Alerts | |------------------+-------------------------------------+-------------------} | _ AIDs Idle | _ CPU Idle _ MQ OK | _ Bottlnck Idle | | | | | | _ ICEs Idle | _ DASD Idle _ MRO/ISC Idle | _ CICSloop Idle | | | | | | _ Response Idle | _ DB2 Idle _ Paging Idle | _ Dumps Idle | | | | | | _ Tasks Idle | _ DBCTL Idle _ Storage OK | _ Enqueues Idle | | | | | | _ TranRate Idle | _ DL/I Idle _ Tapes Idle | _ I/O Rate Idle | | | | | | | _ Files Idle _ TempStor Idle | _ VTAM ACB Idle | | | | | | | _ Journals Idle _ TranData Idle | _ XRF Idle | | | | | | | _ LSR Idle | | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print PA1=Switch



FIGURE 152. Region Status Panel (CICS/ESA Version 5.1 and higher)

Specifying Thresholds for Monitoring MQ StatusPerform the following procedure to specify the thresholds for controlling the behavior of the MQ status light on the Region Status panel:

1. Type action code L in the entry field preceding the MQ resource on the Region Status panel. The MQ Thresholds panel is displayed.

_____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/15/97 10:02:01 KC2B01D Region Status Region: TDOCS56 + Auto(Off) Select one component with a / or an action code. S=Show details A=Analyze problems L=Control +------------------+-------------------------------------+-------------------+ | Workloads | Resources | Alerts | |------------------+-------------------------------------+-------------------| | _ AIDs Idle | _ CPU Idle _ MRO/ISC Idle | _ Bottlnck Idle | | | | | | _ ICEs Idle | _ DASD Idle _ Paging Idle | _ CICSloop Idle | | | | | | _ Response Idle | _ DB2 Idle _ Storage OK | _ Dumps Idle | | | | | | _ Tasks Idle | _ DBCTL Idle _ Tapes Idle | _ Enqueues Idle | | | | | | _ TranRate Idle | _ Files Idle _ TCP/IP Idle | _ I/O Rate Idle | | | | | | _ UOWs Idle | _ Journals Idle _ TempStor OK | _ VTAM ACB Idle | | | | | | | _ LSR Idle _ TranData OK | _ XRF Idle | | | | | | | _ MQ OK _ Web OK | | | | | | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print PA1=Switch



FIGURE 153. MQ Thresholds Panel

2. On the MQ Thresholds panel, you can take the following actions:n Start (Monitor=Yes) or stop (Monitor=No) monitoring the status of the MQ connection.

n Specify whether an inactive MQ connection status appears as a warning condition (Warning=On; Critical=Off) or critical condition (Warning=Off; Critical=On) on the MQ status light on the Region Status panel.

n Start (Monitor=Yes) or stop (Monitor=No) monitoring the status of busy Task Control Blocks (TCBs).

n Specify the number of busy TCBs that cause the MQ status light to signal a warning condition.

n Specify the number of busy TCBs that cause the MQ status light to signal a critical condition.

n Specify the frequency of data collection (from every 1 to every 99 seconds).

Refer to the field helps on this panel for a detailed description of the contents of each field.

_____ Actions GoTo Index Options Help - +--------------------------------------------------------------------------+ | KC2QMQM MQ Thresholds | | | | Type any changes, then press Enter. | | | + | Performance Measure Warning Critical Monitor + | | | ------------------------------------ ------- -------- ------- | + | MQ connection inactive . . . . . . . off + On + Yes | | | MQ Busy TCBS . . . . . . . . . . . . > 6 > 7 Yes | | | | | | Frequency of data collection . . . . 5 (1-99) | | | | | | F1=Help F4=Prompt F5=Refresh F12=Cancel F18=Default | | +--------------------------------------------------------------------------+ | _ Tasks Idle | _ DBCTL Idle Storage OK | _ Enqueues Idle | | | | | | _ TranRate Idle | _ DL/I Idle Tapes Idle | _ I/O Rate Idle | | | | | | | _ Files Idle TempStor Idle | _ VTAM ACB Idle | | | | | | | _ Journals Idle TranData Idle | _ XRF Idle | | | | | | | _ LSR Idle | | +------------------+-------------------------------------+-------------------+ F1=Help F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print PA1=Switch



Displaying Overview Information About Tasks Using MQTo display overview information about the MQ activity within the region being monitored:

1. Select the entry field preceding the MQ resource entry on the Region Status panel.The MQ Activity panel is displayed. This panel provides high-level information about the status of the CICS-MQ connection and the number of CICS tasks using MQ.

FIGURE 154. MQ Activity Panel

2. To display information about each CICS Task that is using MQ, select the CICS Tasks using MQ field on the MQ Activity panel and press Enter.The CICS Tasks using MQ panel is displayed.

_____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/15/97 10:11:07 KC2M01D MQ Activity Region: TDOCS56 Auto(Off+) +----------------------------------------------------------------------------+ | Adapter status . . . : Active | | Connection status . . : Connected | | Initiation queue . . : CICS01.INITQ | |--------------------------------------+-------------------------------------| | Queue manager . . . . . : QMQE | Trace number . . . . . : 1 | | MQ version . . . . . . : 1.1.3 | | | API exit . . . . . . . : Off | _ CICS Tasks using MQ . : 1 | +--------------------------------------+-------------------------------------+ MVS Subtasks +--------------------------------------+-------------------------------------+ | Attached TCBs . . . . . : 8 | Active TCBs . . . . . : 8 | | Busy TCBs . . . . . . . : 0 | | +--------------------------------------+-------------------------------------+

(MQ) <Statistics> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status PA1=Switch



FIGURE 155. CICS Tasks using MQ Panel

3. Place the cursor in the entry field preceding the Task Number and press Enter to display the Task Details panel for the selected task.See the OMEGAMON II for CICS Reference Manual for more information about the Task Details and related task panels. Refer to the field helps on each panel for a detailed description of field contents.

_____ Actions GoTo View Index Options Help ------------------------------------------------------------ 05/15/97 10:16:50 KC2M03D CICS Tasks using MQ Region: TDOCS56 Auto(Off) +----------+----------+----------+----------+----------+----------+----------+| Task | Tran | User | API | Last | Task | Thread || Number | ID | ID | Requests | Request | Status | Status ||----------+----------+----------+----------+----------+----------+----------|| _ 42 | CKTI | CICSUSER | 2 | MQGET | Normal | WaitMsg |+----------+----------+----------+----------+----------+----------+----------+

F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status PA1=Switch



Displaying API, Syncpoint, and Recovery StatisticsTo display statistics about the number of API requests, syncpoint activity, and recovery activity for CICS tasks using MQ:

1. Select the Statistics pushbutton on the MQ Activity panel. The MQ Statistics panel is displayed.

FIGURE 156. MQ Statistics Panel

2. To display a breakdown of API requests by request type, select the API Requests field on the MQ Statistics panel and press Enter. The API Requests pop-up panel is displayed.

_____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/15/97 10:20:35 KC2M02D MQ Statistics Region: TDOCS56 Auto(Off)+--------------------------------------+-------------------------------------+| _ API requests . . . . . : 4226 | Flow calls . . . . . . : 4756 || Run OK . . . . . . . . : 3169 | SyncComp . . . . . . . : 3699 || Futile . . . . . . . . : 0 | SuspReqd . . . . . . . : 0 || Getwait . . . . . . . . : 1 | Switched . . . . . . . : 4755 || Msgwaited . . . . . . . : 1 | |+--------------------------------------+-------------------------------------+ Syncpoint Statistics Recovery Statistics+--------------------------------------+-------------------------------------+| Tasks . . . . . . . . . : 529 | Indoubt . . . . . . . : 0 || Backout . . . . . . . . : 0 | Unresolved . . . . . . : 0 || Commit . . . . . . . . : 0 | Commit . . . . . . . . : 0 || S-Phase . . . . . . . . : 0 | Backout . . . . . . . : 0 || 2-Phase . . . . . . . . : 0 | |+--------------------------------------+-------------------------------------+

<MQ> (Statistics) F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status PA1=Switch



FIGURE 157. API Requests Panel

Refer to the field helps on each panel for a detailed description of the contents of each field.

_____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/15/97 10:23:44 KC2M02D MQ Statistics Region: TDOCS56 Auto(Off) +--------------------------------------+-------------------------------------+| API requests . . . . . : 4226 | Flow calls . . . . . . : 4756 || +-------------------------------------------+ p . . . . . . . : 3699 || | KC2M02P API Requests | d . . . . . . . : 0 || | | d . . . . . . . : 4755 || | MQOPEN requests . . . . . : 1585 | |+-- | MQCLOSE requests . . . . . : 528 | ---------------------------+ | MQGET requests . . . . . . : 529 | | MQPUT requests . . . . . . : 528 | covery Statistics+-- | MQPUT1 requests . . . . . : 0 | ---------------------------+| | MQINQ requests . . . . . . : 528 | . . . . . . . : 0 || | MQSET requests . . . . . . : 528 | ved . . . . . . : 0 || | Miscellaneous requests . . : 0 | . . . . . . . . : 0 || | | . . . . . . . : 0 || | F1=Help F12=Cancel | |+-- +-------------------------------------------+ ---------------------------+

<MQ> (Statistics) F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status PA1=Switch

Displaying Application Trace Data for MQ



IntroductionIf you are monitoring CICS/ESA Version 4.1 or above, you can collect application trace data for MQ API calls at the task level.

Displaying Application Trace Facility details for MQ tasks

1. On the Task History panel, select an entry for a task that used MQ from the Task End Time column by typing ’T’.

2. Press Enter to display the Application Trace panel for the selected task.

FIGURE 158. Application Trace panel

3. From the Application Trace panel, select a RMIIN or RMIOUT entry in the Trace Type column.

4. Press Enter to display the Application Trace Entry panel for the selected entry.

_____ Actions GoTo View Locate Index Options Help ------------------------------------------------------------ 11/26/97 11:44:55 KC2T50D Application Trace Region: CICSPROD Auto(Off) +--------------------------------------+-------------------------------------+ | Task number . . . . . . : 183 | Transaction ID . . . . : AMG3 | +--------------------------------------+-------------------------------------+ Lines _1 to 15 of 60 +----------+---------+------+-----------------+--------+----------+----------+ | Trace | Program |Offset| Function |Resource|Response | Elapsed | | Type | | | | | | Time | |----------+---------+------+-----------------+--------+----------+----------| | _ TSKSTRT| DKJMQ1 | | 1ST DISPATCH | | | 0.289392 | | _ EXECIN | DKJMQ1 | 78| ADDRESS |COMMAREA| | 0.154303 | | _ EXECOUT| DKJMQ1 | 78| ADDRESS |FF000000|NORMAL | 0.000084 | | _ EXECIN | DKJMQ1 | B0| GETMAIN | 24000| | 0.000050 | | _ EXECOUT| DKJMQ1 | B0| GETMAIN |00100A58|NORMAL | 0.000264 | | _ RMIIN | DKJMQ1 | 988| RESOURCE MANAGER|MQM | | 0.000045 | | _ EXECIN | DKJMQ1 |FFFFFF| ASSIGN | | | 0.233211 | | _ EXECOUT| DKJMQ1 |FFFFFF| ASSIGN | |NORMAL | 0.000194 | | _ EXECIN | DKJMQ1 |FFFFFF| ASSIGN | | | 0.000057 | | _ EXECOUT| DKJMQ1 |FFFFFF| ASSIGN | |NORMAL | 0.000147 | | _ EXECIN | DKJMQ1 |FFFFFF| ENTER TRACENUM | 123| | 0.000457 | | _ EXECOUT| DKJMQ1 |FFFFFF| ENTER TRACENUM | 123|NORMAL | 0.021286 | | _ EXECIN | DKJMQ1 |FFFFFF| ENTER TRACENUM | 123| | 0.779266 | | _ EXECOUT| DKJMQ1 |FFFFFF| ENTER TRACENUM | 123|NORMAL | 0.000189 | | _ RMIOUT | DKJMQ1 |FFFFFF| RESOURCE MANAGER|MQM |00000000 | 0.026985 | +----------+---------+------+-----------------+--------+----------+----------+ <Details> <Storage> <Timings> <Statistics> <Task Terminal> (Trace) F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status PA1=Switch



FIGURE 159. Application Trace Entry panel

_____ Actions GoTo Index Options Help ------------------------------------------------------------ 11/26/97 11:45:19 KC2T52D Application Trace Entry Region: CICSPROD Auto(Off) +--------------------------------------+-------------------------------------+ | Task number . . : 183 | Transaction ID : AMG3 | +--------------------------------------+-------------------------------------+ +--------------------------------------+-------------------------------------+ | Time . . . . . : 11:24:07.231469 | Function code : 0082 | | Trace type . . : RMIIN | Command . . . : RESOURCE MANAGER | | _ Program . . . . : DKJMQ1 | Resource . . . : MQM | | _ Offset . . . . : 988 | | | Elapsed time . : 00:00:00.000045 | | +--------------------------------------+-------------------------------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F7=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status PA1=Switch

Resource Limiting of MQ Requests


Resource Limiting of MQ Requests

IntroductionIf you want to limit the number of MQ API requests that a task can issue, you can use the Resource Limiting feature of OMEGAMON II for CICS. With this feature, you can specify a warning threshold that will result in a message if a task issues more than the specified number of MQ requests. You can also specify a kill limit that will result in an RLMQ abend if a task exceeds the specified threshold.

Specifying thresholdsYou specify thresholds in the global data area module using the RESOURCE_LIMITING parameter as follows:

RESOURCE_LIMITING ENTRY,RESOURCE=MQ,

LIMIT=(mmmmmmmm,nnnnnnnnn),INCLUDED_TRANS=(aaaa,bbbb)

RESOURCE_LIMITING ENTRY,RESOURCE=MQ,

LIMIT=(mmmmmmmm,nnnnnnnnn),EXCLUDED_TRANS=(cccc,dddd)

where mmmmmmm is the kill limit and nnnnnnnn is the warning limit.

For further information on the RESOURCE_LIMITING parameter, see the OMEGAMON II for CICS Configuration and Customization Guide for Version 520 in the Global Data Area Module chapter.

Note: You can also specify resource limits dynamically from the Resource Limits panel in the CUA interface (fastpath OOLL).

Responding to Alerts 229

Responding to Alerts

IntroductionThis chapter describes the Alerts portion of the Region Status panel. Alerts allow you to anticipate problems and to take corrective action or preventative measures before problems become critical.

Alerts may be raised for the following reasons:

n Bottlenecks

n CICS loop

n Dumps

n Enqueues

n I/O rate

n VTAM ACB

n XRF

Chapter ContentsBottlenecks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230CICS Loop (CICS Time-of-Day Clock) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234Dumps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236Enqueues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238I/O Rate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241VTAM ACB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245XRF (Extended Recovery Facility) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247

8

Bottlenecks


BottlenecksBy selecting Bottlenecks from the Region Status panel (type S to show details) you see the Internal Bottlenecks panel.

See a Summary of Bottlenecks in the CICS RegionThe Internal Bottlenecks panel displays a summary of all the detected bottlenecks in the CICS region, sorted in descending order of bottleneck ratio for each category of resource type.

If multiple bottlenecks exist for a given resource type with different resource names, the total ratio for the resource type is displayed with a resource name of *TOTAL*, followed by the ratios for all bottlenecks belonging to the category listed in descending order.

The following figure shows the panel.


Since waiting for resources to become available, or events to complete, can have a significant impact on response time, you should identify which resources are responsible for these waits in order to minimize response time.

A group name can be entered in the Group Name field. The resulting panel will list only those bottlenecks impacting elements belonging to the group. Press F4 to see a list of valid names for the field. You can also enter an asterisk (*) in the field to display contention for all transactions. For information on defining groups, see “Defining Response Time Groups for Monitoring” on page 251.

____ Actions GoTo View Index Options Help ----------------------------------------------------------- 05/24/93 16:05:50 KC2L01D Internal Bottlenecks Region: CICSPROD Fastpath: =AB Auto(60) +-----------------------------------------+---------------------------------+ | Group name . . . . . . PAYROLL_____ + | Samples taken . . . : 59 | | Collection interval : 1:00 MN | Elapsed time . . . . : 10 SEC | +-----------------------------------------+---------------------------------+ Lines ___1 to 7 of 10 +------------+------------+-----------+-------------------------------------+ | Resource | Resource | Wait | Bottleneck | | Type | Name | Type | Ratio 0.....................100 | |------------+------------+-----------+-----------+------------!--!---------| | _ RUNNING | RUNNING | CPU | 9% |----> | | _ FCIOWAIT | *TOTAL* | FILE | 6% |--> | | _ FCIOWAIT | FILEA | FILE | 4% |-> | | _ FCIOWAIT | FILEB8CH | FILE | 2% |> | | _ TSBUFFER | (NONE) | TEMPSTOR | 5% |--> | | _ PROGRAM | BIGPROG0 | LOADER | 3% |-> | | _ IRLINK | SYS2 | MRO | 1% |> | +------------+------------+-----------+-----------+-------------------------+ (Internal Bottlenecks) <External Contention> <Response Time Details> F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status


Bottlenecks

For more information on the Bottlenecks panels, see the OMEGAMON II for CICS Reference Manual.


Use the View pull-down to filter the contents of the Internal Bottlenecks panel by selecting Some or Problems for all groups or for a particular group. Sort the panel contents using the following selections:



n Sort by wait type

n Sort by bottleneck ratio

Internal Bottlenecks Pushbuttons

The pushbuttons at the bottom of the panel allow you to navigate to the following panels:

Select a Resource Type for Details

To see details for a particular resource type listed in the Resource Type field of the Internal Bottlenecks panel, enter S in the entry field. The Internal Bottleneck Details panel then displays.

This Pushbutton: Leads to this Panel:External Contention External ContentionResponse Time Response Time Details

Bottlenecks


FIGURE 161. Internal Bottleneck Details Panel

This panel shows how demand for a particular resource type is affecting the groups you have defined.

Analyze Bottleneck Problems from the Region StatusYou can analyze problems for Bottlenecks when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to Bottlenecks to view the Analyze Bottleneck Problems panel, shown in the following figure.

____ Actions GoTo View Index Options Help ------------------------------------------------------------ 05/24/93 16:06:50 KC2L02D Internal Bottleneck Details Region: CICSPROD Fastpath: =ABD Auto(60) +----------------------------------------------------------------------------+ | Resource type . . . . FCPSWAIT + Resource name . . . . : LOGFILE1 | | Description . . . . : FC: Private string | +----------------------------------------------------------------------------+ Lines ___1 to 8 of 30 +----------------+----------------+------------------------------------------+ | Group | Group | Bottleneck | | Name | Type | Ratio 0......................100 | |----------------+----------------+---------------+--------------------------| | _ ATMSTRANSGRP | Tran | 20% |----> | | _ VTAM0401 | LU | 15% |---> | | _ PRODTRAN | Tran | 10% |--> | | _ ACCOUNTS | Tran | 5% |-> | | _ RECEIVE | Tran | 0% | | | _ PURCHASE | Tran | 0% | | | _ MGMTLVL1 | Term | 0% | | | _ DEVALVL1 | Term | 0% | | +----------------+----------------+---------------+--------------------------+ F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status


Bottlenecks

FIGURE 162. Analyze Bottleneck Problems Panel


Select a problem to display the Internal Bottleneck Details panel.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 16:07:16 KC2B02D Analyze Bottleneck Problems Region: CICSPROD Auto(60) +-------------------------------------+------------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | +-------------------------------------+------------+------------+------------| | _ Bottleneck ratio for ICWAIT | 90% | 50% | 60% | +-------------------------------------+------------+------------+------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status

CICS Loop (CICS Time-of-Day Clock)


CICS Loop (CICS Time-of-Day Clock)By selecting CICSloop from the Region Status panel (enter S to show details) you display the Common System Area (CSA) panel.

Check the CICS Time-of-Day ClockUse the CICS time-of-day field on the CSA panel to check the status of the CICS time-of-day clock. When this clock is not being updated, the CICS dispatcher is not getting control. This condition may be caused by a looping task.

This panel also presents some general highlights of the CSA control block, and is a gateway for further information through its selectable fields. The following figure shows the panel.

FIGURE 163. CSA Panel

The top part of the panel displays status information on CICS and the bottom part displays control block and module addresses. You can select the following fields from this panel:

n Current tasksn System at MXT limitn System at CMXT limitn System short-on-storagen Any control block addressFor more information on the CSA panels, see the OMEGAMON II for CICS Reference Manual.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 16:07:35 KC2P02D Common System Area (CSA) Region: CICSPROD Fastpath: =AC Auto(60) +-------------------------------------+--------------------------------------+ | CICS release . . . . : 4.1.0 | _ Current tasks . . . . . : 13 | | MVS release . . . . . : 4.3.0 | Total task counter . . : 52 | | Start-up date . . . . : 05/24/93 | _ System at MXT limit . . : No | | Start-up time . . . . : 14:44:52 | _ System at CMXT limit . : No | | CICS time-of-day . . : 16:07:34 | _ System short-on-storage : No | +-------------------------------------+--------------------------------------+ Control Blocks +-------------------------------------+--------------------------------------+ | _ CSA . . . . . . . . . : 00067160 | _ DCT (Destinations) . . : 05E982B8 | | _ CSA optional features : 00045FE8 | _ JCT (Journals) . . . . : 00049E20 | | _ CWA . . . . . . . . . : 00067368 | _ SIT (Initialization) . : 85E1F978 | | _ ICE chain . . . . . . : 060D10F0 | _ TCT (Prefix) . . . . . : 00051FD0 | | _ Static storage list . : 05FF1000 | _ TST (Temporary storage) : 00000000 | | _ File control . . . . : n/a | _ TSUT (First unit table) : n/a | | _ Interval control . . : 85E9E5C4 | _ SRT (Recovery) . . . . : 85EF7230 | | _ Task control . . . . : 85EA9E28 | _ XLT (Exclusion list) . : 00000000 |+-------------------------------------+--------------------------------------+



CICS Loop (CICS Time-of-Day Clock)

Analyze CICS Loop Problems from the Region StatusYou can analyze CICS loop problems when the CICSloop status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to CICSloop to view the Analyze CICS Loop Problems panel, shown in the following figure.

FIGURE 164. Analyze CICS Loop Problems Panel


Select the listed problem to display the Common System Area (CSA) panel.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 16:23:19 KC2B02D Analyze CICS Loop Problems Region: CICSPROD Auto(60) +--------------------------------------+-----------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | |--------------------------------------+-----------+------------+------------| | _ CICS time-of-day clock not updated | On | On | Off | +--------------------------------------+-----------+------------+------------+


Dumps


DumpsBy selecting Dumps from the Region Status panel (enter S to show details) you display the Dumps summary panel.

See the Status of Dump DatasetsThe Dumps summary panel shows the current state of the Dump datasets and the Dump history by dump code. The following figure shows the panel (this example is for CICS/ESA only).

FIGURE 165. Dumps Panel

The selectable fields on this panel are Anchor Address, which navigates to the CICS Memory panel, and Current Extent DFHDMPx, which navigates to the File Details panel.

For more information on the Dumps panels, see the OMEGAMON II for CICS Reference Manual.


Use the View pull-down menu to filter the contents of the panel by selecting Some. Sort the contents of the panel using one of these selections:

n Sort by dump code

n Sort by dump type

n Sort by max allowed

____ Actions GoTo View Index Options Help ------------------------------------------------------------ 05/24/93 16:29:53 KC2P05D Dumps Region: CICSPROD Fastpath: =AD Auto(60) +-------------------------------------+--------------------------------------+ | Dump dataset status . : Closed | _ Anchor address . . . . : 05D7C4D0 | | Switch status . . . . : Manual | Total dumps taken . . . : 2 | | System dump suppression: Off | Total system dumps . . : 0 | | Dump taking place . . : No | Total transaction dumps : 2 | |-------------------------------------~--------------------------------------| | _ Current extent DFHDMPB : TDCICS1.TOC.TDOCS22.DFHDMPB | +----------------------------------------------------------------------------+ +-------------+----------+---------+----------+----------+--------+----------+ | Dump | Dump | Maximum | System | System | Tran | Tran | | Code | Type | Allowed | Taken |Suppressed| Taken |Suppressed| |-------------+----------+---------+----------+----------+--------+----------| | AED7 | Tran | None | 0 | 2 | 2 | 0 | | AEXY | Tran | None | 0 | 1 | 0 | 1 | | AICA | Tran | None | 0 | 7 | 0 | 7 | | EIKI | Tran | None | 0 | 6 | 0 | 6 | +-------------~----------~---------~----------~----------~--------~----------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status


Dumps

n Sort by system taken

n Sort by system suppressed

n Sort by tran taken

n Sort by tran suppressed

Analyze Dump Problems from the Region StatusYou can analyze problems for Dumps when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to the alert to go to the Analyze Dumps Problems panel, shown in the following figure.

FIGURE 166. Analyze Dump Problems Panel


Select any problem to display the Dumps panel.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 16:24:20 KC2B02D Analyze Dump Problems Region: CICSPROD Auto(60) +--------------------------------------+-----------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | |--------------------------------------+-----------+------------+------------| | _ CICS taking an SDUMP | On | Off | On | | _ System dumps | 1 | 0 | 1 | | _ Transaction dumps | 34 | 24 | 50 | +--------------------------------------+-----------+------------+------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status

Enqueues


EnqueuesBy selecting Enqueues on the Region Status panel (enter S to show details) you display the Enqueues panel.

See Current Enqueues in the CICS RegionThe Enqueues panel shows all current enqueues in the region, information on the owning task, and how many, if any, other tasks are waiting for the same enqueue resource. This panel focuses on all enqueues in CICS, including those that may not be causing any conflicts.

The Number of Enqueue Conflicts field displays the total number of tasks waiting to enqueue on any resource. Select the Conflicts pushbutton to display these tasks.

FIGURE 167. Enqueues Pane

Selectable Fields on Enqueues

Selectable fields on this panel are as follows:l


Use the View pull-down menu to filter the contents of the panel by selecting Some or Problems. Sort the panel contents using one of the following selections:

n Sort by enqueue resource

n Sort by waiting tasks

Enqueue Resource Navigates to the Enqueue Details panelOwning Task No. Navigates to the Task Details panel

____ Actions GoTo View Index Options Help ------------------------------------------------------------ 05/24/93 16:41:08 KC2D02D Enqueues Region: CICSPROD Fastpath: =AE Auto(60) +----------------------------------------------------------------------------+ | Number of enqueue conflicts: 1 | +----------------------------------------------------------------------------+ +------------+---------+----------+----------+---------+----------+----------+ | Enqueue | Waiting | Resource | Owning | Owning | Resource | Resource | | Resource | Tasks | Length | Task No | Tran ID | Type | Name | |------------+---------+----------+----------+---------+----------+----------| | _ ENQWAIT | 1 | 7 | _ 658 | OEN2 | EKCWAIT | SINGLE | | _ 86069A10 | 0 | | _ 658 | OEN2 | EKCWAIT | SINGLE | | _ 86069A09 | 0 | | _ 658 | OEN2 | EKCWAIT | SINGLE | | _ ENQWAI + | 0 | 9 | _ 658 | OEN2 | EKCWAIT | SINGLE | +------------+---------+----------+----------+---------+----------+----------+ <Conflicts> (Enqueues) F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status


Enqueues

n Sort by owning task number

n Sort by owning transaction ID

Pushbutton on Enqueues

The pushbutton at the bottom of the panel allows you to navigate as follows:

Selecting Details for an Enqueue

When you select a particular enqueue in the Enqueue Resource column on the Enqueues panel or on the Enqueue Conflicts panel, (enter S), the Enqueue Details panel displays. The following figure shows the panel.

FIGURE 168. Enqueue Details panel

This panel shows details for a particular enqueue resource you selected. Two types of enqueue resources can be displayed in the top portion of this panel: a variable-length resource name or a fixed four-byte address. The resource name is displayed in both character and hexadecimal format. For address enqueue resources, the resource name is displayed as an address only.

For more information on all the Enqueues panels, see the OMEGAMON II for CICS Reference Manual.

This Pushbutton: Leads to this Panel:Conflicts Enqueue Conflicts

____ Actions GoTo View Index Options Help ------------------------------------------------------------ 05/24/93 16:46:23 KC2D03D Enqueue Details Region: CICSPROD Fastpath: =AED Auto(60) +----------------------------------------------------------------------------+ | _ Enqueue resource (char): ENQWAIT.FILEA | | Enqueue resource (hex) : CDDECCE4CCDCC | | 5586193B69351 | |--------------------------------------+-------------------------------------| | Enqueue resource type : Variable | _ Queue element address : 08600030 | | Enqueue resource length: 13 | Waiting tasks . . . . : 0 | +--------------------------------------~-------------------------------------+ Task Profile +--------------+-------------+---------------+---------------+---------------+ | Task | Tran | Task | Resource | Resource | | Number | ID | Status | Type | Name | |--------------+-------------+---------------+---------------+---------------| | _ 1206 | UPDT | Owning | KCCOMPAT | TERMINAL | +--------------~-------------~---------------~---------------~---------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

Enqueues


Analyze Enqueue Problems from the Region StatusYou can analyze problems for Enqueues when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to Enqueues to view them Analyze Enqueues Problems panel, shown in the following figure.

FIGURE 169. Analyze Enqueue Problems Panel


Selecting problems listed on this panel will display either the Enqueue Details panel or the Enqueue Conflicts panel, depending on the problem.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 16:48:59 KC2B02D Analyze Enqueue Problems Region: CICSPROD Auto(60) +-------------------------------------+------------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | |-------------------------------------+------------+------------+------------| | _ Tasks waiting for enqueue ENQWAIT | 1 | 0 | 3 | +-------------------------------------+------------+------------+------------+



I/O Rate

I/O RateBy selecting I/O Rate from the Region Status panel (enter S to show details) you display the DASD I/O Rate panel.

See Total and CICS I/O Rates for DASDThe DASD I/O Rate panel shows both the total and CICS I/O rates either for all DASD devices or just for those devices on which CICS datasets are allocated. The following figure shows the DASD I/O Rate panel.

FIGURE 170. DASD I/O Rate Panel

____ Actions GoTo View Index Options Help ------------------------------------------------------------ 05/24/93 17:08:53 KC2K02D DASD I/O Rate Region: CICSPROD Fastpath: =AI Auto(60) +-------+------+------------------------------+------------------------------+ | Device|Volume| Total I/Os per second | CICS I/Os per second | | | | 0.................150 | 0................150 | |-------+------+--------+----------!!---------+---------+----------!!--------| | _ 169 |TSO002| 18 |--> | 0 |> | | _ 159 |OMON30| 11 |-> | 11 |-> | | _ 32A |OMON22| 1 |> | 0 |> | | _ 153 |OMON29| 0 |> | 0 |> | | _ 30C |PPSMP3| 0 |> | 0 |> | | _ 31C |OMON23| 0 |> | 0 |> | | _ 328 |OMON24| 0 |> | 0 |> | | _ 14B |OMON27| 0 |> | 0 |> | | _ 338 |OMON20| 0 |> | 0 |> | +-------+------+--------+---------------------+---------+--------------------+ <Performance> (I/O Rate) <Statistics> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status

I/O Rate


Display All or Allocated Devices

You can choose whether the DASD I/O Rate panel displays all devices or only those on which CICS datasets are allocated using the DASD Thresholds pop-up window. To do so, follow these steps:

1. Select Thresholds from the Options pull-down menu. The Thresholds pop-up window displays.

2. Select Resources. The Resources Thresholds pop-up window displays.

3. Select DASD. The DASD Thresholds pop-up window displays.

4. In the Display Only CICS DASD or All field, select CICS or All by pressing F4 to toggle between the settings. Press Enter. The Save Region Options pop-up displays.

5. Enter 1 to save the change only for this session; enter 2 to save the change to the region profile.


Use the View pull-down menu to filter the contents of the panel by selecting Some or Problems. Sort the panel contents using one of the following selections:

n Sort by device

n Sort by volume

n Sort by total I/Os per second

n Sort by CICS I/Os per second

DASD I/O Rate Pushbuttons

The pushbuttons on the bottom of the DASD I/O Rate panel navigate as follows:


When you select a particular device in the Device column on the DASD I/O Rate panel, the DASD Details for a Device panel displays. This panel gives you more information on the device you selected. The following figure shows the panel.

This Pushbutton: Leads to this Panel:Performance CICS DASD PerformanceStatistics DASD Statistics


I/O Rate

FIGURE 171. DASD Details for a Device Panel

To see details for a different device, enter the device or volume serial number in the Device and Volume fields on the panel, or press F4 while at either field for a list of devices or volumes. If you enter data into both fields and there is a discrepancy, the Device field takes precedence over the Volume field.

The one selectable field on the panel, CICS open DCBs, navigates to the CICS Datasets on a DASD Volume panel.

For more information on the I/O Rates panels, see the OMEGAMON II for CICS Reference Manual.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:29:58 KC2K05D DASD Details for a Device Region: CICSPROD Fastpath: =RDE Auto(60) +-------------------------------------+--------------------------------------+ | Device . . . . . . . . . 0156_+ | Volume . . . . . . . . . OMON30_+ | | Total open DCBs . . . : 95 | Total I/Os per second . : .6 | | _ CICS open DCBs . . . . : 8 | CICS I/Os per second . : 0 | | I/O queue . . . . . . : 0 | % busy . . . . . . . . : 35% | | DASD not ready . . . : No | DASD not responding . . : No | | Status . . . . . . . . : Online | Dynam. I/O configuration: Static | | Type . . . . . . . . . : 3380 | Response time period . : 4:13 MN |+-------------------------------------+--------------------------------------+

+--------------+-------------------------------------------------------------+ | Component | Response 0...............................................60 | |--------------+----------+-------------------!-----------!------------------| | IOS queue | 20ms|----------------> | | Pending | 25ms|--------------------> | | Connect | 7ms|-----> | | Disconnect | 25ms|--------------------> | | Total | 79ms|------------------------------------------------>>| +--------------+----------+--------------------------------------------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

I/O Rate


Analyze I/O Problems from the Region StatusYou can analyze problems for I/O Rate when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to I/O Rate to view the Analyze I/O Rate Problems panel, shown in the following figure.

FIGURE 172. Analyze I/O Problems Panel


Select the problem listed to display the DASD I/O Rate panel.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:29:36 KC2B02D Analyze I/O Problems Region: CICSPROD Auto(60) +-------------------------------------+------------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | |-------------------------------------+------------+------------+------------| | _ I/O rate | 94/s | 90/s | 120/s | +-------------------------------------+------------+------------+------------+



VTAM ACB

VTAM ACBBy selecting VTAM ACB from the Region Status panel (enter S to show details) you display the Terminal Control Table Prefix panel.

See the VTAM ACB Status for the CICS RegionThe Terminal Control Table Prefix panel shows the status of the VTAM ACB for this CICS region, options global to CICS terminal control, and information on autoinstall. The following figure shows the panel.

FIGURE 173. Terminal Control Table Prefix (TCTFX) Panel

Selectable fields on this panel are the TCT Address field, which navigates to the CICS Memory panel, and the Exit Program Name field, which navigates to the Program Detail panel.

For more information, see the OMEGAMON II for CICS Reference Manual.

Analyze VTAM Problems from the Region StatusYou can analyze problems for VTAM ACB when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to VTAM ACB to view the Analyze VTAM ACB Problems panel, shown in the following figure.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:34:55 KC2P09D Terminal Control Table Prefix (TCTFX) Region: CICSPROD Fastpath: =AV Auto(60) +--------------------------------------+-------------------------------------+ | _ TCT address . . . . . : 00051FD0 | TCT suffix . . . . . . : XA | | OPNDST/CLSDST limit . : 10 | Maximum RA size . . . : 256 | | Specific VTAM applid . : TDOCS22 | RAs currently in use . : 0 | | Generic VTAM applid . : TDOCS22 | RA high water mark . . : 1 | | VTAM ACB state . . . . : Open | HPO is active . . . . : No | |--------------------------------------+-------------------------------------| | Fully qualified LU name : USCACO01.TDOCS22 | +----------------------------------------------------------------------------+ Autoinstall Information +--------------------------------------+-------------------------------------+ | _ Exit program name . . : DFHZATDX | Externally enabled . . : Yes | | Total requests . . . . : 3 | Internally enabled . . : No | | Peak requests . . . . : 1 | Maximum requests . . . : 100 | | Times at peak requests : 3 | Times at max requests : 0 | | Requests rejected . . : 1 | Postponed logons . . . : 0 | | Total deletes . . . . : 4 | Peak postponed logons : 0 | +--------------------------------------+-------------------------------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

VTAM ACB


FIGURE 174. Analyze VTAM Problems Panel


Selecting the listed problem will display the Terminal Control Table Prefix panel.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 15:46:18 KC2B02D Analyze VTAM Problems Region: CICSPROD Auto(60) +-------------------------------------+------------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | |-------------------------------------+------------+------------+------------| | _ VTAM ACB not open | On | Off | On | +-------------------------------------+------------+------------+------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status


XRF (Extended Recovery Facility)

XRF (Extended Recovery Facility)By selecting XRF on the Region Status panel (enter S to show details) you display the XRF Information panel.

Monitor the Status of the Primary and Alternate CICS RegionsThe XRF Information panel shows the status of the primary and alternate CICS regions. XRF provides recovery of a region by having a fully defined alternate region readily available to replace the operation of the failed region. The following figure shows the XRF Information panel.

FIGURE 175. XRF Information Panel

This panel contains one selectable field, Control File DSN, which navigates to the File Details panel or the VSAM Details panel, depending on whether the file is closed or open, respectively. The File Details panel is discussed in “Journals” on page 182 the VSAM Details panel is discussed in “Files” on page 177.

To see information about the XRF-related SIT (System Initialization Table) operands, TAKEOVER, ADI and JESDI, type IS on the home position, then press Enter. The Search Index pop-up window displays. Next, type SIT on the Search field, then press Enter. The Search Argument pop-up displays, showing the title of the System Initialization Table panel. Press Enter. The System Initialization Table panel displays.

_____ Actions GoTo Index Options Help -------------------------------------------------------------05/24/93 15:50:59 KC2X09D XRF Information Region: CICSPROD Fastpath: =AX Auto(60) +------------------------------------+---------------------------------------+ | Heartbeat interval : 2s | Last surveillance (CAVM): 00:02:34 | | Primary delay intrvl: 30s | Last surveillance (CICS): 00:02:34 | |------------------------------------|---------------------------------------} | Primary CICS Region | Alternate CICS Region | | CAVM status . . . . : Signed on | CAVM status . . . : Abnormal signoff | | CICS status . . . . : Signed on | CICS status . . . : Signed off | | Generic applid . . : TDOCS22 | Generic applid . : TDOCS22 | | Specific applid . . : CICS0001 | Specific applid . : CICS0002 | | SMF ID . . . . . . : SYSG | SMF ID . . . . . : SYSG | | Jobname . . . . . . : TDOCS22 | Jobname . . . . . : CICSAPRD | | JES job ID . . . . : STC06655 | Job number . . . : STC06656 | | Start time . . . . : 00:02:34 | Start time . . . : 00:02:35 | | Start date . . . . : 05/24/93 | Start date . . . : 05/14/93 | |------------------------------------+---------------------------------------| | _ Control file DSN . : CANDLE.XRF.CONTROL | +----------------------------------------------------------------------------+ <CPU> <Paging> <ASID> <Job> <TCBs> <Modules> <MVS Resources> (XRF) F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status



XRF Information Pushbuttons

The pushbuttons at the bottom of the panel allow you to navigate to the following panels:

For more information on the XRF Information panel, see the OMEGAMON II for CICS Reference Manual.

Starting an Alternate CICS Region

You can issue a command at the System Console panel to start the alternate region that has become inactive. Press F6 at the XRF Information panel to display the System Console panel. The following figure shows the panel.

This Pushbutton: Leads to this Panel:CPU CPU RatesPaging Working Set Size and Paging RatesASID CICS Address Space InformationJob CICS Job InformationTCBs CICS Address Space TCBsModules MVS Loaded ModulesMVS Resources MVS Resources



FIGURE 176. System Console Panel

To start the alternate CICS region:

1. Enter a number from 01 through 99 in the Console ID field to specify the console ID to receive the command. Press Enter. If you do not specify a console ID, the ID defaults to the master console.

2. Type the command to start the alternate region on the Command line of the System Console panel. Press Enter.See the OMEGAMON II for CICS Reference Manual for more information on the System Console panel.

____ Commands GoTo Index Options Help ------------------------------------------------------------ 05/24/93 16:13:03 KC2U14D System Console Region: CICSPROD Auto(60) +----------------------------------------------------------------------------+ | Console ID . . . . . . . . M_______ | +----------------------------------------------------------------------------+ Lines ___9 to 28 of 28 - SYSG(0232379021): GSA(9000) - 13.12.26 SYSG STC16040 KLVDF011 MESSAGE FROM DIALOG KONDPINI - 13.12.26 SYSG STC16040 ’CV076 OMEGAMON II For VTAM (V200) - - Initialization Completed’ - 13.12.48 SYSG STC15585 IST894I ADJSSCPS TRIED FAILURE SENSE ADJSSCPS - TRIED FAILURE SENSE - 13.12.48 SYSG STC15585 IST895I CCCDRM01 087D0001 - CCCDRM02 08420000 - 13.12.48 SYSG STC15585 IST895I CCCDRM04 08420000 - CCCDRM12 087D0001 - 13.12.48 SYSG STC15585 IST895I CCCDRM13 08420000 - CCCDRM16 087D0001 - 13.12.48 SYSG STC15585 IST895I CCCDRM17 08420000 - CCCDRM18 08420000 - 13.12.48 SYSG STC15585 IST895I CCCDRM19 08420000 - CCCDRM21 08420000 - 13.12.48 SYSG STC15585 IST895I CCCDRM22 087D0001 - CCCDRM23 08420000 - 13.12.48 SYSG STC15585 IST895I CCCDRM24 08420000 - CCCDRM25 08260000 Command ===> _______________________________________________________________ F1=Help F2=Keys F3=Exit F5=Refresh F7=Bkwd **=Fwd F9=Retrieve F10=Action Bar F11=Print F15=Region Status



Analyze XRF Problems from the Region StatusYou can analyze problems for XRF when the status bar on the Region Status panel indicates a warning or critical condition. Either condition indicates that thresholds you set previously (or default thresholds) have been exceeded. Enter A in the entry field next to XRF to view the Analyze XRF Problems panel, shown in the following figure.

FIGURE 177. Analyze XRF Problems Panel


Select the problem to display the XRF Information panel.

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/24/93 16:13:21 KC2B02D Analyze XRF Problems Region: CICSPROD Auto(60) +--------------------------------------+-----------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | |--------------------------------------+-----------+------------+------------| | _ Alternate not active | On | Off | On | +--------------------------------------+-----------+------------+------------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status

Defining Response Time Groups for Monitoring 251

Defining Response TimeGroups for Monitoring

IntroductionDefining response time groups allows you to establish logical associations between objects of the same type. Types of objects that can be set up as groups are transactions, programs, terminals, and VTAM logical units (LUs). You may place one or more transactions, programs, terminals or VTAM LUs in a group. But note that each group should contain objects (called elements) of only one type.

Chapter ContentsImportance of Defining Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252How to Use This Chapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253Managing Groups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254

9

Importance of Defining Groups


Importance of Defining GroupsOMEGAMON II system components use groups so that you can focus your CICS monitoring efforts on specific sets of resources. A resource for which response time data is required must be described by an element belonging to a group. An element may belong to more than one group. The following OMEGAMON II components use the control blocks and definitions of the Groups feature:

n Internal Bottlenecks

n Task History

n Interval Recorder

n Response Time

Components that support the group structure gather data for the elements (contents) of each group. A maximum of 30 groups and an aggregate maximum of 2048 elements are supported.


How to Use This Chapter

How to Use This ChapterYou might find it helpful to use the sections in this chapter as described below.

If You Are Defining New GroupsIf you want to define new groups, see these sections of the chapter as needed:

n “Creating a New Group” on page 256.

n “Defining Elements for a Group” on page 258.

n “Adding Elements to One or More Groups” on page 262.

If You Are Modifying Existing GroupsIf you want to modify existing groups, see these sections of the chapter as needed:

n “Modifying Groups and Elements” on page 264.

n “Adding Elements to One or More Groups” on page 262.

n “Deleting Groups and Elements” on page 265.

Managing Groups


Managing GroupsOMEGAMON II is shipped with predefined groups whose defaults you can change as desired. You can add or delete groups and add or delete elements from groups. Once you create a group, its contents can be displayed and modified.

The Response Time CollectorBefore you modify the structure for one or more groups, you must stop the Response Time collector if it is active; otherwise, the change you are attempting to make will not be implemented.

Whenever the Response Time collector is active, the Stop Response Time Collection pop-up displays when you attempt to create or modify groups or elements. If the Response Time collector is inactive, the StopResponse Time Collection pop-up will not display.

OMEGAMON II displays the Stop Response Time Collection pop-up window to allow you to stop the subtask. You can restart the collector through the Start Response Time Collection pop-up window, which is automatically displayed when you exit the Response Time Groups component.

FIGURE 178. Start Response Time Collection Pop-up

+-----------------------------------------------------------+| KC2QRS Start Response Time Collection || || You are exiting the Groups component; the Response || Time Analysis subtask was stopped while changes were || made to groups. || || Select one of the following, then press Enter. || || 1 1. Start the Response Time Analysis subtask || 2. Do not start the Response Time Analysis subtask. || || F1=Help F12=Cancel |+-----------------------------------------------------------+


Managing Groups

FIGURE 179. Stop Response Time Collection Pop-up

Duration of ChangesThe changes you make to groups on-line are dynamic and remain in effect only until OMEGAMON II is stopped. To make permanent changes to the group structure, you must assemble and link the group definition parameters into the GLOBAL_OPTIONS module. This is the recommended method. For information on how to do this, see the OMEGAMON II for CICS Configuration and Customization Guide.

The following sections describe how to create, modify, copy, and delete groups.

+-----------------------------------------------------------+| KC2QRP Stop Response Time Collection || || You are attempting to make a change to the groups || and the Response Time Analysis subtask needs to be || stopped for the change to be implemented. || || Select one of the following, then press Enter. || || 1 1. Stop the Response Time Analysis subtask. || 2. Do not stop the Response Time Analysis subtask. || || F1=Help F12=Cancel |+-----------------------------------------------------------+

Managing Groups


Creating a New GroupYou can create (or define) a new group using either of two methods:

n Enter a new group name.

n Copy an existing group.

Enter a New Group Name

Follow these steps to create a group using a new name:

1. From the Options pull-down menu, select Response time groups. Press Enter. The Response Time Groups panel displays.

FIGURE 180. Response Time Groups Panel

2. Type the 1- to 12-character name of the new group on the blank line in the first Group Name column.

Note: Each group name must be unique. Be sure that the name you enter is different from any group name that exists.

3. Tab to the Type column and enter the group type. Press F4 to select from a list of valid group types. Press Enter. If the Response Time collector is active, the Stop Response Time Collection pop-up window displays. See Figure on page 255.

Note: If the Response Time collector is inactive, the Elements in a Group panel is displayed instead.

____ Actions Goto Options Help ----------------------------------------------------------- 05/24/93 15:30:59 KC2QGR Response Time Groups Region: CICSPROD Auto(60) Type an action code or type a new group name and group type. M=Modify D=Delete C=Copy +----------------+--------++----------------+------++----------------+-------+ | Group Name | Type || Group Name | Type || Group Name | Type | |----------------+--------||----------------+------||----------------+-------| | USERGROUP123 | Prog + || _ K* TRANSACT. | Tran || _ U* TRANSSACT.| Tran | | _ A* TRANSACT. | Tran || _ L* TRANS | Tran || _ V* TRANS | Tran | | _ B* TRANS | Tran || _ MARKTLUS | LU || _ VS*PROGS | Prog | | _ CICS TRN | Tran || _ M* TRANS | Tran || _ W* TRANS | Tran | | _ D* TRANS | Tran || _ N* TRANS | Tran || _ X* TRANS | Tran | | _ E* TRANS | Tran || _ O* TRANS | Tran || _ Y* TRANS | Tran | | _ F* TRANS | Tran || _ P* TRANS | Tran || _ Z* TRANS | Tran | | _ G* TRANS | Tran || _ Q* TRANS | Tran || | | | _ H* TRANS | Tran || _ R* TRANS | Tran || | | | _ I* TRANS | Tran || _ S* TRANS | Tran || | | | _ J* TRANS | Tran || _ T* TRANS | Tran || | | +----------------+--------++----------------+------++----------------+-------+ Frequency of data collection . . . __1 (1-99)



Managing Groups

4. Enter 1 to stop the Response Time collector.

Note: If you do not stop response time collection, a new group will not be created.

Press Enter. The Elements in a Group panel displays (see “The Elements in a Group Panel” on page 260 for information on this panel).

This panel shows the name of the new group you defined, its group type, and its default warning and critical average response time thresholds. Through this panel you can define elements for this group. See “Defining Elements for a Group” on page 258 for the procedures to follow.

Copy an Existing Group

Follow these steps to create a new group by copying from an existing one:

1. On the Response Time Groups panel, type 1 to 12 characters on the blank line in the Group Name column.

Note: Each group name must be unique. Be sure that the name you enter is different from any group name that exists.

2. Type C next to the existing group whose attributes and elements you want to copy. Press Enter.The attributes of the existing group are copied to the new group name you specified. In addition, the Elements in a Group panel displays so you can define or modify the elements of the group and their thresholds. See “Defining Elements for a Group” on page 258 for the procedures to follow.

Managing Groups


Defining Elements for a GroupYou can use the Elements in a Group panel to define elements for a group, using either of two methods:

n Enter a new element name.

n Copy from an existing element.

For a description of the Elements in a Group panel, see “The Elements in a Group Panel” on page 260.

Enter a New Element Name

To define a new element name, follow these steps:

1. On the Elements in a Group panel, type a new name on the blank line in the Element column.

Note: When typing the element name, use up to 4 characters for transaction and terminal elements; use up to 8 characters for programs and LUs.

2. On the blank lines in the Response threshold column, enter a warning value in the range 0.1 to 99.9 seconds. Press Enter.The element name and threshold values are added to the Element and Response columns of the panel. If any fields are omitted, OMEGAMON II will assign a default value.

Note: If you are defining elements for an LU group type, you will also need to enter threshold values, in a range of 0.1-99.9 seconds, in the Network and Host columns.

3. Repeat the steps for each element you want to add to the group. Remember that each element within a single group must be of a single resource type; that is, transaction, terminal, program, or VTAM LU.

Using Wildcard Characters

Elements can also be defined using wildcard characters for all group types except VTAM LU. Wildcard characters allow you to add to the group elements containing common characters (for example, all transactions starting with the letters “AB”). Type AB* to add to the group all transactions starting with “AB”. The wildcard can be used anywhere in the element’s name. For example, to include all transactions with four character IDs that start with “A” and end with “B”, type A**B. To include all four character IDs that end with “AB”, type **AB. The wildcard character needs to be repeated for each position, unless the “*” is the last character when it represents one or more characters.


Managing Groups

Copy from an Existing Element

To define an element for a group by copying from an existing element, follow these steps:

1. On the Elements in a Group panel, type a new name on the blank line in the Element column.

2. Type C next to the element you want to copy from. Press Enter. The attributes of the element you selected are copied to the element name you specified.The Element Manipulation panel is displayed.

Note: When typing the element name, use up to 4 characters for transaction and terminal elements; use up to 8 characters for programs and LUs.

3. On the Element Manipulation panel, you can keep the copied element as it is, or modify it by changing its thresholds. To change its thresholds, simply overtype the threshold values in the Response, Network, or Host columns.The new elements you’ve defined for a group you’ve created can be added to one or more additional groups (see “Adding Elements to One or More Groups” on page 262) or deleted from groups (see “Deleting Groups and Elements” on page 265).

Managing Groups


The Elements in a Group Panel

In the Elements in a Group panel, you can modify the list of elements, and their thresholds, belonging to a group. If you had selected an existing group from the Response Time Groups panel, existing elements for that group would appear on this panel. The following figure shows the panel.

FIGURE 181. Elements in a Group Panel

This panel displays the average response time thresholds of the group as a whole and all elements belonging to the group with their individual thresholds.

On this panel, an element may be added, copied, modified, or deleted.

Note: The Network and Host thresholds apply only to the LU group type.

____ Actions Options Help ----------------------------------------------------------- 05/24/93 15:31:59 KC2QED Elements in a Group Region: CICSPROD Auto(60) +------------------------------------+----------------------------------------+ | Group name . . . USERGROUP123 + | Warning average response . >_2 . 0 s | | Group type . . : Prog | Critical average response: > 4 .0s | +------------------------------------+----------------------------------------+ Response Times Thresholds +-------------+--------------------+--------------------+---------------------+ | | Response | Network | Host | | Element | Warning Critical | Warning Critical | Warning Critical | |-------------+----------+---------+----------+---------+----------+----------| | ________ |>__ . _ s | | | | | | +-------------+----------+---------+----------+---------+----------+----------+

F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status


Managing Groups

The following fields appear on this panel.

Note: The response, network, and host thresholds determine the color of the response times on the Response Time Details panel, which displays response times for each element of a single group.

Group Name This field displays a group name.

To display the elements of a different group, you can either overtype the name or press F4 to choose from a list of groups.

Group Type This field indicates the type of group displayed. The group type can be one of the following:

Tran (transactions)

Term (terminals)

Prog (programs)

LU (VTAM logical units)

Warning Average Response Threshold

This field allows you to change the average response time warning threshold for the displayed group.The critical threshold is double the warning threshold.This threshold is compared to the actual average response time for all elements within the displayed group.

The warning and critical average response time thresholds are used to determine the color of the fields on the Response Times panel, which shows average response time by group over the last 9 one-minute intervals.

The color of the Curr Minn field on the Response Times panel for the group that has most severely exceeded its thresholds determines the color of the Response status bar on the Region Status panel.

Element This column displays one or more elements belonging to the group.

The blank line at the top of the column enables you to add a new element to a group. See “Defining Elements for a Group” on page 258 for procedure on how to do this.

Response Time Warning Threshold

This field allows you to set the response time warning threshold for a particular element.The critical threshold is double the warning threshold.

For groups comprised of programs, transactions, and terminals, response time is the elapsed time between the start and end times of a CICS task. For LU type groups, the response time is the sum of network and host times and is the elapsed time between the user pressing a key (for example, ENTER, F1 through F24, PA1, PA2, PA3 or CLEAR) and receiving a response at the terminal.

Network Warning Threshold

The thresholds in this column apply only to LU group types.

Network time is the sum of the times that the transaction spends travelling from the terminal to VTAM on the inbound request and from VTAM back to the terminal on the outbound response.

Host Warning Threshold

The thresholds in this column also apply only to LU group types.

Host time is the time that the request spends travelling from VTAM, through CICS, and back to VTAM.

Managing Groups


Adding Elements to One or More GroupsYou can add elements you’ve defined for a group to one or more additional groups.

Add the Elements

Follow these steps to add elements to one or more groups:

1. On the Elements in a Group panel, type M next to the desired element. Press Enter. The Element Manipulation panel displays, showing the current thresholds for the element and a list of groups of the same type, which indicate whether or not the element is already associated with the group. (“Yes” appears in the Element is in this Group column next to the group name.)

2. To add the element to additional groups, type A next to one or more groups in which you want the element to be included. Press Enter. (“Yes” appears in the Element is in this Group column next to the groups you select.)See the following section for information on the Element Manipulation panel.

The Element Manipulation Panel

The Element Manipulation panel allows you to add the elements you’ve defined for a group to additional groups. The following figure shows the panel.

FIGURE 182. Element Manipulation Panel

____ Actions Goto Options Help ------------------------------------------------------------ 05/24/93 15:32:59 KC2QMD Element Manipulation Region: CICSPROD Auto(60) Type any changes then press Enter. A=Add element to a group D=Delete element from a group. +-------------------+------------------+------------------+------------------+ | | Response > | Network > | Host > | | Element and Type | Warning Critical| Warning Critical| Warning Critical| |-------------------+----------+-------+----------+-------+----------+-------| | C*______ + Tran + | _3 . 1 s | 6.2s | n/a | n/a | n/a | n/a | +-------------------+----------+-------+----------+-------+----------+-------+ Lines ___1 to 3 of 26 +-----------------+---------------+--------------------------+---------------+ | | Element is | Average Threshold | Current | | Group Name | in this group | Warning Critical | Elements | |-----------------+---------------+------------+-------------+---------------| | _ TRAN GRP A* | Yes | > 1.0s | > 2.0s | 2 | | _ TRAN GRP C* | Yes | > 3.1s | > 6.2s | 1 | | _ TRAN GRP Z* | Yes | > 6.0s | > 12.0s | 2 | +-----------------+---------------+------------+-------------+---------------+ F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status


Managing Groups

The list of groups in the Group Name column shows the groups to which the element belongs. To display a different element, overtype the Element and Type fields and press Enter. The following fields are defined for this panel.

Element This field allows you to change the element being displayed. Overtype the existing name or press F4 for a list of choices.

Element Type This field allows you to change the element type being displayed. Overtype the existing type or press F4 for a list of choices.

Response Time Warning Threshold

This field allows you to change the response time warning threshold for a particular element.

The critical threshold is double the warning threshold.

For groups comprised of programs, transactions, and terminals, response time is the elapsed time between the start and end times of a CICS task. For LU type groups, the response time is the sum of network and host times and is the elapsed time between the user pressing a key (for example, Enter, F1 through F24, PA1, PA2, PA3 or Clear) and receiving a response at the terminal.

Network Warning Threshold

The thresholds in this column apply only to LU group types.

Network time is the sum of the times that the transaction spends travelling from the terminal to VTAM on the inbound request and from VTAM back to the terminal on the outbound response.

Host Warning Threshold

The thresholds in this column also apply only to LU group types.

Host time is the time that the request spends travelling from VTAM, through CICS, and back to VTAM.

Group Name This field allows you to add or delete the displayed element to or from this group.

Average Response Time Thresholds

This column displays the average response time thresholds for each group. These thresholds are used to determine the color of the fields on the Response Times panel, which averages the element response times for each group over the last 9 one-minute intervals. The most critical color in the Curr Min field of the Response Time panel determines the color of the response time status bar on the Region Status panel.

The Response status bar on the Region Status panel uses these thresholds.

Current Elements

This column displays the number of elements within a group.

Managing Groups


Modifying Groups and ElementsThe Response Time Groups component allows you to modify existing groups and the elements associated with them. This section contains the procedures to follow.

Modify a Group

To modify a group (either predefined or user-defined), follow these steps:

1. On the Options pull-down, select Response time groups. Press Enter. The Response Time Groups panel displays.

2. Type M next to a name of a group in the Group Name column. Press Enter. The Elements in a Group panel displays.

3. On the Elements in a Group panel, you can modify a group byn modifying the Warning average response time threshold for the group. Simply overtype

the threshold in the upper right corner of the panel.n defining a new element for the group (see “Defining Elements for a Group” on page 258).n deleting an element from the group (see “Deleting Groups and Elements” on page 265).n modifying the thresholds for an element that belongs to the group (see “Modify Group

Elements” on page 264).

Modify Group Elements

To modify elements for a group, do one of the following:

n On the Response Time Groups panel, type M next to a group and press Enter. When the system navigates to the Elements in a Group panel, overtype the thresholds for one or more elements in the group. Press Enter.

n On the Elements in a Group panel, type M next to an element to be modified. Press Enter. When the system navigates to the Element Manipulation panel, modify the thresholds for the element. Press Enter.

The change you made takes effect for all groups in which the element exists.

Note: The Network and Host thresholds apply only to the LU group type.


Managing Groups

Deleting Groups and ElementsYou can delete an entire group or just elements from a group. To do so, follow the steps below.

Delete a Group

To delete an entire group:

1. On the Response Time Groups panel, type D next to the name of the group to be deleted.

2. A confirmation pop-up displays to allow you to confirm the deletion. The following figure shows the pop-up.

FIGURE 183. Confirm Request to Delete a Group

3. Enter 1 or P to confirm the deletion.

Delete an Element from a Single Group

To delete an element from a single group, you can delete it from either the Elements in a Group panel or the Element Manipulation panel.

+---------------------------------------------------+| KC2CONF Confirm Request || || Confirm the deletion of group TRAN A* || || _ 1. Process request || 2. Cancel request || || F12=Cancel |+---------------------------------------------------+

Managing Groups


Delete an Element Using the Elements in a Group Panel

To delete an element from a single group using the Elements in a Group panel, follow these steps:

1. Do either of the following:n On the Response Time Groups panel, enter M next to a group from which you want to

delete an element. Press Enter. The Elements in a Group panel displays.

n On the Elements in a Group panel, overtype the Group Name field with the name of the group from which you want to delete the element. Press F4 to see a list of valid group names. Press Enter.

2. Type D next to the element to be deleted. A confirmation pop-up window displays to allow you to confirm the deletion. The following figure shows the confirmation pop-up.

FIGURE 184. Confirm Request to Delete an Element

3. Enter 1 or P to confirm the deletion. Press Enter. The element is deleted from the group.

Delete an Element Using the Element Manipulation Panel

To delete an element from a single group using the Element Manipulation panel, follow these steps:

1. In the Element and Type column on the Element Manipulation panel, select the element you want to delete by overtyping the fields. Press F4 to see a list of valid element names and types.

2. Scroll through the groups listed in the Group Name column to see which group contains the element (“Yes” displays next to the group in the Element is in this Group column).

3. Enter D next to the group from which you want to delete the element. Press Enter. A confirmation pop-up window displays to allow you to confirm the deletion.

4. Enter 1 or P to confirm the deletion. Press Enter. The element is deleted from the group.

+-----------------------------------------------+| KC2CONF Confirm Request || || Confirm the deletion of element A* || || _ 1. Process request || 2. Cancel request || || F12=Cancel |+-----------------------------------------------+


Managing Groups

Delete an Element from Multiple Groups

To delete an element from multiple groups, follow these steps:

1. On the Element Manipulation panel, make sure the element you want to delete is displayed in the Element and Type fields. Press F4 to see a list of valid element names and types.

2. Scroll through the groups listed in the Group Name column to find the first group from which you want to delete the element (“Yes” is displaying next to the group in the Element is in this Group column).

3. Enter D next to each group from which you want to delete the element. Press Enter. A confirmation pop-up window displays to allow you confirm the deletion for each selected group.

4. For each group enter 1 or P to confirm the deletion. Press Enter. The element is deleted from each group in turn.

Managing Groups


OMEGAVIEW Enhanced Zoom 269

OMEGAVIEW Enhanced Zoom

IntroductionYou can use OMEGAVIEW as an alternative method of logging onto OMEGAMON II. In OMEGAVIEW you can select an OMEGAMON II for CICS status light and zoom directly into an OMEGAMON II for CICS session.

When you zoom from OMEGAVIEW, you can automatically navigate to one of several OMEGAMON II screens that analyze or show you more detail about the cause of the problem.

Chapter ContentsZooming from OMEGAVIEW to OMEGAMON II . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270Zoom Summary Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271Default or First Zoom Destination Choice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273Alternate Zoom Destinations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274Usage Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276

Important

You can use this zoom facility only if you are running OMEGAMON II with OMEGAVIEW Version 110 and OMEGAVIEW PTFs QMV0090 and QSD0020 have been applied.

A

Zooming from OMEGAVIEW to OMEGAMON II


Zooming from OMEGAVIEW to OMEGAMON II

Note: To ensure an acceptable amount of zoom time from OMEGAVIEW to OMEGAMON II, be sure to run the CUA interface (KC2PROC) and the menu system interface (CANSOCnn) on the same system. You can run OMEGAVIEW on any system that you want.

Note: The nn variable in CANSOnn designates an address space from 00–55 in which to run the started task. For example, CANSOC03 specifies 03 as the address space.

To zoom from OMEGAVIEW to OMEGAMON II, follow these steps:

1. Access OMEGAVIEW. (See the OMEGAVIEW documentation for details.)

2. Type S next to an OMEGAMON II for CICS status light and press Enter.

3. Do either of the following:n Select your zoom destination from a menu of zoom destination choices. (The Confirm

Zoom to Session pop-up must be enabled.)

n Zoom directly to a default zoom destination. (The Confirm Zoom to Session pop-up is disabled.)

You will arrive at a selected OMEGAMON II panel as shown in “Default or First Zoom Destination Choice” on page 273 and “Alternate Zoom Destinations” on page 274. You can then navigate within OMEGAMON II as usual.

For more information about procedures within OMEGAVIEW, see the OMEGAVIEW documentation.

To return to OMEGAVIEW at any time, press the OMEGAVIEW trigger that you had defined in OMEGAVIEW.


Zoom Summary Table

Zoom Summary TableThe following table presents a summary of the relation between OMEGAVIEW zoom source panels and OMEGAMON II zoom destination panels, when the OMEGAVIEW zoom pop-up is enabled. The first zoom choice is also the default zoom destination, which is used when the zoom pop-up is disabled.

Table 1. OMEGAVIEW to OMEGAMON II for CICS Zoom Summary

OMEGAVIEW Status Light

First Destination Choice

Second Destination Choice

Third Destination Choice

AID Workloads Analyze AID Problems Automatic Initiate Descriptors (AIDs)

Region Status

ICE Workloads Analyze ICE Problems Interval Control Elements (ICEs)

Region Status

Response Time Workloads

Analyze Response Time Problems

Response Times Region Status

Task Workloads Analyze Task Problems Tasks Region Status

Transaction Rate Workloads

Analyze Transaction Rate Problems

Transaction Rates Region Status

CPU Resources Analyze CPU Problems CPU Rates Region Status

DASD Resources Analyze DASD Problems CICS DASD Performance Region Status

DB2 Resources Analyze DB2 Problems DB2 Activity Region Status

DBCTL Resources Analyze DBCTL Problems

DBCTL Activity Region Status

DL/I Resources Analyze DL/I Problems DL/I Activity Region Status

File Resources Analyze File Problems Open VSAM Files Region Status

Journal Resources Analyze Journal Problems

Datasets Allocated to CICS

Region Status

LSR Resources Analyze LSR Problems Local Shared Resources (LSR)

Region Status

MRO/ISC Resources Analyze MRO/ISC Problems

Terminal Control Table System Entries

Region Status

Paging Resources Analyze Paging Problems Working Set Size and Paging Rates

Region Status

Storage Resources Analyze Storage Problems

CICS Storage Region Status

Tape Resources Analyze Tape Problems Tape Drives Region Status

Temporary Storage Resources

Analyze Temporary Storage Problems

Temporary Storage Region Status

Transient Data Resources Analyze Transient Data Problems

Transient Data Region Status

Zoom Summary Table


Bottleneck Alerts Analyze Bottleneck Problems

Internal Bottlenecks Region Status

CICS Loop Alerts Analyze CICS Loop Problems

Common System Area (CSA)

Region Status

Dump Alerts Analyze Dump Problems Dumps Region Status

Enqueue Alerts Analyze Enqueue Problems

Enqueues Region Status

I/O Rate Alerts Analyze I/O Problems DASD I/O Rate Region Status

VTAM ACB Alerts Analyze VTAM Problems Terminal Control Table Prefix (TCTFX)

Region Status

XRF Alerts Analyze XRF Problems XRF Information Region Status

Table 1. OMEGAVIEW to OMEGAMON II for CICS Zoom Summary

OMEGAVIEW Status Light

First Destination Choice

Second Destination Choice

Third Destination Choice


Default or First Zoom Destination Choice

Default or First Zoom Destination ChoiceThis section shows an example of a panel you can zoom to as the default or first zoom destination choice. All theOMEGAMON II Analyze Problem panels are default or first zoom destination choices.

FIGURE 185. Analyze AID Problems Panel

____ Actions GoTo Index Options Help ------------------------------------------------------------ 05/14/93 16:42:31 KC2B02D Analyze AID Problems Region: CICSPROD Auto(60) +--------------------------------------+-----------+-------------------------+ | | | Thresholds | | Problem Description | Value | Warning Critical | |--------------------------------------+-----------+------------+------------| | _ Number of AIDs | 175 | 100 | 300 | +--------------------------------------+-----------+------------+------------+


Alternate Zoom Destinations


Alternate Zoom DestinationsIn addition to the default or first zoom destination choice, you have the choice of two other zoom destinations.

Show Details—Second Zoom ChoiceThe second zoom destination choice for each basic status light is the associated Show Details panel.

For example, when you zoom from the basic File Resources status light and choose the second destination, you will zoom to the Open VSAM Files panel, shown in the following figure. (This Open VSAM Files panel is displayed for all CICS versions prior to CICS/ESA Version 5.1.0.)

FIGURE 186. Open VSAM Files Panel (CICS/ESA Version 4 and earlier

____ Actions GoTo View Index Options Help ------------------------------------------------------------ 05/24/93 16:04:32 KC2H01D Open VSAM Files Region: CICSPROD Fastpath: =RF Auto(60)+-------------------------------------+--------------------------------------+| Splits/extents interval : 5 min | Time of last analysis . : 16:00:00 |+-------------------------------------+--------------------------------------+ Lines 1 to 7 of 30+------------+------+------+-------+------+------+------+------+------+------+| File | Curr.|String|Current| Data | Data | Data | Index| Index|Index || ID |String|Waits/|Strings| CA | CI | | CA | CI | || |Waits | I/O |in Use |Splits|Splits|Extnts|Splits|Splits|Extnts||------------+------+------+-------+------+------+------+------+------+------|| _ DFHLCD | | | | 0 | 0 | 0 | 0 | 0 | 0 || _ DFHXRCTL | | | | | | 0 | | | || _ DFHXRMSG | | | | | | 0 | | | || _ FILEA | 3 | 45% | 75% | 0 | 4 | 0 | 0 | 0 | 0 || _ DFHRSD | | | | 0 | 0 | 0 | 0 | 0 | 0 || _ DFHJACD | | | | 0 | 0 | 0 | 0 | 0 | 0 || _ DFHTEMP | 0 | | 20% | | | 2 | | | |+------------+------+------+-------+------+------+------+------+------+------+(Open VSAM) <Datasets> <String Waits> <Buffer Waits> <LSR> F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status


Alternate Zoom Destinations

Region Status - Third Zoom ChoiceIf you zoom from any basic status light, the third zoom destination choice is the Region Status panel, as shown below. (This Region Status panel is displayed for all CICS versions prior to CICS/ESA Version 5.1.0.)



Usage Notes


Usage NotesThe benefit of using OMEGAVIEW is that you can monitor multiple CICS regions at once. You can also zoom directly to an OMEGAMON II CUA interface panel that provides information about the selected OMEGAVIEW status light.

Once you zoom into OMEGAMON II, you can navigate normally within the product. If the zoom destination panel does not provide adequate data to determine what actually caused the status light on the OMEGAVIEW panel to report a warning or critical condition, you can investigate further.

OMEGAMON II saves you time by letting the enhanced zoom feature automatically navigate to the panel most likely to explain the problem.

For more information on the enhanced zoom feature, refer to the OMEGAVIEW documentation.

OMEGAVIEW Customized PanelsIn addition to the OMEGAVIEW Default Status panel, if your custom-designed OMEGAVIEW panels include any of the OMEGAMON II for CICS basic status lights, you can zoom from them to the destinations described in “Default or First Zoom Destination Choice” on page 273 and “Alternate Zoom Destinations” on page 274.

For further information on OMEGAVIEW panel customization, see the OMEGAVIEW documentation.

Fast Pathing in the CUA Interface 277

Fast Pathing in the CUA Interface

IntroductionThe fast path mnemonics contained in this appendix allow you, in many instances, to navigate to a panel directly, rather than through a series of panels, to reach your destination.

This appendix also contains mnemonics that let you access items on the Options and Help pull-down menus.

Chapter ContentsEntering the Fast Path . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278Fast Path Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

B

Entering the Fast Path


Entering the Fast Path You can enter a fast path mnemonic on any panel that has an action bar.

1. Move the cursor to the home position.

2. Type the fast path character (=) followed by the mnemonic string (for example, =WAA).

Note: You do not need to use the fast path character when entering fast paths to access the Options or Help pull-down menus (fast paths for these menus start with H or O). For example, type HG to access the glossary from the Help pull-down menu.

3. Press Enter.


Fast Path Tables

Fast Path TablesThe panels you can navigate to and their fast path mnemonic strings are arranged alphabetically by panel title in the following tables.

A

B

C

To navigate to this panel Enter this fast path

About HA

Address Space Information =RCA

Address Space Storage =RSA

Address Space Task Control Blocks (TCBs) =RCT

Address Symbol Definition =MY

AIDs (Automatic Initiate Descriptors) =WA

AID Details =WAD

AIDs Thresholds OTWA

Allocations =RSL

Authorized Commands—Disable OCD

Authorized Commands—Enable OCE

Auxiliary Temporary Storage =ROA


Bottlenecks Thresholds OTAB


Chase Chain =MC

CICS Address Space Information =RCA

CICS Address Space TCBs =RCT

CICS DASD Performance =RD

CICS DASD Status =RDA

CICS Datasets on a DASD Volume =RDED

CICS Dataspaces =MD

CICS File/Database Collection OOF

CICS Job Information =RCJ

Fast Path Tables


D

CICS Loop Threshold OTAC

CICS Master Terminal =ME

CICS Memory =M

CICS Shutdown Option OS

CICS Storage =RS

CICS Storage Thresholds OTRS

CICS Tables =C

CICS Tasks Using DL/I =RIK

Close Print Log OL

Common System Area (CSA) =AC

CPU Rates =RC

CPU Thresholds OTRC


DASD Details for a Device =RDE

DASD I/O Rate =AI

DASD Performance =RD

DASD Statistics =RDS

DASD Status =RDA

DASD Thresholds OTRD

Datasets Allocated to CICS =RFA

Datasets on a DASD Volume =RDED

Dataspace Indirect Addressing =MDMI

Dataspace Memory =MDM

Dataspaces =MD

DB2 Activity =RB

DB2 Thresholds OTRB

DB2 Transaction Details =RBD

DBCTL Activity =RL

DBCTL Tasks =RLK

DBCTL Thresholds OTRT

DCT Extrapartition Information =CDE



Fast Path Tables

E

DCT Indirect Information =CDI

DCT Intrapartition Information =CDP

DCT Remote Information =CDR

Destination Control Table (DCT) =CD

Destination Queues Over Limits =RNL

Disable Authorized Commands OCD

DL/I Activity =RI

DL/I Configuration =RIC

DL/I Database Details =RIDE

DL/I Database Directory (DDIR) =CI

DL/I Databases =RID

DL/I Interface Addresses =RIA

DL/I Interface ECBs =RIE

DL/I ISAM/OSAM Buffers =RIB

DL/I PSB Directory Entry =CBE

DL/I PSB Directory (PDIR) =CB

DL/I—CICS Tasks Using =RIK

DL/I Thresholds OTRI

DSA Storage =RST

Dumps =AD

Dumps Thresholds OTAD


Enable Authorized Commands OCE

Enqueue Conflicts =AEC

Enqueue Details =AED

Enqueues =AE

Enqueues Thresholds OTAE

Exit Program Blocks (EPBs) =CEP

Extended Help HE

External Contention =ABC

External Contention Details =ABCD


Fast Path Tables


F

G

H

I


File Control Table (FCT) =CF

File Control Table Entry =CFE

File Control Table Entry - Data Table =CFT

File Control Table Entry - Logging =CFL

File Control Table Entry - Statistics =CFS

File Details =RFD

File/VSAM Thresholds OTRF

Front End Programming Interface WTE


Global User Exits (GLUEs) =CE

Glossary HG


Help for help HH

Help Index HI


ICE Details =WID

ICEs Thresholds OTWI

Indirect Addressing =MI

Internal Bottleneck Collection OOB

Internal Bottleneck Details =ABD

Internal Bottleneck Display Controls OOD

Internal Bottlenecks =AB

Interval Control Elements (ICEs) =WI

Interval Recording OOI


Fast Path Tables

J

K

L

Intrapartition Transient Data Statistics =RNS

I/O Rate Thresholds OTAI


Journal Control Table Entry =CJE

Journal Control Table (JCT) =CJ

Journal Details =RJD

Journal Models =RJM

Journal Thresholds OTRJ

Journals =RJ


Keys Help HK


Local Shared Resources (LSR) Pools =RL

Log Streams =RJL

LSR Buffer Pool Details =RLD

LSR Buffer Waits =RFB

LSR Compound Buffers =RLDC

LSR Data Buffers =RLDA

LSR Hiperspace Compound Buffers =RLDH

LSR Hiperspace Data Buffers =RLDT

LSR Hiperspace Index Buffers =RLDX

LSR Index Buffers =RLDI

LSR Thresholds OTRL


Fast Path Tables


M

N

O

P


Master Terminal =ME

Memory =M

MQ Activity =RQ

MRO/ISC Thresholds OTRM

MVS Loaded Modules =RCM

MVS Resources =RCR

MVS Storage Thresholds OTRV


New Features HN


OMEGAMON II for CICS Address Symbol Definition =MOY

OMEGAMON II for CICS Chase Chain =MOC

OMEGAMON II for CICS Dataspaces =MA

OMEGAMON II for CICS Indirect Addressing =MOI

OMEGAMON II for CICS Memory =MO

OMEGAMON II for CICS Scan Memory =MON

OMEGAMON II for CICS Zap Memory =MOZ

Open VSAM Files =RF


Page Allocation Map =RSM

Paging Thresholds OTRP

Preferences OP

Program Check/Abend Trace Table (CICS/MVS) =CRP

Program Compressions (CICS/MVS) =RSP

Program Detail =CPE


Fast Path Tables

R

S

Programs =CP

Program Storage HWM =WTOH


Region Profile OR

Resources Thresholds OTR

Response Times =WR

Response Time Collection OOR

Response Time Details =WRD

Response Time History =WRH

Response Time History Details =WRHD

Response Time Groups OG


Scan Dataspace Memory =MDMN

Scan Memory =MN

Screen Print Output Routing Options OCO

Sequential TCTTE =CTQ

Session Defaults OCS

Shutdown Option OS

Storage =RS

Storage Allocation by Components =RSC

Storage Allocation by Tasks =RSCT

Storage Details =RSD

Storage Subpools =RSCS

Storage Violations =RSV

System Initialization Table (SIT) =CS


Fast Path Tables


T


Tables =C

Tape Drives =RA

Tape Drive Details =RAD

Tapes Thresholds OTRA

Task Addresses =WTA

Task Bridge Details =WTB

Task Details =WTD

Task File Statistics =WTF

Task History =H

Task History Collection OOH

Task Remote Information =WTR

Task Statistics =WTS

Task Storage =WTO

Task Terminal Statistics =WTM

Task Thresholds OTWT

Task Time Analysis =WTI

Task Umbrella Data =WTU

Tasks =WT

Tasks Using DL/I =RIK

TCB Details =RCTD

TCP/IP Thresholds =RT

TCTSE Statistics =RMS

TCT System Entry (TCTSE) =RME

TCTTE =CTE

TCTTE Statistics =CTS

Temporary Storage =RO

Temporary Storage Queues =ROQ

Temporary Storage Statistics =ROS

Temporary Storage Table (TST) =CO

Temporary Storage Thresholds OTRO

Terminal Control Table Prefix (TCTFX) =AV

Terminal Control Table System Entries (TCTSEs) =RM


Fast Path Tables

U

V

Terminal Control Table (TCT) =CT

Trace =CR

Transaction Detail =CNE

Transaction Rates =WN

Transaction Rate Thresholds OTWN

Transactions =CN

Transaction Statistics =WTN

Transient Data =RN

Transient Data Thresholds OTRN

Tutorial HT


UOWs =WU

UOW Details =WUD

UOW Enqueues =WUQ

UOW Links =WUL

UOW Statistics =WUS

Userid Profile OU

User Information HU


VSAM Data Component Allocation =RFVT

VSAM Data Component Statistics =RFVD

VSAM Details =RFV

VSAM Index Component Allocation =RFVX

VSAM Index Component Statistics =RFVI

VSAM String Waits =RFS

VTAM ACB Thresholds OTAV


Fast Path Tables


W

X

Z


Web Interface =RW

Working Set Size and Paging Rates =RP

Workloads Thresholds OTW


XRF Information =AX

XRF Thresholds OTAX


Zap Dataspace Memory =MDMZ

Zap Memory =MZ

Transplex Navigation and Session Switching 289

Transplex Navigation andSession Switching

IntroductionThis appendix provides you with information about using two new OMEGACENTER features.

n With the new session switching feature, you can switch directly among all OMEGAMON sessions defined to OMEGAVIEW without having to return to OMEGAVIEW.

n With transplex navigation, you can track transactions as they execute throughout the sysplex. This feature lets you observe a transaction being processed in CICS, IMS, DBCTL, or DB2. Context-sensitive pushbuttons provide the mechanism to navigate from one OMEGAMON to another to follow the transaction, regardless of which subsystem it is running on.

Terminology

The following terms are defined:

Chapter ContentsSession Switching. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290Transplex Navigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291Using Transplex Navigation with OMEGAMON II for CICS . . . . . . . . . . . . . . . . . . . . . . 293

sysplex A multiple-MVS system environment that allows MCS consoles or extended MCS consoles to receive messages and send commands across systems.

transplex All parts of the sysplex involved in the processing of a transaction.

C

Session Switching


Session SwitchingThe OMEGACENTER session switching feature lets you switch among your OMEGAMON sessions without returning to OMEGAVIEW. This allows quick access to problem information.

Session Switching ProcedureUse the following procedure to switch sessions.

Step Action

1 To switch sessions from any OMEGAMON panel or from the OMEGAVIEW main panel, press the session switch key. (PA1 is the default key.)

To switch sessions from the OMEGAVIEW main panel action bar, select Switch and press Enter.

Result: OMEGAVIEW displays the Switch to Session pop-up menu.

2 From the Switch to Session pop-up menu, you can do one of the following:n Type the name of the session you want in the input field at the top of the session list and

press Enter.n Move the cursor next to the session you want and press Enter.n Use the Find key (F14) when you do not know the exact name of the session.

For example, if you know your session begins with ABC, press F14 to get the Find Session pop-up. From the Find Session pop-up, type ABC in the Session Name input field and press Enter. OMEGAVIEW returns you to the Switch to Session pop-up menu; the session list will now begin with the session that precedes all of the ABC sessions. Select a session with the cursor and press Enter.

Result: OMEGAVIEW switches to the session you have chosen.


Transplex Navigation

Transplex NavigationWith transplex navigation, you can follow a specific transaction from a panel in one OMEGAMON to a panel in another OMEGAMON that contains information corresponding to that transaction. You invoke this feature with a context-sensitive pushbutton that provides the mechanism to navigate between OMEGAMON panels.

Sample PanelThe following figure shows how the DBCTL transplex navigation pushbutton (<GoTo DBCTL>) looks on an OMEGAMON II for CICS panel. The subsystem name on the pushbutton depends on the product and panel you are navigating from, but the location of the pushbutton is the same for all of the OMEGAMONs.

FIGURE 188. Transplex Navigation Pushbutton

Usage ExamplesThe following table shows examples of how you can use transplex navigation to monitor transactions.

IF you are at... AND... USE Transplex navigation to go to...

an OMEGAMON II for CICS Task File Statistics panel

a transaction is spending too much time in DL1

the corresponding Thread Detail panel in OMEGAMON II for DBCTL for more information

_____ Actions GoTo Index Options Help ------------------------------------------------------------10/10/99 15:30:59 Task File Statistics Region: CICSPROD Auto(60) +-------------------------------------+--------------------------------------+ | Task number . . . . . __123 + | Transaction ID . . . . : SQL4 | +-------------------------------------+--------------------------------------+ +-------------------------+-------------------------+------------------------+ | File Type | Total Requests | Total Time | |-------------------------+-------------------------+------------------------| | _ VSAM | 117 | n/a | | _ DL/I | 1345 | 1.237s | | _ DB2 | 613 | 0.961s | | _ MQ | n/a | n/a | | ADABAS | 10 | 0.613s | | DATACOM | 0 | 0.000s | | IDMS | 13 | 1.226s | | SUPRA | 1 | 0.036s | | _ USREVNT1 | 10 | 41.034s | +-------------------------+-------------------------+------------------------+

Transplex Navigation


Product Versions and PTFsThe following table shows the minimum product versions that support transplex navigation and the PTFs that you must apply to enable this feature.

You must be at the latest cumulative maintenance level for each product. We recommend that you review preventive service planning (PSP) information for these products to ensure that you are at the latest maintenance level. PSP information is available through Candle Electronic Customer Support (CECS) or by calling Candle Support Services.

Higher versions of the products listed above will support transplex navigation. In that case, be sure to apply PTFs for corrective maintenance.

The rest of this appendix provides instructions on how to use transplex navigation from OMEGAMON II for CICS.

an OMEGAMON II for DBCTL Thread Details panel

you want to look at the details about a task in the CICS region

the corresponding Task Details panel in OMEGAMON II for CICS for more information

an OMEGAMON II for CICS Task Remote Information panel

you want to look at information about a remote CICS region

the corresponding Task Remote Information panel in your remote OMEGAMON II for CICS for more information

Product Version PTFs

OMEGAVIEW 110 QMV0156

OMEGAMON II for CICS 100 QOC0728

QC20729

OMEGAMON II for DB2 260 QO2C169

OMEGAMON II for IMS 110 QOI1790

QI21791

QI22030

OMEGAMON II for DBCTL 110 QOI0090

QI20091

QI22030

IF you are at... AND... USE Transplex navigation to go to...


Using Transplex Navigation with OMEGAMON II for CICS

Using Transplex Navigation with OMEGAMON II for CICSFrom the following panels, you can use transplex navigation to go to the corresponding OMEGAMON II for DBCTL panel, the corresponding OMEGAMON II for DB2 panel, or the corresponding remote OMEGAMON II for CICS panel.

n Task Detailsn Task Addressesn Task File Statisticsn Task Remote Informationn Task Statisticsn Task Storagen Task Time Analysisn Task Umbrella Datan Front End Programming Interfacen Task Terminal Statistics

The procedures below describe how to access and use transplex navigation from these panels.

RequirementFor each target OMEGAMON that you navigate to, the OMEGAVIEW collector session for that OMEGAMON must be active. If an OMEGAMON collector session is not active, OMEGAVIEW displays a message with instructions to contact your system administrator.



Navigating from a Tasks Panel to DBCTLYou can use session switching to reach an OMEGAMON II for CICS session either from OMEGAVIEW or another OMEGAMON; refer to “Session Switching” on page 290 for instructions. Then use the following procedure to access a Tasks panel and use transplex navigation.

Note: Transplex navigation is invoked with a pushbutton. If there is no transaction activity to monitor, this pushbutton does not appear on the panel.

Step Action Result

1 From the Region Status panel, select Tasks and press Enter.

The Tasks panel appears.

2 From the Tasks panel, select a task and press Enter.

The Task Details panel appears.

3 From the Task Details panel, select a pushbutton, for example, Files, at the bottom of the screen.

The Task File Statistics panel appears.

4 From the Task File Statistics panel, select the GoTo DBCTL pushbutton at the bottom of the screen.

The OMEGAMON II for DBCTL target panel appears.

If you want to return to OMEGAMON II for CICS, select the Return to CICS pushbutton at the bottom of the screen.

Note: If the transaction you are monitoring is no longer active, an informational pop-up message appears.



Navigating from a Tasks Panel to DB2You can use session switching to reach an OMEGAMON II for CICS session either from OMEGAVIEW or another OMEGAMON; refer to “Session Switching” on page 290 for instructions. Then, use the following procedure to access a Tasks panel and use transplex navigation.


Step Action Result



2 From the Tasks panel, select a task number and press Enter.


3 From the Task Details panel, select a pushbutton, for example, Files, at the bottom of the screen.

The Task File Statistics panel appears.

4 From the Task File Statistics panel, select the GoTo DB2 pushbutton at the bottom of the screen.

The OMEGAMON II for DB2 target panel appears. If you want to return to OMEGAMON II for CICS, select the Return to CICS pushbutton at the bottom of the screen.




Navigating from a Tasks Panel to Remote CICSYou can use session switching to reach an OMEGAMON II for CICS session either from OMEGAVIEW or another OMEGAMON; refer to “Session Switching” on page 290 for instructions. Then, use the following procedure to access a Tasks panel and use transplex navigation.


Step Action Result



2 From the Tasks panel, select a task number and press Enter.


3 From the Task Details panel, select a pushbutton, for example, Remote, at the bottom of the screen.

The Task Remote Information panel appears.

4 From the Task Remote Information panel, select the GoTo Remote CICS pushbutton at the bottom of the screen.

The remote OMEGAMON II for CICS target panel appears.

If you want to return from the remote OMEGAMON II for CICS, select the Return from remote CICS pushbutton at the bottom of the screen.


CUA Actions 297

CUA Actions

IntroductionThis appendix describes how you can modify attributes for some CICS resources directly on OMEGAMON II for CICS panels.

Chapter ContentsPurpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298Summary of Panel Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302

D

Purpose


PurposeYou can manage CICS resources more easily by modifying resource attributes directly on the Common User Access (CUA) summary and detail panels in OMEGAMON II for CICS.

Description

The following changes have been made to the CUA panels in OMEGAMON II for CICS:

n New actions codes have been added to specific CUA panels.

n To aid memorization, new action codes are displayed on summary panels.

n Some previously display-only fields are now entry fields, and new entry fields have been added to some panels. With these changes, you can modify a resource attribute (for example, the Maximum Tasks Limit) displayed in a field.

Requirements

You must be authorized in OMEGAMON II for CICS to perform the specified actions. There are two kinds of security:

n If you are using function-level security, user authorization is controlled by the CUA function level security resource cicsname.KC2.MEM.CEMT

n If you are using menu system security, you can control user authorization for the actions by restricting access to the CMT command

Procedures for Modifying Resource Attributes

Performing actions from a Summary Panel

Action codes are usually displayed directly on a summary panel to indicate the actions you can perform on a resource. For example, the following Programs panel shows the action codes (E, I, N, and P) you can specify for programs. Action codes differ depending on the panel that is displayed.

On the Programs panel, for example, you type the appropriate code in the action entry field preceding the Program ID to change the attribute for that program. In the following example, the NewCopy(N) action is selected for the CMRTRNJ0 program.

CUA Actions 299

Purpose

FIGURE 189. Action Codes on the Programs Panel

Performing Actions from a Detail Panel

From a detail panel, you can select the action you want to perform on the resource from the Actions pulldown menu. The choices on the Actions menu differ depending on the panel that is displayed. For example, the following Actions pulldown menu for the Programs Entry detail panel lists the actions (Enable, Disable, Newcopy, and Phasein) you can perform on the CMRTRNJ0 program.

In this example, the NewCopy(N) action is selected for the CMRTRNJ0 program.

Note: You can also type the mnemonic AN on the action bar to perform this action

_____ Actions GoTo View Index Options Help ------------------------------------------------------------ 08/14/96 7:36:22 KC2P37D Programs Region: CICSPROD Fastpath: =CP Auto(Off) E=Enable I=Disable N=NewCopy P=PhaseIn Lines 1 to 11 of 454 +------------+----------+-----------+----------+---------+---------+---------+ | Program | Program | Program | Program | Program | Current | Total | | ID | Status | Language | Location | Length | Usage | Usage | +------------+----------+-----------+----------+---------+---------+---------+ | _ CMRAIDJ0 | Enabled | Assembler | ERDSA | 2792 | 1 | 24901 | | N CMRTRNJ0 | Enabled | Assembler | | 3632 | 0 | 0 | | _ CRDATASP | Enabled | Assembler | | 0 | 0 | 0 | | _ CSRETN00 | Enabled | Assembler | | 688 | 0 | 0 | | _ CSTTA001 | Enabled | Assembler | | 1792 | 0 | 0 | | _ DEDATASP | Enabled | Assembler | | 0 | 0 | 0 | | _ DEGCICS | Enabled | Assembler | ERDSA | 6280 | 0 | 62251 | | _ DFH$AALL | Enabled | Assembler | | 2936 | 0 | 0 | | _ DFH$ABRW | Enabled | Assembler | | 2520 | 0 | 0 | | _ DFH$ACOM | Enabled | Assembler | | 1128 | 0 | 0 | | _ DFH$AGA | Enabled | BMS map | | 520 | 0 | 0 | +------------+----------+-----------+----------+---------+---------+---------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console **=Bkwd F8=Fwd F10=Action Bar F11=Print F15=Region Status PA1=Switch

Purpose


FIGURE 190. Actions Pulldown Menu for the Program Entry Panel.

_____ Actions GoTo Index Options Help ____+----------------------------------+ ___________________ 08/30/96 13:01:32 | N 1. Show details | ntry Region: CICSPROD Fas | | Auto(Off) +-- | 2. Enable program | ------------------------------------+ | | 3. Disable program | Entry address . . . . : 08C7C5E8 | | | 4. Newcopy | Definition type . . . : Catalog | | | 5. Phasein | Program attribute . . : Reusable | | | | Current use count . . : 0 | | | 6. Exit F3 | Total use count . . . : 0 | | | | Total load count . . . : 0 | | | F1=Help F12=Cancel | Current copies . . . . : 0 | | +----------------------------------+ Load status . . . . . : Located | | Load point . . . . . . : n/a | Entry point . . . . . : n/a | | Loaded from . . . . . : n/a | Program location . . . : n/a | | Data location . . . . : Below | Exec key . . . . . . . : USER | | Use count . . . . . . : 0 | | | Fetch count . . . . . : 0 | Deletes by compression : 0 | | Statistics last reset : 6:13:17 | Refreshes . . . . . . : 2 | +--------------------------------------+-------------------------------------+ | RPL dataset . . . . . : CICS.PROD.LOAD | +----------------------------------------------------------------------------+ F1=Help F2=Keys F3=Exit F4=Prompt F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status PA1=Switch

CUA Actions 301

Purpose

Typing Attribute Values in Entry Fields

Another method you can use to modify selected resource attributes is to type a value into an entry field on the panel. In this example (for a system monitoring CICS Release 4.1.0), you can type a value into a field in the Active Limit column to change the maximum tasks limit (MXT) or the maximum number of tasks for the defined transaction classes.

FIGURE 191. Entry Fields on the Transaction Statistics Panel

_____ GoTo Index Options Help ------------------------------------------------------------ 08/30/96 10:18:30 Transaction Statistics Region: CICSPROD Fastpath: =WTN Auto(Off) +----------+-------+--------+-----+--------+------+-------+------------------+ | | Active|Times at|Peak |Current |Queue |Number |% of Active | | Type | Limit |Act Lim |Tasks| Tasks |Limit |Queued |Limit 0.......100 | +----------+-------+--------+-----+--------+------+-------+------+-----------+ | MXT | _32 | 244 | 38 | 13 | n/a | n/a | 41% |---> | | DFHTCL01 | __9 | 0 | 1 | 0 | 0 | 0 | 0% | | | DFHTCL02 | __1 | 0 | 0 | 0 | 0 | 0 | 0% | | | DFHTCL03 | __1 | 0 | 0 | 0 | 0 | 0 | 0% | | | DFHTCL04 | __1 | 0 | 0 | 0 | 0 | 0 | 0% | | | DFHTCL05 | __1 | 0 | 0 | 0 | 0 | 0 | 0% | | | DFHTCL06 | __1 | 0 | 0 | 0 | 0 | 0 | 0% | | | DFHTCL07 | __1 | 0 | 0 | 0 | 0 | 0 | 0% | | | DFHTCL08 | __1 | 0 | 0 | 0 | 0 | 0 | 0% | | | DFHTCL09 | __1 | 0 | 0 | 0 | 0 | 0 | 0% | | | DFHTCL10 | __1 | 0 | 0 | 0 | 0 | 0 | 0% | | +----------+-------+--------+-----+--------+------+-------+------+-----------+ F1=Help F2=Keys F3=Exit F5=Refresh F6=Console F10=Action Bar F11=Print F15=Region Status PA1=Switch

Summary of Panel Changes



Introduction

The resource attributes you can modify differ depending on the release of CICS you are monitoring as shown in the following tables.

Each table provides the following information:

n CICS resource

n Resource attribute

n CUA panel name on which you can specify the resource attribute

n Fast path code for accessing the panel

CICS Release 2.1.2The following table describes the OMEGAMON II for CICS panel changes you will see when you are monitoring CICS Release 2.1.2.

Table 2. CUA Panel Enhancements (CICS Release 2.1.2)

CICS Resource Resource Attributes CUA Panel NameFast Path

Auxiliary Trace New actions:n Start auxiliary tracen Stop auxiliary trace

Trace =CR

Destinations New actions:n Open queuen Close queuen Enable queuen Disable queue

Destination Control Table (DCT) =CD


New actions:n Enable queuen Disable queue



DSA cushion size New entry field:n Cushion size



Files New actions:n Open filen Close filen Enable filen Disable file



File Control Table Entry - Statistics =CFS

File Control Table - Logging =CFL

File Control Table - Data Table =CFT

CUA Actions 303


Internal trace New actions:n Start internal tracen Stop internal trace

Trace =CR

Maximum active tasks limit

New entry field:n Maximum active tasks


New entry field:n AMXT Active Limit


Maximum tasks limit

New entry field:n Maximum tasks


New entry field:n MXT Active Limit


Programs New actions:n Enable programn Disable programn Newcopy

Programs =CP

Program Entry =CPE

Region exit interval New entry field:n Region exit interval


Runaway task interval

New entry field:n Runaway task interval


Stall time interval New entry field:n Stall time interval


Systems New actions:n Set terminal inservicen Set terminal outservicen Acquire sessionn Release session


=RM

TCT System Entry =RME

TCT System Entry Statistics =RMS

Terminals New actions:n Set terminal inservicen Set terminal outservicen Acquire sessionn Release session

Terminal Control Table (TCT =CT

TCTTE =CTE



Transaction class limits

New entry fields:n Class 1 - Class 10

maximum tasks


New entry fields:n Class01 - Class10 Active

Limit




Transactions New actions:n Enable transactionn Disable transaction

Transactions =CN

Transaction Entry =CNE

VTAM ACB New actions:n Open VTAM ACBn Close VTAM ACB

Terminal Control Table Prefix (TCTFX)

=AV

CUA Actions 305


CICS Release 3.1.1 or 3.2.1The following table describes the OMEGAMON II for CICS panel changes you will see when you are monitoring CICS Release 3.1.1 or 3.2.1.

Table 3. CUA Panel Enhancements (CICS Release 3.1.1 or 3.2.1)


Auxiliary Trace New actions:n Start auxiliary tracen Pause auxiliary tracen Stop auxiliary tracen Switch dataset

Trace =CR


Destination Control Table (DCT)

=CD





DSA cushion sizes New entry fields:n DSA storage cushionn EDSA storage cushion


The cushion size for the selected area is given in the new Cushion size entry field.





File Control Table Entry - Statistics

=CFS



GTF trace New actions:n Start GTF tracen Stop GTF trace

Trace =CR


Trace =CR




New entry field:n Maximum active task




Maximum tasks limit





Programs New actions:n Enable programn Disable programn Newcopyn Phasein

Programs =CP

Program Entry =CPE






Scan delay interval New entry field:n Scan delay interval




=RM





TCTTE =CTE




New entry fields:n Class 1 - Class 10 maximum

tasks


New entry fields:n Class01 - Class10 Active Limit




CUA Actions 307




Transactions =CN




=AV




Trace =CR



=CD




Destination Queues Over Limits

=RNL

DSA cushion sizes New entry fields:n CDSA cushion sizen UDSA cushion sizen ERDSA cushion sizen ECDSA cushion sizen EUDSA cushion size


Cushion size for the selected area is given in the new Cushion size entry field.










=CFS




Trace =CR


Trace =CR


New entry field:n Maximum active tasks




Maximum tasks limit






Programs =CP

Program Entry =CPE










CUA Actions 309




=RM





TCTTE =CTE




New entry fields:n Class 1 - Class 10 maximum

tasks


New entry fields:n Class01 - Class10 Active

Limit



Transactions =CN




=AV





CICS Release 4.1.0The following table describes the OMEGAMON II for CICS panel changes you will see when you are monitoring CICS Release 4.1.0




Trace =CR



=CD

DCT Extrapartition Information

=CDE


DCT Intrapartition Information

=CDP

Destination Queues Over Limits

=RNL

DSA limits New entry fields:n DSA limitn EDSA limit


CICS Storage =RS





=CFS




Trace =CR


Trace =CR

CUA Actions 311


Maximum tasks limit






Programs =CP

Program Entry =CPE










=RM





TCTTE =CTE




New entry fields:n An Active Limit field for

each defined transaction class



Transactions =CN




=AV








Trace =CR



=CD





DSA limits New entry fields:n DSA limitn EDSA limit


CICS Storage =RS





=CFS




Trace =CR


Trace =CR

Journals New action:n Enable journaln Disable journaln Flush journaln Reset journal

Journals =RJ

Journal Details =RJD

CUA Actions 313


Maximum tasks limit






Programs =CP

Program Entry =CPE










=RM



Task Bridge information Task Bridge Details =WTB

TCP/IP TCP/IP Sockets TCP/IP Sockets Activity =RT



TCTTE =CTE




New entry fields:n An Active Limit field for

each defined transaction class



Transactions =CN





UOW New actions:n Force commitn Force backoutn Force defined action

UOWs =WU

UOW Details =WUD

UOW Enqueues =WUQ

UOW Links =WUL

UOW links New action:n Delete UOW link

UOW Links =WUL



=AV

Web CICS Web Information Web Interface =RW


CUA Actions 315





DB2 DB2 Active Transactions DB2TRANSACTIONS with active threads

=RBA

DB2 DB2ENTRY Detail DB2ENTRY Details =RBED

DB2 DB2ENTRY Names DB2ENTRYs =RBE

DB2 DB2TRAN Names DB2TRANs =RBT



Guide to Candle Customer Support 317

Guide to CandleCustomer Support

IntroductionCandle Corporation is committed to producing top-quality software products and services. To assist you with making effective use of our products in your business environment, Candle is also committed to providing easy-to-use, responsive customer support.

Precision, speed, availability, predictability—these terms describe our products and Customer Support services.

Included in this Guide to Candle Customer Support is information about the following:

Base Maintenance Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318– Telephone Support– eSupport– Description of Severity Levels– Service-level objectives– Recording and monitoring calls for quality purposes– Customer Support Escalations– Above and Beyond

Enhanced Support Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322– Assigned Support Center Representative (ASCR)– Maintenance Assessment Services (MAS)– Multi-Services Manager (MSM)

Customer Support Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323– Link to Worldwide Support Telephone and E-mail information

E

Base Maintenance Plan



OverviewCandle offers a comprehensive Base Maintenance Plan to ensure that you realize the greatest value possible from your Candle software investments. We have more than 200 technicians providing support worldwide, committed to being responsive and to providing expedient resolutions to support requests. Technicians are available worldwide at all times during the local business day. In the event of an after-hours or weekend emergency, our computerized call management and forwarding system will ensure that a technician responds to Severity One situations within one hour. For customers outside of North America, after-hours and weekend support is provided in English language only by Candle Customer Support technicians located in the United States.

Telephone supportCandle provides consistently reliable levels of service—thanks to our worldwide support network of dedicated experts trained for specific products and operating systems. You will always work with a professional who truly understands your problem.

We use an online interactive problem management system to log and track all customer-reported support requests. We give your support request immediate attention by routing the issue to the appropriate technical resource, regardless of geographic location.

Level 0 Support is where your call to Candle Customer Support is first handled. Your support request is recorded in our problem management system, then transferred to the appropriate Level 1 support team. We provide Level 0 manual interaction with our customers because we support more than 170 products. We feel our customers would prefer personal interaction to a complex VRU or IVR selection menu.

Level 1 Support is the service provided for initial support requests. Our Level 1 team offers problem determination assistance, problem analysis, problem resolutions, installation assistance, and preventative and corrective service information. They also provide product usage assistance.

Level 2 Support is engaged if Level 1 cannot provide a resolution to your problem. Our Level 2 technicians are equipped to analyze and reproduce errors or to determine that an error is not reproducible. Problems that cannot be resolved by Level 2 are escalated to Candle’s Level 3 R&D support team.

Level 3 Support is engaged if a problem is identified in Candle product code. At Level 3, efforts are made to provide error correction, circumvention or notification that a correction or circumvention is not available. Level 3 support provides available maintenance modifications and maintenance delivery to correct appropriate documentation or product code errors.

eSupportIn order to facilitate the support process, Candle also provides eSupport, an electronic full-service information and customer support facility, via the World Wide Web at www.candle.com/support/. eSupport allows you to open a new service request and update

http://www.candle.com/support/



existing service requests, as well as update information in your customer profile. New and updated service requests are queued to a support technician for immediate action. And we can respond to your request electronically or by telephone—it is your choice.

eSupport also contains a continually expanding knowledge base that customers can tap into at any time for self-service access to product and maintenance information.

The Candle Web Site and eSupport can be accessed 24 hours a day, 7 days a week by using your authorized Candle user ID and password.

Description of Candle severity levelsResponses to customer-reported product issues and usage questions are prioritized within Candle according to Severity Code assignment. Customers set their own Severity Levels when contacting a support center. This ensures that we respond according to your individual business requirements.

Candle has established the following service-level objectives:

Severity 1 Crisis

A crisis affects your ability to conduct business, and no procedural workaround exists. The system or application may be down.

Severity 2High

A high-impact problem indicates significant business effect to you. The program is usable but severely limited.

Severity 3Moderate

A moderate-impact problem involves partial, non-critical functionality loss or a reasonable workaround to the problem. A “fix” may be provided in a future release.

Severity 4Low

A low-impact problem is a “how-to” or an advisory question.

Severity 5Enhancement Request

This is a request for software or documentation enhancement. Our business units review all requests for possible incorporation into a future release of the product.

Call StatusSeverity 1

GoalSeverity 2

GoalSeverity 3

GoalSeverity 4

GoalSeverity 5

Goal

First Call Time to Answer

90% within one minute

Level 1 Response(Normal Business Hours)

90% within 5 minutes

90% within one hour

Level 2 Response(Normal Business Hours)

Warm Transfer

90% within two hours

90% within eight hours

The above information is for guideline purposes only. Candle does not guarantee or warrant the above service levels. This information is valid as of October 1999 and is subject to change without prior notice.



Scheduled follow-up (status update)

Hourly or as agreed

Daily or as agreed

Weekly or as agreed Notification is made when an enhancement is incorporated into a generally available product.

Notification is made when a fix is incorporated into a generally available product.

Call StatusSeverity 1

GoalSeverity 2

GoalSeverity 3

GoalSeverity 4

GoalSeverity 5

Goal

The above information is for guideline purposes only. Candle does not guarantee or warrant the above service levels. This information is valid as of October 1999 and is subject to change without prior notice.



Recording and Monitoring Calls for Quality PurposesCandle is committed to customer satisfaction. To ensure that our customers receive high levels of service, quality and professionalism, we’ll monitor and possibly record incoming and outgoing Customer Support calls. The information gleaned from these calls will help us serve you better. If you prefer that your telephone call with Candle Customer Support in North America not be monitored or recorded, please advise the representative when you call us at (800) 328-1811 or (310) 535-3636.

Customer Support EscalationsCandle Customer Support is committed to achieving high satisfaction ratings from our customers. However, we realize that you may occasionally have support issues that need to be escalated to Candle management. In those instances, we offer the following simple escalation procedure:

If you experience dissatisfaction with Candle Customer Support at any time, please escalate your concern by calling the Candle support location closest to you. Ask to speak to a Customer Support manager. During standard business hours, a Customer Support manager will be available to talk with you or will return your call. If you elect to hold for a manager, you will be connected with someone as soon as possible. If you wish a return call, please tell the Candle representative coordinating your call when you will be available. After contacting you, the Customer Support manager will develop an action plan to resolve your issue. All escalations or complaints received about support issues are logged and tracked to ensure responsiveness and closure.

Above and BeyondWhat differentiates Candle’s support services from our competitors? We go the extra mile by offering the following as part of our Base Maintenance Plan:

n Unlimited multi-language defect, installation and operations supportn eSupport using the World Wide Webn Regularly scheduled product updates and maintenance provided at no additional chargen Over 200 specialized technicians providing expert support for your Candle products

Enhanced Support Services


Enhanced Support Services

OverviewOur Base Maintenance Plan provides a high level of software support in a packaged offering. However, in addition to this plan, we have additional fee-based support services to meet unique customer needs.

The following are some examples of our added-value support services:

n Assigned Support Center Representative Services (ASCR)

– An assigned focal point for managing support escalation needs– Proactive notification of available software fixes– Proactive notification of product version updates– Weekly conference calls with your ASCR to review active problem records– Monthly performance reviews of Candle Customer Support service levels– Optional on-site visits (extra charges may apply)

n Maintenance Assessment Service (MAS)

– On-site assessment services– Advice about product maintenance and implementation– Training your staff to develop efficient and focused procedures to reduce overall cost

of ownership of your Candle software products– Analysis of your Candle product environment: versions, updates, code correction

history, incident history and product configurations– Reviews to ensure that purchased Candle products and solutions are used effectively

n Multi-Services Manager (MSM)

Multi-Services Manager provides highly valued services to customers requiring on-site full time expertise to complement their technical resources.

– Dedicated on-site Candle resource (6 months or one year) at your site to help ensure maximum use and effectiveness of your Candle products

– Liaison for all Candle product support activities, coordination and assistance with implementation of all product updates and maintenance releases

– Works with your staff to understand business needs and systems requirements– Possesses technical and systems management skills to enhance your staff’s knowledge

and expertise– Other projects as defined in Statement of Work for MSM services


Customer Support Contact Information


Link to Worldwide Support Telephone and E-mail informationTo contact Customer Support, the current list of telephone numbers and e-mail addresses can be found on the Candle Web site, www.candle.com/support/.

Select Support Contacts from the list on the left of the page.

http://www.candle.com/support/



Index 325

Numeric3270 terminal/emulator 33

Aaccessing OMEGAMON II

through direct logon 48through OMEGAVIEW 52

account level security 49account number 48action bar

Actions 35GoTo 35help 35, 40home position on 35Index 35moving cursor to the 35Options 35selecting from the 35using the 35View 35

action code 38, 60explicit 74implicit 74

Actions pull-down menu 60active elements 142address space initialization 48Adobe portable document format 17alerts

bottlenecks 230CICS loop 234CICS time-of-day 234dumps 236enqueues 238I/O rate 241VTAM ACB 244XRF 247

all-uppercase text display 34alternate CICS region, starting 248alternative logon method 52analyzing problems

DASD 169for bottlenecks 232for CICS loops 235for CPU 165for DB2 172for DBCTL 173

for DL/I 176for dumps 237for enqueues 240for files 179for I/O rate 244for journals 187for local resource pools (LSR) 191for storage 200for tapes 202for temporary storage 206for transient data 211for VTAM ACB 245for XRF 250

application trace datacontrolling collection of data 89setting filters 89

application, poor response 110ASCR

assigned support center representative 322assigned support center representative

ASCR 322asterisk (*) 33

entering an 142, 185, 230authorized commands

disable 79enable 79

auto refresh interval 58, 77automatic initiate descriptor (AID) 130

analyze problems for 134terminating 131

Bbatch reports

historical reporter 30SAS (Statistical Analysis System) 30user-written programs 30

beep 73bottleneck analysis 143, 230

external bottlenecks 106internal bottlenecks 106, 143

CCICS control blocks 62CICS File/Database (CUA)

activating collection 85CICS Memory panel 63

Index


CICS monitoring 87CICS region 47

monitoring a 58OMEGAVIEW Switch Session key 58profile, settings for 94region profile search order 58switching to another 58

CICS shutdown task purge option 89CICS Tables panel 62CL/Engine address space 48clock, CICS 234Close Print Log option 95CMXT exception 145Collection Controls option 80color, highlighting 33commands, protected 51common interface password 51Common System Area (CSA) 234control data collection 57CPU consumption 164CUA interface 15, 26, 31

accessing through direct logon 26, 48accessing through OMEGAVIEW 26, 52, 269, 276customizing options for the 72exiting from 45panels 32session 72using 26

customer servicetelephone support 318

customer supportbase maintenance plan 318contact information 323enhanced support services 322eSupport 318severity levels 319

customization defaults, verifying 52

DDASD 167data collection 80

for CICS file/database information 85for internal bottlenecks 80for interval recording 83for response time 82for task history 84frequency of 57

data display area 32data integrity, loss of 146date and time

format 74stamp 58

DB2 170DBCTL 173default

options 72settings (changing response time) 140userid profile 92view 77

Default view 77direct logon 48disable authorized commands 79DL/I 175documentation set 16dropped ready 167dump analysis

controlling collection time for counts 88resetting the count 88

dumps 236dynamic groups 254Dynamic Profile Update Facility 96

Eelements

deleting from multiple groups 267deleting from single group 265

Elements in a Group panel 260ellipsis 34end-to-end response time 140enqueues 238enter key 42eSupport

customer support 318excessive CPU usage 100, 164excessive response time 104exiting form the CUA interface 45explicit selection 60extended recovery facility (XRF) 247external contention 106

Ffast path character 38, 278fast pathing (CUA) 38, 39, 65

tables 277features, monitoring 28field-level help 41file organization

ESDS 179KSDS 179RRDS 179

Files 177filtering criteria 70filters for application trace data

ATF filters 89

Index 327

force purge task 147frequency of data collection 57function keys 32, 43, 74

Ggetting started 47Go To pull-down menu 61group level security 49group types

program 261terminal 261transaction 261VTAM logical unit (LU) 261

groupsadding elements to 262copying from existing 257copying from existing element 259creating new 256defining 251, 267defining elements for 258defining elements for (using wildcard

characters) 258defining permanently 254deleting entire 265logical unit 140modifying 264modifying (defining dynamically) 254modifying (start Response Time collection) 254modifying (stop Response Time collection) 254modifying elements for 264number of elements supported 252purpose of 252response time 140

Hhelp

from a panel 41from an input field 41from the action bar 40glossary 41online 40search help glossary 40search help index 40system (CUA interface) 97

Help index 41Help pull-down menu 40, 97highlighting

color 33fields 33types of text 33underscore 33

historical data 63

historical facility 25home position 35

II/O rate 241ICE 135identifying problems 99implicit action/selection 38, 74index of panels 65Index pull-down menu

fast path codes based on 65input field 41internal bottleneck

activating collection 80analysis 81collection 28display controls 81

internal security 133, 137intersystem communication 192interval control element (ICE) 135

analyze problems for 139details panel 138summary panel 135terminating a single ICE 136terminating ICES for a terminal 136

interval control element ICE)terminating ICEs for a transaction 136

interval recording (CUA) 83intrapartition transient data queues, deleting 209Introduction 25

JJapanese 74Journal Models panel 183journals 182Journals Details panel 183Journals panel 182

pushbuttons 183

Kkill

AID 131ICE 136task 146

LLocal Shared Resources (LSR) 189Log Streams panel 183logical tuning approach 27logon 269

options 49


security entry 49to OMEGAMON II (direct) 48to OMEGAMON II (through OMEGAVIEW) 52

loop, CICS 234

Mmaintenance assessment service

MAS 322MAS

maintenance assessment service 322measuring performance 27menu system 26message queueing (MQ)

CUA panels 217displaying application trace data 226displaying MQ activity 222limiting resource requests 228monitoring 215monitoring functions 219specifying thresholds 220

migrate profile 51mnemonics 38, 73monitoring

controls, setting 90features 28message queueing 215performance 27

monitoring, levels of controlCICS 87OMEGAMON II 87SMF data collection 87

monochrome terminal 33selecting items on 38unavailable items on 33

more informationdisplaying 34using More 34using overtypable line 34

MRO/ISC 192MSM

multi-services manager 322multi-services manager

MSM 322MXT, % of 145

Nnational language 74navigation

fast path 38, 39point and shoot 38to all panels 38transplex 39

with pushbuttons 38, 39new application has poor response 110

OOMEGACENTER 289OMEGAMON 25OMEGAMON II monitoring 87OMEGAVIEW 269

logon 52session switching 289zoom time from 270

online help 40, 97Options pull-down menu

delete confirmation 74exit confirmation 74

PPaging field 195paging rate 195panel characteristics

action bar 32asterisks 33body 32color 33function keys 32help 41ID 73pushbuttons 32

password 48authorized commands 51change 49common interface 51duration of 51entering 49reset authorization for 51

performance 99data collection 80identifying problems 27measure 54, 90monitoring 27, 90setting standards 27solving problems 27, 125status bar 33

permanent groups 254plus sign (+) 33plus sign (+), minus sign (-) 34point and shoot 26poor response (application) 110pop-up window 37Preferences option 73primary CICS region 247printing problems 17

Index 329

problemsidentifying 99solving 99, 125

profiledefault region 93default user ID 91managing, region 93managing, user 91

program changes not reflected 115program, response time 140pull-down menu 36purge

task 165purge tasks at shutdown 89purge, task 146pushbuttons 32

fastpathing to 38

Rrealtime monitor 25record level sharing 180region

profile 72, 93profile, search order for 58profile, settings for 94

Region Profiles option 93Region Status panel 54, 60report methods 30reporter, historical 30resetting the count 88resource limiting

global data area module 86KOCRLIM macro 86setting thresholds 86

resource usage 57resources 163

CPU consumption 164CPU Rates panel (excluded tasks on) 164DASD 167DB2 170DBCTL 173DL/I 175files 177IMS pool types 175journals 182local shared resources (LSR) 189MRO/ISC 192paging 195storage 197tapes 201temporary storage 204transient data 208

transient data (intrapartition transient data queues, deleting) 209

response timeanalyze problems for 144collection of 140, 254groups 140, 251poor 105, 108, 110programs, end-to-end 140terminals 140transactions 140VTAM LU 140

response time (CUA)activating collection 82

restoring values 70reverse video 33RLS 180

SSAS 30screen print log 95scrolling 34scrolling indicator 34search facility

for help glossary 41for help index 41

Search Index 65security program 51selectable field 32service level 90service level agreement 90service level indicator 90session defaults 72, 77session switching 289

default key 290procedure for 290

severity levelscustomer support 319

Share control 179Sign On panel 49SMF (System Management Facility)

records 30SMF data collection 87software performance monitor 25solving problems 99starting an OMEGAMON II session 52Statistical Analysis System (SAS)statistics collection VSAM 88status

bar 33characters 77condition, following 27words 77

status bar


color of 33storage violation analysis

controlling collection time for counts 88sysplex, definition of 289system defaults, changing 72system features 28System Management Facility (SMF) 83Systems Application Architecture (SAA) 26

TTask History (CUA)

activating collection 84Task History panel 63task purge option 89task statistics 86Tasks 145

AMXT, % of 145CMXT, highest % of 145summary panel (excluded tasks on) 145terminating 146wait reasons 146

TCP/IP socket activity 214telephone support

customer service 318Temporary Storage Queues panel

deleting queues 206hexadecimal queue ID display 206

terminal response time 140terminal, color 33terminating CICS, risk of 146thresholds 54, 72

critical 90default response time settings 140values 90warning 90

Thresholds option 90time

afternoon indicator 75morning indicator 75separator character 75time format 75valid 75

time and date display 74time-of-day, CICS 234tip of the day 52tips list 41transaction (Menu)

response time 140transient data queues 209transplex navigation 39, 289

with OMEGAMON for CICS 293transplex, definition of 289

trigger key 64, 77tuning CICS 27typical CICS problems

complaints on bad response 108excessive CPU usage 100excessive response time 104new application has poor response 110program changes not reflected 115

Uuppercase text display 34user complaints on bad response 108user ID 48user interfaces

CUA 26menu system 26

userid profile 50, 72, 91settings for 92

Userid Profiles option 91

Vvalues, restoring 70Version 520 enhancements 21View pull-down menu 67View Some pop-up window

fields and columns, promptable 69for all panels except Task History 67for the Task History panel 70search criteria 69value column, asterisks in 69

virtual storage 63VSAM analysis

controlling statistics collection 88VSAM record level sharing 180VTAM

applids 48logical units (LUs) 261

Wwait reasons 81

for CICS/ESA 146provided by OMEGAMON II 146

web interface 213wildcard characters 258workloads

automatic initiate descriptor (AID) 130interval control element (ICE) 135response 140tasks 145

XXRF 247

Index 331

Zzoom

from OMEGAVIEW to OMEGAMON II 270

return to the CUA interface 64through OMEGAVIEW 269to OMEGAMON II menu system 64


Date post:	21-Mar-2018
Category:	Documents
Upload:	ngodiep
View:	290 times
Download:	7 times

OMEGAMON II for CICS User s Guide V520 - IBM...

Documents