+ All Categories
Home > Documents > OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ...

OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ...

Date post: 05-May-2018
Category:
Upload: vuongliem
View: 228 times
Download: 2 times
Share this document with a friend
56
User’s Guide OMEGAMON ® XE for IMSplex Version 220 GC32-9304-00 May 2003 Candle Corporation 100 North Sepulveda Blvd. El Segundo, California 90245
Transcript
Page 1: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

User’s GuideOMEGAMON® XE for IMSplex

Version 220

GC32-9304-00

May 2003

Candle Corporation100 North Sepulveda Blvd.

El Segundo, California 90245

Page 2: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

2 OMEGAMON XE for IMSplex User’s Guide, V220

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, CandleNet eBusiness Platform, CandleNet Portal, Candle Technologies, CL/CONFERENCE, CL/SUPERSESSION, CommandWatch, CandleNet Command Center, CT, CT/Data Server, CT/DS, DELTAMON, eBA, eBA*ServiceMonitor, eBA*ServiceNetwork, eBusiness Assurance, 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 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 Administrator, CandleNet eBusiness Platform Connector, CandleNet eBusiness Platform Connectors, CandleNet eBusiness Platform Powered by Roma Technology, CandleNet eBusiness Platform Service Directory, 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 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 © May 2003, 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.

Page 3: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Contents 3

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Adobe Portable Document Format . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Documentation Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Candle Customer Service and Satisfaction . . . . . . . . . . . . . . . . . . . . 13

What’s New . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15

Chapter 1. Introducing OMEGAMON XE for IMSplex . . . . . . . . . . . . . . . . 17OMEGAMON XE for IMSplex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18OMEGAMON XE for IMSplex Operating Environment . . . . . . . . . . . 21

Chapter 2. Learning about OMEGAMON XE for IMSplex . . . . . . . . . . . . . 25Understanding Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Understanding OMEGAMON XE for IMSplex Information . . . . . . . . 27

Chapter 3. OMEGAMON XE for IMSplex Workspaces . . . . . . . . . . . . . . . 31Introducing the OMEGAMON XE for IMSplex Workspaces . . . . . . . . 32Coupling Facility Data Sharing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Coupling Facility Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Global Lock Conflicts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38MQSeries Status Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Multiple Systems Coupling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41OMEGAMON XE for IMSplex (default) . . . . . . . . . . . . . . . . . . . . . . . 43Online TRF Class Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Online TRF DLI Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Response Time Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Shared Lterm Queues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Shared Transaction Queues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Startup Parameters Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

Contents

Page 4: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

4 OMEGAMON XE for IMSplex User’s Guide, V220

Chapter 4. OMEGAMON XE for IMSplex Predefined Situations . . . . . . . .51What Is a Situation? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52What Is a Predefined Situation?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Using Situations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55

Page 5: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Preface 5

Preface

This user’s guide provides information about the use of OMEGAMON® XE for IMSplex to monitor availability and performance of IMSplex. This guide will help you

� become familiar with the predefined workspaces that report on your IMSplex system

� anticipate and detect problems in using your IMSplex environment

� access specific information about events occurring in your environment

P

Page 6: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

About This Book

6 OMEGAMON XE for IMSplex User’s Guide, V220

About This Book

Who should read this bookThis guide is intended to be used by OMEGAMON XE for IMSplex system administrators. The guide supplements the online help provided with OMEGAMON XE for IMSplex.

Candle recommends that you reference this document whenever you need additional information about the OMEGAMON XE for IMSplex product, its attributes, workspaces, and situations.

This manual assumes that you

� have installed CandleNet Portal™

� have installed OMEGAMON XE for IMSplex

� are familiar with basic CandleNet Portal concepts, tasks, and features

If you are unfamiliar with these concepts and tasks, please review the Administering OMEGAMON Products: CandleNet Portal manual. You should also review the online CandleNet Portal Tour to become familiar with the product’s features and capabilities.

Documentation set informationCandle provides several sources of documentation for the OMEGAMON XE for IMSplex. Each of these sources contains a specific type of information to help you use the product. Relevant manuals are the

� OMEGAMON XE for IMSplex User’s Guide, IP54-6772

Introduces you to the features, workspaces, attributes, and predefined situations for OMEGAMON XE for IMSplex.

� OMEGAMON XE for IMS User’s Guide, I354-6773

Introduces you to the features, workspaces, attributes, and predefined situations for OMEGAMON XE for IMS.

Page 7: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Preface 7

About This Book

� CandleNet Portal documentation that came with your OMEGAMON XE for IMSplex product

Provides instructions for using the CandleNet Portal interface to monitor the enterprise.

� Candle Products Messages Documentation Set

A compilation of the error and informational messages produced by Candle’s products.

� CandleNet Command Center™ documentation that came with your OMEGAMON XE for IMSplex product

Provides instructions for setting up the Candle Management Server® (CMS™)

� Installation documentation that came with your OMEGAMON XE for IMSplex product

Provides instructions for installing the product and the framework components.

Where to look for more informationFor more information about this product and other related products, please see the

� technical documentation CD-ROM that came with your product

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

� online help provided with this and the other related products

Ordering additional product documentationTo order additional product manuals, contact your Candle Support Services representative.

Page 8: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

About This Book

8 OMEGAMON XE for IMSplex User’s Guide, V220

We would like to hear from youCandle 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 XE for IMSplex User’s Guide, V220” in the subject line.

Page 9: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Preface 9

Adobe Portable Document Format

Adobe Portable Document Format

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

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

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

3. On the Print pop-up, select one of the Print Range options for� All� Current page� 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:� 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.)

� 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.)

� 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.

� 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.

Page 10: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Adobe Portable Document Format

