OMEGAMON II for IMS Realtime Commands Reference Manual V510

Realtime Commands Reference Manual OMEGAMON II® for IMS Version 510

GC32-9268-00 March 2002

Candle Corporation 201 North Douglas Street El Segundo, California 90245-9796

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, eBA*ServiceMonitor, eBA*ServiceNetwork, eBusiness Institute, 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, Candle CIRCUIT, Candle eDelivery, 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, 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 © March 2002, 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.

2

OMEGAMON II for IMS Realtime Commands Reference Manual V510

Contents List of Figures

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7

List of Tables

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

Preface

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 Adobe Portable Document Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15 Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16

What’s New

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Application Trace Facility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20 New OMEGAMON II Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21 Documentation Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

Chapter 1.

Operational Essentials. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 OMEGAMON II User Interfaces and Components . . . . . . . . . . . . . . . . . . . . . . . . . . . .24 Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27 Modes of Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28 INFO-line Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30 Entering Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32 Command Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35

Chapter 2.

Operational Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 Command Modifiers and Help Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40 Operational INFO-line and Immediate Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . .42

Chapter 3.

User Profile Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83 OMEGAMON Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84 Multi-line Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86 Profile Maintenance Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87 Controlling Session and Display Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88 Setting Print Output Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89 Setting Color Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95 Setting Operational Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100 Setting Installation Performance Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102

Chapter 4.

Commands for Customizing and Creating Exceptions. . . . . . . . . . . . . . . . . . . 103 Customizing IMS Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104 Customizing Profiles for Users Who Log On through the CUA Interface . . . . . . . . . . .105 Commands for Controlling Exception Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106 Resource Contention Exception Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120

Contents

3

Chapter 5.

System Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 Real Memory Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .124 Common Storage Area Virtual Memory Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125 CSA Storage Isolation Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127 IMS Control Block Display Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128 Dynamic Control Block Table Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135 Dynamic Control Block Table Minor Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . .136 Display Checkpoint ID Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138 MFS Format Blocks in Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139 Display Information from $$IMSDIR Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .141 Locate IMS Modules in Virtual Memory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143 IMS Startup Parameters and Overrides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .144 IRLM Startup Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146 IMS Control Region Virtual Storage Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149 General IMS Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .151 IMS Online Change Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .156 IMS Dataset Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .158 IMS Transaction Rates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166 Fast Path Transaction Rates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167 IMS Trace Table Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169 Time-Controlled Operations Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .170 Plotting System Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .172

Chapter 6.

Device Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175 Device Listing Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .176 Disk Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .178 Tape Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .188 Long-Term Device Utilization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .195

Chapter 7.

Group Definition and Activation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201 Defining Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .202 Specifying Maximum Number of Transaction Groups . . . . . . . . . . . . . . . . . . . . . . . . .208 Activating New Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .210 Selecting Groups Automatically. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211

Chapter 8.

IMS Regions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 IMS Region Immediate Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216 IMS Region Major Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221 IMS Region Minor Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .226

Chapter 9.

IMS Resource Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253 Scheduling Class Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .256 Database Management Block Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .260 Program Specification Block Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .270 IMS User Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .277

4


Logical Terminal Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .280 Physical Terminal and Line Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .284 IMS VTAM Node Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .288 Transaction Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .291 IMS Conversation Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .298 Pool Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .301 IMS Logging Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .337 Fast Path Resource Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .343 Extended Recovery Facility (XRF) Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .356

Chapter 10.

IMS/DB2 Attach Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359 Major Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .360 Minor Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .361

Chapter 11.

Authorized Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363 Using Authorized Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .365 Address Specification for Storage Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .369 Displaying and Modifying Storage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .372 Console-related Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .387 Collecting Data about Address Spaces. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .396 Online Facility for Logging IMS Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .409 Displaying and Modifying Data Space and Hiperspace Storage. . . . . . . . . . . . . . . . . .414

Appendix A.

Automating and Logging Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421 Event- and Time-driven Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .422 Controlling Automating Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .423 Setting Parameters for XLF and ASF Operation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .425 Logging Parameters for XLF, ASF, and TSF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .428 Using Screen Spaces in ASF and TSF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .429

Appendix B.

The Database Control (DBCTL) Environment . . . . . . . . . . . . . . . . . . . . . . . . 433 OMEGAMON II for IMS Differences in DBCTL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .434 OMEGAMON Command DIfferences in DBCTL . . . . . . . . . . . . . . . . . . . . . . . . . . . . .435 Exception Differences in DBCTL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .436 Minor Command Differences in DBCTL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .438

Appendix C.

The Candle Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441 Candle Subsystem Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .442 Starting and Stopping the Candle Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .443

Appendix D.

Guide to Candle Customer Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445 Base Maintenance Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .446 Enhanced Support Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .450 Customer Support Contact Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .451

Index

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453

Contents

5

6


List of Figures FIGURE 1. FIGURE 2. FIGURE 3. FIGURE 4. FIGURE 5. FIGURE 6. FIGURE 7. FIGURE 8. FIGURE 9. FIGURE 10. FIGURE 11. FIGURE 12. FIGURE 13. FIGURE 14. FIGURE 15. FIGURE 16. FIGURE 17. FIGURE 18. FIGURE 19. FIGURE 20. FIGURE 21. FIGURE 22. FIGURE 23. FIGURE 24. FIGURE 25. FIGURE 26. FIGURE 27. FIGURE 28. FIGURE 29. FIGURE 30. FIGURE 31. FIGURE 32. FIGURE 33. FIGURE 34. FIGURE 35. FIGURE 36. FIGURE 37. FIGURE 38. FIGURE 39. FIGURE 40.

OMEGAMON II user interfaces and components . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24 INFO-line command help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37 SQA and ESQA utilization display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126 IMSCTL region virtual storage areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .150 ASYS information for IMS without Remote Site Recovery . . . . . . . . . . . . . . . . . . . . . .151 ISYS information for IMS without Remote Site Recovery . . . . . . . . . . . . . . . . . . . . . .153 ISYS information for IMS with Remote Site Recovery . . . . . . . . . . . . . . . . . . . . . . . . .154 Typical MVS System information display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .154 PDSK under IDEV display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .197 PDSK display of devices allocated to the DLS address space . . . . . . . . . . . . . . . . . . .198 Typical analysis of OLDS activity using IDEV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .199 Typical analysis of WADS activity using IDEV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .199 ISAP command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216 THIN Add command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217 THIN List command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217 THIN Delete command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .218 TTIM Add command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .219 TTIM List command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .220 TTIM Delete command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .220 RGN command used with IDEV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221 LOCK command display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230 Region major command with several minor commands . . . . . . . . . . . . . . . . . . . . . . .248 Region major command with service unit and page rate minor commands . . . . . . . . .248 Physical Line Minor Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .287 IMS conversation commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .300 CIOP major and minor commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .303 Typical RECA command output display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .307 Typical HIOP major and SIZE minor output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .307 Typical AIOP major and SIZE minor output. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .308 DMPL Major and SIZE Minor Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .312 Display VSAM buffer subpool statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .314 ISAM/OSAM buffer pool statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .317 FPDB major and BSTS and SIZE minor commands . . . . . . . . . . . . . . . . . . . . . . . . . .322 Typical EPCB major and SIZE minor output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324 Message format pool statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .326 SB16, SDIR, SFRE, and SDYN minor commands . . . . . . . . . . . . . . . . . . . . . . . . . . . .327 IMS PSBW pool information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .329 DSIZ and SIZE minor commands of PSPL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .331 QBUF major and SIZE, REQU, and BIOS minor commands. . . . . . . . . . . . . . . . . . . .334 LUMP pool statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .336

List of Figures

7

FIGURE 41. FIGURE 41. FIGURE 42. FIGURE 43. FIGURE 44. FIGURE 45. FIGURE 46. FIGURE 47. FIGURE 48. FIGURE 49. FIGURE 50. FIGURE 51. FIGURE 52. FIGURE 53. FIGURE 54. FIGURE 55. FIGURE 56. FIGURE 57.

8