10 OMEGAMON XE for IMSplex User’s Guide, V220

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

Adding annotations to PDF filesIf you have purchased the Adobe Acrobat application, you can add annotations to Candle documentation in .PDF format. See the Adobe product for instructions on using the Acrobat annotations tool and its features.

Page 11: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Preface 11

Documentation Conventions

Documentation Conventions

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

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

Required blanksThe slashed-b (!) character in examples represents a required blank. The following example illustrates the location of two required blanks.

!!!!eBA*ServiceMonitor!!!!0990221161551000

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

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

LOGON APPLID (cccccccc)

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

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

Page 12: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Documentation Conventions

12 OMEGAMON XE for IMSplex User’s Guide, V220

SymbolsThe following symbols may appear in command syntax:

Table 1. Symbols in Command Syntax

Symbol Usage

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

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

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

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

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

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

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

_ Default values are underscored. Example:

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

Page 13: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Preface 13

Candle Customer Service and Satisfaction

Candle Customer Service and Satisfaction

BackgroundTo assist you in making effective use of our products, Candle offers a variety of easy-to-use online support resources. The Candle Web site provides direct links to a variety of support tools that include these services:

eSupport allows you to create and update service requests opened with Customer Service and Satisfaction (CSS).

eDelivery allows you to download products, documentation, and maintenance 24 hours a day, 7 days a week.

eNotification notifies you of product updates and new releases.

In addition, you can find information about training, maintenance plans, consulting and services, and other useful support resources. Refer to the Candle Web site at www.candle.com for detailed customer service information.

Candle Customer Service and Satisfaction contactsYou will find the most current information about how to contact Candle CSS by telephone or email on the Candle Web site. Go to the www.candle.com support section, and choose the link to Support Contacts to locate your regional support center.

Page 14: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Candle Customer Service and Satisfaction

14 OMEGAMON XE for IMSplex User’s Guide, V220

Page 15: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

What’s New 15

What’s New

OverviewOMEGAMON XE for IMSplex, V220 features coupling facility enhancements and subsystem autodiscovery.

Coupling Facility EnhancementsWhile statistics on coupling facility lock structures were available in earlier versions of OMEGAMON XE for IMSplex, managing cache or list structures used by IMS proved challenging. Usage information needs to be collected for the data sharing cache structure and the shared queues list structures in order to determine when these structures are reaching capacity. OMEGAMON XE for IMSplex provides the data that is available from the Coupling Facility for data sharing cache and shared queues list structures, so that you can determine when coupling facility structures approach their capacity.

Subsystem AutodiscoveryOMEGAMON XE for IMSplex, V200 configuration required you to explicitly specify the IDs of the IMS and IRLM subsystems to be monitored. This characteristic presented the following challenges:

� New subsystems were not monitored and thus, required reconfiguration and recycling of the CMS address space.

� Subsystems renamed and restarted required configuration and recycling of the collectors or the CMS.

� Data collection for terminated subsystems continued to occur, requiring users to manually issue commands to terminate data collectors.

W

Page 16: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

16 OMEGAMON XE for IMSplex User’s Guide, V220

� Intermittent abends occurred at CMS shutdown if data collection was still active from subsystems that have terminated.

OMEGAMON XE for IMSplex, V220 features autodiscovery of the IMS and IRLM subsystems to be monitored. This autodiscovery function is supported by the IPDC AUTODISCOVER command, which replaces the IPDC START commands issued in the KIPSTART member in RKANCMD. The subsystems are monitored based on the order in which you add the IMS subsystems.

Page 17: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Introducing OMEGAMON XE for IMSplex 17

IntroducingOMEGAMON XE for IMSplex

IntroductionThis chapter introduces the features in the OMEGAMON XE for IMSplex and how it can enhance the performance of your system.

Chapter contentsOMEGAMON XE for IMSplex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18OMEGAMON XE for IMSplex Operating Environment . . . . . . . . . . . . . . . 21

1

Page 18: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

OMEGAMON XE for IMSplex

18 OMEGAMON XE for IMSplex User’s Guide, V220

OMEGAMON XE for IMSplex

OverviewSystems administrators face increasing challenges in an ever-changing technical environment. Candle Corporation developed the CandleNet Portal and OMEGAMON XE for IMSplex to help you meet these challenges and better manage the performance of your system.

This topic presents a high-level description of OMEGAMON XE for IMSplex.

Using OMEGAMON XE for IMSplex and CandleNet Portal OMEGAMON XE for IMSplex offers a central point of management of IMS database systems. It provides a comprehensive means for gathering exactly the information you need to detect problems early and to prevent them. Information is standardized across all systems, and you can monitor hundreds of servers from a single workstation. The CandleNet Portal lets you easily collect and analyze specific information.

OMEGAMON XE for IMSplex is an intelligent, remote monitoring agent that resides on managed systems. It assists you in anticipating trouble and warns systems administrators when critical events take place on their systems. With OMEGAMON XE for IMSplex, database and systems administrators can set threshold levels and flags as desired to alert them when the system reaches these thresholds.

CandleNet Portal information appears in named workspaces. Within a given workspace, information may appear in tabular form similar to the reports displayed by Candle Management Workstation®. CandleNet Portal refers to this tabular format for information as a table view. Information may also be displayed in the workspace as charts, graphs, or other formats you can specify.

Page 19: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Introducing OMEGAMON XE for IMSplex 19

OMEGAMON XE for IMSplex

How OMEGAMON XE for IMSplex assists you OMEGAMON XE for IMSplex provides several benefits. It can

� Simplify application and system management — by managing applications, platforms, and resources across your environment.

� Increase profits —by providing you with real-time access to reliable, up-to-the-minute data that allows you to make faster, better-informed operating decisions.

� Scale and port to new platforms —by supporting a wide variety of platforms.

� Improve system performance —by letting you integrate, monitor, and manage your system, network, console, and mission-critical applications. OMEGAMON XE for IMSplex alerts the Candle Management Server (CMS) and the CandleNet Portal when conditions on the system network meet threshold-based conditions. These alerts notify your systems administrator to limit and control database usage. You can view data gathered by OMEGAMON XE IMSplex in tables and charts for the status of your distributed database systems.

� Enhance efficiency —by monitoring diverse platforms and networks from a single PC screen. Depending on your CandleNet Portal configuration, you can collect and monitor data across platforms. OMEGAMON XE for IMSplex helps you monitor and gather the consistent, accurate, and timely information you need to effectively perform your job.

Page 20: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

OMEGAMON XE for IMSplex

20 OMEGAMON XE for IMSplex User’s Guide, V220

Features to facilitate database managementThe OMEGAMON XE for IMSplex includes the following features that facilitate database management:

� support for database management system

� the ability to create situations from attributes

� the ability to determine whether the problem being monitored is related to SQL

� the ability to check for a particular situation and, if found, to page someone or send a UNIX mail note (reflex automation)

� predefined situations and templates

Planning and installationFor information on planning and installing OMEGAMON XE for IMSplex, refer to the installation documentation that was sent with your product.

Page 21: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Introducing OMEGAMON XE for IMSplex 21

OMEGAMON XE for IMSplex Operating Environment

OMEGAMON XE for IMSplex Operating Environment

OverviewOMEGAMON XE for IMSplex helps you to address the increasing challenges presented by today’s technical environment. In this unit you learn about the operating environment in which the OMEGAMON XE for IMSplex resides.

What is OMEGAMON XE?OMEGAMON® XE is a suite of products that assists you in monitoring your mainframe and distributed systems on a variety of platforms using a variety of workstations.

It provides a way to monitor the availability and performance of all the systems in your enterprise from one or several designated workstations. It provides many useful reports you can use to track trends and understand and troubleshoot system problems. You can use OMEGAMON XE to

� establish your own performance thresholds

� create situations, which are conditions to monitor

� create comprehensive reports about system conditions

� monitor for alerts on the systems and platforms you are managing

� trace the causes leading up to an alert

Components of the environmentThe client-server-agent implementation includes

� a client, that can be

– a Candle Management Workstation (CMW) or

– a CandleNet Portal workstation

� a CandleNet Portal server that performs common CandleNet Portal functions and serves to lighten the CandleNet Portal client

� monitoring agents that collect and distribute data to a CMS. The OMEGAMON XE for IMSplex is such an agent.

Page 22: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

OMEGAMON XE for IMSplex Operating Environment

22 OMEGAMON XE for IMSplex User’s Guide, V220

What is CandleNet Portal?CandleNet Portal provides a view of your enterprise from which you can drill down to more closely examine components of your systems environment. Its application window consists of a Navigator that shows all the systems in your enterprise where Candle agents are installed, and a workspace that includes table and chart views of system and application conditions.

CandleNet Portal runs situations at regular intervals to check that your applications and system resources are running, and running well. A failed test causes event indicators to appear in the Navigator.

CandleNet Portal offers two modes of operation: desktop and browser. In desktop mode, the application software is installed on your system. In browser mode, the system administrator installs the application on the web server and you start CandleNet Portal from your browser. In browser mode, the software is downloaded to your system the first time you log on to CandleNet Portal, and thereafter only when there are software updates.

What is the Candle Management Workstation?The Candle Management Workstation (CMW) offers a graphical view of your system. The CMW receives real-time and historical performance and availability data that the CMS collects and distributes. Through its graphical user interface, the CMW enables you to display data about and monitor the performance and availability of multiple heterogeneous systems. Advanced automation features enable you to specify actions to be taken when certain events occur. These actions can be automated or can include the notification of personnel for human intervention and decision-making.

OMEGAMON DEThe OMEGAMON DE feature package for CandleNet Portal offers a dashboard view of your enterprise. This feature provides a single point of control from which you can manage the resources your business-critical applications rely on, including a range of operating systems, servers, databases, mainframes, and Web components. It enables you to pull together the data and functionality built into all the Candle monitoring solutions, such as OMEGAMON XE for IMSplex. When you are using OMEGAMON XE for IMSplex and choose to install OMEGAMON DE, a new tab, called the Business View, appears at the bottom of your Navigator pane.

Page 23: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Introducing OMEGAMON XE for IMSplex 23

OMEGAMON XE for IMSplex Operating Environment

Detailed information about OMEGAMON DE is provided in the CandleNet Portal online Help. Its features are summarized below.

� You can display multiple applications in one workspace

In a single workspace, you can build a table or chart with data from one type of monitoring agent, and another table or chart with data from a different agent. Within that workspace, you can show views from as many different agent types as are included on that branch of the Navigator, in either the physical view or the business view.

� You can link application workspaces

You can define a link from a workspace associated with one type of monitoring agent to a workspace associated with another type of agent.

� You can define enterprise-specific navigator business views

CandleNet Portal has a Navigator physical view that reflects the hierarchy of your network operating platforms, systems, agents, and attributes. OMEGAMON DE provides a Navigator business view that shows the hierarchy of managed objects defined through the CMW. You can customize one workspace or multiple workspaces for every managed object to show data from any and all agents represented in the managed object.

About the Workflow EditorIf your product supports the use of the Workflow Editor, you can find information about its use in CandleNet Portal Help and Administering OMEGAMON Products: CandleNet Portal. The Workflow Editor permits you to create new policies or modify any predefined policies for your product or policies created using the Candle Management Workstation.