(Part 1 of 2). LSYS and its minor commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .338 (part 2 of 2). LSYS and its minor commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .339 RCDx Command and Its Minors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .355 XRFS command executed on the active IMS system . . . . . . . . . . . . . . . . . . . . . . . . . .356 XRFS command executed on the standby IMS system. . . . . . . . . . . . . . . . . . . . . . . . .356 XRSV command output (RDS surveillance mode inactive) . . . . . . . . . . . . . . . . . . . . .357 XRSV command output (LINK surveillance mode not selected). . . . . . . . . . . . . . . . . .358 Typical output for ILST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .373 XLMS output in character format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .375 XLMS output in hex and character formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .375 Output from XMLS command with an action character . . . . . . . . . . . . . . . . . . . . . . . .376 ICNS command with the ICMD authorized command . . . . . . . . . . . . . . . . . . . . . . . .390 OCMD and CONS output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .393 AMAP display format (XA and ESA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .398 Example of TCB structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .408 Typical JCL for external writer procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .409 Dynamically allocating a dataset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .412 DEX02 screen space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .431


List of Tables Table 1. Table 2. Table 3. Table 4. Table 5. Table 6. Table 7.

OMEGAMON II for IMS Documentation Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12 Symbols in Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17 OUTP minor commands with initial settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90 Color/Highlighting settings in .SCC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99 Exception analysis control commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106 Commands that require the action character . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .366 Partial List of Valid Control Block Identifiers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .371

List of Tables

9

10


P

Preface

Introduction This manual contains reference information on the command user interface for the realtime performance component (OMEGAMON®) of OMEGAMON II® for IMS, Version 510. The manual describes each command in detail, and is organized into chapters that group the commands by the type of information they display. For example, there are chapters on the commands that give information about IMS devices, IMS regions, and IMS internal and external resources. In addition, the opening chapters cover operational essentials, and starting and stopping the product.

Preface

11

About This Book

About This Book Who should read this book This manual is for users who are familiar with performance monitoring software and IMS. For introductory, step-by-step instructions on how to use OMEGAMON II for IMS’s command interface as well as the primary CUA™ interface and menu interface, see the OMEGAMON II for IMS User’s Guide. This manual does not include information about the commands used by the bottleneck analysis (DEXAN), response time analysis (RTA), or historical (EPILOG) components of OMEGAMON II for IMS. For descriptions of these commands, see the: n

OMEGAMON II for IMS Bottleneck Analysis Reference Manual,

n

OMEGAMON II for IMS Response Time Analysis (RTA) Reference Manual,

n

OMEGAMON II for IMS Historical Component (EPILOG) Reference Manual

In this manual, OMEGAMON II refers to the OMEGAMON II for IMS product, and OMEGAMON refers to the command interface of the realtime performance component of OMEGAMON II for IMS, unless the context indicates otherwise.

Documentation set information The documentation listed in the following table is available for the Candle IMS Products. To order additional product manuals, contact your Candle Support Services representative. Table 1. OMEGAMON II for IMS Documentation Set Document Number

12

Document Name

Description

ET53-5586

End-to-End Response Time Feature (ETE) Reference Manual

Provides reference information about ETE commands, error messages, return codes, and sense codes.

IC51-6057

Installing Candle Products on MVS

Provides installation instructions and other installation considerations.

I251-5610

OMEGAMON II for IMS and OMEGAMON II for DBCTL Configuration and Customization Guide

Explains how to configure and customize OMEGAMON II and its user interfaces and

components.


About This Book

Table 1. OMEGAMON II for IMS Documentation Set Document Number

Document Name

Description

I253-6332

OMEGAMON II for IMS Realtime Commands Reference Manual

Describes in detail all of the features of the OMEGAMON II command interface.

I253-6333

OMEGAMON II for IMS Bottleneck Analysis Reference Manual

Provides reference information and descriptions of the features of the bottleneck analysis component.

I253-6336

OMEGAMON II for IMS Historical Component (EPILOG) Reference Manual

Provides a comprehensive description of the features of the historical component (EPILOG).

I254-6334

OMEGAMON II for IMS User’s Guide

Teaches the basics of using OMEGAMON II for IMS to manage realtime IMS environments.

I254-6335

OMEGAMON II for IMS Historical Component (EPILOG) User’s Guide

Teaches you, step-by-step, how to operate the historical component (EPILOG) reporter after installation.

I254-6337

OMEGAMON II for IMS Response Time Analysis (RTA) Reference Manual

Provides reference information and descriptions of the features of the response time analysis (RTA) component.

I299-6303

OMEGAMON II for IMS and OMEGAMON II for DBCTL Application Trace Facility

Provides user and reference information about the features of the Application Trace Facility (ATF) component.

I299-6338

OMEGAMON II for IMS and OMEGAMON II for DBCTL Transaction Reporting Facility

Provides user and reference information about the features of the Transaction Reporting Facility (TRF) component.

I299-6339

OMEGAMON II for IMS and OMEGAMON II for DBCTL IMS Console Facility

Provides a comprehensive description of the features of the IMS Console Facility (ICF) component.

W052-6238, W052-6239, W052-6240, W052-6356, W052-6357

Candle Products Messages Provides reference summary Manual, Vol. 1 through 5 information for all Candle product messages.

Preface

13

About This Book

Where to look for more information For more information related to this product, please see the n

technical documentation CD-ROM that came with your product

n

technical documentation information available on the Candle Web site at www.candle.com

n

online help provided with this and the other related products.

We would like to hear from you Candle welcomes your comments and suggestions for changes or additions to the documentation set. A user comment form, located at the back of each manual, provides simple instructions for communicating with the Candle Information Development department. You can also send email to [email protected]. Please include “OMEGAMON II® for IMS Historical Component (EPILOG) Reference Manual” in the subject line.

14


Adobe Portable Document Format

Adobe Portable Document Format Printing this book Candle 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 for n All n Current page n 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 Adobe If 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.

Preface

15

Documentation Conventions

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

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

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

Variables and literals In 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.

16



Symbols The following symbols may appear in command syntax: Table 2. 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 | NO In 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.

Preface

17


18


What’s New

W Chapter overview

Version 510 of OMEGAMON II for IMS and OMEGAMON II for DBCTL significantly enhanced the Application Trace Facility. This version also provides several new functions, which broaden the overall functionality of OMEGAMON II for IMS and OMEGAMON II for DBCTL.

Chapter contents Application Trace Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 New OMEGAMON II Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 Documentation Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

What’s New

19

Application Trace Facility

Application Trace Facility Application Trace Facility (ATF) is a monitoring agent in OMEGAMON II for IMS and OMEGAMON II for DBCTL. In Version 510, ATF was significantly enhanced so that: n

Multiple ATF OMEGAMON Classic address space sessions can monitor the same IMS

n

The IMS Monitor can run concurrently with these ATF sessions

n

All environments for IMS, IMS DB/DC, IMS DC and IMS DBCTL are supported

n

A site has external control of its operations

n

IMS Version 7 DC Monitor is supported

n

Concurrent Online TRF display and ATF display functions are supported

In the previous Version 500, ATF had a DETAIL parameter that could be set to LOW or HIGH. In Version 510, this parameter was removed and the function was separated to display this information on separate sets of panels: n

What used to be DETAIL=LOW in ATF V500 is now the Online TRF Display

n

What used to be DETAIL=HIGH in ATF V500 is now new ATF panels

The changes made to ATF in this release are explained in detail in the OMEGAMON II for IMS and OMEGAMON II for DBCTL Application Trace Facility Manual, Version 510. ATF’s online help has been upgraded to reflect these new features.

20


New OMEGAMON II Functions

New OMEGAMON II Functions Several new functions were added to OMEGAMON II for IMS and OMEGAMON II for DBCTL. These functions are: n

Expanded generic IMS command support

n

Enhanced VSAM buffer pool statistics

n

Enhanced fast path buffer pool statistics

n

Enhanced fast path statistics

n

Enhanced operator assistance for fast path areas

n

Additional data and sorting on IMS Message region fields

What’s New

21

Documentation Changes

Documentation Changes Online documentation With version 510, Candle Corporation has moved OMEGAMON II for IMS 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 IMS 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.

22


Operational Essentials

1 Chapter overview

OMEGAMON II is a comprehensive software performance management tool for the IMS environment, that provides you with realtime and historical performance data and tools to enable you to manage your IMS environment.

Chapter contents OMEGAMON II User Interfaces and Components . . . . . . . . . . . . . . . . . . . User interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Modes of Operation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VTAM mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ISPF mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TSO mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dedicated mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Cross Memory/Cross System Facility mode . . . . . . . . . . . . . . . . . . . . . INFO-line Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Entering Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Command types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Command format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Command Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Major, minor, and immediate command help. . . . . . . . . . . . . . . . . . . . Help symbols examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Help symbols examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . INFO-line command help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


24 25 25 27 28 28 29 29 29 29 30 32 32 33 35 35 35 35 37

23

OMEGAMON II User Interfaces and Components

OMEGAMON II User Interfaces and Components Introduction This manual focuses on the OMEGAMON II command interface to the realtime performance component (OMEGAMON). The following illustration puts this focus in context. FIGURE 1. OMEGAMON II user interfaces and components

OMEGAVIEW (optional)

User Interfaces

CUA Interface

Batch Reports

Menu Interface

Realtime Performance Monitor

Command Interface

Response Time Analysis (RTA) Collector (not valid for DBCTL)

Bottleneck Analysis Collector

TSO.ISPF Interactive Panels

Historical Collector (EPILOG)

Historical Reporter (EPILOG)

Data Components Historical Datastore

24


OMEGAMON II User Interfaces and Components

User interfaces OMEGAMON II has the following user interfaces: n

CUA Interface

OMEGAMON II ’s primary user interface is a graphical, object-oriented interface, that follows the guidelines of IBM’s SAA™/CUA (Systems Application Architecture®/Common User Access) model overconfident graphical user interfaces across products. The CUA interface gives the user access to OMEGAMON II ’s key realtime status information, as well as to an operator assist feature that simplifies the issuing of IMS commands. From the CUA interface, you can also zoom into OMEGAMON II ’s menu and command interfaces for additional information. You can access the CUA interface through OMEGAVIEW®. n

Menu interface For users requiring more detailed information, OMEGAMON II has a menu interface. The menu interface lets you access realtime data using an easy-to-use menu system. Each menu option leads to a panel displaying appropriate OMEGAMON II commands and output.

n

Command interface The most detailed information is available through the command interface. This interface lets you enter extensive commands in any order or combination, covering almost every aspect of the IMS environment in realtime. You can also save commands in screen spaces for easy access.

n

Historical information interfaces For historical information, you can request printed reports using a batch report generator, or by making interactive queries through a series of TSO or ISPF panels.

For details on using the CUA menu, and command interfaces, refer to the OMEGAMON II for IMS User’s Guide.

Components OMEGAMON II is composed of the following components: n

Realtime Performance component (OMEGAMON) OMEGAMON provides the basic realtime data about the IMS environment. One of its most unique features of OMEGAMON is exception analysis, which provides automatic alerts when system problems occur or service levels are not being met. This information is available through the CUA interface’s graphical status displays, or in the form of tables and graphs that you access in OMEGAMON II ’s command and menu interfaces. For information on using the realtime performance component, refer to the OMEGAMON II for IMS User’s Guide.


25

OMEGAMON II User Interfaces and Components n

Response Time Analysis component (RTA) RTA monitors IMS transaction response time and End-to-End Response Time Feature. IMS transaction response time is measured as the time it takes IMS to acknowledge an input message from the teleprocessing network and initiate a response. RTA measures queuing and service times within IMS, and summarizes its measurements into user-defined groups. End-to-end response time is measured as the time from when a user presses Enter until a response appears on the screen. The End-to-End Response Time Feature™ gathers this information to help you determine whether a response problem is in the network or on the host system. RTA information is available through the CUA interface’s graphical status displays, or in the form of tables and graphs that you access in OMEGAMON II ’s command and menu interfaces.

n

Bottleneck Analysis component (DEXAN) DEXAN helps a system tuner perform degradation or bottleneck analysis, an analysis technique that focuses on workloads rather than resources. DEXAN breaks down IMS transaction response time into times spent in various executing states: CPU usage, IMS scheduling waits, database I/O waits, output waits, and external subsystem waits. This information is available through the CUA interface’s graphical status displays, or in the form of tables and graphs that you access in OMEGAMON II ’s command and menu interfaces. For information on using the bottleneck analysis component, refer to the OMEGAMON II for IMS Bottleneck Analysis (DEXAN) Reference Manual.

n

Historical component (EPILOG) EPILOG provides historical information about the IMS environment. EPILOG collects, analyzes, and reports on resource and response time information, and bottlenecks for substantial periods of time, such as hours or days. For details on using the historical component, refer to the OMEGAMON II for IMS Historical Component (EPILOG) Reference Manual and OMEGAMON II for IMS Historical Component (EPILOG) User.

26


Software Requirements

Software Requirements Requirements OMEGAMON II is available for IMS and DB Control systems running under MVS, and requires MVS/ESA™ SP5 or above. OMEGAMON II also requires both of the following: n

IMS 6.1 or above

n

SMP/E Release 5 or above

Note: See “The Database Control (DBCTL) Environment” on page 433 for a list of OMEGAMON commands and exceptions that do not apply in a DBCTL environment.


27

Modes of Operation

Modes of Operation Introduction OMEGAMON II runs as a separate MVS started task and has no dependencies on IMS facilities. This high availability design lets OMEGAMON II diagnose even the most severe problems. OMEGAMON II ’s primary mode of operation is through OMEGAVIEW using VTAM®. This mode gives you access to the primary CUA user interface, and also lets you zoom into the menu and command interfaces. If you prefer to log onto the command or menu interface directly, you also have the option of using any of the following modes: n

dedicated mode

n

TSO mode (uses your TSO terminal from the TSO READY state)

n

ISPF mode (uses your TSO/ISPF terminal and allows split screen mode)

n

VTAM automatic update mode (uses a VTAM-owned terminal logged onto OMEGAMON II )

n

cross memory/cross system facility mode (enables you to combine data collected by multiple Candle products)

For more information, refer to the OMEGAMON II for IMS and OMEGAMON II for DBCTL Configuration and Customization Guide.

VTAM mode VTAM mode lets you run OMEGAMON II sessions from a VTAM terminal directly, without the intervention of an intermediate online application such as TSO. Candle also provides an optional security logon feature for OMEGAMON II in VTAM mode. Systems programmers or performance analysts can use VTAM mode to analyze IMS performance in real time when the extra availability of dedicated mode is not required, and when TSO mode would be undesirable. The advantages of VTAM mode over TSO mode include:

28

n

You can use OMEGAMON II on remotely attached display terminals without the overhead and limitations of TSO.

n

You can set OMEGAMON II in automatic update mode so that the screen refreshes as in dedicated mode.

n

You can use OMEGAMON II without using TSO, which is useful when you want to restrict employees from TSO but not from OMEGAMON.

n

You can use VTAM automatic update mode from a remote site to process data with the event- and time-driven features (exception logging facility, timed screen facility, and automatic screen facility). TSO mode does not support the event- and time-driven features.


Modes of Operation

ISPF mode If you run with TSO and ISPF Version 2, OMEGAMON II has an ISPF split-screen mode that allows you to swap back and forth between OMEGAMON II and another ISPF application. You can request both basic and extended color options in ISPF mode if your terminal supports them. However, ISPF does not support the extended highlighting features: blinking, reverse video, and high intensity.

TSO mode In TSO mode, OMEGAMON II simulates logging onto the OMEGAMON II VTAM application ID from your TSO session. Systems programmers or performance analysts can use this mode to access OMEGAMON II if ISPF is not available. In TSO mode, the screen refreshes when you press Enter.

Dedicated mode Dedicated mode offers the highest OMEGAMON II availability. In dedicated mode, OMEGAMON II does not use any telecommunications access. By operating this way, OMEGAMON II can report hardware and software problems so severe that they disable other mechanisms, including MVS system consoles. As a feature of dedicated mode, OMEGAMON II refreshes the screen automatically every few seconds without operator intervention. The default cycle time in dedicated mode is 5 seconds; however, you can change this interval (see the .SET command.) You can also establish optional secondary consoles to echo the output of the dedicated terminal. The dedicated terminal and its optional secondary consoles must be local non-SNA devices.

Cross Memory/Cross System Facility mode Cross Memory/Cross System Facility mode (XMF/XSF) lets you combine data that multiple Candle products (OMEGAMON for MVS, VM, IMS, and CICS™) collect, that run on the same or different CPUs. Note: The various systems do not have to be at the same level of VM or MVS. XMF/XSF mode is useful because it lets you limit the number of dedicated terminals, or provides a single point where you can monitor VM, MVS, and all IMS and CICS regions. Operators and systems programmers typically use XMF/XSF mode. See the OMEGAMON II for IMS and OMEGAMON II for DBCTL Configuration and Customization Guide for more information.


29

INFO-line Format

INFO-line Format Introduction The top line of an OMEGAMON screen display is called the INFO-line and looks similar to this: /PRINT_ _ _ _ _ #01

VTX OIDIRIEI IMSA 01/02/97 17:03:37 5 B

The INFO-line accepts input (such as the /PRINT command) over the underscores, and displays status information about your session. The last eight positions of the input line may be reserved by many commands and may not be used to input data. This section explains the components of the INFO-line using the variables shown in the following figure: _ _ _ _ cccccccc

30

mode LOG pr cc sysid mm:dd:yy hh:mm:ss nnn Ac

input area

Accepts INFO-line commands or screen space names. A screen space is a set of commands that is saved under a unique name. Each of the commands on the pre-defined screen is invoked when the screen space name is entered. OMEGAMON distinguishes screen space names from INFO-line commands because INFO-line commands always start with a slash (/). They are explained in the next section.

cccccccc

Shows the name of the screen space currently in use, if any.

mode

Shows the type of session or mode being used to access OMEGAMON. The possible values are: DED

A dedicated mode session

DIR

A director segment running dedicated in a cross memory or cross system mode session

DSK

A collector segment running in a cross system mode session

VTD

A director segment running under VTAM in a cross memory or cross system mode session

VTM

A VTAM mode session

VTS

An ISPF mode session running under VTAM

VTT

A TSO mode session running under VTAM

XMM

A collector segment running in a cross memory mode session


INFO-line Format

LOG

If the word LOG appears, the screen is being copied to the REPORT log file. If logging is off, the field is blank.

pr

Displays a code or multiple codes for the product(s) running. For example, this variable will be OC for OMEGAMON II for IMS.

cc

Identifies the user profile in use.

sysid

Indicates the IMS system ID value. This value identifies which IMS system OMEGAMON is monitoring.

mm:dd:yy

Indicates the date the screen was last refreshed.

hh:mm:ss

Indicates the time the screen was last refreshed.

nnn

Indicates the scrolling depth.

A

Indicates whether the automatic screen facility is currently active. If it is, an A appears. If it is not, the field is blank.

c

The variable c can be one of these values: S

Screen spaces are currently stacked.

B

The terminal bell has been activated and will sound if exceptions occur.

Note: If both screen stacking and the bell feature are active, only an S will appear.


31

Entering Commands

Entering Commands Introduction If you want to operate the command interface, you need to know the types of OMEGAMON commands and the appropriate time and place to enter each type.

Command types The next figure shows the four types of commands used in OMEGAMON along with some sample output.

/PRINT_ _ _ _ _ #01 DISK dadr .MIN

VTX OIDIRIEI /C IMSA 2/26/02 17:03:37 5 B

VMXA04 VMXA05 1A0 1A1 DADR DALC DIO

VMSP50 VMHP02 OMONVM DOSTST DP215R 1B0 1B1 2A7 2B0 4F1 DIOQ DOPN DRES DSTA DTYP DUSR

DOSRES + 4F2 DVMP +

The types are:

32

INFO-line

These commands perform control functions such as printing a screen (/PRINT) and stopping your OMEGAMON session (/STOP). INFO-line commands are executed first and, unlike the other types of commands, disappear as soon as they execute. Therefore, you cannot save them in a screen space. INFO-line commands always begin with a slash (/), and must be entered on the top line starting in column 2. If you are running in an automatic update mode, placing the cursor in column 1 on this line pauses updating until you move the cursor.

Major

These commands select general categories for display, such as system information, resource utilization, or storage utilization. In the example, the major command DISK produces a list of online disks. You can enter major commands on any line below the INFO-line.

Minor

Minor commands display detailed information about the category that the major selects. In the example, the minor command DADR displays the unit addresses of the devices listed with DISK. You can enter minor commands on any line below the INFO-line, but they will not execute unless they are preceded by the appropriate major command.

Immediate

Immediate commands serve various functions. Some are system monitoring commands, while others give you information about your session or about OMEGAMON. In the example, .MIN produces a list of all the minors of DISK. Immediate commands can also provide screen and session controls, and often perform the same or similar functions as INFO-Line commands of the same name. This enables you to include control commands as part of a screen space. Enter immediate commands on any line below the INFO-line. (It is permissible to enter immediate commands between a major command and one of its minors.)


Entering Commands

Command format Here is another example of OMEGAMON commands and their output. Notice that command fields are four characters, but commands can be entered with labels or arguments. The text below the screen explains the command entry area.

.MJ DS DISK dadr 2GDEV

DISK

DLST

VMXA04 1A0 SYSDA MIS003

DSKB

DSKC

VMXA05 1A1

HSM001

DSKE

DSKG

DSKM

VMSP50 VMHP02 1B0 1B1

WORKB1

PDB002

MIS002

DSKN

DSKP

DSKQ DSKR DSKS +

OMONVM DOSTST DP215R DOSRES + 2A7 2B0 4F1 4F2 MIS003

SYSB24

SYSD22 PROD02 +

The command entry area is lccccnn, where: Field l

Column 1

Description Label field Many commands accept a character in this field that alters the type of output displayed. The field is also used for special command modifiers, such as those that request online help text for commands. In the example (since the GDEV command produces output that extends for several lines), the numeral 2 in the label field skips the first two rows of available output.

cccc

2-5

Command name This field contains the command name and is four characters in length. Although the command name field is columns 2 through 5, OMEGAMON will recognize most commands begun in column 1 and will automatically shift the command one space to the right.


33

Entering Commands

nn

6-7

Argument field Many commands accept arguments that modify their function or specify output options. In the example, the .MJ command produces a list of major commands. It has been entered with an argument of DS, a group code which specifies that only disk major commands be listed.

8 - 72

Extended argument Arguments are entered in columns 8 through 72. In the example, the GDEV command has been entered with an argument of SYSDA, which is a generic device name in the system. Thus, only devices in the SYSDA category are displayed. Many commands also accept keywords and parameters that can extend to column 72. Note that a parameter string cannot be extended onto a second line. The command (along with keywords) must be re-entered on succeeding lines

34


Command Help

Command Help Introduction OMEGAMON provides online helps for every command. This section describes how to request these explanations for different kinds of commands.

Major, minor, and immediate command help You can use one of three symbols in column 1 in front of a major, minor, or immediate command to request an explanation of the command function. All commands offer a brief, one-line help. Many commands also have an extended help, which gives you more information about the command or displays the command operands. A continuation character (+) to the right of the one-line help indicates that more (extended) help is available. Help symbols examples ? /

Displays a one-line help that stays on the screen until you clear it. Displays an extended help that stays on the screen until you clear it. command discussed You can clear the help text with the .DCL command discussed later in this guide.

;

Displays an extended help that disappears from the screen on the next cycle.

Examples of these three symbols used with the .WAT command follow. This entry for the .WAT immediate command ?.WAT

produces a one-line help as shown below. _____________________ VTX OIDIRIEI /C IMSA 01/02/97 10:32:22 >.WAT > Specifies a delay before executing the commands that follow. +

When you use a slash instead of a question mark, /.WAT

an extended help is displayed as shown below.


35

Command Help

>.WAT > > > > > > > > > > > > > > > > >

Specifies a delay before executing the commands that follow. Type of Command: Command Format:

+

Immediate .WATnn

1 | 2 | Definition of operands: ---------------------------------------------------------------------| .WAT | nn Specifies the length of the delay (seconds) before | | the command(s) that follow are executed. EXAMPLE: .WAT02 .FGO MYSCREEN The commands shown above cause OMEGAMON to wait 2 seconds before fetching screen space MYSCREEN.

The entry ;.WAT

produces the same output as /.WAT, except that plus signs display in column 1 below the one-line help. The plus signs are continuation symbols and indicate that the extended help text will disappear on the next cycle. You can obtain help for a minor command by using the symbols previously described, without knowing the associated major command name. In some cases, however, the same minor name is used for multiple majors. If the function of the minor command is the same for all of its associated majors, OMEGAMON displays a help screen similar to the following one.

?dio > DIO is a minor command of the following major(s): > DEV DEVL DEVP DISK DSKA DSKB DSKC DSKE DSKG > DSKQ DSKR DSKS DSKU DSKV GDEV TAPE TPAL TPBS > TPOF TP16 TP38 TP62 TP7T TP80 2305 3330 3340 > Help: > Displays the I/O count since IPL of the device(s).

DSKM TPCU 3350

DSKN TPFR 3375

DSKP TPMT 3380 +

In cases where the same minor command name is used for multiple major commands, but the function and help text differs, OMEGAMON lists the possibilities and instructs you to place your cursor under the desired major command name. When you press ENTER, the desired help appears.

36


Command Help

If you know that the minor command is shared among several major commands, you can type the desired major command name on the same line after the help request. For example, the entry /dio DISK

produces the help text for the DIO minor specific to the DISK major.

INFO-line command help INFO-line command help is obtained with the .ILC immediate command rather than with a symbol in column 1. Enter the name of the INFO- Line command (cccccc) in this format (the slash in not needed): .ILC cccccc

For example, to get help for the /DEF command, enter: .ILC DEF

You will see a help like the following. FIGURE 2. INFO-line command help

>.ILC /DEF > Sets definition mode. + > > Type of Command: INFO-line > > Command Format: /DEF cccc > > 1 | 2 Definition of operands: > ---------------------------------------------------------------------> | /DEF ON Turns on definition mode. Definition mode > | suspends command execution (except for the > | commands that control screen editing > | functions) so that you can define a screen > | space without executing commands. Once you > | set definition mode with /DEF ON, it remains > | in effect until you issue /DEF OFF or the > | screen space is saved or replaced. > | OFF Restores normal command execution (cancels > | /DEF ON or /DEF HOLD). > | HOLD Same as ON argument, but definition mode > | remains in effect after you save a screen > | space. It is only cancelled when you issue > | /DEF OFF. Use this option when you want to > | save 2 or more screens in a row without > | turning on definition mode each time.


37

Command Help

38


Operational Commands

2 Chapter overview

This section describes some INFO-line and immediate commands that control OMEGAMON, as well as some generic operands. Other operational commands that can be used in customizing your OMEGAMON profile are described in “User Profile Facility” on page 83.

Chapter contents Command Modifiers and Help Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . Rate and difference arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Operational INFO-line and Immediate Commands . . . . . . . . . . . . . . . . . . Keywords for conditional setting of variables . . . . . . . . . . . . . . . . . . . Relational operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Example: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Define PF keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Assign screen space names to PF keys . . . . . . . . . . . . . . . . . . . . . . . . Delete definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Redefine multiple PF keys at once . . . . . . . . . . . . . . . . . . . . . . . . . . . Keywords for conditional setting of variables . . . . . . . . . . . . . . . . . . . Relational operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Keywords for conditional setting of variables . . . . . . . . . . . . . . . . . . . OMEGAMON-defined variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Relational operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Examples of setting variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Examples of conditionally setting variables . . . . . . . . . . . . . . . . . . . . .


40 40 42 50 50 51 58 58 58 58 68 69 74 75 75 75 76

39

Command Modifiers and Help Symbols

Command Modifiers and Help Symbols Introduction This section explains command modifiers that can be used generically with all commands of the specified types. [n cccc] [< cccc] [# cccc] [> cccc] [? cccc] [/ cccc] [; cccc] n

Controls the display of major command output. When a major command selects a list of items (for example, all online disks), the list may extend to more than one line. The value of n is a number from 1 to 9 or a letter from A to Z (representing 10 to 35) that specifies the number of lines to skip from the last line displayed. For example, entering 3DISK on the first row of output from the DISK major command displays the 4th row of output.

Indicates a comment line. OMEGAMON generates this character in front of some commands after they execute to prevent them from being executed again on succeeding cycles. It is also displayed in front of help text. You can use it when creating screen spaces to designate the line as comment text. The _ (underscore) is an alias of >.

?

Provides a one-line explanation of the command. If a plus sign (+) appears in column 79 of the one-line explanation, it indicates that a more detailed explanation is available by using the slash or semicolon.

/

Provides a detailed explanation of the command and its syntax. The help stays on the screen until you clear it.

;

Provides a detailed explanation of the command and its syntax. The expanded help disappears from the screen on the next cycle.

Rate and difference arguments For any minor OMEGAMON command that normally displays a numeric value, you can add an argument that calculates the rate of a system event during an OMEGAMON interval or the difference from one interval to the next. Statistics that show rates or differences are often more useful that the original output of the command. For example, the I/O rate is more meaningful to performance analysis than the raw number of I/Os processed.

40


Command Modifiers and Help Symbols

For commands that normally display time values, such as CPU time, the rate calculated represents a scaled percentage of utilization (expressed as a decimal value) where the real time of the interval equals 100%. OMEGAMON requires data from 2 cycles to calculate a rate or a difference. On the first cycle (the initialization cycle), a row of 8 periods (........) appears. The rate appears on the next cycle. Be aware that the rate and difference arguments are not effective in the following cases: n

If a major command selects different items from cycle to cycle. For example, the DSKB major command may select different busy disks at each screen update. When a rate argument is used with a minor of DSKB, the periods may appear after each update, indicating that OMEGAMON is initializing each time.

n

If a command displays a value that has been reset to zero by the system between OMEGAMONOMEGAMON intervals. The arguments shown below must be entered in columns 6 and 7 after a minor command that displays a numeric value. cccc [.D|.R|.H|.M|.S]

.D

Causes OMEGAMON to calculate the difference between the two most recent values of an event monitored by the specified command (cccc).

.R

Causes OMEGAMON to calculate the rate per second of an event monitored by the specified command (cccc) during the last OMEGAMON interval. .S is an alias for .R.

.H

Displays a rate per hour.

.M

Displays a rate per minute.

.S

Displays a rate per second.


41

Operational INFO-line and Immediate Commands

Operational INFO-line and Immediate Commands Introduction This section describes the commands which control OMEGAMON. The commands appear in alphabetical order, starting with special characters. Clears rest of screen (b indicates a blank).

..bb

Type:

Immediate

This command clears the entire display down to the end of the logical screen. Draws a separator line across the screen.

====

Type:

Immediate

Format:

c====aa c

For terminals that support an extended data stream, specifies the color of the separator line. Replace the variable with the first letter of one of the seven extended colors (Red, Blue, White, Green, Pink, Yellow, or Turquoise). For four- or non-color terminals, OMEGAMON translates an entry of G or B to low intensity. All other color codes translate to high intensity.

aa

Any two characters you want to use for the separator line. When you invoke this command, the specified characters are repeated across the screen.

For example, this command R====++

creates a line of red pluses across the screen. ====++++++++++++++++++++++++++++++++++++++++++++++++++++++ /ABORT

Stops processing for a cross memory (XMF) collector immediately. Type:

INFO-line

If the collector is hung and cannot process a STOP command, you can enter the /ABORT command on the INFO-line of the collector.

42



This command also frees up any resources the director has associated with it. Caution Use this command only in an emergency, as it does not bring the collector down cleanly. (If the collector later starts up after an /ABORT, it may crash with an unexpected program check.)

See the discussion of XMF in the Configuration and Customization Guide. /ATTACH

Attaches the specified cross system session (alias is /A). Type:

INFO-line

Format:

/ATTACH cccc

The variable cccc is the 4-character system ID of the cross system collector. For example, the following command attaches cross system collector A083: /ATTACH A083

For information about the cross system collector, see the Configuration and Customization Guide. /ATTN

Emulates the PA1 (program attention) key. Type:

INFO-line

/ATTN clears the screen, resets your internal security authorization to the lowest level, returns to default basic color settings, and turns off extended color. /AUPON

Enables automatic update mode. Type:

INFO-line

This command is valid only in VTAM mode. Automatic update mode is similar to running OMEGAMON in dedicated mode, since the screen updates at regular intervals without pressing ENTER. You can check the current default interval or change it with the .SET command. While OMEGAMON is automatically updating in VTAM mode, you can continue to enter commands. OMEGAMON delays processing in order to avoid executing half-entered input. The length of the delay is determined by the IODELAY keyword of the .SET command. Important Some network programs do not support automatic update mode (for example, a program that emulates a terminal for your OMEGAMON VTAM mode session).


43


.AUP is the equivalent immediate command. /AUPOFF

Disables automatic update mode. Type:

INFO-line

This command will turn the automatic update mode off. See /AUPON for additional information on automatic update mode. Important Some network programs do not support automatic update mode (for example, a program that emulates a terminal for your OMEGAMON VTAM mode session).

.AUP is the equivalent immediate command. .AUP

Controls automatic update mode. Type:

Immediate

See /AUPON, the equivalent INFO-line command, for the command description. If .AUP is entered without an argument, OMEGAMON displays whether automatic update mode is ON or OFF. .CN

Controls the specified secondary console in dedicated mode. Type:

Immediate

Format:

.CNxxxx or .CN cc

The variable xxxx is the hexadecimal address of the secondary console. In dedicated mode, you can set up a secondary OMEGAMON console to be used for output only. The secondary console is a repeater console; it echoes everything that appears on the primary console, but accepts no commands or input of any kind. After you set the address of the secondary console with .CNxxx, you can manipulate it with the following arguments: .CN OP

Allocate (open) a secondary console for OMEGAMON output display.

.CN CL

Deallocate (close) a secondary console.

.CN SW

Swap primary and secondary console functions.

The secondary console must be the same terminal type as the primary console. .D

44

Deletes the specified number of lines on the physical screen.



Type:

Immediate

Format:

.Dnn

This command deletes lines beginning with the current line. For example, the following command deletes 5 lines on the physical screen. .D5 ./DCL

Deletes all comment lines on the screen. Type:

INFO-line

If you want to delete only those comment lines below a certain point on the screen, use the equivalent immediate command instead. .DCL

Deletes all comment lines below its entry line. Type:

Immediate

If you want to delete all comment lines on the screen, use the equivalent INFO-line command instead. Unlike most other immediate commands, .DCL disappears after it executes. .DDb

Deletes a block of data. Type:

Immediate

To delete a block of data from the physical screen, enter .DD on the first line of the block and .DD on the last line. For example, the following command deletes the line with the first .DD command and the succeeding 3 lines. .DDb DISK SYSB24 TSO021 SYSB21 MVSA21 DSKB MVSA21 PROD05 SYSA24 .DDb 150 334 ./DEF

D8B

Inhibits automatic updating to allow screen space definition.

This command allows you to define a screen space to include commands that comment themselves out or otherwise change form after execution. Type:

INFO-line

Format:

/DEF {ON|HOLD|OFF}


45


ON

/DEF ON inhibits automatic updating during a dedicated mode session or a VTAM mode session with automatic updating activated (see the /AUPON, /AUPOFF, or .AUP command). Once you set definition mode with /DEF ON, it remains in effect until you issue /DEF OFF, or save or replace the screen space.

HOLD

Same as ON argument, but definition mode remains in effect after you save a screen space. It is only cancelled when you issue /DEF OFF. Use this option when you want to save two or more screens in a row without reactivating definition mode each time.

OFF

Restores normal screen updating (cancels the effect of /DEF ON or /DEF HOLD).

.DEF is the equivalent immediate command. .DEF

Inhibits automatic updating to allow screen space definition. Type:

Immediate

See /DEF, the equivalent INFO-line command, for the command description. If .DEF is entered without an argument, OMEGAMON displays the current definition mode status (ON, OFF, or HOLD). DELT

Deletes a screen space from main storage and/or from the user’s screen space library (RKOIPCSV).

DELT does not delete screen spaces from the Candle-supplied screen space library, which is referenced by the RKOIPCSV DD statement. Type:

Immediate

Format:

DELTc aaaaaaaaa c

One of the following arguments that specifies the location of the screen space. Enter it in column 6: B or b

Deletes from both main storage and RKOIPCSV (default).

I

Deletes from main storage (in-storage) only.

D

Deletes from RKOIPCSV only.

aaaaaaaa The screen space name you want to delete. Specify the name starting in column 8.

For example, the following command deletes screen space SAMPLE from main storage. DELTI SAMPLE

46



DING

Forces the terminal bell (audible signal) to sound. Type:

Immediate

The bell must be activated with the BELL=YES option of the OPTN immediate command. You can set the BELL=YES option through the menu system and save your setting in a user profile. .DIR

Executes a cross memory (XMF) or cross system (XSF) director command. Type:

Immediate

Format:

.DIR cccccc

.DIR lets you issue commands (cccccc) that control director and collector functions. This capability allows you to execute these commands from a screen space. The commands are: .DIR ABORT (see /ABORT) .DIR ATTACH cccc (see /ATTACH) .DIR GIVE nn cccc (see /GIVE) .DIR TAKE nn cccc (see /TAKE) /DOWN

Scrolls down the specified number of lines (alias is /D). Type:

INFO-line

Format:

/DOWN cccc

cccc can be: nnn

Scrolls nnn lines (from 1 to 999).

BOT

Scrolls to the last logical row.

CSR

Scrolls according to the current location of the cursor. If the cursor is on the INFO-line, the scroll amount is a page.

MAX

Scrolls down the number of LROWS defined for your terminal.

PAGE

Scrolls down so that the current cursor position is at the bottom of the physical screen. This is the default.

/DOWN works only if the number of logical rows is defined to a number greater than the number of physical rows on this terminal. This definition can be changed with the LROWS startup parameter.


47


If you assign the /DOWN command to a PF key (the default is PF20), you can type any of the optional arguments on the INFO-line before you press the PF key. OMEGAMON will interpret the entry as if you had typed the command plus the argument. .DSE

Displays the status of stacked screens. Type:

Immediate

The .DSE command displays the status of screens stacked with the /STK INFO-line command. The information includes the screen space name, the GETMAINed size in bytes of each screen space, a time stamp that indicates when you stacked the screen, the total amount of storage allocated for all stacked screens, and the relative position of the current stack entry pointer. The current stack entry pointer is the arrow that is labelled current in the .DSE display. The entry pointer indicates which screen space in the stack has most recently been referenced with a /STK INFO-line command. If you issue the /STK command with an up or down argument, the pointer moves to the entry above or below the current entry. Following is a typical .DSE immediate command display. .DSE + + + +

.EXM

Entry Screen Size (bytes) 1 #01 17987 current --> 2 SYSLOAD 17987 3 OIINITZZ 17987 Total stack size: 53961

Time 10:27:14 11:08:30 11:56:00

Lists and executes all minor commands for the preceding major command. Type:

Immediate

Format:

.EXM [nn|c1 c2] (blank)

Without operands, the .EXM command lists and executes all the minors.

nn

Skips nn minor commands and executes the rest.

c1 c2

Executes all the minor commands that begin with the specified character string or are in the range specified (c1 to c2). A character string can be 1 to 4 characters long.

This command applies only to the major command that immediately precedes it. The .EXM command executes the minors in alphabetical order and shows the number of minors it has executed. You can use operands to limit the execution to specified minors.

48



For example, the following .EXM command executes minors of the DISK command that have names starting with A through F. DISK .EXM A F

The .EXM command comments itself out after it executes. .FGO

Allows fast access to screen space cccccccc. Immediate

Type:

The .FGO (Fast GO) command is used when creating screen spaces to fetch the next screen space of a series. It allows screen spaces to be chained together and to execute very quickly, bypassing the screen display and the normal OMEGAMON interval. It is particularly useful in exception analysis for implementing the Automatic Screen Facility (ASF) or the Timed Screen Facility (TSF). .FGO has a conditional screen fetch feature that fetches a screen space only if a condition is true. Format:

n.FGO cccccccc [CPSER [DIR [MODE [OPSYS [PREFIX [IMSID [UNIT [USER [&var

{=|EQ|GE|GT|LE|LT|NE} {=|EQ|GE|GT|LE|LT|NE} {=|EQ|GE|GT|LE|LT|NE} {=|EQ|GE|GT|LE|LT|NE} {=|EQ|GE|GT|LE|LT|NE} {=|EQ|GE|GT|LE|LT|NE} {=|EQ|GE|GT|LE|LT|NE} {=|EQ|GE|GT|LE|LT|NE} {=|EQ|GE|GT|LE|LT|NE}

argument] argument] argument] argument] argument] argument] argument] argument] argument]

n

The variable n is an optional numeric label that allows you to delay the fetch of screen space cccccccc for a number of cycles up to 35. Use the numbers 1 to 9 or the letters A to Z (representing 10 to 35 cycles). Each time the screen updates, n decrements by 1. When n=0, screen cccccccc is fetched on the next cycle.

cccccccc

The variable cccccccc specifies the name of a screen space.


49


Keywords for conditional setting of variables The following keywords are available for conditional setting of variables. Their values are initialized by OMEGAMON. CPSER

CPU serial number. In the case of a multi-processor, this will compare the supplied CPU serial number with the serial numbers of all CPUs in the complex. If the relational argument is equal (= or EQ), OMEGAMON will fetch the screen space the first time it finds a match. If the relational argument is NE, OMEGAMON will fetch the screen space only after it has checked all of the CPUs in the complex.

DIR

The ID assigned to the director in cross system mode.

MODE

The 3-character code for OMEGAMON’s mode of operation. It is displayed on the INFO-line during a session. Refer to“INFO-line Format” on page 30 for a list.

OPSYS

The MVS operating system level (for example, 210 or 310).

PREFIX

The OMEGAMON product code (for example, OI).

IMSID

The system ID from the SYS= startup parameter.

UNIT

The device number from the UNIT= startup parameter (the primary OMEGAMON console).

USER

The user profile suffix from the USER= startup parameter.

&var

Allows you to set any comparison you want. The keyword and argument can be any variable name set with the .VAR command or any OMEGAMON-defined variable. The .VAR command lists OMEGAMON-defined variables.

Relational operators The relational operators require blanks on either side except for the equal sign (=). = or EQ

Keyword equals argument.

GE

Keyword is greater than or equal to argument.

GT

Keyword is greater than argument.

LE

Keyword is less than or equal to argument.

LT

Keyword is less than argument.

NE

Keyword is not equal to argument.

argument The argument is a 1- to 8-character value to which OMEGAMON compares the keyword. The keyword and argument can be any variable name set with the .VAR command or any OMEGAMON-defined variable. The .VAR command lists OMEGAMON-defined variables.

To protect against the possibility of a looping condition caused by the .FGO command, OMEGAMON limits the number of consecutive fetches allowed.

50



The limit is controlled with the FGOLIMIT keyword of .SET, which is set to 64 by default (in the Candle-supplied profile). After the limit is reached, .FGO acts like .SGO (Screen Go) so that screen spaces continue to execute, but now they display on each cycle. Therefore, if there was a loop caused by .FGO screen spaces, you will need to correct the condition and re-enable .FGO with the FGOLOOP keyword of the .SET command. Because FGOLOOP=ON causes .FGO to display executing screen spaces, you may want to turn it on yourself to test your screen space fetch routines. If multiple .FGO commands appear on one screen, the last .FGO command without a condition, or for which the. condition is true, executes. Example: To fetch screen space SAMPLE only if the terminal address is 05E1, enter: .FGO SAMPLE UNIT=05E1

or .FGO SAMPLE UNIT EQ 05E1

See also the .SGO command. /GIVE

Gives the specified number of screen rows to the cross memory (XMF) or cross system (XSF) collector (alias is /G).

This command determines the number of lines on the physical screen to be used by a cross memory or cross system collector. Type:

INFO-line

Format:

/GIVE nn cccc nn

The number of screen rows. If you omit nn, all lines are given to collector cccc.

cccc

The XMF or XSF collector to receive the lines.

If you issue this command from a collector without specifying cccc, /GIVE returns nn lines to the director’s screen segment. For example, this next command assigns 15 lines to the screen segment for the collector running on CPU ID A083. /GIVE 15 A083 /HELP

Describes HELP facilities (alias is /H). Type:

INFO-line


51


The help screen space tells you how to find out more about the functions, features, and operation of OMEGAMON. For help with an individual major, minor, or immediate command, type a question mark (?) in column 1 in front of the command. For help with an INFO-line command, refer to the .ILC. immediate command. /HOLD

Controls the execution of OMEGAMON commands. Type:

INFO-line

Format:

/HOLD ccc ON

Suspends OMEGAMON command execution.

OFF

Returns to normal OMEGAMON command execution.

/HOLD ON allows you to stop automatic updating until you enter /HOLD OFF. The /HOLD command is designed for users of VM/PASSTHRU. If you are not a user of VM/PASSTHRU, you can also stop automatic updating by placing the cursor in column 1, row 1. .I

Inserts nn blank lines. Type:

Immediate

Format:

.I nn

This command inserts nn blank lines so that you can insert new commands on the screen. The number of logical rows on your terminal is the maximum. For example, the next command inserts 5 lines before the current line. .I 5 .ILC

Displays INFO-line commands or their help text. Type:

Immediate

Format:

.ILC /cccccc

The variable /cccccc is an INFO-line command name (slash is optional). To display all of the INFO-line commands and their aliases, enter the .ILC command without a command name. To display help text for a specific INFO-line command, enter .ILC followed by the command.

52



For example, the next command generates an explanation of the /STOP INFO-line command. .ILC /STOP /LOG

Sends the current OMEGAMON REPORT log or the XLFLOG to the printer. Type:

INFO-line

.LOG is the equivalent immediate command, which additionally offers the PUSH and POP arguments. /O is an alias for /LOG with the OUT argument. .LOG

Sends the current OMEGAMON REPORT log or the XLFLOG to the printer, or manipulates the status of the log. Type:

Immediate

Format:

.LOGcccc .LOG accepts the following arguments. ON

Starts logging

OFF

Stops logging.

OUT

Prints the current log and leaves it open. The command comments itself out to prevent the log from automatically resetting again on the next cycle.

PUSH

Saves the status of the log (ON or OFF) so that it can be restored when you execute .LOGPOP. This capability allows you to manipulate the log’s status in screen spaces invoked by .FGO or .SGO, then return it to its original state after these. screen routines are complete. One of the following messages will appear on the same line as the command. >> Log inactive. Status saved. > Log active. Status saved.
Log status restored to inactive. > Log status restored to active.
Help/News PF1 Exit PF3 Keys PF5 Command Mode PF12 Colors PF18 > FCPB ------ Control Region Specifications ----------------------------------+ RES= Y FRE= 30* QBUF= 5* PST= 1* + SAV= 19,500 EXVR= 1* PRF= || SRCH= 0* + SOD= 0 IOB= || VAUT= 1* FMTO= D* + AUTO= N* TRN= N* SGN= N* RCF= N* + IMSID= I41A ISIS= 0* NLXB= 0 LSO= S + DBRC= Y|| IRLM= N IRLMNM= SSM= SSM * + WADS= D* ARC= 1 FBPR= || UHASH= DBFLHSH0 + QTU= 75* QTL= 50* DBRCNM=IMS500AB* DLINM= IMS500AD* + HSBID= RECA= 5* RECH= || FESTIM= 0* + CRC= ‘ ‘ APPC= N* ETO= Y* DLQT= 60* + ASOT= 60* ALOT= 60* + ------ Storage Pool Sizes in 1K blocks --------------------------------+ FBP= 48** PSB= 12** DMB= 48** DLIPSB= 40* + TPDP= || WKAP= 48** PSBW= 24** SPAP= || + DBWP= 24** MFS= || CSAPSB= 12* + ------ Expandable Storage Pool Upper Limits in bytes ------------------+ CIOP= 2G* SPAP= 2G* LUMC= 2G* LUMP= 2G* + HIOP= 2G* CESS= 2G* EMHB= 2G* FPWP= 2G* + ------ Member Suffixes ------------------------------------------------+ SUF= ‘0’ FIX= ‘DC’* PRLD= ‘DC’* VSPEC= ‘DC’* + HSBMBR= ‘00’* SPM= ‘ ‘ + ------ Fast Path Specifications ---------------------------------------+ BSIZ= 2048* OTHR= 5* DBFX= 10* DBBF= 50* + MSDB= ‘C’* LGNR= 10* EPCB= 8** + + blank = value used in IMS gen * = value used in startup parms + ** = IMS overrode all values || = parameter is obsolete

System Information

145

IRLM Startup Parameters

IRLM Startup Parameters Introduction The command RLMO displays the startup options. RLMX displays IRLM contention and coupling facility information. RLMO

Displays IRLM startup options. Immediate

Type:

RLMO

+ + + + + + +

----

IRLM options

-----------------------------------------------------

IRLMNM= KRLM IRLMID= 1 COMCYCL= 20 MAXCSA= 1( 1M) DEADLOK=’15,4’ SCOPE= LOCAL RULES= COMPAT PC= YES ----- Appl options ----------------------------------------------------APPLS= KRLM1,PRLM1 APPL2= KRLM1,TRLM1 APPL3= KRLM1,BRLM1 ----- IRLM Trace status -----------------------------------------------RH= ON PTB= OFF INTERNAL= OFF

A description of the fields in the RLMO display follows. Unless indicated, these fields represent the parameter values specified in the IRLM startup procedure. Note: The parameters displayed on your panel may be different from this example, depending on which version of IRLM your site is using.

146

IRLMNM=

Specifies the IRLM subsystem name.

IRLMID=

Displays the ID= parameter.

COMCYCL=

Displays the COMCYCL= parameter.

MAXCSA=

Displays the MAXCSA= parameter and the actual storage size.

CURRENT=

Displays the current CSA usage.

DEADLOK=

Displays the DEADLOK= parameter.

SCOPE=

Displays the SCOPE= parameter (GLOBAL or LOCAL).

RULES=

Displays the RULES= parameter (COMPAT or AVAIL).

PC=

Displays the PC= parameter (YES or NO).

APPLS=

Displays the APPLS= parameter

APPL2=

Displays the APPL2= parameter.

APPL3=

Displays the APPL3= parameter.

RH=

Displays if request handler trace is active or inactive (ON or OFF).



RLMX

PTB=

Displays if pass-the-buck trace is active or inactive (ON or OFF).

INTERNAL=

Displays if the internal trace is active or inactive (ON or OFF).

Displays IRLM contention and Coupling Facility information. Type:

Immediate

Note: This command applies to IRLM 2.1 and above and MVS 5.1, 5.2, and OS/390. This command displays statistical information concerning IRLM real and false contention. Real contention occurs when two PSBs attempt to access the same database block at the same time. False contention occurs when there is a lock synonym, but no real contention. The Real Contention Rate is the actual lock rate, per second, during this interval. False Contention Rate is the lock synonym rate, per second, during this interval. In an MVS 5.1, 5.2, or OS/390 environment, you may define your IRLM to participate in a Data Sharing group. The group name you defined is also displayed plus all of the participants in the Data Sharing group. CF Name

Coupling Facility name.

Job Name

The MVS started task or job name of the participating IRLM subsystem.

System ID

The MVS System ID on which the IRLM subsystem is running.

Status

The current Coupling Facility status. ACTIVE

The IRLM subsystem is actively connected to the Coupling Facility and is eligible for N-Way Data Sharing.

CREATED

The IRLM subsystem is defined to the Coupling Facility but is not yet active. This should be a transient state.

FAILED

The IRLM subsystem has failed to connect to the Coupling Facility. See your MVS system console for error messages.

QUIESCED

The IRLM subsystem is removing itself from the Coupling Facility. This is a transient state.

System Information

147


RLMX Lock Structure Name . . . . . . . . . . Size . . . . . . . . . . Record List Entries (RLEs) Used . . . . . . . . . . In Lock Structure . . . Percentage Used . . . . Totals: Real Contention Granted . Real Contention Rate . . Global False Contention . False Contention Rate . .

: IRLMLT1 : 8388608 : : : : : : :

871 44719 1.95% 2118 5.6/s 721 .67/s

N-way Datasharing Subsystems for Group IRLMD1 CF Name -------IRLMD1$$ IRLMD1$$

148

Jobname -------IMS510AI IMS510NI

System ID --------SP11 SP13

Status -------Active Active


IMS Control Region Virtual Storage Analysis

IMS Control Region Virtual Storage Analysis Introduction The VMEM command tracks virtual storage use. VMEM

Tracks virtual storage use and warns when shortages develop within the IMS control region. Type:

Immediate

Exception analysis monitors a variety of virtual storage areas for exceptional conditions, based on thresholds you set. With the VMEM command you can identify storage shortages, as well as excesses. To trim these excesses back, you can readjust the position of IEALIMIT within the control region. VMEM + + + + + + +

IMS Virtual Storage Constraint Analysis

Control DBRC DLS IRLM

Region Region Region Region

: : : :

Lsqa Free 5836k 7224k 7428k 7896k

Lsqa Largest 5796k 7220k 7424k 7884k

Lsqa Assured 3700k 4892k 3868k 5924k

Private Private Private Free Largest Top block 2288k 2136k 2136k 2356k 2332k 2332k 3592k 3560k 3560k 1972k 1972k 1972k

A diagram of IMSCTL region virtual storage areas follows.

System Information

149

IMS Control Region Virtual Storage Analysis

FIGURE 4. IMSCTL region virtual storage areas

+-------------------+

| | | LSQA | | | Current | ------------|. . . |UPDATE

/min 0_2_4_6_8_|

32 --->. . . |Class001 18 ->. . . . |Class004

32 --->. . . | 18 ->. . . . |

If you enter R in its label field, ITX resets the IMS class information to reflect /ASSIGN changes.

166


Fast Path Transaction Rates

Fast Path Transaction Rates Introduction Use the FTX command to display Fast Path transaction rates. FTX

Displays the current rates for Fast Path exclusive transactions and those Fast Path potential transactions that execute in Fast Path regions. Type:

Immediate

Format:

cFTXnnn

FTX does not show transactions that run in IMS regions. It displays these rates by balancing group (BALG), not by CLASS or GROUP, as does ITX. The three-digit numeric argument is uses as a display threshold by rate. For example, the command FTX001 only displays rates if they are greater than or equal to one transaction per minute. The rates FTX displays are an average compiled over the previous 60 second interval, so the FTX display only changes once every minute, as each interval completes. (This is true for all except the first 60 seconds, when FTX recalculates its display every cycle until it collects the first interval of data. After that first interval, the display freezes and only changes as each succeeding interval completes.) When you execute FTX for the first time it produces the Initializing message. After this point, OMEGAMON collects transaction rate data whether FTX is on the screen or not. That is, FTX does not need to re-initialize if you remove the command from the screen. The following example shows the results of the FTX command.

FTX030|BALG FPM/MIN 0 100 200 300 400 500 | + |DBFSAMP3 183 -----------------> . . . . . . . | + |DBFSAMP2 45 -----> . . . . . . . . . | + |DBFSAMP4 246 ----------------------->. . . . . . | + |DBFSAMP6 426 ------------------------------------------> . . | ========================================================================== 1FTX030|BALG FPM/MIN 0 20 40 60 80 100 | + |DBFSAMP3 183 ++++++++++++++++++++++++++++++++++++++++++++++++++> | + |DBFSAMP2 45 ----------------------> . . . . . . | + |DBFSAMP4 246 ++++++++++++++++++++++++++++++++++++++++++++++++++> | + |DBFSAMP6 426 ++++++++++++++++++++++++++++++++++++++++++++++++++> |

FTX accepts an alphanumeric argument in its label field. FTX uses this argument as a scaling factor to determine the maximum transaction rate for the graph. If you do not supply a scaling factor, FTX uses five as its default. (This means the graph will plot from 0–500 transactions per minute.) System Information

167

Fast Path Transaction Rates

FTX accepts the following scaling factors:

168

1

0–100

2

0–200

3

0–300

4

0–400

5

0–500

6

0–600

7

0–700

8

0–800

9

0––900

A

0–1500

B

0–2000

C

0–2500

D

0–3000

E

0–3500

F

0–4000


IMS Trace Table Entries

IMS Trace Table Entries Introduction Use the TRAC command to display IMS trace table entries. TRAC

Displays IMS trace table entries. Type:

Immediate

Format:

TRACcc PST=n FUNC=xx CD

Specifies the type of trace: DG

disk trace log

DL

DL/I trace table entries

DS

dispatcher trace table entries

FO

force trace

FP

Fast Path trace

LA

latch trace

SC

scheduler trace table entries

SS

subsystem trace

PST=n

Specifies the number of the PST.

FUNC=xx

Specifies the number of hexadecimal trace entries.

The following example shows a small portion of the dispatcher trace table.

TRACDS + DS TRACE TABLE + BEGINNING ADDR = 00A8F0A0 + 00A8F0A0 19051832 0013B050 + 00A8F0B0 1A051833 00000000 + 00A8F0C0 06FE1834 007D7880 + 00A8F0D0 19021835 00AB53D4 + 00A8F0E0 1A021836 007D7880 + 00A8F0F0 05051837 0013B050 + 00A8F100 23051838 0013B050 . . . . . . . . .

NEXT ENTRY ADDR = 00A8FCE0 40C4D3F4 FF575CB4 IPC ENQ 00250025 00000025 IPC RESUME 50ABA866 00AB53D4 IPOST(ECB=) 40E3D9C1 FF575DB4 IPC ENQ 00250025 00000025 IPC RESUME 40C4D3F4 40000000 RE-DISPATCH 00000000 40A82692 ISERWAIT . . . . . . . . .

System Information

169

Time-Controlled Operations Information

Time-Controlled Operations Information Introduction Time-Controlled Operations (TCO) can be used to: n

start BMPs at predetermined times

n

automate image copies and reorganization of databases

n

issue any IMS command, including commands to automate shutdown of IMS

TCO can also be used in conjunction with the automated operator interface (AOI) to intercept commands or messages for automated operations. TCO receives all information from a script library. The members in this library contain the IMS commands and time schedule requests. The members can also contain message sets. A time schedule request in a script can specify: n

a given time of day (by hour and minute)

n

a time interval

n

a specified delay after IMS startup

At the time requested in the schedule, TCO can:

TCOS

n

load a new script

n

enter commands

n

send message switches

n

send transaction messages

Displays the current status of Time-Controlled Operations (TCO). Type:

Immediate

TCOS also displays the current script member name and whether TCO is active or inactive. TCOS applies to IMS 3.1 and above only. TCOC

Displays the contents of the current TCO script member. Type:

Immediate

Format:

TCOCcc Where cc can be:

170


Time-Controlled Operations Information

blank

Displays all commands and messages in the current script member.

ST

Displays startup commands and messages only.

DL

Displays delayed startup commands and messages only.

TD

Displays time-of-day commands and messages only.

To display all the commands and messages in the current script member, enter TCOC without any argument, as illustrated in the following figure.

TCOC + IMS Startup commands/messages: + ELEM# TIME USER EXIT COMMAND/MESSAGE + ----- ------ --------- --------------+ 1 START DFSTXIT0 /STA DC + 1 START DFSTXIT0 /STA LINE 1 PTERM 1 + + DELAYED STARTUP COMMANDS/MESSAGES: + ELEM# TIME USER EXIT COMMAND/MESSAGE + ----- ------ --------- --------------+ 1 11:55 USEREXT1 /STA PGM ALL + 1 11:55 DFSTXIT0 /STA TRAN ALL + + TIME-OF-DAY COMMANDS/MESSAGES + ELEM# TIME USER EXIT COMMAND/MESSAGE + ----- ------ --------- --------------+ 1 12:00 DFSTXIT0 /DIS A + 2 13:00 DFSTXIT0 /DIS A + 3 14:00 DFSTXIT0 /DIS A + 4 15:00 DFSTXIT0 /DIS A + 5 16:00 DFSTXIT0 /DIS A

TCOC applies to IMS 3.1 and above only.

System Information

171

Plotting System Information

Plotting System Information Introduction Use the PLOT command to produce graphs of various system resources. PLOT

Graphically displays historical information about IMS resources. Type:

Immediate

Format:

cPLOT aaaa

OMEGAMON collects data about IMS resources and stores this data in an internal table. The PLOT command displays information from this internal table. The PLOT command accepts one, two, or three 4-character resource names (aaaa) as parameters. If you supply more than three names, PLOT displays the message EXTRANEOUS NAMES IGNORED. PLOT CAN ONLY SHOW THREE PLOTS PER COMMAND. The PLOT command displays information about the following resources: ARVL

Transaction arrival rate (includes Fast Path if installed).

CPUC

Amount of CPU utilized.

DEQU

Transaction dequeue rate (includes Fast Path if installed).

INQL

Transaction input queue size (includes Fast Path if installed).

IORT

IMS I/O rate per second.

PGAV

Private page-in rate per second for all non-dependent regions.

PGCR

Private page-in rate per second for the control region.

PGDB

Private page-in rate per second for the DBRC region.

PGDL

Private page-in rate per second for the DLI region.

PGIR

Private page-in rate per second for the IRLM region.

ROAV

Average region occupancy for all dependent regions.

If you supply a name that PLOT does not recognize, it displays the message NOT DEFINED. The PLOT command uses the graph character you supply in the label field (c) to plot each point on the graph. If you do not supply a graph character, PLOT uses the default (an asterisk). PLOT displays information as a vertical bar graph. (The following figure the results of a typical PLOT command.) The vertical bars farthest to the right of the graph represent the most current data. As you move to the left across the

172



graph, the vertical bars represent an averaged value which the product updates every 2, 4, 8, 16, 32, 64, and 128 cycles respectively.

PLOT CPUC IORT + + CPUC CPU UTILIZATION + 80% + + =>---------------+ 60% + + | + 40% + + =>---------------+ 20% + + | * * * * * * + + - + - + - + - + + Past Now +

IORT 240 180 120 60

IMS I/Os PER SEC + * =>-------------*-+ * * * | * * * + * * * | * * * * =>-----*-*-*-*-*-| * * * * * * * + - + - + - + - + Past Now *****

Each graph contains an upper and lower threshold line. When a resource equals or exceeds the upper threshold, that resource is considered in danger. If a resource is below the lower threshold, that resource may or may not be in danger, depending on the particular resource and your operating environment. Use the PSET major command and its minors to adjust the upper and lower thresholds. If the value in the column representing data averaged over the last two cycles (the column to the left of the current cycle) exceeds the upper threshold, PLOT displays a horizontal line of five highlighted asterisks below the resource graph. In extended color mode, PLOT displays the body of the graph in reverse video. The upper threshold displays in red. The lower threshold displays in blue. If the value in the column representing data averaged over the last two cycles (the column to the left of the current cycle) exceeds the upper threshold, PLOT displays the body of the graph in red. If the value in the column representing data averaged over the last two cycles is between the two thresholds, PLOT displays the body of the graph in yellow. If the value in the column representing data averaged over the last two cycles is less than the lower threshold, PLOT displays the body of the graph in blue. If you enter the command PLOTX instead of PLOT (in extended color mode only), each vertical column displays in its own color: red for values above the red line, yellow for values between the two thresholds, and blue for values below the blue line.

System Information

173


PSET

Sets the thresholds the PLOT command uses dynamically. Type:

Major

Format:

PSET resource minor command M=n U=n L=n resource minor command

is any of the resource names the PLOT command can display M=

is the maximum of Y-axis scale value: the minimum scale value is 8

U=

is the value of the upper threshold

L=

is the value of the lower threshold

The following example shows a PSET command with the ARVL minor command. PSET ARVL M=30 U=22 L=7

The above commands set the maximum Y-axis scale value of the transaction arrival rate plot to 30, the upper threshold to 22, and the lower threshold to 7. The results of the PLOT command for ARVL would look something like this: PLOT ARVL + + ARVL MSG ENQ RATE/SEC + 30 + + | + 22 =>---------------+ | + + * * + =>-*-*-*-*-*-*-*-* + 7 + * * * * * * * * + | * * * * * * * * + + - + - + - + - + + Past Now +

The upper threshold value must be greater than the lower threshold value. The maximum Y-axis scale value must be greater than the upper and lower threshold values. If the lower threshold is greater than the upper threshold or the maximum Y-axis scale value is less than the upper threshold, PSET displays an error message and does not set these values. If you issue one of the PSET minor commands without an M=, U=, or L= parameter, the minor command displays the current M=, U=, and L= parameters for that resource.

174


Device Information

6 Chapter overview

OMEGAMON has commands which display information about disk and tape devices.

Chapter contents Device Listing Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Disk Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Disk Select Major Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Selected disk minor commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . Examples of disk commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tape Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tape select major commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Selected tape minor commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . Long-Term Device Utilization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Device Information

176 178 178 182 186 188 188 190 195

175

Device Listing Commands

Device Listing Commands Introduction These immediate commands display lists of devices. DLST

Lists all online and offline disks. Type:

Immediate

A hyphen (-) in the command display indicates the selected offline disks. GLST

Lists esoteric and generic device names by device class. Type:

Immediate

Format:

GLST

The GLST display can be limited to specific device classes with the following operands: b

Displays all defined device names. Blank is the default.

ALL

Displays all device names. ALL produces the same display as blank.

CHAR

Displays character reader devices.

COMM

Displays communication devices.

CTC

Displays channel to channel devices.

DASD

Displays direct access storage devices.

DISP

Displays display devices.

TAPE

Displays tape devices.

UREC

Displays unit record devices.

These operands can be used in combination. For example: GLST TAPE COMM

displays all tape devices and communications devices, as shown: _______________ GLST + TAPE DEVICES: + 3480X 3400-6 TAPE + 3400-3 + + COMMUNICATIONS DEVICES: + 3705

176

CART

T3480

3480


3400-9

3400-5

Device Listing Commands

Use of the optional operands is limited to MVS 4.1 and above. See also the GDEV command. TLST

Selects all tape drives (online/offline). Type:

Immediate

A hyphen (-) in the command display indicates the offline tape drives selected.

Device Information

177

Disk Information

Disk Information Introduction This section describes major commands which select disks and the minor commands which display detailed information about the disks.

Disk Select Major Commands DEV

Selects a disk with volser cccccc or address xxx or xxxx. Type:

Major

Format:

DEV cccccc|xxxx

Note: DEV command now accepts input in either a 3-digit or 4-digit format. If you supply the volser or the address of a disk, DEV displays the volser, the address, and the online or offline status of the disk. If you enter: DEV 5200

the result is: DEV 5200 volser=TSO099 Online Alloc

Alternatively, you could supply the volser (TSO099). DEVL

Selects list of online disks by volser cccccc or unit address xxxx. Type:

Major

Format:

DEVL cccccc ... cccccc|xxxx ... xxxx

DEVL selects a list of disks for examination, whereas DEV selects only one device at a time. The following example shows disks at addresses 123 and 141 and volsers TSO021 and TSO022: DEVL 1230 TSO021 TSO022 1410

If you list an invalid address or volser, or if you specify the same disk twice, OMEGAMON eliminates the invalid or duplicate value from the list. DEVP

178

Selects a list of online disks using patterns set with .SPT. Type:

Major

Format:

DEVP/n


Disk Information

The variable n is a number from 0 to 9 indicating the pattern set with the .SPT immediate command. For example, you could set the pattern and then display all online disks beginning with TSO as shown in this figure: .SPT/9

DEVP/9

DISK

TSO*

TSO024

TSO025

TSO021

TSO022

TSO023

TSO069

Selects online disks. Type:

Major

An argument of AL (DISKAL) displays all offline disks as well as those online. DSKB

Selects busy disks. Type:

DSKC

Selects disks with suspended channel programs. Type:

DSKE

Major

Selects disks waiting on mounts. Type:

DSKN

Major

Selects mass storage (MSS) virtual disks. Type:

DSKM

Major

Selects permanently resident disks. Type:

DSKG

Major

Major

Selects disks with volsers that start with cc. Type:

Major

Format:

DSKNcc

Device Information

179

Disk Information

The following example selects disks with volsers that begin with the characters TS, such as all TSO disks: DSKNTS DSKP

Selects DASD volumes with a mount status of PUBLIC. Type:

DSKQ

Major

Selects disks with I/O queue length of nn or more. Type:

Major

Format:

DSKQnn

The DPLTnn minor command plots a microscopic analysis of device utilization. You can use it to investigate disks with I/O queues. DSKR

Selects disks with a RESERVE currently issued from this CPU. Type:

DSKS

Selects DASD volumes with a mount status of STORAGE. Type:

DSKU

Major

Major

Selects disks with UCBnames starting with xx or xxx. Type:

Major

Format:

DSKUxx

Note: DSKU command now accepts input in either a 2-digit or 3-digit format. The variable xx or xxx specifies the UCBnames with which the disks begin. This may or may not correspond to control unit xx or xxx. DSKUxx does not consider alternate paths. The following example selects disks with UCBnames that start with 58, which includes disks 580 through 58F: DSKU58 DSKV

Selects DASD volumes with a mount status of PRIVATE. Type:

180

Major


Disk Information

GDEV

Lists devices with name cccccc. Type:

Major

Format:

nGDEV cccccc

This major command lists disk and tape devices with the generic name cccccc. The value of n can be one of the following: the less-than symbol (34 >35 >36 >37 >38 >39 | + |CPU |||..|..|...||.......|||......|......|||......||..| + |User >PAYROLL >SORT >PAYROLL >SORT | + |Cyl >280>281 >403 >282 >283 >404 >284 | + |Nrdy | + |Resv |

Samples: 50 Interval: 4 I/O’s: 6

To report on the I/O# subfield properly, DPLT requires RMF to be monitoring the device. The Interval value to the right is the true interval between samples, calculated after DPLT completes processing. On a system running perfectly, this number is the same as the nn sampling interval. This number may vary due to your system’s workload.

Device Information

183

Disk Information

DBsy

D indicates device busy. S (XA and ESA) indicates suspended channel program.

IOQ

Length of IOQ. A value greater than 9 but less than 36 is given by a letter of the alphabet, where A=10, B=11, and so on. A value greater than 35 is given by a plus (+) sign.

I/O#

Wraparound I/O#. (The > indicates the point at which OMEGAMON calculates a new wraparound I/O#. The new number appears to the right of the >. and indicates the end of the I/O.

CPU

Can be one of these symbols:

User

|

CPU dispatchable. This character indicates that the address space has at least one TCB ready to be dispatched.

.

Waiting. This character indicates that no TCBs are ready to execute.

Current user. (The > indicates the point at which a new user had the device.) Note: OMEGAMON may not be able to identify the user of a device if that user is a system routine or utility issuing its own seek commands.

Cyl

Cylinder address. (The > indicates the point at which a new cylinder was accessed.) Rls in this field indicates that a standalone release is in progress, and therefore no cylinder is involved.

Nrdy

Not ready.

Resv

Device reserved this CPU.

The above example shows that the DSKQ01 command selected a disk with a volser of MVS005 because it had an I/O queue length of one or more. The minor command DPLT03 plots the activity on the selected device at 3 millisecond intervals (OMEGAMON always takes 50 samples). The resulting plot shows two jobs (PAYROLL and SORT) competing for the disk arm at cylinder addresses 280 and 403. This explains the I/O queue on the selected device. Even though we specified a 3 millisecond interval (DPLT03), the actual interval that appears is 4 milliseconds (Interval: 4). This is because other address spaces operated at a higher priority than OMEGAMON at the time. DRES

Displays device reserve count from this CPU. Type:

DSTA

Displays mount status. Type:

184

Minor of disk majors



Disk Information

Status can be:

DTYP

n

PRIVATE

n

PUBLIC

n

STORAGE

Displays disk type. Type:


Disk type can be 3380, 3390, etc. DUSR

Displays current user of device. Type:

DVMP


Displays unit control block (UCB) hex dump. Type:


DVMP dumps the UCB, the UCB prefix, and all appropriate extensions for the disk. It also shows the device status. The following screen shows a typical DVMP display. DEV SYS640 dvmp Mount Status: Perm_Res Private + Status: + User: *MASTER* Waiting I/O’s: + Status: Ch_Active - Suspended Channel Program + + UCB Prefix: 001188 + 00000000 00FF39B4 + + UCB Common + DASD Device Dependent Segment: 001190 + 008BFF8C 0240A201 B0000100 00F1F4F0 3010200E 00008D38 19D70100 E2E8E2F0 + F2F45000 00000400 + + Common Extension: 008D38 + 00000000 18820040 000A0000 F755001A 01000000 00022898 0000EAF0 00100005

DVOL

Displays the volser of a selected device. Type:

Minor of DEV and DEVL

Device Information

185

Disk Information

ICHPn

Displays installed channel paths for the disk (XA). Type:


The value of n is a number from 1 to 8. OCHP

Displays online channel paths for the disk (XA or ESA). Type:


Format:

OCHPn

The value of n is a number from 1 to 8.

Examples of disk commands The following are examples of how to use the disk commands. This example shows how to use the DSKU major command to monitor the I/O rates of devices at 160 to 16F. DSKU16

IMS001

IMS002

....

dadr 160 161 .... dio .R 1.4 0 .... ================================================================================ DSKU16 SCRAT1 SCRAT2 .... dadr 168 169 .... dio .R 2.5 8.7 ....

The next example shows I/O queue length. For any device with an I/O queue length greater than or equal to 2, the minor commands display the current user, the I/O queue length, and the address. DSKQ02 MVSRES dusr *MASTER* dioq 3 dadr 163

SPOOL JES2 2 167

The next example selects all private disks. DSKV DB0021 DB0022 dusr MESSAGE1 dio ..R 2.3

186

DB0023

DB0024

KN0056 KB0087 MESSAGE1 5.3


Disk Information

The next example selects all disks whose volsers begin with WO. DSKNWO dadr

WORK01 140

WORK02 147

Device Information

187

Tape Information

Tape Information Introduction This section describes major and minor commands for tape drives.

Tape select major commands Major commands to select tape drives provide a number of different ways to examine the tape configuration. For each tape drive selected by a major command, a number of minor commands can describe the device in further detail. DEV

Selects tape drive with volser cccccc or address xxx or xxxx.

Note: DEV Command now accepts input in either a 3-digit or 4-digit format.

GDEV

Type:

Major

Format:

DEV cccccc|xxxx

Lists devices with name cccccc. Type:

Major

Format:

nGDEV cccccc|xxx

This major command lists disk and tape devices with the generic name cccccc. The value of n can be one of the following: the less-than symbol (> OI901: Unable to locate module KOIGBL44
transaction group range numeric option (1-MAXGRP) | | (Valid only with SET) | | | +-->Option = Set - Establish automatic group selections | = Reset - Rescan for most active transactions | or terminals | = Clear - Clear groups 1-n | = List - List groups 1-n | = ? or blank - List groups 1-n | = Off - Disable automatic monitoring group | selections | = Test - Identify 30 most frequent transactions | or terminals (Do not set groups) | +--->Type: x = transactions (default) t = terminals

Note: You can not use this command when the RTA collector is active.

Creating groups automatically The SET option of the AUTO command automatically assigns n transactions to a range of groups. The AUTO SET command specifies the AUTO range. The AUTO command selects transactions or terminals by total use count (since startup) at the time you issue the command. OMEGAMON selects the n transactions or terminals you use most frequently and assigns them to n groups in descending order (OMEGAMON assigns the transaction you use most frequently to group 1). The selection process proceeds only if the groups within the group range are empty. This is to protect you from accidentally reassigning the monitoring groups. To override the test for empty groups, specify FORCE on the AUTO SET command.

Group Definition and Activation

211

Selecting Groups Automatically

AUTO SET,5

OMEGAMON responds as follows: LAUTO SET,5 + Tran=CNX00220 + Tran=CNX00230 + Tran=CNX00240 + Tran=CNX00250 + Tran=CNX00260

Listing the entries in a group automatically The LIST option of the AUTO command displays the contents of the groups that the automatic selection group range defines. The AUTO ? command is an alias for the AUTO list command. LAUTO ? Group 1: + Tran=CNX00260 Group 2: + Tran=CNX00250 Group 3: + Tran=CNX00240 Group 4: + Tran=CNX00230 Group 5: + Tran=CNX00220

Resetting groups automatically The RESET option of the AUTO command reassigns the most active transactions You must invoke the SET function before you use the AUTO command, otherwise an error message appears. AUTO RESET

OMEGAMON responds as follows: LAUTO RESET + Tran=CNX00200 + Tran=CNX00210 + Tran=CNX00220 + Tran=CNX00230 + Tran=CNX00240 + Tran=CNX00250 + Tran=CNX00260

212



Clearing a group automatically The CLEAR option of the AUTO command clears the transaction groups in the automatic selection process. You must invoke the SET function before you use the AUTO command, otherwise an error message appears. AUTO CLEAR

OMEGAMON responds as follows: DAUTO CLEAR

Freezing a group automatically The OFF option of the AUTO command freezes the groups. After some experimentation with setting and resetting the automatic selection groups, you may want to freeze the groups (not allow the LIST, RESET or CLEAR functions). Group assignments remain in effect. To do this, use the AUTO OFF command as follows. AUTO OFF

OMEGAMON responds as follows: OAUTO OFF + Automatic group facility is now off; use SET to restart

Note: You must invoke the SET function before you use the AUTO command, otherwise an error message appears.

Group Definition and Activation

213


214


IMS Regions

8 Chapter overview

The architecture of IMS requires that it assign multiple MVS address spaces to each IMS system that you start. There is always a control region, and some combination of message processing regions (MPPs or MPRs), batch message regions (BMPs), and Fast Path regions (IFPs). The following section refers to all address spaces as regions.

Chapter contents IMS Region Immediate Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . IMS Region Major Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IMS Region Minor Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IMS-related region minor commands . . . . . . . . . . . . . . . . . . . . . . . . MVS-related region minor commands. . . . . . . . . . . . . . . . . . . . . . . . Fast Path region minor commands . . . . . . . . . . . . . . . . . . . . . . . . . .

IMS Regions

216 221 226 226 240 248

215

IMS Region Immediate Commands

IMS Region Immediate Commands List of commands ISAP

Starts and stops SAP support from the command interface and displays the current status of SAP support (active or inactive). Type:

Immediate

Format:

ISAP ON|OFF|?

Note: ? is the default. If you do not specify a parameter, the system assumes you want to know the SAP status. Results:

The following example shows the results of an ISAP command.

FIGURE 13. ISAP command

_________________ KOIISAP >ISAP + >ISAP +

VTM

OI-II

/C

I51A

01/02/97

10:56:04

ON SAP Support started. ? SAP Support is active.

In this example,

THIN

216

n

The ISAP ON starts SAP support.

n

The ISAP ? displays the current status of SAP support.

Defines the percentage of threads in use thresholds for CCTLs. Type:

Immediate

Format:

THIN ADD cccccccc THREADS=nnn ADD

Adds a threshold for a specific CCTL ID.

DELETE

Deletes a threshold for a specific CCTL ID.

LIST

Lists thresholds for specified CCTL IDs.

(blank)

Lists all defined thresholds. This is the default.


B

IMS Region Immediate Commands cccccccc Specifies the CCTL ID to which the threshold applies. You can use a wildcard (*) as either the first or last character of the CCTL ID only with the LIST operand. You can use the THRD immediate command to display all connected CCTL IDs. THREADS= Specifies the percentage of threads in use (1-100), that will cause the Tnnn exception to trip.

The THIN immediate command assigns a number to each CCTLID that you have given a THREADS= threshold. This number becomes the last three characters of the Tnnn exception name. If a CCTL exceeds the percentage of threads in use threshold, the Tnnn exception trips to notify you that the CCTL has a high percentage of threads in use. Note: Exception Analysis must be active for the Tnnn exception to provide data. You can define up to 100 CCTL IDs for the Tnnn exception to monitor during your current session. To save the thresholds that you define with THIN in a user profile, use the PPRF command. If you want to create and save more than 100 thresholds, you can use a second user profile. Figure 14 on page 217 shows an example of adding a threshold for a specific CCTL ID. Figure 15 on page 217 shows the list of all defined thresholds for RCI*, after adding the threshold in this example. FIGURE 14. THIN Add command

THIN ADD RCICS321 THREADS=5 + CCTL THRESHOLD HAS BEEN ADDED

FIGURE 15. THIN List command

THIN LIST + T001 + T002 + T003 + T004 + T005 + T006

RCI* RCICS001 RCICS002 RCICS003 RCICS004 RCICS321 RCICS322

THREADS=10 THREADS=100 THREADS=20 THREADS=10 THREADS=5 THREADS=9

Figure 16 on page 218 shows an example of deleting a threshold for a CCTL ID.

IMS Regions

217


FIGURE 16. THIN Delete command

+

THRD

THIN DEL RCICS322 CCTL THRESHOLD HAS BEEN DELETED

Displays each thread’s CCTL ID, Pseudo-Recovery Token, Recovery Token, RGID (PST number), PSB name, and thread status. Immediate

Type:

The thread status can be any of the following: Active

The thread is actively processing a PSB.

Avail

The thread is available to schedule a PSB.

Indoubt

The thread has failed and indoubt data exists.

Term

The thread is terminating.

Unavail

The thread is terminating a scheduled PSB and is therefore unavailable to schedule a new PSB.

W-BlkMvr

The thread is waiting for the ACB block mover.

W-Intent

The thread is waiting for intent to resolve a conflict with a currently scheduled program’s use of the database.

W-PoolSp

The thread is waiting for DMS, PSB, or PSB work area pool space.

W-Switch

The thread is waiting to be switched over to an alternate system.

The THRD immediate command provides information about threads that you use with the PNR major command for thread analysis. TTIM

Defines time thresholds for PSBs that IMS schedules on behalf of CCTLs threads. Type:

Immediate

Format:

TTIM ADD cccccccc PSB=aaaaaaaa CPU=nnnn ELAPSED=nnn ADD

Adds a threshold for a CCTL and a PSB.

DELETE

Deletes a threshold for a CCTL and a PSB.

LIST

Lists thresholds for specified CCTLs.

(blank)

Lists all defined thresholds. This is the default. The list of defined thresholds sorts in descending alphabetical order, with the most specific threshold at the top of the list and thresholds beginning with a wildcard (*) at the bottom.

218



cccccccc Specifies the CCTL ID to which the PSBs and threshold apply. You can use a wildcard (*) as either the first or last character of the CCTL ID only with the LIST operand. aaaaaaaa Defines the PSB set to which CPU= and ELAPSED= apply. You can use a wildcard (*) as either the first or last character. CPU= Specifies the threshold for CPU time, in tenths of a second (1-9999). ELAPSED= Specifies the threshold for ELAPSED time, in tenths of a second (1-9999). You must specify either CPU time, ELAPSED time, or both times.

The TTIM immediate command compares each active thread with each TTIM threshold to see if a PSB exceeded the CPU or ELAPSED threshold. If a PSB exceeds the CPU or ELAPSED time threshold, the TPSB exception trips to notify you that the PSB may be using more CPU or ELAPSED time than you expected. Note: Exception Analysis and the Transaction Reporting Facility (TRF) must be active for the TPSB exception to provide data. If you start OMEGAMON after IMS schedules a PSB, the TTIM command does not check the PSB against the TTIM thresholds. You can define up to 100 PSB names for the TPSB exception to monitor during your current session. To save the PSB names that you define with TTIM in a user profile, use the PPRF command. If you want to create and save more than 100 PSB names, you can use a second user profile. Figure 17 on page 219 shows an example of adding a threshold for a CCTL and a PSB. Figure 18 on page 220 shows the list of all defined thresholds for RCICS410, after adding the threshold in this example. FIGURE 17. TTIM Add command

+

TTIM ADD RCICS410 PSB=ABC* CPU=1 ELAPSED=10 PSB THRESHOLD HAS BEEN ADDED

IMS Regions

219


FIGURE 18. TTIM List command

+ + + + + +

TTIM LIST RCISC410 RCICS410 PSB=DFHSAM25 RCICS410 PSB=DFHSAM2* RCICS410 PSB=C* RCICS410 PSB=B* RCICS410 PSB=ABC* RCICS410 PSB=*05

CPU=0001 CPU=0001 CPU=0001 CPU=0001 CPU=0001 CPU=0001

ELAPSED=0001 ELAPSED=0001 ELAPSED=0001 ELAPSED=0001 ELAPSED=0010 ELAPSED=0001

Figure 19 on page 220 shows an example of deleting a threshold for a CCTL and a PSB. FIGURE 19. TTIM Delete command

+

220

TTIM DEL RCICS410 PSB=ABC* PSB THRESHOLD HAS BEEN DELETED


IMS Region Major Commands

IMS Region Major Commands Introduction To provide flexibility, a number of different commands are available to select IMS regions. The IMS region major commands select only those regions associated with the IMS system for which OMEGAMON is active. While there may be more than one IMS system (and, therefore, more than one IMS control region) active at the same time, an OMEGAMON session only associates with a single IMS system, and the major commands only select regions belonging to that system. For example, if you have two IMS systems called PROD and TEST, withOMEGAMON running in each, the OMEGAMON terminal monitoring the PROD control region completely ignores any IMS region associated with the TEST system. OMEGAMON only recognizes an address space as being an IMS dependent region once it makes itself known to the control region via the IMS SVC and has an assigned PST. There is a brief period during both dependent region initialization and termination where the address space exists but OMEGAMON does not see it. Once the IMS control region recognizes the dependent region, OMEGAMON can display it. If a region major command selects the control region, it always appears first in the display. Dependent regions always appear in the same order you assign them to PSTs, with the exception of the RGNL major command. In the case of RGNL, you supply a list of region names, andOMEGAMON preserves your order. Note: The region major commands have a special relationship with the IDEV (device activity analysis) command. To analyze the devices allocated to the first region in the list which the region major command displays, use the P label on IDEV minors. Figure 20 on page 221 shows an example of the analysis of the device activity for all devices allocated to region IMSMPP01. FIGURE 20. RGN command used with IDEV

RGNL

IMSMPP01

IDEV Interval Start Time: 13:29:01 Elapsed: 12:27 MN Length: 14:58 MN Ppdsk * . . . . . . . . SRB TIME(%) 9.7 |->. . . . . . . . . . PAGE-INS/S_ 3.8 |------=>. . . . . . . PAGE-OUTS/S 2.8 |----->. . . . . . . . I/O’S/SEC__ 7.2 |->. . . . . . . . . . SU’S/SEC___ 131.4 |--> . . . . . . . . . WORKING SET 1400K |--> . . . . . . . . . PG-IN/CPU-S 12.5 |--> . . . . . . . . .

LONG 5.5 .7 .1 .0 7.2 105.4 1406K 30.7

0.1.2.3.4.5.6.7.8.9.0 |->. . . . . . . . . .+ |> . . . . . . . . . .+ |> . . . . . . . . . .+ |> . . . . . . . . . .+ |->. . . . . . . . . . |--> . . . . . . . . .+ |--> . . . . . . . . .|------=>. . . . . . .+

The left portion of the display represents the last OMEGAMON cycle; the right portion represents a running average of the previous 20 OMEGAMON cycles. The last column of the display indicates: The trend is upward (+). The trend is downward (-). No change ( ). ASID

Displays the MVS address space ID of the region. Type:

Minor of IMS region majors

The address space ID displays in hexadecimal.

240


IMS Region Minor Commands

MVS numbers the regions beginning with the *MASTER* scheduler at ASID 0001. As MVS starts regions, it assigns them an ASID number which it uses as an internal reference. CPU

Displays the TCB CPU time for the current job step for the region in seconds. Type:


Use the CPU command with the .R suffix to show the CPU rate during the last OMEGAMON cycle. DISP

Displays the type of MVS dispatching algorithm being used for a region. Type:


The algorithm type is one of the following: MTW (mean-time-to-wait), ROTATE, TIME-SLC, or FIXED. DOM#

Displays the current domain number of the region with which it is associated. Type:


The IEAIPSnn member of SYS1.PARMLIB defines and controls domains. DPRT

Displays the CPU dispatching priority of the region in both decimal and hexadecimal. Type:

FIXF


Displays the fixed frame count when a region is swapped out. Type:


Under ordinary circumstances, MVS never swaps out IMS regions, but some users modify their IMS systems to allow it. FMCT

Displays the number of frames a region is using in main storage. Type:


Note: For MVS/ESA, expanded storage is included. When a region executes under MVS, portions of the program can be in main storage and other temporarily inactive portions can be on disk (on a PAGE or SWAP data set). A unit of main storage (4096 bytes) is a frame. The unit of disk storage that holds one frame is a slot.

IMS Regions

241


The frame count is zero when the region is swapped out. Instead of displaying zero, OMEGAMON displays the last frame count (and marks it with an S). Regions can be resident and still show an S for FMCT. This usually means that the region is page-stolen down to zero. FXFR

Displays the number of frames of real storage a region is using that are fixed and cannot move to disk (as slots) to make room for other regions. Type:


One frame equals 4096 bytes. HUIC

Displays the highest unreferenced interval count for the region. Type:


A low number for HUIC indicates the system is paging heavily and there is a high demand for real storage frames. IODP

Displays the I/O dispatching priority for the region. Type:

IOJ


Displays the I/O counts for the region. Type:


Use the IOJ command with the .R suffix to show the I/O rate during the last OMEGAMON cycle. JPCI

Displays the job common area page-in counts. Type:


Use with .R to display the common area page-in rate. JPUI

Displays the job private area page-in counts. Type:


Use with .R to display the private area page-in rate. JPUO

242

Displays the job private area page-out counts.




Type:

Use with .R to display the private area page-out rate. JSTA

Displays the job status indicator for the region. Minor of IMS region majors

Type:

The following figure illustrates the JSTA command display. RGNC jsta

IMS210FP I/O*NSW

The job status indicator (I/O*NSW, above) contains three fields in the following format. aaabccc aaa

b

ccc

NVSC

dispatchability: CPU

Region is CPU dispatchable.

WAT

Region is waiting.

DLY

Region is delayed.

I/O

Region has performed I/Os but is currently not CPU dispatchable.

transaction flag: *

Region is in an MVS transaction.

()

Region is not in an MVS transaction.

location: RES

Region is resident.

NSW

Region is resident and nonswappable.

LSW

Region is logically swapped.

SWP

Region is swapped out.

Displays the number of non-VIO slots the region uses. Type:


These are the slots on a PAGE dataset used for portions of the program. IMS Regions

243


The example below shows the number of non-VIO slots each dependent region uses. RGND fmct wkst fxfr nvsc vsc

PERF

MESSAGE1 MESSAGE2 40 S 30 160K S 120K 10 40 33 5

BMP03 10 40K 5 14

frame count working set size fixed frames non-VIO (program)slots VIO slots

Displays the performance group number of a region. Type:


The PERF and DOM# minor commands display the performance group number and domain number of a region. The SRM manages performance in the MVS operating system by swapping regions out and in according to defined rules. The SRM uses service units to track the amount of computer resources a region is using. These service units are a composite of CPU time used, I/Os performed, and main storage occupancy for the region. After examining a region’s activity, different parts of the SRM recommend whether IMS should swap the region in or out. (Usually, IMS marks all regions non-swappable unless the user took some action to circumvent it.) The IEAIPScc member of SYS1.PARMLIB defines and controls performance groups. PROC

Displays the current procedure step name for the region. Type:

PSTI


Displays a summary of parameters and data relating to storage isolation. Type:


The example that follows shows the output of a typical PSTI command. RGNL psti + + + + +

MESSAGE1 Private: Maximum Target Actual Minimum

Working Set Size 100K 60K 72K 40K

Page-ins /CPU-sec -none-----0.13 -none-

In this example, the MESSAGE1 region is in a performance group which has a minimum of 40K and a maximum of 100K established as storage isolation

244



limits. MESSAGE1’s actual current working set size is 72K, but the current target size storage isolation has set is 60K. The actual value for page-ins/CPU-second is currently 0.13; -none- indicates the user is not fencing for page-ins. (The ------ field indicates there is no such thing as target page-ins.) Note: OMEGAMON labels the /CPU-sec field as /Elap-sec when it runs in internal monitoring. Only one PSTI display can be active on an OMEGAMON display at a time. If you attempt to display data from two different jobs at the same time, PSTI does not complete initialization. SEQN

Displays the sequence number of the region on the CPU dispatching queue. Type:


The next example shows the CPU dispatching queue sequence number of each dependent region. RGND MESSAGE1 MESSAGE2 cpu 144.23 58.09 cpu .R .038 .117 srbt 11.23 43.18 srbt.R .009 .023 tcpu 155.46 101.27 tcpu.R .047 .14 disp MTW MTW dprt (FA)250 (FC)252 seqn 18 16

SRBT

Displays the SRB CPU time of the current job step for the region in seconds. Type:

STEP

BMP01 78.32 .012 58.09 .008 136.41 .02 MTW (FC)252 14


Displays the current step name for the region. Type:


The example below shows the output of a typical STEP command. RGND MESSAGE1 MESSAGE2 BMP01 asid (0C) 12 (15) 21 (18) 24 dom# 1 1 13 perf 6 6 18 proc GO step REGION REGION ORDERUPD

IMS Regions

245


SUAL

Displays all service units for the period. Type:


All service units = SUCP + SUIO + SUMS. SUCP

Displays the CPU service units for this period. Type:


Use with .R to display service units per second during the last interval. SUIO

Displays the I/O service units for this period. Type:


Use with .R to Display service units per second during the last interval. SUMS

Displays the main storage occupancy service units for this period. Type:


Use with .R to display service units per second during the last interval. TCPU

Displays the total CPU utilization (TCB + SRB) for the region. Type:


This should equal the sum of the CPU and SRBT commands. You can use the above commands (CPU, SRBT, TCPU) with the .R rate operator to display the percent of the CPU that this particular region is using. Percentages are displayed as decimal values; for instance, 2.7% is displayed as .027. This percentage value assumes 100 percent is available from each CPU in the system. For a 3081 dyadic processor or a 3033MP which contains two CPUs, this figure could, in theory, go as high as 200 percent. TMTR

Displays the time since the region began. Type:


Transaction refers to an MVS rather than IMS transaction. (An MVS transaction begins every time the performance group changes.) This field

246



displays the time since the last transaction began. If the performance group changes during execution of the job, the TMTR reflects the time since that change. For instance, it may measure only the time since a STEP change. Otherwise, it measures the total job time. If you execute the MVS operator command SET IPS, IMS does not reset the times of transactions which are swapped out at the time of execution until they are swapped in again. TWSS

Displays the target working set size in K (1024 bytes) for any fenced region. Type:


This command is for installations using the MVS feature called storage isolation. If the maximal target working set size is seen, MAXIMUM appears. VSC

Displays the number of VIO slots the region used. Type:


Virtual I/O (VIO) is a method of using virtual memory for temporary files. WAIT

Displays the time since the region was last active. Type:


Active means the time since any CPU was last expended. WKST

Displays the working set size in number of K (1024 bytes) a region is using in main storage. Type:


WKST = 4 x FMCT. The value is zero when the region is swapped out. Instead of displaying the zero value, OMEGAMON displays the last working set size (and marks it with an S). Regions can be resident and still show an S for WKST. This usually means that the region is page-stolen down to zero. Figure 22 on page 248 and Figure 23 on page 248 show several typical region major and minor commands.

IMS Regions

247


FIGURE 22. Region major command with several minor commands

RGND MESSAGE1 jsta CPU*RES ioj .R 24.1 iodp (04)212 tmtr 3:20 MN wait

BMP02 I/O*RES 12.1 (63)99 2:10 MN 1 SEC

BMP03 WAT*SWP 0 (63)99 1:15 MN 1:23 MN

FIGURE 23. Region major command with service unit and page rate minor commands

RGND sucp suio sums sual huic jpui.R jpuo.R jpci.R

MPP01 50 130 180 4 .2 1.0

BMP01 182 0 27 209 12 .7 2.2 1.5

MPP05 883 0 < “ “ - I/O> < “ “ - Main Storage> 883 < “ “ - Total> 17 5.1 2.1

Fast Path region minor commands This section explains the Fast Path related minor commands that apply to the RGNF AND FSTP major commands. BFWT

Displays the number of times the region was idle due to buffer waits for free buffers for accessing a Fast Path database. Type:


IMS resets this value at each synchronization point for the region. This command applies to any region (BMP, MPP, or IFP) that accesses a Fast Path database, not only Fast Path (IFP) regions. CNTN

Displays the name of the region with which the selected region is in unit of work contention. Type:


This command applies to any region (BMP, MPP, or IFP) that accesses a Fast Path database, not only Fast Path (IFP) regions.

248



COBA

Displays whether or not the selected region is the current overflow buffer allocation user. Type:

Minor of RGNF and FSTP

This command applies to any region (BMP, MPP, or IFP) that accesses a Fast Path database, not only Fast Path (IFP) regions. DEDC

Displays the number of Fast Path DEDB calls that have been issued during the current invocation of the transaction. Type:


This command applies to any region (BMP, MPP, or IFP) that accesses a Fast Path DEDB, not only Fast Path (IFP) regions. DEDR

Displays the number of Fast Path DEDB reads that have been issued during the current invocation of the transaction. Type:


An application DEDB call may require the reading of none or many CIs from DASD to supply the information it requires. One application DEDB call does not necessarily equate to one DEDB CI READ. If the DEDB READ count is greater than the DEDB call count, the application on the average needs to read multiple CIs to satisfy one DEDB call. If the DEDB READ count is less than the DEDB call count, the application was able to satisfy multiple calls from the same CI. DEDR.A displays the average number of CI reads per DEDB call. This command applies to any region (BMP, MPP, or IFP) that accesses a Fast Path DEDB, not only Fast Path (IFP) regions. MSDC

Displays the number of Fast Path MSDB calls issued during the current invocation of the transaction. Type:


This command applies to any region (BMP, MPP or IFP) that accesses a Fast Path MSDB, not only Fast Path (IFP) regions. NBDF

Displays the number of normal buffer allocation (NBA) buffers defined at region initialization. Type:


IMS Regions

249


This command applies to any region (BMP, MPP or IFP) that accesses a Fast Path database, not only Fast Path (IFP) regions. NBIU

Displays the number of normal buffer allocation (NBA) buffers this region is currently using. Type:


This command applies to any region (BMP, MPP or IFP) that accesses a Fast Path database, not only Fast Path (IFP) regions. NUOW

Displays the number of Fast Path DEDB unit of work contentions that occurred in this region during the current invocation of the transaction. Type:


This command applies to any region (BMP, MPP or IFP) that accesses a Fast Path DEDB, not only Fast Path (IFP) regions. This value is reset at each synchronization point for the region. OBDF

Displays the number of overflow buffer allocation (OBA) buffers defined at region initialization. Type:


This command applies to any region (BMP, MPP or IFP) that accesses a Fast Path MSDB, not only Fast Path (IFP) regions. IMS resets this value at each synchronization point for the region. OBIU

Displays the number of overflow buffer allocation (OBA) buffers currently in use by this region. Type:


This command applies to any region (BMP, MPP or IFP) that has an OBA specification, not only Fast Path (IFP) regions. XCRB

Displays the active DEDB resource (control interval) requests in the region (as represented by the XCRB control block). Type:


This command applies to any region (BMP, MPP or IFP) that accesses a Fast Path database, not only Fast Path (IFP) regions.

250



If the major command shows more than one region, XCRB only shows the first region you list. The following list explains the XCRB fields: dbname

Name of the Fast Path DEDB.

AREAname

Name of this partition of the DEDB.

RBA

Relative byte address - the address of the resource (control interval).

Status

Status of the resource request.Possibilities are:

EX/OWNER

exclusive/owner

EX/WAITING

exclusive/waiting - highlighted

NE/OWNER

non-exclusive/owner

NE/WAITING

non-exclusive/waiting - highlighted

Owner

Owner of resource appears if status is WAITING

PI

Is the resource control request known to IMS program isolation? YES or NO

IMS Regions

251


252


IMS Resource Information

9 Chapter overview

This section describes OMEGAMON commands that display information about the following IMS internal and external resources: n

scheduling classes

n

data management blocks (DMBs)

n

program specification blocks (PSBs)

n

logical terminals (LTERMs)

n

physical terminals (PTERMs, lines, and VTAM nodes)

n

transactions

n

IMS conversations

n

IMS pool statistics

n

VSAM database pool statistics

n

ISAM/OSAM buffer pool statistics

n

Fast Path resources commands

Chapter contents Scheduling Class Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Scheduling class major commands . . . . . . . . . . . . . . . . . . . . . . . . . . Scheduling class minor commands . . . . . . . . . . . . . . . . . . . . . . . . . . Database Management Block Commands . . . . . . . . . . . . . . . . . . . . . . . DMB immediate command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DMB major commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DMB minor commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Program Specification Block Commands . . . . . . . . . . . . . . . . . . . . . . . . PSB major commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PSB minor commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IMS User Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IMS user major commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


256 256 257 260 260 262 264 270 270 271 277 277

253

IMS user minor commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Logical Terminal Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Logical terminal major commands . . . . . . . . . . . . . . . . . . . . . . . . . . Logical terminal minor commands . . . . . . . . . . . . . . . . . . . . . . . . . . Physical Terminal and Line Commands . . . . . . . . . . . . . . . . . . . . . . . . . Physical terminal major commands . . . . . . . . . . . . . . . . . . . . . . . . . Physical terminal minor commands . . . . . . . . . . . . . . . . . . . . . . . . . IMS line major commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IMS line minor commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IMS VTAM Node Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IMS VTAM node major commands . . . . . . . . . . . . . . . . . . . . . . . . . . IMS VTAM node minor commands . . . . . . . . . . . . . . . . . . . . . . . . . . Transaction Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transaction major commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Transaction minor commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IMS Conversation Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . IMS conversation major commands . . . . . . . . . . . . . . . . . . . . . . . . . IMS conversation minor commands . . . . . . . . . . . . . . . . . . . . . . . . . Pool Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Communications external subsystem pool commands . . . . . . . . . . . Communications I/O pool commands. . . . . . . . . . . . . . . . . . . . . . . . Scratch pad area pool command . . . . . . . . . . . . . . . . . . . . . . . . . . . Receive Any (RECA) pool information . . . . . . . . . . . . . . . . . . . . . . . High I/O pool (HIOP) information . . . . . . . . . . . . . . . . . . . . . . . . . . Automated Operator Interface Pool . . . . . . . . . . . . . . . . . . . . . . . . . Main work area pool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Database pool commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . VSAM database buffer pool statistics. . . . . . . . . . . . . . . . . . . . . . . . . VSAM database subpool statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . ISAM/OSAM buffer pool commands . . . . . . . . . . . . . . . . . . . . . . . . . ISAM/OSAM subpool commands . . . . . . . . . . . . . . . . . . . . . . . . . . . Sequential buffering (SBUF) information . . . . . . . . . . . . . . . . . . . . . Fast Path buffer pool commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . EPCB pool information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Message format services (MFS) pool commands . . . . . . . . . . . . . . . . PSB work pool commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Program isolation enqueue commands . . . . . . . . . . . . . . . . . . . . . . . Message queue buffer pool commands . . . . . . . . . . . . . . . . . . . . . . . Save area prefix (SAP) pool command . . . . . . . . . . . . . . . . . . . . . . .

254


278 280 280 281 284 284 284 285 286 288 288 289 291 291 293 298 298 298 301 301 302 305 306 307 308 309 310 313 314 316 318 321 321 324 324 328 332 333 335

IMS Logging Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . DASD logging analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Online log datasets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Write-ahead log datasets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Fast Path Resource Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Summary of Fast Path information . . . . . . . . . . . . . . . . . . . . . . . . . . Balancing groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Data entry database areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Main storage database commands . . . . . . . . . . . . . . . . . . . . . . . . . . Fast Path output thread command . . . . . . . . . . . . . . . . . . . . . . . . . . Route code commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Extended Recovery Facility (XRF) Support . . . . . . . . . . . . . . . . . . . . . . .


337 337 339 341 343 343 343 348 352 354 354 356

255

Scheduling Class Commands

Scheduling Class Commands Introduction The IMS scheduling class is the mechanism by which IMS assigns dispatching priorities to individual transactions. A transaction’s class is simply a decimal number from 1-25. (For this reason, there is no pattern matching major for classes.)

Scheduling class major commands OMEGAMON provides a number of major commands to select IMS scheduling classes. CLSA

Selects all scheduling classes. Type:

CLSL

Selects a list of IMS scheduling classes. Type:

CLSU

Major

Major

Selects IMS scheduling classes that are unusable. Type:

Major

Use the STAT minor command to display the status of a class, which explains why OMEGAMON considers the class unusable. CLSA 1 2 3 4 5 6 =============================================================================== CLSL 3 2 stat Started Started =============================================================================== CLSU 5 stat Stopped

The CLSA major command on line 1 of the above example shows the IMS system has 6 scheduling classes defined. On line 2, the user selected classes 3 and 2, and then displayed their current status in line 3. The CLSU major command tells us that class 5 is currently unusable and the class is stopped (possibly because a user issued a /STOP command).

256



Scheduling class minor commands OMEGAMON provides a number of minor commands to display information about IMS scheduling classes. ARVL

Displays the number of transaction arrivals. Type:

Minor of scheduling class majors

Format:

ARVLnn

nn indicates that OMEGAMON considers only transactions of priority nn. when it calculates the result. If you include an X in the label field (column 1), ARVL excludes any transactions which relate to message-driven BMPs. If you enter .R in the operand field, IMS displays the number of transaction arrivals per second. The following example shows that 145 class one transactions arrived: 70 of them are priority 4. Over the last OMEGAMON cycle, the transaction arrival rate for class 1 transactions was 1.2 per second. CLSA arvl arvl04 arvl.R

IQLN

1 145 70 1.2

2 223

3 32 32 .2

Displays the input message queue length. Type:


Format:

IQLNnn

nn indicates that OMEGAMON considers only transactions of priority nn when it calculates the result. If you include an X in the label field (column 1), IQLN excludes any transactions which relate to message-driven BMPs. A large input queue length may indicate that either the scheduling class was /STOPped or IMS has performance problems and is not scheduling work quickly enough.


257


The following example shows that class 1 has two input messages queued up for class 1, and none of them are priority 4. Class 2 has one priority 4 input message queued up and waiting. CLSA iqln iqln04

PRCS

1 2

2 1 1

3

Displays the number of transactions already processed. Type:


Format:

PRCSnn

nn indicates that OMEGAMONconsiders only transactions of priority nn when it calculates the result. If you include an X in the label field (column 1), PRCS excludes any transactions relating to message-driven BMPs. If you enter .R in the operand field, OMEGAMON displays the number of transactions per second IMS processed during the last OMEGAMON cycle. The following example shows that 145 class one transactions processed; 70 of them were priority 4. Over the last OMEGAMON cycle the transaction processing rate for class 1 transactions was 1.2 per second. CLSA prcs prcs04 prcs.R

SMBQ

1 145 70 1.2

2 223

3 32 32 .2

Displays the number of SMBs enqueued. Type:


Format:

SMBQnn

nn indicates that OMEGAMON considers only transactions of priority nn when it calculates the result. If you include an X in the label field (column 1), SMBQ excludes any transactions relating to message-driven BMPs. This is not the same as IQLN (input message queue length); SMBQ represents the number of different transactions that are currently enqueued, not the number of times the user issued the transaction. The following example shows that two different transactions are queued up and waiting for class 1 scheduling;1 of them is priority 4. Note that while there

258



are only 2 transaction types queued up, between them there are 45 input messages waiting. CLSA smbq smbq04 iqln

STAT

1 2 1 45

2

3 2 3

Displays the status of this scheduling class. Minor of scheduling class majors

Type:

The possibilities are: stopped

IMS received a /STOP CLASS command.

active

A transaction of this class is currently executing.

started

The class is schedulable but inactive.

The following example shows the status of each scheduling class. CLSA stat

1 Started

2 Stopped

3 Active


259

Database Management Block Commands

Database Management Block Commands Introduction The database management block (DMB) is an internal IMS control block which defines an IMS database. IMS knows each database by an 8-character name you choose during the IMS system generation process in the DBO= parameter of the database macro. Note: This manual uses the term DMB as a casual synonym for database.

DMB immediate command DBIO

Displays each IMS database and associated DDName with current I/O rates and EXCP counts. This information is not available for Fastpath Databases. Immediate

Type:

You can filter the display by setting a variable. The variables available are: OIDBTYP Database type Maximum of 8 characters Valid values are HDAM, HIDAM, HISAM, HSAM, SSAM, DEDB, MSDB, INDEX OIDBORG Database organization Maximum of 4 characters Valid values are OSAM, VSAM OIDBPAT Database name pattern Maximum of 8 characters.Use an asterisk for wild characters. If an asterisk is followed by a space, the remainder of the 8-character name is wild.

260



OIDBST DMB status Maximum of 16 characters Valid values are

’/DBR ACTIVE’ ’/DBD ACTIVE’ ’WAIT ON DMB POOL’ ’STOP PENDING’ ’RESTART PEND.’ ’RECOVERY NEEDED’ ’DYN ALLOC ERROR’ ’DMB STOPPED’ ’DMB NOT LOADED’ ’DMB NOT FOUND’ ’DMB NOT ALLOC’ ’DMB LOCKED’ ’DMB AVAILABLE’ ’DMB ACTIVE’ ’DATA AREA EMPTY’ ’AREA STOPPED’ ’AREA OPEN’ ’AREA NOT OPEN’ ’AREA I/O ERROR’ ’USABLE’ ’UNUSABLE’ You must use single quotes to enclose the literal, because these literal values have imbedded spaces. Once a variable has been set, it will stay set for the duration of your session or until it is changed. To set a variable, issue the following command starting in column 1. -VAR S & variable value


261


The variable name must be preceded by an ampersand (&). To disable a variable, set the variable value to asterisk (*). DBIO DBD Name -------BA$HDL00 BB$HDL00 BC$HDL00 BD$HDM00 BE$HDM00 BF$HDM00 BG$HDH00 BG$HDH00 BH$HDH00 BI$HDH00 DBFSAMD1 DBFSAMD2 DBFSAMD4 DI21PART DI21PART IVPDB1 IVPDB1I IVPDB2 IVPDB4 DBFSAMD3 IVPDB3 IVPDB3

DMB Status Type/Org DD Name EXCP Count ---------------------- ---------------DMB AVAILABLE HDAM/OSAM BAHDL001 0 DMB AVAILABLE HDAM/OSAM BBHDL001 0 DMB AVAILABLE HDAM/OSAM BCHDL001 0 DMB AVAILABLE HDAM/OSAM BDHDM001 0 DMB AVAILABLE HDAM/OSAM BEHDM001 0 DMB AVAILABLE HDAM/OSAM BFHDM001 0 DMB AVAILABLE HDAM/OSAM BGHDH001 0 DMB AVAILABLE HDAM/OSAM BGHDH001 0 DMB AVAILABLE HDAM/OSAM BHHDH001 0 DMB AVAILABLE HDAM/OSAM BIHDH001 0 DMB AVAILABLE MSDB 0 DMB AVAILABLE MSDB 0 DMB ACTIVE HDAM/VSAM LOAN 0 DMB AVAILABLE HISAM/VSAM DI21PART 7 DMB AVAILABLE HISAM/VSAM DI21PARO 3 DMB NOT LOADED 0 DMB NOT LOADED 0 DMB NOT LOADED 0 DMB AVAILABLE MSDB 0 AREA NOT OPEN DEDB 0 AREA OPEN DEDB DFSIVD32 0 AREA OPEN DEDB DFSIVD34 0

EXCP Rate --------.00 .00 .00 .00 .00 .00 .00 .00 .00 .00 .00 .00 .00 .00 .00 .00 .00 .00 .00 .00 .00 .00

DMB major commands This section describes the major commands available to select DMBs. DMBA

Selects all DMBs. Type:

DMBE

Major

Selects all DMBs that have I/O or dynamic back-out errors. Type:

Major

This command applies to IMS 2.1 and above. I/O errors consist of read errors, write errors, hot I/O standby errors, DBRC user errors, and DBRC permanent errors. DMBI

Selects DMBs that are currently loaded into virtual storage. Type:

262

Major



IMS only loads DMBs that it has marked resident into memory or when the database they represent is actually open. DMBL

Selects all specified DMBs. Type:

DMBN

Major

Selects databases that are defined as non-recoverable. Type:

Major

The DMBN major command displays only non-recoverable databases that have been opened. DMBP/n

Selects all DMBs matching a pattern. Type:

Major

The .SPT command sets the pattern. See the .SPT command for information about setting patterns. If DMBP does not find a /n value in the argument field, it uses the first pattern supplied with the last .SPT command. DMBU

Selects DMBs that are unusable. Type:

Major

Use the SCHD minor command to display the status of a DMB, which explains why IMS considers a DMB unusable. In some IMS systems, IMS does not find a large number of DMBs at IMS initialization and OMEGAMON includes them in the unusable display. There are times when you do not care that these DMBs are unavailable; to exclude them from the DMBU display, enter an X in the argument field (DMBUX). The following example shows the database management block major commands. DMBA BE2PCUST BE3ORDER BE3ORDRX BE3PARTS BE3PSID1 DI21PART schd Availble Active Not-Fnd Availble Availble DMB-Stop ================================================================================ DMBI BE3ORDER ================================================================================ DMBL BE3ORDER BE3ORDRX ================================================================================ .SPT B**P* > Not a VSAM Database >>

If the database that DMB represents is not open, VDDN displays >>Database not open
Intent list for PSB PE4CPPUR is not in memory .RMF > >

>> RMF Monitor I active ) in front of MDEF after it executes.

In the next example, MDEF gives the name XYZ to the address at offset 4A in the CSA. MDEF CSA+4A,XYZ

You can also use a pre-defined control block identifier to specify an anchor. OMEGAMON comes with pre-defined names for control blocks in a table. Use the MLST command to display the table. Table 7. Partial List of Valid Control Block Identifiers Identifier

Description

CVT

MVS communications vector table.

ESCD

IMS extended system contents directory.

IMSTCB

Physical logger TCB.

SCD

IMS system contents directory.

Authorized Commands

371

Displaying and Modifying Storage

Displaying and Modifying Storage Introduction This section describes the authorized commands that display, scan, or modify address names for storage locations.

Storage display commands The following commands display storage locations. You can use the ILST and MLST commands to look at IMS control blocks and memory locations. An important use of the ILST and MLST commands, especially when you use them with the DUMP command from the regular OMEGAMON command package, is for IMS education. Certain IMS education courses ask students to look through IMS control blocks in sample memory dumps. Students find that they can use OMEGAMON commands to look at those control blocks in their own system while it is running and increase the usefulness of such courses. ILST

Lists memory from the IMS address space.

ILST displays the contents of the private area of: n

the IMS control region

n

the DBRC region

n

the IRLM address space

Note: Some IMS private storage requires no authorization or special key to display: however, some areas are store-protected. To display these areas you must supply the action character in the label field of the ILST command. Type:

Immediate

Format:

aILSTcc addr,len a

If required, an action character (-) in column 1.

cc

The format and source address space of the display.

p.

The first character specifies the display format: b, B, or .

Hex and character (default).

C

Character only.

X

Hex only.

The second character specifies the address space OMEGAMON displays:

372



b or I

The IMS control region (default).

D

The IMS DLS region.

R

The IMS DBRC region.

L

The IMS IRLM region.

addr

The first address of storage that OMEGAMON displays. See “Address Specification for Storage Commands” on page 369 for more information.

len

The number (up to eight hex digits) of bytes that OMEGAMON displays. Default is 16 (X’10’) bytes.

In the following example, ILST displays 80 (X’50’) bytes starting at hex address 15547C: ILST 15547C,50

This command defaults to displaying the IMS control region in both hex and character formats as shown in Figure 47 on page 373. FIGURE 47. Typical output for ILST

ILST 15547C,50 + 0000 00000020 + 0010 007AA990 + 0020 00000000 + 0030 0014BD00 + 0040 01540000

MLST

ADDR=0015547C 00000050 00000000 00000000 00145920 00144920

001559E0 00000000 00000000 00155120 00155120

80155B00 00000000 00000000 0014AD00 00000000

*.......&...\..$.* *.:z.............* *................* *................* * ........*

Displays bytes of memory from either the common area or the OMEGAMON private storage area. Type:

Immediate

Format:

aMLSTc addr,dlen a

A K in the label position requests a display showing the fetch protection key for each virtual block in the range specified, and whether fetch protection is ON or OFF.

c

Specifies the format of the output. Possible values are: B or b

Hex and character (default).

C

Character only.

X

Hex only.

Authorized Commands

373


addr

The first address of storage that OMEGAMON displays. See“Address Specification for Storage Commands” on page 369 for more information.

dlen

The number (up to eight hex digits) of bytes that OMEGAMON displays. The default is 16 (X’10’) bytes.

In the following display, MLST lists 32 (X’20’) bytes, starting at address 1EB0, in character format. MLSTC 1EB0,20 +0000 *.........h.... .....167........*

Addr= 00001EB0

In the next display, MLST lists 16 (X’10’) bytes, starting at address FF32D6, in both hex and character formats. MLST FF32C1+15,10 +0000 20280010 A18800F9 82F000FF 20400000

Addr= 00FF32D6 *....*h.9b0... ..*

The next example shows MLST with a K in the label field, which displays fetch protection KMLST 7EF000,4000 + Virtual Block + Virtual Block + Virtual Block + Virtual Block

XMLS

Number: Number: Number: Number:

07EF000 07F0000 07F1000 07F2000

KEY:5 KEY:1 KEY:1 KEY:0

Addr= 007EF000 Fetch Protection:OFF Fetch Protection:ON Fetch Protection: OFF Fetch Protection:OFF

Displays storage from IMS address spaces. Type:

Immediate

Format:

aXMLSc targ,addr,dlen a

c

An action character in column 1. -

Changes to a comment character (>) after command executes.

XMLSC 21,1EB0,20 >storage at 00001EB0 in CICSTEST ASID=21: > 0000 *ABCDEFGH IJKLMNOP QRSTUVWX Z0123456

In Figure 49 on page 375, XMLS displays 16 (X’10’) bytes from the IMS region specified by the jobname USER14, starting at 1EB0, in both hex and character formats. FIGURE 49. XLMS output in hex and character formats

>XMLS USER14,1EB0,10 >storage at 00001EB0 in USER14 ASID=21: > 0000 C1C2C3C4 C5C6C7C8 C9D1D2D3 D4D5D6D7

*ABCDEFGHIJKLMNOP*

In Figure 50 on page 376, XMLS displays 16 (X’10’) bytes from address space 21, starting at FF32D6, in hex and character format. The less-than symbol ( 0000 E2E2C3E3 00000000 D6C30199 00000000

XMSC

*SSCT

OC r

*

Scans storage in the IMS address space for a string of data and displays the location.

XMSC scans an IMS region for a string of hex or character values. If the scan is successful, OMEGAMON displays the string. Type:

Immediate

Format:

aXMSCc targ,addr,string,slen,dlen a

c

A required action character in column 1. -

Changes to a comment character (>) after command executes.

XMSC USER14,515988,’WORKAREA’,1000,14 >storage at 00515988 in USER14 ASID=21: > 1B8 E6D6D9D2 C1D9C5C1 000000000 000C0000 *WORKAREA........* > 1C8 000C002C *....*

Storage modification commands The following commands modify storage locations. Use these commands with caution. IZAP

Zaps memory in the IMS address space Type.

382

Immediate



Caution IZAP is very powerful. Use it with extreme care.

IZAP modifies the contents of the private areas of: n

the IMS control region

n

the DLS region

n

the DBRC region

n

the IRLM address space

Consider the following points: n

Some IMS private storage requires no authorization or special key to modify; however, some areas are store-protected. To modify these areas, you must supply the action character in the label field of the IZAP command.

n

If you use IZAP to modify storage in the pageable link pack area (PLPA), IZAP automatically does a long-term page-fix to pageable link pack area (PLPA) page-fix ensure that the storage remains modified. If this is necessary, OMEGAMON displays this message: PAGE(S) FIXED

Format:

aIZAPcc addr,ver,rep

a

If required, an action character in column 1:

cc

-

Changes to a comment character (>) after the command executes.

IZAP >

MZAP

B46DE8+20,80,40 >> MEMORY ZAP SUCCESSFUL.
) after the command executes.

targ

The IMS region. It can be:

addr

cccccccc

Decimal ASID number.

nnnn

Jobname.

The address of the string that OMEGAMON may modify. See “Address Specification for Storage Commands” on page 369 for more information.

ver

The verify string. OMEGAMON modifies storage only if OMEGAMON finds this string at addr. If OMEGAMON does not find the string, it displays what is actually at addr.

rep

The replacement string. If OMEGAMON finds ver at addr, rep replaces ver.

Note:The verify and replacement strings must be the same length.

Authorized Commands

385


In the next example, XMZP changes a byte at location A0160 in the master scheduler address space. -XMZP *MASTER*,A0160,0A,64

In the next example, XMZP changes a fullword in the target CICS address space at location 7088 from X’A’ to X’64’. -XMZP $,7088,0000000A,00000064

In the next example, XMZP changes a halfword at C4834 in the PRODJOB address space from X’1854’X’0700’. -XMZP PRODJOB,C4834,1854,0700

In the example below, XMZP changes a halfword at location D7E30 from X’18C0’ to X’18C1’. -XMZP BMP01,D7E30,18C0,18C1

Typical output (if the zap is successful) is: .XMPZP >

386

BMP01,D7E30,18C0,18C1 >>Memory Zap Successful
IMS Reply ID not found: RC=4
OCMD R 83,ABEND RC = 0 ================================================================================ CONS01 MASTER CONSOLE 01F line99 *STC 721 *82 DFS996I *IMS READY* IPO1 + - STC 1113 $HASP395 IMSRDR ENDED + STC 1113 $HASP250 IMSRDR IS PURGED + - JOB 1114 $HASP373 BMP01 STARTED - INIT 4 - CLASS I - SYS A430 + - JOB 1111 $HASP395 TSO003G ENDED + $HASP309 INIT 3 INACTIVE ******** C=I + JOB 1111 $HASP250 TSO003G IS PURGED + - STC 721 DFS2500I *MDA00 IPO1 + - DATABASE BE3PARTS SUCCESSFULLY ALLOCATED + - STC 721 DFS2500I *MDA00 IPO1 + - DATABASE BE3PSID1 SUCCESSFULLY ALLOCATED + | JOB 1114 @83 DFS3125A PRIMER SAMPLE TEST, REPLY CONT, LOOP, ABEND, O + | CANCEL JOB + TSU 1115 $HASP100 TSO045 ON TSOMEGAMON/IMSNRDR + - TSU 1115 $HASP373 TSO045 STARTED + 00 IEE600I REPLY TO 83 IS;ABEND ================================================================================

CONU

Locates the output buffer for an MVS operator console by device address. Type:

Major

Format:

CONU xxxx

Note: CONU Command now accepts input in either a 3-digit or 4-digit format. CONU functions like CONS, except that you supply the three-byte hex device address as an operand instead of the console ID. If you omit xxx, OMEGAMON automatically locates the output buffer for the master console. CONU displays the address and the console ID as shown: CONU

6A00

Master Console 6A00 ( ID=3 )

The following minor commands display information about the selected console. ACTN

Displays only those lines from the screen that require some action. Type:

Minor of CONS and CONU

Authorized Commands

393

Console-related Commands

ACTN displays any line that begins with an asterisk (*).You can use this command to display any outstanding Mount or Reply messages that need attention. ACTN has no arguments. For example, the ACTN command displays the IMS WTOR message issued from the control region that OMEGAMON is monitoring. A typical action message command appears as follows: CONS03 Console 640 (ID=3) actn + 0100 08.26.21 STC 2188 *12 DFS996I *IMS READY* IMSD

LINE

Displays the last nn lines from the console you select. Type:


Format:

LINEnn

To display the last 12 lines of the screen of console 11, enter this command: CONS11 Master Console (ID=11) line12

The LINE minor command displays only in-line messages, such as the display produced by the following command. D A,L,L=Z

LINE does not display out-of-line messages, such as those produced by the following command. D A,L,L=A

To avoid this situation, either use the L=Z operand where appropriate, or issue the following console control command to remove the out-of-line display areas: K A,NONE MNT

Displays mount messages that require operator action. Type:


MNT has no arguments.

394


Console-related Commands

For example, to display mount messages for console 4, enter the following command: CONS04 Console 660 (ID=4) mnt + 2000 09.07.47 JOB 2225 *13 IEC701D M 370,VOLUME TO BE LABELED CA1759

Authorized Commands

395

Collecting Data about Address Spaces

Collecting Data about Address Spaces Introduction This section describes the PEEK major command and its minors. PEEK

Collects information about a single address space. Type:

Major

After you issue the PEEK command to collect information from the target address space, you can format and display this information with various PEEK minor commands. Format:

aPEEK targ a

targ

An action character in column 1: -

Specifies that new data be collected from the target address space.

> OB8112: Data Collection Initiated
(greater-than) for comment lines 40 >(new input) 184 ? (question mark) for command help 40 ? in column 1 35 @@ 40 _(underscore) for comment lines 40 | (CPU dispatchable) 184, 191 ’-as action character ’.& & 380 ’-as action character’

454

.& as action character 374

Numerics 1600 BPI tape drives 189 24-bit address 399 31-bit address 399 3340 major 181 3350 major 181 3375 major 181 3380 major 181 3390 major 181 3420-9 189 3480 tape drives 189 38000 BPI tape drives 189 6250 BPI tape drives 190 7-track drives 190 800 BPI tape drives 190

A A (in label field of TCBS) 408 ABWP 318 ACB minor 158 ACBLIB dataset 158 ACCS minor 264 action character 365, 372, 383, 397, 417 action messages 393 active CPUs display number of 155 activity, summarizing 106 ACTN minor 393 Line minor 367 address specifying 369 address names saving 371 specifying storage 370 address space collecting data about 396 peeking at OMEGAMON 396 plotting status and activity 183 address space storage display 373 address spaces grouping for exception analysis 106 addresses, naming (MDEF) 370 ADMB minor 264 Adobe portable document format 15 advice reserve 192 AENV minor 240


AINF 349 ALL 107, 115 allocate 328, 329 allocated pool space 303, 305, 309, 310, 311 allocations to disk 182 ALOC 305, 309, 310, 311, 317, 325, 328, 329, 333 external subsystem pool 301 I/O pool 303 AMAP minor 397 DATA 365 anchor address pre-defined 369 AOIP 308 APF authorization 408 APIE 332 application program scheduling 236 APSB minor 271 APST 344 area information 349 argument 34 command 34 difference 41 hour 41 minute 41 rate 41 second 41 argument operand 34 ARVL 344 ARVL minor 257, 271 -as action character as action character 383 as action character 372, 381 action 376 384 MSCN immediate 378 private area zapping storage 385 -as action character & & 376 -as action character. & 365 ASCR assigned support center representative 450 ASETG 205 ASF OPTN keyword 88 ASID number 385 ASID minor address space ID 240 ASID number in PEEK command 396

ASSIGN status 192 assigned support center representative ASCR 450 ASYS immediate 151 ATIL 293 ATOL 281 attach information 359 ATTR 293 ATTRIBUTE 117 authorization for data-only spaces listing 414 authorized command using action character (-) 365 authorized commands 363 requiring action character MCHN immediate MDEF immediate 365 supplying the passwords 365 AUTO command 211, 212 commands disable automatic selection 213 OFF function 213 range 211 auto command 211 AUTO command command AUTO 211, 212 auto command command auto 211 AUTO command enable automatic selection 211 AUTO command LIST function 212 AUTO command RESET function 212 auto command selecting transaction groups 211 AUTO command SET function 211 Auto keyword 425 automated features updating 43, 44 automated operator interface 309 Automatic features 421–431 Automatic Screen Facility 31 Automatic Screen Facility (ASF) 31 automatic screen facility (ASF) 422, 425, 428 .DEF immediate 46 /DEF INFO-line 45 activating 84, 88 cancel while running 429 commands 423 example 430 screen space 429 , 431 terminating 65 using .FGO 49

Index

455

using .SGO 67 automatic screen facility (ASF) ASF 423 automatic update 28 , 85, 101 AVQ minor 196 AWAT 318

B baa 42 BACKGROUND Main Menu option 423 BAL Gnn minor 128 balancing groups 128 , 343 operational 344 queuing 344 unused 344 BALG 294, 355 name of application 347 number of associated 355 status 345 BALT 314 batch message processing 221 batch message processing regions 221 BCPT minor 128 BELL 116 bell activating 84, 88 interval 84 , 88 setting terminal 47 status on INFO-line 31 BFSP minor 128 BFUS minor 129 BFWT 248, 344 BHDR minor 129 BIOS 334 pool I/O 325, 333 BLGA balancing groups 343 BLGI 343 BLGO 344 BLGQ 344 BLGU 344 BLKL major 136 BLKN minor 136 BLKU minor 136 BMP major 221 bottleneck analysis component (DEXAN) 26 box 118 BOXATTR 117 BOXCHAR 117 BOXCLR 117 BSIZ 314 BSPH minor 129 BSTA minor 345

456

BSZE 318 buffer pool statistics FPDB 322 buffer subpools DBVS immediate 313 buffer waits 248 buffer waits in current transaction 248 buffer waits 248 buffers OBDF 250 BUFS 302 , 306, 308, 309, 321, 335

C CA splits 264 CALL minor 226 calls DEDC 249 Candle subsystem 442 starting 443 CANSOI 67 CASP minor 264 CBTA major 135 CBTL major 135 CBTP major 135 CCB minor 129 CDMB minor 226 CERR 314 CESS communications external subsystem pool 301 chaining screens 430 channel path mask defining for exception analysis 106 character 376 debugging 384 checkpoint ID information 138 checkpoint ID table 128 checkpoint/restart log record buffer 133 CI requests by area 350 CI splits 264 CIAB 349 CID 289 CIDO 349 CIIF free CIs in independent overflow 350 CIIO total CIs in independent overflow 350 CIOP 302 CIRA total CIs in root addressable portion of the area 350 CISF free CIs in sequential dependent overflow 350 CISO


total CIs in sequential dependent overflow 350 CISP minor 264 CISZ size of a CI in this area 350 CIUW total CIs in unit of work (UOW) 350 CKPT major 138 CLAS minor 227 CLASS 294 CLB minor 129 clear screen 43 CLSA major select all classes 256 CLSU major select unusable IMS classes 256 CNDPROC start parameter start parameter 443 CNT minor 129 CNVA 298 CNVH 298 CNVI 298 CNVL 298 CNVR 298 COBA 249 collector 47 synchronize 77 collector segment DSK on INFO-line 30 XMM on INFO-line 30 color basic 29, 97 commands 95 defining 99 extended 29 options 85 profile definition mode 96 SCC command 95 color device 3270-type 95 four-base 95 command argument 34 entering parameters 34 help 35, 36, 37, 40 Master Terminal 387 name 33 output, setting case 88 type 32 major 32 command format 33 command interface 25 command output, setting case 84 commands

issuing console 390 comment lines 40 common area storage OMEGAMON address space (MLST) 373 common area storage display OMEGAMON 373 Common User Access model consistent graphical user interfaces across products. 25 commonly-addressable storage CSA 384 communications I/O pool 302 line block 129 terminal block 130 communications I/O pool 303, 304 free pool space 304 communications work area pool 306 compatibility mode 189, 192 components of OMEGAMON II 24, 25 bottleneck analysis component (DEXAN) 26 historical component (EPILOG) 26 realtime performance component (OMEGAMON) 25 response time analysis component (RTA) 26 CONF immediate 120 CONS major 391 console issue commands 390 continuation character 35 control area splits (VSAM only) 264 interval splits (VSAM only) 264 control block conversational 129 control region 221 (alias for RGNC) 221 private area DLS 376 storage, modifying DLS 383 the DLS region 372 CONU 393 conversational control block 129 conversational transactions 298 COPY minor 90 CPCB minor 227 CPRI 294 CPU display number of active 155 mask 106 CPU dispatchable 184, 191 CPU minor 241

Index

457

CPU time figures about initiator, not job PROC minor 244 CPU usage 154 average 155 cross memory collector segment 30 commands 403 cross system 29 director code on INFO-line (DIR) 30 director code on INFO-line (VTD) 30 executing commands 47 mode 29 cross system collector 51 collector system 30 director code on INFO-line (DIR) 30 director code on INFO-line (VTD) 30 executing commands 47 mode 29 CSA real memory 124 see common storage area SQA storage isolation 127 usage 125 CSA immediate 125 CSAR immediate 124 CSTI immediate 127 CTB 289 CTB minor 130 CTL major 222 CTRM minor 227 CTRN minor 227 CTSK minor 227 CUMULATIVE 118 CUOW number of 350 CURR minor 136 current user of device 185, 192 cursor pointing feature /ZOOM INFO-line 79 customer support base maintenance plan 446 contact information 451 enhanced support services 450 eSupport 447 severity levels 447 telephone support 446 cycle delay .RTN immediate 66 cycles 183, 191 cylinder address 191

458

D D immediate 44 DADR minor 182 DALC minor 182 DASD logging analysis 337 DASD logging exceptions 107 data entry database areas DEDB 348 DATA minor 400 data space display memory 415 modifying storage 418 owner 414 scan control blocks 417 scan storage 416 type 414 data space/hiperspace utilization (DATA minor) 400 data spaces 414 data stream EDS 95 database buffer pool statistics (DBVS) 313 Database Control environments 433 database exceptions 107 database information non-recoverable 263, 264, 267 database management block (DMB) DMB 260 database pool 310, 311 database type TYPE minor 268, 269 databases split and extent information VDDN minor split and extent information 269 VDDN minor 269 data-only spaces 414 authorization (.DSA) 414 dataset 337, 338, 341 OLDS 337, 339 secondary 337, 338 sequential for logging 89 dataset allocation displaying 401 dataset information 158 datasets allocating and unallocating 411 date display format 84, 88 on INFO-line 31 DAY keyword 427 DB 107 DB# minor 271 DB2 attach information 359


DBOS major buffer subpool information 316 DBRC region 383 DBRC major 222 DBRC RECON dataset information 162 DBsy 191 DBT minor 227 DBWP 310 DC monitor log control directory 132 DCAT minor issued to disk 182, 190 DCB attributes 89 DCBs open on disk 182 DD statement for logging 89 DDIR minor 130 DDNM Minor dataset 159 DDNM minor 91 , 159 DDNS minor 401 extended information 401 DED code on INFO-line 30 DEDA 348 DEDB 249 area control 130 areas 348 areas by list 348 calls for all PSTs 345 CI contentions 346 displays buffer waits 344 master control 130 reads for PSTs in the BALG 345 resources accessed and/or requested by area 351 DEDB calls 249 DEDB reads 249 DEDC 345 DEDH major 348 dedicated mode 29 DED on INFO-line 30 DEDL 348 DEDP 348 DEDR 345 DEDU major 348 DEFER 43 defining for ex 106 defining for exception analysis tasks 106 definition mode 45 , 46 delete 117 screen space

both main storage and RKOIPCSV (default) 46 main storage only 46 RKOIPCSV only 46 screen spaces 46 delimiter 382 & && 381 delimiter .&& 117 delimiter(’) 117 DELT immediate 46 DEQ 278 DEST minor 91 DETL 284 DEV 188 DEV major 178, 183 device activity (IMS system control address spaces 195 address 401 busy 191 color 95 EDS or non-EDS 95 current user 191 DCAT minor of disk commands 182, 190 DPIN minor of disk commands 182, 190 EXCP count 182, 190 monochrome, EDS or non-EDS 95 name table entries 85, 100 not ready 192 reserve 184 devices generic 181 , 188 devices 176 DEVL major 178 DEVP major 178 DFS996I message suppressed ICNS 389 DGN minor 227 DGU minor 228 difference argument 41 DING immediate 47 DIO minor 182, 190 DIOQ minor 182 DIR code on INFO-line 30 DIRA major 141 director 47 director segment DIR on INFO-line 30 VTD on INFO-line 30 DIRL major 141 DIRP major 141

Index

459

DIRU major 141 disk busy 179 information 178 with suspended channel programs 179 disk dataset CANSOI 67 RKOIPCSV 67 DISK major 179 disks by control unit 180 current allocations 182 currently reserved from CPU 180 I/O queue length 180, 182 mass storage virtual 179 mounted private 180 mounted public 180 mounted storage 180 permanently resident 179 plotting activity 183 selecting by volser 179 types 185 unit address 182 volume serial number 185 waiting on mounts 179 DISP minor 241 dispatcher trace table entries 169 dispatching algorithm 241 priority 241 display in-memory FREs 139 display and set PF keys 58 display fields, defining color 98 DISPLAY parameter in XACB 117 displays number of active PSTs for this BALG 344 displays number of Fast Path message arrivals 344 displays status of the BALG 345 DL 107 DL/I trace table entries 169 DLEN 352 DLET minor 228 DLS 383 DLS major 222 DLST major 176 DMAC minor 130 DMB 265, 267, 268, 269 directory entry 130 DMB immediate command DBIO 260 DMB pool 311 DMBA major 262

460

DMBE major 262, 263, 264 DMBI major 262 DMBL major 263 DMBN major 263, 264 DMBP Major 263 DMBs 253 currently in memory 262 unusable 263 DMBU major 263 DMCB minor 130 DMHR minor 130 DMPL database management block (DMB) pool 311 documentation set information 15 DOM# minor domain number 241 DOPN minor 182 DPCB minor 228 DPDSK 195 DPIN minor 182, 190 DPLT minor 180, 183, 191 DPRT minor 241 DRCS minor 228 DRDY exception 430 DRES minor 184 drives 188 allocated 188 awaiting mounts 189 busy 189 free 189 offline 189 on a control unit 189 read/write errors 193 types of 189 DSC minor 196 DSETG99 206 DSIZ 329, 331 DSK code on INFO-line 30 DSKB major 179 DSKC major 179 DSKE major 179 DSKG major 179 DSKM major 179 DSKN major 179 DSKP major 180 DSKQ major 180, 183 DSKR major 180 DSKS major 180 DSKU major 180 DSKV major 180 DSL


region 372 DSME 348 DSML 349 DSORG 402 DSPS 349 DSPX 349 DSTA minor 184 DSTU minor 91 DTME 298 DTYP minor 185, 192 DUMP 128 dump IMS control blocks 128 DUMP major 128 DUSR minor 185, 192 DUT minor 196 DVMP minor 185, 190, 192 DVOL minor 185, 193 DYNA immediate 411 example 412 format 411 dynamic I/O device activity monitoring with OMEGAMON 441 dynamic storage area control block tables 135 DYNU immediate 412 example 413 format 413

E ECNT minor 130 ECRC minor 361 ECSA usage 125 ECSA immediate 125 EIO 318 ELSQA,SWA available storage 399 current bottom 399 unallocated 399 EMHB 321, 346 ENQ 278 ENQL 294 enqueued number of SMBs enqueued 258 entering 387 EPCB 324 EPST minor 130 ESCD minor 131 ESQA immediate 125 eSupport customer support 447 ETIC minor 228

ETIO minor 228 ETLK minor 228 ETPL minor 228 ETSP minor 229 example XMSC immediate 381 exception 106 characteristics, defining 106 defining characteristics 110 logging 89 .LOG immediate 53 /LOG INFO-line 53 /XLF INFO-line 77 sending to printer 78 summary of activity 108 thresholds 114 exception analysis 106, 421 exception groups 110 LEXC immediate 112 exception group controlling 119 defining 110 exception logging facility (XLF) 28, 422, 425, 428 activating 84, 88 commands 423 exception output reorder execution of exceptions 112 exceptions 221 grouping 110 EXCEPTIONS Main Menu option 423 EXCP 402 issued to disk 182 issued to tape 190 execute minor commands 48 EXNCYC 118 EXTD 302 expandable storage pools 304, 306 extended attributes 96 CNT 130 data stream 95 highlighting 97 PST 130 SCD 131 external writer 409

F FA 107 FADR minor 139 FAQE 304, 306, 310, 311, 317, 325, 329, 333 database pool 310, 311 I/O pool 303

Index

461

ISAM/OSAM buffer pool 317 main work area pool 309 message queue buffer pool 333 MFS pool 325 PSB work pool 328, 329 scratch pad area pool 305 Fast GO command 49 Fast Path 248, 249, 250, 294, 296, 322, 343, 348, 352 , 354 buffer headers 130 exceptions 107 latch conflicts 122 resource commands 343 resources request conflicts 121 transaction rates 167 utility currently active on the DEDB area 350 FCDE immediate 143 FCPB immediate 144 FGO immediate 426 FGOLIMIT .SET keyword 100 FGOLOOP .SET keyword 100 FIDX minor 131 field argument 34 command name 33 label 33 parameter 34 FIXF minor 241 FMCT minor 241 FMTI major 139 FMTL major 139 FMTP major 139 FOLD minor 92 FORCE 115 format 410 action character 389 MVS commands 389 FPDSK 195 FPUT 350 FPWP 321 FR 107 frames slots 241 FREE communications I/O pool 304 communications work area pool 306 database pool 311 external subsystem pool 302 main work area pool 310 MFS pool 325 program isolation enqueue 333 PSB

462

work pool 329 PSB work pool 329 free block 399, 400 free pool space 310, 311, 325, 329, 333 communications work area pool 306 free space fragmented 399, 400 FREP fetch request element (FRE) pool 324 FRES minor 136 FSTP major 222 FTX immediate 167 FWRT 314 FXFR minor fixed frames 242

G GDEV major 181, 188 GDEVUCBS .SET option 100 GDFN immediate 110, 116 generic devices 181, 188 selection 70 GETS 315 GETS minor 136 GHN minor 229 GHNP minor 229 GHU minor 229 GLBL immediate 210 GLST immediate 176 GNP minor 229 GROUP 116 groups terminal 201 transaction 201

H H.MJ 55 H.MJC 56 H.MJI 56 help 35 added information 35 extended 35 immediate commands 35 INFO-line commands 37, 52 major commands 35 minor commands 35 hex dump 192 highlighting 95, 117 HIOP 307 hiperspace 414 display memory 415


hit ratio 316 modifying storage 418 owner 414 scan control blocks 417 scan storage 416 type 414 historical component (EPILOG) 26 historical information (EPILOG) interfaces 25 hit ratio 316 HOLD minor 92 hour argument 41 HSPB minor 229 HSSP DEDH major 348 options 235 HUIC minor 242

I I/FETCH DIR READ 157 I/O 186 queue length 182, 191 wraparound number 191 I/O pool pool space 304 I/O# 191 IBM releases supported 27 IBPL minor 131 IBPR minor 131 ICHP minor 186 ICMD 387 ICMD command examples 387 ICMD immediate format 387 ICNS 389 ICNS immediate 388 ICNT 285 ID# minor 265 ID1 minor 92 ID2 minor 93 ID3 minor 93 ID4 minor 93 IDDN major 158 IDEV major 195 idle idle BALG 343 IEALIMIT 150 , 404 IHLD minor 230 IKT004051 screen error 97 ILST immediate 372

IM 107 immediate MLST immediate 365 immediate .baa 42 immediate commands 32, 216 help 35 listing 55, 56 IMS 215, 221, 277, 301, 337 control blocks 128 CPU usage 154 internal exceptions 107 region minor commands 226 regions 215, 221 related region minor commands 226 virtual storage exceptions 107 IMS 1.3 337 IMS DASD logging environment 337 IMS commands 387 IMS DASD logging feature 337 IMS dependent regions 221 IMS ID on INFO-line 31 IMS READY message suppressed DFS996I message suppressed IMS READY message suppressed 389 IMS regions 216 INCT 289 INFO-line automatic screen facility indicator 31 bell status 31 commands help for 52 date display 31 format 30 help 52 logging status 31 screen stacking feature 71 scroll amount 31 system ID 31 time of last refresh 31 INFO-line commands 32 help 37 input area 30 initialization cycle 41 initialization parameter block 131 Input commands issuing IMS 387 inserting blank lines 52 installation 409 installed channel path for the disk 186 in-storage screen facility 46, 62 , 63, 66, 67

Index

463

intensity, changing with .SCC 96 interval setting 85, 100 INTERVAL .SET keyword 100 INTERVAL .SET keyword INT immediate 100 INTERVAL .SET keyword INT INFO-line 100 intervals value 183 INUM minor 230 IODELAY .IOD immediate 100 IODELAY .SET keyword 100, 101 IODP minor 242 IOJ minor 242 IOPT immediate 102 IOQ 191 IOS minor 197 IPB minor 131 IPDSK 195 IPFR minor 136 IPGA major 135 IPGL major 135 IPGP major 135 IPKD 352 IPLN minor 137 IPRF immediate 87 IQLN minor input message queue length 257 IR# minor 265 IRES minor 272 IRLM 120, 147, 372, 376 region 383 startup parameters 146 IRLM locks 230 IRLM major 222 ISAM/OSAM buffer pool prefix 131 buffer subpool buffer prefix (subpool nn) 131 buffer subpool header 131 ISAM/OSAM buffer pool 317 allocate pool space 317 FREE ISAM/OSAM buffer pool 317 free pool space 317 pool space 317 ISAP Immediate 216 ISBP minor 131 ISES 315 ISKS 315 ISPF mode 29 ISPF mode

464

under VTAM (VTS) 30 ISRT minor 230 issuing 390 issuing IMS ICMD immediate 387 IT# minor 266 ITX immediate 166 IV 107 IWRT 315 IZIB minor 131

J JCL 144 JES2 operator command 390 jobpack area 403 jobpack queue 143 JOBS minor 365, 402 example 402 JPCI minor 242 JPUI minor 242 JPUO minor 242 JSTA minor job status 243

K KCNDLI subsystem interface module 442 KOBVTAM monitor 76 KOIGBL 210 KYTP key type of the MSDB 352

L label field 33 LANG minor 272 largest free block (fragmentation exceptions) 107 LBFR 318 LBUF 337 len argument 373, 375 LENV 337 LEXC immediate exception analysis 112 LFND 318 LGMG minor 159 LIMIT keyword 425 LINE minor 394 list minor commands 54 list screen space both main storage and disk datasets (default) 67 CANSOI 67


default 67 disk datasets 67 main storage only 67 RKOIPCSV 67 LNCT minor 94 LNEP 286 LNEU 286 LNID 281 load screen space from CANSOI to main storage 54 locate IMS modules in virtual memory 143 lock conflicts 120 CONF immediate 120 lock trace table entries 169 LOCP minor 137 LOG keyword 425 on INFO-line 31 log activating 84, 88 print 53, 57 turn off 53 turn on 53 LOGGED message 59 logging 428 MTO messages logging 409 logging analysis (DASD) 337 logging exception print options 89 logging IMS. messages 410 LOGGING Main Menu option 423 logical terminals (LTERMs) LTERMs 280 long message dataset 159 long-term utilization displays 195 LOOPCOUNT .SET keyword 100, 101 LOOPCOUNT .SLD immediate 100 LOOPCOUNT keyword control block testing 408 using 397 looping detection 397 setting parameters 85, 101 LOOPTIME .SET keyword 100 , 101 LPDSK 195 LPRI 295 LRECL 402 LROWS screen stacking feature 71 LSCR immediate 54 LSETG 204, 206 LSETG99 206

LSQA,SWA unallocated 399 LSQA/SWA bottom 400 storage space 400 LSTA 337 LSYS 337 LTERM logical terminal 238 LTERMSs 253 LTRX 281 LUMC 335 LUMP 335

M MADR minor 139 main storage 46 , 62, 63, 66, 67 main storage database commands MSDB 352 main work area pool 309, 310 maintenance assessment service MAS 450 major commands 32, 221, 270, 280 controlling output 40 displaying complete list 40 help 35 listing 55, 56 to select LTERMs 280 to select PSBs 270 to select scheduling classes 256 major commands/to select DMBs 262 MAP1 major 376 MAS maintenance assessment service 450 master console 391 , 392 Master Terminal Output 388 MAXG without operands 208 MAXG immediate 207 maximum transaction groups 208 MAXS minor 137 MCHN immediate 377 MCNT 346 MCS messages 409 MDBL minor 160 MDEF immediate 370 MDEQ 282, 289 MDST minor 160 memory display from data-only spaces 415 scanning data-only spaces 416 MENQ 282, 289

Index

465

menu interface 25 message boxing 117 forcing 116 No Act 365 reply 394 setting color in 117 message format buffer pool header 132 message logging facility 409 message processing regions 221 message queue buffer pool 329, 333 message queue buffer pool header 132 message queue buffer pool statistics 333 message region occupancy 232 messages displaying IMS 389 ICNS immediate 389 in-line 394 mount 394 out-of-line 394 queued to WTOR LTERM 389 WTO messages 389 MFBP minor 132 MFP major message format buffer pool statistics 325 MFS format blocks in memory 139 MFS format library dataset 164 MFS incore directory index 131 MFS minor 161 MFS pool 325 allocate 325 pool space 325 MFSTEST describes I/O status 157 MGN minor 231 MGU minor 232 minor DDNS minor 365 minor commands 32, 257, 264, 281, 293 case, setting 84, 88 execute all 48 executing 48 help 35 listing 54 to select PSBs 271 minute argument 41 MIRT minor 232 MLCD minor 132 MLOG 365, 410, 411 START operand 410 MLOG immediate 410 example 411 MLST immediate

466

storage 373 MNT minor 394 CONU major 367 MNUM minor 232 MODBLKS datasets 160 Modes of Operation 28 modes of operation shown on INFO-line 30 modifying MODS minor 403 STEP minor 365 MODSTAT dataset 160 MODSTAT2 displays if XRF is available 157 mount message 394 status 184 MPP major 222 MPRG minor 232 MSCN immediate MZAP immediate 365 MSDA 352 MSDB all 352 by list 352 contains an invalid packed field 352 headers 129 length of one segment 353 real to virtual size percentage 353 working set size 353 MSDC 249, 346 MSDL 352 MSDP 352 MSGD immediate 113 MSGT minor 232 MSM multi-services manager 450 MSYS immediate 154 MTO console support 387 screen space 388 MTO output 388 multi-line input facility 86 multi-processors and CPU utilization CPU percent used 246 multi-services manager MSM 450 Mvolser message 193 MVS 179 commands 390 issuing 390 -related region minor commands 240 resource exceptions 107 MVS command


issuing 390 MVS console authority 391 MXRG 295 MZAP immediate 384

N NAME name of the DEDB of which this is an area 351 name pre-defined 371 name of application associated with the BALG 347 native mode 190, 192 NBDF 249 NBFR 315 NBIU 250 NBUF 318 NDSP 116 NODA 288 NODE 203, 278, 282, 286 NODL 288 NODP 288 NODQ 288 NODS 288 non-recoverable databases 263, 264, 267 NPGS minor 137 NPRI 295 Nrdy 192 number of 248, 249, 250, 296 associated EMHBs 346 messages processed 346 overflow buffers 250 PSTs that can be scheduled 347 waiting PSTs queued on this BALG 347 number of associated BALG 355 number of transaction arrivals transaction arrivals 257 number of transaction groups 208 numeric argument controlling major command output 40 NUOW 346 NUSR minor 139 NVSC minor 243

O OBA 250 OBA buffers 250 OBLB 339 OBLK 339 OBLW 340 OBLZ 340 OBST 340 occupancy 232

WFI Regions 232 OCHG immediate 156 OCHP minor 186 OCIO 340 OCMD immediate 365, 390 OCUP minor 232 ODDN minor non-VSAM databases 266 ODDS 339 OFF 116 OFLW overflow occurred in a field 352 OFWF list fields overflowed 353 OIREPORT file 428 OIXFLOG file 428 OLDS 337, 339 OLDSnn 337 OLRL 340 OMEGAMON program check statistics 57 ON 116 online channel paths for the disk 186 disk 179 online change analysis 156 online facility for MLOG immediate format 410 OPDN 340 operand START 410 STATUS 411 STOP 410 operation 442 modes of 30 operational BALG 344 operational parameters .SET immediate 100 setting 85 operator command 390 MTO 387 replies to 391 operator console display commands 392 operator console support 390 OPST 340 OPTN immediate 88 , 423, 424 ASF keyword 423, 430 TSF keyword 424, 426 XLF keyword 423 OPTN immediate.ASF immediate 88 OPTN.BELL immediate 88 OPTN.LOGOFF immediate 88

Index

467

OPTN.LOGON immediate 88 OPTN.SMT immediate 88 OPTN.TSF immediate 88 OPTN.XLF immediate 88 OPTN.ZER immediate 88 OPTN/ASF INFO-line 88 OPTN/BELL INFO-line 88 OPTN/LOG OFF INFO-line 88 OPTN/LOG ON INFO-line 88 OPTN/TSF immediate 88 OPTN/XLF INFO-line 88 OPTN/ZER INFO-line 88 OPUA 340 OPVL 340 OQLN 282, 289 or 91 ORDR 340 OS 107 OSDN 340 OSST 341 OSUA 341 OSUB 318 OSVL 341 out-line-messages 394 OUTP minors, parentheses 90 report 428 OUTP major 78, 89, 428 output buffer location 392 output threads 354 OTHR 354 overflow buffers OBIU 250 OVWL PSTs waiting for OBA latch 347 owner of data-only spaces (OSPC) 414

P P argument 181 P/FETCH DIR READ 157 PA1 key /ATTN INFO-line 43 PAB minor 132 page fix 384 pageable link pack area (PLPA) 384 PAGELIMIT .PLM immediate 100 PAGELIMIT .SET keyword 100, 101 paging fence limits 127 parameter anchor block 132 parameter overrides

468

startup 144 parameters 428 displaying startup command 59 logging 428 setting 425, 426 PARM minor 361 partition specification table 132 partitioning of PSB pool DLISAS address space 331 password 60 authority 376 protection 402 pattern clearing 70 selection 70 setting 70 PB# minor 266 PD# minor 267 PDIR minor 132 PDLS minor LSO=S option 272 PDRA minor 273 PDSK 195, 198 PEEK major 365, 396 action characters with 397 example 396 LOOPCOUNT keyword 397 PEEKSIZE keyword 397 work area size 397 PEEKSIZE .SET option 101 SET option 100 PEEKSIZE keyword using 397 PEEKSIZE WSIZ minor of PEEK 100 PERF minor 244 PERSIST keyword 425 PF keys assigning to 58 cancel definition 58 delete definition 58 screen save 58 PGMN 295 PGNM program name 355 PGST 353 physical terminal lines 253 PI 120 lock conflicts CONF immediate 120 PI locks LOCK minor 230 PIEP


program isolation enqueue pool 332 PLAN minor 233 PLIM 295 PLIM minor 233 plot device activity 183, 191 PLOT immediate 172 PLPA 143 PLSC minor 233 PLSY minor 233 PMSG immediate 114 PND minor 197 PNR major 222 POLDS 337 pool requests 325, 330 REQU 333 pool space 303, 305, 306, 309, 310, 311, 317, 325 , 328, 329, 330, 333 pool statistics pool statistics 301 pool storage 329 pool storage usage 311, 325, 330, 333 pool utilization exceptions 107 PPRF immediate 87 PPUS minor 273 PRCS minor 273 pre-defined names 371 PRES minor 273, 274, 275 primary 337, 338 primary dataset 337, 338 printing .PRT immediate 60 .REP 63 /O 57 /p 59 /PRINT INFO-line 59 output options 84 , 101 XLG 78 printing problems 15 private are 396 private area 402 bottom 399, 400 DBRC 376 region private area 376 storage display 373 top 399 top of extended 399 PRLM 296 profile 31, 96 PROFILE Main Menu option 423 ProfileDefinitionMode keyword 96 program

name 404 structure 407 program check 367 program check statistics OMEGAMON 57 program isolation enqueue 333 PROGxxx program check 97 protect key 125 PSB 270 directory entry 132 PSB work pool 328, 329, 330, 331 REQU 329 PSBA major 270 PSBC minor 273 PSBI major 270 PSBL major 270 PSBN 347 PSBN minor PSBN name 233 PSBP major 270 PSBs 253 PSBS major 270 PSBs scheduled PSBC minor 267 PSBU major 270, 271 PSBW 328 PSET major 174 PSPL 329, 332 PST minor 132 PSTA minor PST address 233 PSTI minor storage isolation 244 PSZE 318 PSZE minor 274 PT# minor 267 PTERMs 253 line commands 284 PTID 282 PTRA 284 PTRL 284 PTRP 284 PTRU 284 PTYP 296 PTYP minor 274 PURG 319 PWADS SWADS 338 PWRT 319

Q QBLK minor 161

Index

469

QBUF 333 QBUF minor 132 QTME minor 233 QUE 278 queue length 186 queue blocks dataset 161 queuing BALG 344

R R2V 353 rate argument .S is an alias for .R. 41 ratio of real memory to virtual 155 RCDA 354 RCDL 354 RCDO 354 RCDP 354 RCDU 355 RCMD major 391 RCNS minor 162 RCOV minor 267 RCTE 296, 355 status 355 unusable 355 RCTE minor 132 RDB2 major 223 RDS minor 162 reads DEDR 249 real memory 155 realtime performance component (OMEGAMON) 25 RECA 306 RECFM 402 refresh current screen ./RESHOW INFO -line 64 region 216, 372 DBRC 372 IEALIMIT value 404 in use 404 limit 404 private area 376 requested 404 storage modifying 383 region moving between steps 244 STEP minor 245 region SRM information 244 regions 215, 221 service units 244 regions in unit of work contention CNTN 248 relational operators (.FGO) 50

470

relational operators (.SGO) 69 relational operators (.VAR) 75 remote terminals 28 rename screen space 62 reorder exception analysis chain linkage dynamically 112 REPEAT keyword 425 REPL minor 234 replace screen in both main storage and RKOIPCSV 63 in main storage only 63 in memory 63 in RKOIPCSV 63 in-storage screen facility 63 REPORT file 89 defining size 85, 101 LOG on INFO-line 31 REPORT log 431 REQU 325, 330 REQU subparm OTHER 330 reset colors 43 passwords 43 residency attributes DRES minor 265 resource commands 354 resource measurement facility 190, 191 resource requests XCRB 250 resources 253 resources measurement facility 182 , 183 response time analysis component (RTA) 26 RESTART Start Parameter 443 restart dataset 162 Resv 192 return to calling screen 65 reverse video 117 RGID minor region ID number 234 RGN2 major 225 RGNA major 223 RGNB major 223 RGNC major 223 RGND major 223 RGNF major 223 RGNH major 224 RGNI major 224 RGNL major 224 RGNM major 224 RGNN major 224 RGNP major 224 RGNR major 224


RGNS major 225 RGNT major 225 RIO 319 RKEY 315 RKOIPCSV 46, 54, 62, 66, 67 DELT immediate 46 immediate 46 RLMO immediate 146 RLMX 147 RMF 182, 183, 190, 191 route codes 132 all 354 by list 354 operational 354 RCTE 354 RRBA 315 RSIN minor 133 RSP minor 197 RTN immediate 429 RTYP minor region type 234

S SACT minor 235 SALL minor 234 SAP minor 133 SAPC minor 235 SAPP 335 save area prefix set (SAP) pool SAPP major 335 save area set prefix 133 save screen to both main storage and RKOIPCSV 66 to in-storage screen facility 66 to main storage only 66 to memory 66 to RKOIPCSV only (default). 66 SBPL minor 137 SBUF 320 Sc keyword 425 SCBF 315 SCC immediate 95 SCC immediate.CLR immediate 95 SCC immediateLEVL immediate 95 SCC immediateXLVL immediate 95 SCD minor 133 SCHC 296 scheduler management block 133 scheduler trace table entries 169 scheduling application program 236 scheduling classes 256

CLSL major select a list of IMS classes 256 scheduling status SCHD minor 268 SCHN immediate 417 SCLS minor 235 scratch pad area (SPA) dataset 163 scratch pad area pool 305, 306 screen display options 84, 88 erasure error 97 print partial 60 printing of 59 Screen GO command 67 screen space /S INFO-line 66 /SAVE INFO-line 66 conditional fetch 49, 68 creating 67 deleting 46 DELT immediate 46 description 30 display libraries 67 fetch (.FGO) 49, 85, 100 fetch (.SGO) 67 first 84, 88 input area 30 listing 67 loading 54 LSCR immediate 54 MTO 388 renaming 62 RENM immediate 62 returning to 65 saving 66 saving address names in a 371 SCRN immediate 67 stacking shown on INFO-line 31 test 51 screen spaces deleting 46 screen stacking display .DSE immediate 48 screen stacking feature /STK INFO --line 70 INFO-line 71 SCRN immediate 67 arguments 67 scrolling 72 amount 31 setting 84, 88 SDSK minor 195 SEAR 319

Index

471

second argument 41 secondary dataset 337, 338 secondary terminals 44 security external 363 features 60 internal 363 selection generic 70 pattern 70 semicolon ( 35, 36 separator line 42 SEQN minor sequence on dispatching queue 245 SERL minor 297 session options command 84 session options command 84 sessions codes shown on INFO-line 30 options commands 88 set and display PF keys 58 SETG format 203 SETG immediate 202 SETO minor 235 SETR minor 236 severity levels customer support 447 SFND 315 SGO immediate 426, 429 SHMG minor 163 short message dataset 163 single quote (’)delimiter 117 SIO rate 155 average 155 SIZE 309, 329, 331 communications I/O pool 305 database pool 311 EPCB pool 324 fast path buffer pool 323 high I/O pool 308 message queue buffer pool 333 MFS pool 325 PSB work pool 330 size DSZE minor 265 SIZE minor 139, 141 SL keyword 426, 427 SLCD 133 SLEN 299, 353 SLST immediate 415

472

SMB minor 133 SMBQ minor SMBs 258 SNID 282 SOLDS 337 SOUT minor 94 SPA dataset information 163 SPA minor 163 SPAL immediate 316 SPAP 305 SPD# minor subpool ID 268 SPID minor 133 split-screen 29 SPQB minor 133 SPST 347 SQA immediate 126 SRB (Service Request Block) 367 scheduling 367 SRB(Service Request Block) 367 SRBT minor 245 SRM information 244 SS keyword 426, 427 SSCN immediate 367, 416 SSPC minor 297 ST 107 start repeating commands 61 start Automatic features logging starting 106 startup 144 STAT 279, 282, 286, 289, 297, 299, 355 STAT minor 139, 259, 361 PSB majors 274 region status 237 STATE 116 static exceptions 107 status information on INFO-line 30 STEP minor 403 STOP immediate 72 stop processing for a collector immediately 42 STOP= 118 stopping 443 storage displaying 372 displaying common area ILST immediate 372 for ELSQA/SWA/USER 399 listing from data-only spaces 415 modifying data-only space 418 private area (MLST) 373 protect key 408


scan ISCN immediate 376 scanning data-only space control blocks 417 scanning data-only spaces 416 subpool allocations 405 storage area prefixed 400 storage isolation parameters for CSA (CSTI) 127 storage key 124 storage management information PEEK major 396 storage modifying 383 region 383 storage, modifying 383 storage modifying 383 STYP 299 STYP minor 275 SUAL minor 246 SUBL major 360 suboperand CLASS 410 SUBP minor 365, 405 SCHN immediate 365 SZAP immediate 365 XMCH minor 365 SUBP/n major 360 subpool allocations 405 subpools 125 subsystem interface module 442 SUCP minor 246 SUIO minor 246 SUMM 163 SUMM Dataset information 163 summary information FSYS 343 SUMS minor 246 support 117 SVC vector table directory 134 SVTD minor 134 SWRT 319 SYS/USER storage space 400 system CPU usage 154 system log control directory 133 Systems Application Architecture 25 SZAP immediate 418

T TAPE major 188 tape volume serial number 193 with address xxx 188

with volser cccccc 188 tape mount message 394 TCB dispatchability 408 scanning with PEEK command 397 structure 407 TCBS minor 407 SLST immediate 365 TCO 170 TCOC immediate 170 TCOS immediate 170 TCPU minor 246 telephone support customer support 446 TERM 299 TERM minor 238 terminal groups 201 terminal bell 84, 88 setting 47 terminals color, EDS or non-EDS 95 monochrome, EDS or non-EDS 95 TERP minor 193 TERR 315 TERSE 115 TERT minor 193 TEST 116 test MFS format library dataset 164 THIN Immediate 216 THRD major 218 THRESHOLD parameter in XACB 117 TIME keyword 427 TIME minor 238 Time-Controlled Operations (TCO) 170 Timed Screen Facility (TSF) 422 activating 88 timed screen facility (TSF) 426, 428 activating 84 cancel while running 429 commands 424 defining entries 85 screen space 429 table 426 terminating 65 using .FGO 49 using .SGO 67 Timed Screen Facility TSF 422 time-outs 367 TIO 316 TIOT address 402

Index

473

TLBL minor 193 TLS 319 TLST major 177 TLV 319 TMFS minor 164 TMTR minor time in transaction 246 to select DMBs DMB 264 to select IMS regions region selection commands 221 to select LTERMs LTERMs 281 to select scheduling classes 256 scheduling classes 257 to select transactions transactions 293 transaction arrivals 293 transactions minor commands 293 TOKN minor 239 TP16 189 TP38 189 TP62 major 190 TP7T major 190 TP80 major 190 TPAL major 188 TPBS major 189 TPCB minor 239 TPCU major 189 TPFR major 189 TPMT major 189 TPOF major 189 TRAC 169 TRAC immediate 169 trace table entries 169 TRAN 300 TRAN minor 239 transaction entering an IMS 387 groups 201 , 208, 211 transaction groups 208 groups transaction 211 transaction groups selecting 211 transaction input queue length IQLN 294 transaction rates 166, 167 transaction status STAT minor 268 transactions 291 transactions processed 296 PRCS 296 transactions processed Fast Path 296 TRCE minor 275

474

TRMA major 280 TRMG major 280 TRML major 280 TRMP major 280 TRMQ major 280 TRMS major 280 TRMU major 280 TRPQ major 281 TRXA 291 TRXC 291 TRXD 291 TRXG 291 TRXL 291 TRXP 291 TRXQ 292 TRXS major 292 TRXU major 292 TSEQ 193 TSF OPTN keyword 88 TSO mode 29 under VTAM (VTT) 30 TTIM Immediate 218 TWRT 316 TWSS minor 247 TX# minor 275 TXCnnn 292 TXPQ 293 TYPE 290, 353 type immediate 32 INFO-line 32 minor 32 TYPE minor 140, 141 type of label 193

U UCB hex dump 185, 192 unallocating datasets 411 underscore (_) for comment lines 40 underscoring exception message 117 unit address 182 unit of work NUOW 250 unit of work contentions 250 unusable 355 unused BALG 344 user area limit 399, 400 top 400 unallocated 400 user area extended


top 399 unallocated 399 User Commands User Commands 277 user interface 24, 25 user interfaces command interface 25 CUA Interface 25 historical information (EPILOG) interfaces 25 menu interface 25 user profile 96 user profile facility 83 USID 278 USRA 277 USRC 277 USRD 277 USRE 277 USRI 277 USRL 277 USRM 277 USRO 277 USRP/n 277 USRR 278 USRS 278 USRT 278 USRZ 278

V variable OMEGAMON-defined 75 setting 73 variable names .VAR 74 in .FGO 50 in .SGO 69 VERBOSE 115 verify text with MZAP replace text with MZAP 384 versions SP1.3 179 virtual memory 155 VMEN immediate 149 volser 178 selecting disks by 179 volume serial 178 volume serial volser 178 VRDS 316 VS 107 VSAM 269, 313 buffer pool prefix 128 buffer subpool header (subpool nn) 129 exceptions 107

VSC minor 247 VSUB 314 VTAM display users (.VTM) 76 VTAM director 30 VTAM mode 30 code on INFO-line 30 VTD code on INFO-line 30 VTS code on INFO-line 30 VTT code on INFO-line 30

W WADS 337, 338 , 341 dataset 341 WADSn 338 WAIT minor 247 WBLK 341 WCIO 341 WDDS 341 WKST 353 WKST minor 247 WLCT 320 WLRL 341 work area for PEEK command 397 size of PEEK command 397 work area for PEEK command 85, 101 workarea pool statistics WKAP 309 working set fence limits 127 working set size page-stolen 247 Workload Profile Facility status mode 85 WOWN 320 WPST 347 wraparound I/O# 184 WSPL 320 WSTA 341 WSTR 320 WSTW 320 WTDE minor 239 WTEE minor 239 WTOR LTERM 389 WTOT 320 WTTE minor 239 WTUE minor 239 WUCB 342 WUSE 342 WVOL 342

Index

475

X X (in label field of TCBS) 408 XACB immediate 98, 114, 423, 425, 430 XCRB 351 XDSK 195 XFPQ immediate 121 XGRP immediate 107 XGSW immediate 119 XIMS immediate 429 XLF 77 XLF OPTN keyword 88 XLFLOG 78, 89 XLTQ 122 XMCH immediate 379, 381 XMLS immediate 374, 403 CONS major 367 MPDD minor 376 XMM code on INFO-line 30 XMSC immediate 382 XMZP immediate 385, 403 XR 107 XRF exceptions 107 XSETG 206 XSUM immediate 108 XTRP immediate 109

Z zapping data-only space storage 418 zapping private area 385 zone initial block 131

476


OMEGAMON II for IMS Realtime Commands Reference Manual V510

OMEGAMON II for IMS Realtime Commands Reference Manual V510

Suggest Documents

Reference Manual: Commands - Sybase

Enhanced AT Commands Reference Manual

HSPICE Reference Manual: Commands and Control Options

GRASS Reference Manual Vector Commands - Grass GIS

Apple II Reference Manual

56K* Commands Technical Reference

PortServer II  Command Reference Manual

Extended AT Commands Manual

Extended AT Commands Manual

Extended AT Commands Manual

CDMA 1xEV-D0 AT Commands Reference Guide

aix commands quick reference pdf - Google Drive

oracle dba commands pdf reference - Google Drive

[15-122] Linux Commands Quick Reference - C0

aix commands quick reference pdf - Google Drive

IMS Specification Quick Reference Guide (PDF) - eCollege ...

AT Commands For CDMA Wireless Modems Reference Guide

Reference Manual

Reference Manual

Reference Manual

Reference Manual

Reference manual

Reference Manual

Reference Manual