Further information about the CMW and CandleNet PortalFor further information about CandleNet Portal, refer to Administering OMEGAMON Products: CandleNet Portal and to the online help.

Further information about the CMW can be found in the CMW Administrator’s Guide and CMW User’s Guide, as well as in the CMW online help.

Page 24: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

OMEGAMON XE for IMSplex Operating Environment

24 OMEGAMON XE for IMSplex User’s Guide, V220

If you are an experienced CMW user, you should review the CandleNet Portal help topic called “CMW Users.” This topic addresses the similarities and differences of these user interfaces, provides guidance about each interface’s functionality, and a cross-reference listing that clarifies the products’ terminology.

Page 25: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Learning about OMEGAMON XE for IMSplex 25

Learning aboutOMEGAMON XE for IMSplex

IntroductionThis chapter provides an overview for using the attributes and workspaces for OMEGAMON XE for IMSplex. It also contains information on predefined situations and reflex automation for action situations.

Chapter contentsUnderstanding Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Understanding OMEGAMON XE for IMSplex Information . . . . . . . . . . . . 27

2

Page 26: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Understanding Attributes

26 OMEGAMON XE for IMSplex User’s Guide, V220

Understanding Attributes

Using attributesOMEGAMON XE for IMSplex gathers data from remote agents residing on the managed systems of your network and stores this data in system elements called attributes. You can use these attributes to build situations to monitor the performance of the underlying IMSplex system.

To use these attributes effectively, you must first understand the structure of an attribute.

An attribute belongs to an attribute group.

� An attribute group associates attributes that refer to some unique characteristic of the data that is being stored.

� An attribute item stores data for a particular property of an attribute group.

For example, in the attribute

<ATTRIBUTEGROUP>.<attribute_item>

<attribute_item> is an attribute item that stores a name recognized by the system for the <ATTRIBUTEGROUP> attribute group.

For more information on attributesFor complete descriptions of the attributes for OMEGAMON XE for IMSplex, refer to the OMEGAMON XE for IMSplex’s online help.

Page 27: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Learning about OMEGAMON XE for IMSplex 27

Understanding OMEGAMON XE for IMSplex Information

Understanding OMEGAMON XE for IMSplex Information

Workspaces and table viewsCandleNet Portal displays information in workspaces. Within a given workspace, information is displayed in tabular form. CandleNet Portal refers to this tabular format for information as a table view. Information may also be displayed in the workspace as a chart, graph, or other format you can specify.

What is a workspace?A workspace is the working area of the CandleNet Portal application window. At the left of the workspace is a Navigator that permits you to select the workspace you want to display. As part of the application window, the right side of the status bar shows the CandleNet Portal server name and port number to which the displayed information applies, as well as the ID of the current user.

As you select items in the Navigator, the workspace presents views pertinent to your selection. Each workspace has at least one view.

Every workspace has a set of properties associated with it. You can customize the workspace by working in the Properties editor to change the style and content of each view.

Another way to customize the workspace is to change the type of view or to add views to the workspace. Be aware that the changes you make to the workspace are lost when you switch to another workspace unless you save them first.

Formats for CandleNet Portal informationCandleNet Portal information can be presented to you in any of the views below:

� Table view

� Pie chart view

� Bar chart view

� Plot chart view

Page 28: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Understanding OMEGAMON XE for IMSplex Information

28 OMEGAMON XE for IMSplex User’s Guide, V220

� Needle gauge view

� Thermometer gauge view

� Notepad view

� Event console view, that shows the status of the situations associated with the system.

� Take Action view, that is used to send a command to the system.

� Terminal view, that enables you to start a 3270 or 5250 work session.

� Browser view, that permits you to open a browser to see HTML pages and Web sites.

Associating workspaces with attributesThere is a direct relationship between attributes and workspaces. An attribute group typically corresponds to a table view within a named workspace and attribute items correspond to columns in the table view.

Each CandleNet Portal workspace displays real-time information for many of the attributes. The information is available to you, independent of whether you are using OMEGAMON XE for IMSplex to monitor situations.

For more information Continue reading to learn how to manipulate information presented to you by CandleNet Portal. For descriptions of the individual workspaces, see “OMEGAMON XE for IMSplex Workspaces” on page 31.

Using OMEGAMON XE for IMSplex informationYou can view information about each managed system that you are monitoring. Use this information to

� monitor the performance of each managed system, helping you to identify system bottlenecks and evaluate tuning decisions

� select the most effective threshold values for situations you create

� review status information when a change in the state of a given resource occurs; such as from OK to Warning or Warning to Critical

Page 29: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Learning about OMEGAMON XE for IMSplex 29

Understanding OMEGAMON XE for IMSplex Information

Defining workspace propertiesEvery workspace has a set of properties associated with it. You can customize the workspace by working in the Properties editor to change the style and content of each view. Changes you make to workspace properties, such as adding or editing a view are only temporary. They will be lost when you exit CandleNet Portal unless you save the workspace.

The properties of a workspace may be some or all of the following

Investigating an event When the conditions of a situation have been met, the situation evaluates True, causing an event indicator to appear in the Navigator. You can investigate the event by opening its workspace.

The event workspace shows two table views, one with the values of the attributes when the situation evaluated True, and the other with the attributes’ current values.

The event workspace can also display a text view with any expert advice written by the situation's author, and the Take Action view so you can send a command to the application started on that system.

Adding a workspace to your favoritesWhen using CandleNet Portal in browser mode, you can start it from any workstation by entering the URL for the web server where the browser mode client is installed. Each CandleNet Portal workspace also has a URL so that you can save the workspace to your Favorites list or specify it as your home page.

Query Specify what data should go in the chart or table

Filters Refine the view by filtering out unwanted data from the chart or table

Thresholds Establish threshold values and color indicators for a table view

Configuration Specify the script to run or the connection to make whenever you open the terminal view

Style Change the behavior and appearance of the view

Page 30: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Understanding OMEGAMON XE for IMSplex Information

30 OMEGAMON XE for IMSplex User’s Guide, V220

Filtering informationTo manually set up filtering for a given table view, place the cursor on the table view, press the right mouse button, and select Properties. From the displayed dialog, select the Filters tab. Here you can select the columns to display as well as set up the criteria for which rows to display. To save your filtering specifications, you must save the workspace before exiting.

Sorting InformationSorting is handled by simply clicking on a column heading. Click once and the workspace will be sorted in ascending order. Click a second time to resort the workspace into descending order. A third click returns you to the workspace’s default sort.

Page 31: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

OMEGAMON XE for IMSplex Workspaces 31

OMEGAMON XE for IMSplexWorkspaces

IntroductionThis chapter describes the OMEGAMON XE for IMSplex workspaces shipped with the product.

Chapter contentsIntroducing the OMEGAMON XE for IMSplex Workspaces. . . . . . . . . . . . 32Coupling Facility Data Sharing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Coupling Facility Structures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36Global Lock Conflicts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38MQSeries Status Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Multiple Systems Coupling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41OMEGAMON XE for IMSplex (default). . . . . . . . . . . . . . . . . . . . . . . . . . . 43Online TRF Class Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Online TRF DLI Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45Response Time Analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46Shared Lterm Queues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Shared Transaction Queues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Startup Parameters Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

3

Page 32: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Introducing the OMEGAMON XE for IMSplex Workspaces

32 OMEGAMON XE for IMSplex User’s Guide, V220

Introducing the OMEGAMON XE for IMSplex Workspaces

OverviewIn the unit “Understanding OMEGAMON XE for IMSplex Information” on page 27, you learned about using CandleNet Portal to work with the workspaces provided by OMEGAMON XE for IMSplex. This chapter describes the workspaces and explains how you might use them to monitor your IMSplex environment.

Accessing a workspaceOMEGAMON XE for IMSplex provides workspaces featuring a variety of table views. You can access a workspace in several ways:

� By selecting its name from the list provided in the CandleNet Portal Navigator

� By right-clicking an item in the Navigator and selecting a workspace from the pop-up menu that is displayed

� By right-clicking in a column of a table view and selecting a workspace from the pop-up menu that is displayed

Page 33: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

OMEGAMON XE for IMSplex Workspaces 33

Introducing the OMEGAMON XE for IMSplex Workspaces

WorkspacesThe predefined workspaces for OMEGAMON XE for IMSplex are, in alphabetical order

� CF Data Sharing OSAM Details

� Coupling Facility Data Sharing Status

� Coupling Facility Data Sharing Structures

� Coupling Facility Shared Queues Structures

� Coupling Facility Structures

� Global Lock Conflicts

� MQSeries Status Details

� MSC Logical

� MSC Physical

� OMEGAMON XE for IMSplex (default)

� Online TRF Class Summary

� Online TRF DLI Summary

� Response Time Analysis Group

� Response Time Analysis Item Analysis

� Shared Lterm Queue Detail

� Shared Lterm Queues Summary

� Shared Transaction Queue Detail

� Shared Transaction Queues Summary

� Startup Parameters Details

Page 34: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Coupling Facility Data Sharing

34 OMEGAMON XE for IMSplex User’s Guide, V220

Coupling Facility Data Sharing

OverviewThese workspaces provide you with Coupling Facility statistics related to the data sharing VSAM and OSAM cache structures. Using these views you can:

� determine the coupling facility capacities

� observe the numbers and types of IMS calls

� determine whether a change needs to be made to the cache structure size

You can sort and filter information in the Data Sharing table view to change the way you see information.

Coupling Facility Data Sharing StatusUp to 32 individual IMS systems in the IMS sysplex attach to the Coupling Facility through the OSAM and VSAM structures. These Coupling Facility structures have information on the connections and the shared data. Buffer status and connection information is found in the IMS control blocks. Use the Coupling Facility Data Sharing Status table view to:

� verify that Data Sharing is active

� view the number of buffers cached in the Coupling Facility and the number for which data sharing is implemented

� determine the structure size required

This table view shows detailed information about data sharing status, buffer counts, queues, and structure size for the data sharing group you choose.

Page 35: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

OMEGAMON XE for IMSplex Workspaces 35

Coupling Facility Data Sharing

CF Data Sharing OSAM DetailsThe CF Data Sharing OSAM Details workspace displays a global view of the data sharing OSAM structures. The OSAM cache structures are used to implement IMS database buffer invalidation. When a data sharing buffer is changed by one of its applications, IMS issues a buffer invalidate call to the Coupling Facility. IMS is notified that its local copy of the data sharing buffer is invalid and must be reacquired. Use the CF Data Sharing OSAM Details table view to:

� determine the Coupling Facility capacities

� monitor the number of requests waiting for the Coupling Facility

� observe the number of blocks not written to the Coupling Facility cache structure

� determine if many blocks read are cached, but never updated

� observe the number of successful buffer invalidate calls that tell the Coupling Facility to notify connectors that their local buffers should be refreshed

� determine whether a change needs to be made to the cache structure size or memory needs to be added to the Coupling Facility

Page 36: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Coupling Facility Structures

36 OMEGAMON XE for IMSplex User’s Guide, V220

Coupling Facility Structures

OverviewYou can use the Coupling Facility Structures workspaces to:

� verify the connection status of your cache and lock structures

� monitor lock structure utilization over a period of time

� monitor cache structure utilization over a period of time

� monitor EMHQ structure utilization over a period of time

� monitor MSGQ structure utilization over a period of time

Coupling Facility StructuresThe Coupling Facility Structures workspace provides a global view of coupling facility structures for a specific data sharing group or for all data sharing groups. Use this workspace to:

� verify the connection status of lock, cache, EMHQ, and MSGQ structures

� track structure utilization over a period of time

� view structure data for a true coupling facility situation

Monitoring coupling facility structures

You can use the Coupling Facility Structures workspace to verify that your structures are active and to track structure utilization over a period of time.

For example, you may want to monitor coupling facility structures to track lock structures that are filling up with record entries.

Access the Coupling Facility Structures workspace. Notice that, by default, the table view is sorted in alphabetical order by structure name. To make it easy to identify all the lock structures, sort the table view by structure type. To see the Record Used Percent column, scroll as necessary.

Page 37: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

OMEGAMON XE for IMSplex Workspaces 37

Coupling Facility Structures

Investigating a true coupling facility situation

You can use the Coupling Facility Structures view to investigate a coupling facility situation, viewing detailed structure data for one or more lock structures that caused a situation to evaluate to true.

For example, you may want to investigate the predefined situation, IMS IRLM CF RLE Percent Warning, which evaluates to true when the record used percent is in the range of 80 to 89 percent.

Access the Coupling Facility Structures workspace. To see the record used percent value for each coupling facility structure, scroll as necessary.

Coupling Facility Shared Queues StructuresThe Coupling Facility Shared Queues Structures workspace provides a global view of coupling facility structures for shared queues.

Coupling Facility Data Sharing StructuresThe Coupling Facility Data Sharing Structures workspace provides a global view of coupling facility structures for a specific data sharing group or for all data sharing groups.

Page 38: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Global Lock Conflicts

38 OMEGAMON XE for IMSplex User’s Guide, V220

Global Lock Conflicts

OverviewThe Global Lock Conflicts workspace provides a global view of lock conflicts for an entire data sharing group.

DescriptionUse the Global Lock Conflicts workspace to:

� identify all BMPs, MPPs, or DBCTL threads waiting on a database lock

� identify both the owners and waiters of a database lock

� track lock processing for transactions over a period of time

� view locking data for transactions when a database lock situation evaluates to true

� view CICS transaction data when a DBCTL thread holds a database lock

You can sort and filter information in the workspaces to change the way you see information.

Monitoring database lock activity

For example, you may want to monitor critical transactions with a lock elapsed time of greater than 10 seconds. Notice that, by default, the table view shows lock elapsed time in descending order. This makes it easy to identify the transactions with a lock elapsed time of greater than 10 seconds.

Investigating a true database lock situation

You could use this table view to investigate a database lock situation, viewing locking data for one or more transactions that caused a situation to evaluate to true. You may want to investigate the predefined situation, IMS Lock Waiter Time Critical, which evaluates to true when the lock elapsed time is greater than 10 seconds and lock status is Waiter. Filter the view to show only those transactions with a lock elapsed time greater than 10 seconds. On the filtered view, identify all transactions with a Waiter lock status.

Page 39: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

OMEGAMON XE for IMSplex Workspaces 39

Global Lock Conflicts

You can continue your investigation of a database lock conflict by using the Accessing OMEGAMON II feature to zoom to an OMEGAMON II host session.

Page 40: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

MQSeries Status Details

40 OMEGAMON XE for IMSplex User’s Guide, V220

MQSeries Status Details

OverviewThe MQSeries Status Detail workspace provides you with detailed MQ status information for a specific IMS subsystem. You can sort and filter information in the MQSeries Status workspace to change the way you see information.

DescriptionUse the MQSeries Status Detail workspace to:

� view status information about the connection between an IMS and an external MQ subsystem

� track MQ status over a period of time

Page 41: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

OMEGAMON XE for IMSplex Workspaces 41

Multiple Systems Coupling

Multiple Systems Coupling

OverviewThese workspaces provide you with detailed link information about your physical and logical links. Using the Multiple Systems Coupling workspaces you can:

� evaluate and analyze your physical and logical links

� monitor the link status and queue counts of your physical and logical links

� identify logical links for a physical link

� identify links that are slow or not processing

� track MSC link activity over a period of time

Note: The MSC feature of IMSplex is not available if you are monitoring a DBCTL system.

MSC Physical LinksThe MSC Physical workspace provides a view of MSC physical links for a specific IMS subsystem.

Use the MSC Physical display to:

� monitor the link status and queue counts of your MSC physical links

� track physical link activity over a period of time

Monitoring MSC physical links

You can use the MSC Physical workspace to monitor your MSC physical links and track link activity over a period of time. For example, you may want to monitor MSC physical links with a normal link status and a queue count greater than 100.

Access the MSC Physical workspace. Notice that, by default, the view is sorted in alphabetical order by physical link name. To see the Physical Link Status and Queue Count columns, scroll as necessary.

Analyzing an MSC physical link

Page 42: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Multiple Systems Coupling

42 OMEGAMON XE for IMSplex User’s Guide, V220

You can use the IMSplex MSC Logical workspace to analyze a specific MSC physical link, and view link details for all MSC logical links assigned to the MSC physical link. For example, you may want to do a logical link analysis of a specific MSC physical link to determine if all the logical links are active.

From the MSC Physical workspace, access the MSC Logical workspace for a specific MSC physical link. The MSC Logical workspace displays the link details for all the logical links for the specified physical link. To view the link status for each logical link, scroll as necessary.

Note: You can continue your investigation of an MSC physical or logical link by using the TN3270 functionality of CNP.

MSC Logical LinksThe MSC Logical workspace displays detailed MSC link information for all logical links assigned to a specific physical link. Use the MSC Logical workspace to:

� identify all the logical links for a physical link

� view the status and queue counts of each logical link

Page 43: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

OMEGAMON XE for IMSplex Workspaces 43

OMEGAMON XE for IMSplex (default)

OMEGAMON XE for IMSplex (default)

OverviewThe section below describes various components of this workspace. For a description of the attributes used as column headings in the workspace’s table view(s), review the attribute group definitions for this workspace in the OMEGAMON XE for IMSplex online Help. Based on the information that this workspace provides, you can recommend changes, set up situations, and verify that your recommended changes improve performance.

DescriptionThe OMEGAMON XE for IMSplex (default) workspace is comprised of two views:

� Global Lock Conflicts bar chart

� Monitored IMS Systems table view

The Monitored IMS Systems table view displays the name and status of your monitored IMS systems. The Global Lock Conflicts bar chart graphically depicts elapsed time syncpoint (in seconds) and lock elapsed time (in seconds) associated with each PSB name.

Page 44: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Online TRF Class Summary

44 OMEGAMON XE for IMSplex User’s Guide, V220

Online TRF Class Summary

OverviewThe Online TRF Class Summary workspace provides a specific or global view of IMS transaction profiles.

DescriptionThis workspace provides a global view of an IMS transaction profile for a specific IMS subsystem or for all IMS subsystems. Use this workspace to:

� identify transactions that fall outside established guidelines for a transaction profile

� monitor resource utilization

� view application and code audit information

� gather information to establish transaction profiles

Page 45: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

OMEGAMON XE for IMSplex Workspaces 45

Online TRF DLI Summary

Online TRF DLI Summary

OverviewThe Online TRF DLI Summary workspace provides you with a global view of DLI resource consumption.

DescriptionThis workspace provides a global view of DLI resource consumption for a specific IMS subsystem. Use the Online TRF DLI Summary workspace to:

� view transaction DLI call profile information

� monitor transaction DLI efficiency

� identify unusual DLI activity

Page 46: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Response Time Analysis

46 OMEGAMON XE for IMSplex User’s Guide, V220

Response Time Analysis

OverviewThe Repsonse Time Analysis workspaces provide views of transaction response times for a specific IMS subsystem or for all IMS subsystems. Use the Response Time Analysis workspaces to:

� view response times of all RTA groups for multiple IMS systems

� view response time components for each RTA group

� track response time activity over a period of time

� view response time data for RTA groups when an RTA situation evaluates to true

Response Time Analysis GroupThe Response Time Analysis Group workspace provides a global view of transaction response times.

Monitoring transaction response times by RTA group

Suppose you want to monitor response times for a specific RTA group to ensure the R0 time for the group stays under 5 seconds. Access the RTA Group workspace. Notice that, by default, the view is sorted in alphabetical order by RTA group name. To locate the R0 Time column, scroll as necessary.

Investigating a true RTA situation

You may want to investigate the predefined situation IMS RTA Group Response Critical, which evaluates to true when:

R0 Time is greater than or equal to 5 seconds

OR

R1 Time is greater than or equal to 7 seconds

Access the RTA Group Analysis workspace. To see the R0 time and R1 time values, scroll as necessary. Identify the RTA groups that have an R0 time greater than or equal to 5 seconds or R1 time greater than or equal to 7 seconds.

Page 47: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

OMEGAMON XE for IMSplex Workspaces 47

Response Time Analysis

Response Time Analysis Item AnalysisThe Respnse Time Analysis Item Analysis workspace displays response time details for all RTA items in a specific RTA group.

Analyzing response time item details

You can use the RTA Item Analysis workspace to analyze the response time item details for a specific RTA group that you identify on the RTA Group Analysis workspace. For example, you may want to do an item analysis of a specific RTA group to identify which items in the group have an R0 time value greater than or equal to 5 seconds.

From the Response Time Analysis Group workspace, access the RTA Item Analysis workspace for the RTA group. The RTA Item Analysis workspace displays the response time details for all items in the RTA group. To see the R0 time values for each item, scroll to the right.

Note: You can continue your analysis of an RTA group or item by using the TN3270 functionality of CNP.

Page 48: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Shared Lterm Queues

48 OMEGAMON XE for IMSplex User’s Guide, V220

Shared Lterm Queues

OverviewThese workspaces provide you with a global view of shared Lterm queues. Using the Shared Lterm Queues workspaces you can see summary and detail information about IMS transactions that are currently on the output queue.

Shared Lterm Queues SummaryUse this workspace to see summary data for one or all IMS transactions that are currently in the output queue.

Shared Lterm Queue DetailUse this workspace to see detailed information about IMS transactions in the output queue.

Page 49: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

OMEGAMON XE for IMSplex Workspaces 49

Shared Transaction Queues

Shared Transaction Queues

OverviewThese workspaces provide you with a global view of coupling facility shared queues. Using the Shared Transaction Queues workspaces you can see information about IMS transactions that are currently on the input queue.

Shared Transaction Queues SummaryUse this workspace to view summary data for one or all IMS transactions that are currently in the input queue.

Shared Transaction Queue DetailUse this workspace to view detailed information about IMS transactions in the input queue.

Page 50: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Startup Parameters Details

50 OMEGAMON XE for IMSplex User’s Guide, V220

Startup Parameters Details

OverviewThese views provide you with a global view of IMS startup parameters. You can sort and filter information in the Startup Parameters Details workspace to change the way you view information.

DescriptionUsing the Startup Parameters Details workspace, you can view detailed settings information about the IMS startup parameters. The workspace includes a Startup Parameters Details table view, a Startup Parameters Quick View table view, and an SQ Thresholds bar chart.

Page 51: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

OMEGAMON XE for IMSplex Predefined Situations 51

OMEGAMON XE for IMSplexPredefined Situations

Chapter introductionThis chapter introduces you to the way in which you work with OMEGAMON XE for IMSplex predefined situations. For the most current information about situations, refer to Administering OMEGAMON Products: CandleNet Portal or the online help provided with CandleNet Portal.

Chapter contentsWhat Is a Situation? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52What Is a Predefined Situation? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Using Situations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

4

Page 52: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

What Is a Situation?

52 OMEGAMON XE for IMSplex User’s Guide, V220

What Is a Situation?

A situation is a logical expression involving one or more system conditions. Situations are used to monitor the condition of systems in your network. You can manage situations from CandleNet Portal by using the situation editor.

Page 53: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

OMEGAMON XE for IMSplex Predefined Situations 53

What Is a Predefined Situation?

What Is a Predefined Situation?

The Candle agents you use to monitor your system environment are shipped with a set of predefined situations that you can use as-is or modify to meet your requirements.

Predefined situations contain attributes that check for system conditions common to many enterprises. Using predefined situations can improve the speed with which you can begin using the OMEGAMON XE for IMSplex. You can examine and, if necessary, change the conditions or values being monitored by a predefined situation to those best suited to your enterprise.

Note: Candle suggests that, if you choose to modify a predefined situation, you first make a copy to ensure fallback if necessary.

Page 54: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Using Situations

54 OMEGAMON XE for IMSplex User’s Guide, V220

Using Situations

You manage situations from CandleNet Portal using the situation editor. Using the situation editor you can

� create a situation

� save a situation

� display a situation

� edit a situation

� start, stop, or delete a situation

� investigate the event workspace for a situation

When you open the situation editor, its left frame initially lists the situations associated with the Navigator item you selected. When you click a situation name or create a new situation, the right frame of the situation editor opens to provide you with the following information about the situation or to let you further define that situation:

Condition See, add to, and edit the condition being tested

Distribution See the systems to which the situation is assigned and assign the situation to systems

Expert Advice Write comments or instructions to be read in the event workspace

Action Specify a command to be sent to the system.

You can also enter take action commands by adding a take action view to a workspace, selecting Take Action from the pop-up menu for an item in the Navigator’s physical view, or creating take action commands and saving them for later use.

Until Reset a true situation when another situation becomes true or a specified time interval elapses

Page 55: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

Index 55

Index

AAdobe portable document format 9agents, remote monitoring 18alerts 18associating workspaces with attributes 28attributes

associating workspaces 28composition of 26organization of 26structure of 26understanding 26using 26

Bbuilding situations 26

CCandle Management Workstation

benefits 22CandleNet Portal

formats for information 27CF Data Sharing OSAM Details

workspace 35components of CCC 21composition of an attribute 26Coupling Facility Data Sharing Status

workspace 34Coupling Facility Data Sharing Structures

workspace 37Coupling Facility Shared Queues Structures

workspace 37Coupling Facility Structures workspace 36

Ddefining an attribute 26documentation set 6

Eemail to Candle 8evaluating

tuning decision 28event

investigating 29Event workspace, opening 29

GGlobal Lock Conflicts workspace 38

Iidentifying

system bottlenecks 28investigating an event 29

Mmanaged systems 26, 28monitoring

agents 18, 21performance 26, 28servers 18

MQSeries Status Details workspace 40MSC Logical Links workspace 42MSC Physical Links workspace 41

OOMEGAMON XE

definition 21OMEGAMON XE for IMSplex (default)

workspace 43Online TRF Class Summary workspace 44Online TRF DLI Summary workspace 45

PPDF files, adding annotations 10

Page 56: OMEGAMON XE for IMSplex User’s Guidഀ攀Ⰰ 嘀㈀㈀publib.boulder.ibm.com/.../en_US/PDF/GC32-9304-00.pdf ·  · 2004-08-19User’s Guide OMEGAMON® XE for IMSplex Version 220

R

56 OMEGAMON XE for IMSplex User’s Guide, V220

predefined situations 51printing problems 9properties

defining for a workspace 29

Rrelationship between attributes and

workspaces 28remote monitoring agents 18, 26Response Time Analysis Group

workspace 46RTA Item Analysis workspace 47

SShared Lterm Queues Detail workspace 48Shared Lterm Queues Summary

workspace 48Shared Transaction Queue Detail

workspace 49Shared Transaction Queues Summary

workspace 49Situation editor 54situations

definition 52predefined 51, 53using 54

standardization 18Startup Parameters Details workspace 50state change 28structure of an attribute 26

Ttable views 27threshold values, setting 28

Uusing workspaces 27

Vviewing

attribute information 28

Wworkspaces 27

accessing 32alphabetical list of 33CF Data Sharing OSAM Details 35Coupling Facility Data Sharing Status 34Coupling Facility Data Sharing

Structures 37Coupling Facility Shared Queues

Structures 37Coupling Facility Structures 36defining properties 29Event, opening 29Global Lock Conflicts 38introduction 32MQSeries Status Details 40MSC Logical Links 42MSC Physical Links 41OMEGAMON XE for IMSplex (default) 43Online TRF Class Summary 44Online TRF DLI Summary 45Response Time Analysis Group 46RTA Item Analysis 47Shared Lterm Queues Detail 48Shared Lterm Queues Summary 48Shared Transaction Queue Detail 49Shared Transaction Queues Summary 49Startup Parameters Details 50


Recommended