OMEGAMON XE for DB2 on z/os Version 300

Transcription

1 User s Guide OMEGAMON XE for DB2 on z/os Version 300 G August 2004 Candle Corporation 100 Sepulveda Boulevard El Segundo, California 90245

2 Registered trademarks and service marks of Candle Corporation: AF/OPERATOR, AF/REMOTE, Availability Command Center, Candle, Candle CIRCUIT, Candle Command Center, Candle Direct logo, Candle edelivery, Candle Electronic Customer Support, Candle logo, Candle Management Server, Candle Management Workstation, CandleLight, CandleNet, CandleNet Command Center, CandleNet ebusiness Platform, CandleNet Portal, CL/CONFERENCE, CL/SUPERSESSION, CommandWatch, CT, CT/Data Server, CT/DS, DELTAMON, DEXAN, eba, eba*servicemonitor, eba*servicenetwork, ebusiness at the speed of light, ebusiness Assurance, ebusiness Institute, ELX, EPILOG, ESRA, ETEWatch, IntelliWatch, IntelliWatch Pinnacle, MQSecure, MQView, OMEGACENTER, OMEGAMON, OMEGAMON II, OMEGAMON Monitoring Agent, OMEGAMON Monitoring Agents, OMEGAVIEW, OMEGAVIEW II, PQEdit, Response Time Network, Roma, SitePulse, Solutions for Networked Applications, Solutions for Networked Businesses, TMA2000, Transplex, and Volcano. Trademarks and service marks of Candle Corporation: AF/Advanced Notification, AF/PERFORMER, Alert Adapter, Alert Adapter Plus, Alert Emitter, AMS, Amsys, AutoBridge, AUTOMATED FACILITIES, Availability Management Systems, Business Services Composer, Candle Alert, Candle Business Partner Logo, Candle Command Center/SentinelManager, Candle CommandPro, Candle esupport, Candle Insight, Candle InterFlow, Candle Managing what matters most, Candle Service Suite, Candle Technologies, CandleNet, CandleNet 2000, CandleNet Conversion, CandleNet ebp, CandleNet ebp Access for S.W.I.F.T., CandleNet ebp Administrator, CandleNet ebp Broker Access for Mercator or MQSI, 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, Candle Vision, CCC, CCP, CCR2, 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, e2e, eba*se, ebaa, ebaauditor, eban, ebanetwork, ebaapractice, ebp, ebusiness Assurance Network, ebusiness at the speed of light, ebusiness at the speed of light logo, ebusiness Exchange, ebx, End-to-End, enotification, ENTERPRISE, Enterprise Candle Command Center, Enterprise Candle Management Workstation, Enterprise Reporter Plus, ER+, ERPNet, ETEWatch Customizer, HostBridge, InterFlow, Candle InterFlow, Lava Console, Managing what matters most, MessageMate, Messaging Mastered, Millennium Management Blueprint, MMNA, MQADMIN, MQEdit, MQEXPERT, MQMON, NBX, NC4, NetGlue, NetGlue Extra, NetMirror, NetScheduler, New Times, New Team, New Readiness, OMA, OMC Gateway, OMC Status Manager, OMEGACENTER Bridge, OMEGACENTER Gateway, OMEGACENTER Status Manager, OMEGAMON/e, OMEGAMON Management Center, OSM, PathWAI, PC COMPANION, Performance Pac, Powered by Roma Technology, PowerQ, PQConfiguration, PQScope, 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, Tracer, Unified Directory Services, WayPoint, and ZCopy. Trademarks and registered trademarks of other companies: AIX, DB2, MQSeries and WebSphere are registered trademarks of International Business Machines Corporation. Citrix, WinFrame, and ICA are registered trademarks of Citrix Systems, Inc. Multi-Win and MetaFrame are trademarks of Citrix Systems, Inc. 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 may be trademarks or registered trademarks of their respective owners. Copyright August 2004, 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 XE for DB2 on z/os User s Guide, Version 300

3 Contents List of Tables Preface Documentation Set Adobe Portable Document Format What s New Chapter 1. Introducing OMEGAMON XE for DB2 on z/os OMEGAMON XE for DB2 on z/os Operating Environment OMEGAMON XE for DB2 on z/os How OMEGAMON XE for DB2 on z/os Assists You Chapter 2. Learning About OMEGAMON XE for DB2 on z/os Understanding OMEGAMON XE for DB2 on z/os Attributes Understanding OMEGAMON XE for DB2 on z/os Information Understanding OMEGAMON XE for DB2 on z/os Situations and Events Using CandleNet Portal to Work with Workspaces Using CandleNet Portal to Work with Situations Chapter 3. Introducing OMEGAMON XE for DB2 on z/os Workspaces.. 45 OMEGAMON XE for DB2 on z/os Workspaces Using CandleNet Portal to Navigate Between Workspaces Chapter 4. Buffer Pool Workspaces Buffer Pool Details Workspace Buffer Pool Management Workspace Chapter 5. CICS Workspaces CICS Connections Workspace CICS Threads Workspace

4 Chapter 6. Coupling Facility Structures Workspace Group Introducing the Coupling Facility Structures Workspaces Coupling Facility Structures Workspace Coupling Facility Connections Workspace Typical Scenarios Chapter 7. DDF Workspaces DDF Conversations Workspace DDF Statistics Workspace Chapter 8. Detailed Thread Exception Workspace Detailed Thread Exception Workspace Chapter 9. EDM Pool Workspace EDM Pool Workspace Chapter 10. GOA Volume Workspace Group Introducing the GOA Volume Workspace Group GOA Volume Workspace GOA Volume Database Workspace GOA Volume Spacename Workspace GOA Volume Spacename Detail Workspace Typical Scenarios Chapter 11. GOA Thread Database Workspace Group Introducing the GOA Thread Database Workspaces GOA Thread Database Workspace GOA Thread Spacename Workspace GOA Thread Spacename Detail Workspace Typical Scenario Chapter 12. GOA Volume Thread Workspace Group Introducing GOA Volume Thread Workspaces GOA Volume Thread Workspace GOA Volume Thread Detail Workspace Typical Scenario OMEGAMON XE for DB2 on z/os User s Guide, Version 300

5 Chapter 13. Global Lock Conflicts Workspace Introducing the Global Lock Conflicts Workspace Typical Scenarios Chapter 14. Group Buffer Pool Statistics Workspace Group Introducing the Group Buffer Pool Statistics Workspaces Group Buffer Pool Statistics Workspace Detailed Group Buffer Pool Statistics Workspace Typical Scenarios Chapter 15. Group Buffer Pool Structures Workspace Group Introducing the Group Buffer Pool Structures Workspaces Group Buffer Pool Structures Workspace Group Buffer Pool Connections Workspace Typical Scenarios Chapter 16. Group Object Activity Database Workspace Group Introducing the Group Object Activity Database Workspaces Group Object Activity Database Workspace Group Object Activity by Spacename Workspace Group Object Activity by Spacename Detail Workspace Typical Scenarios Chapter 17. IMS Workspaces IMS Connections Workspace IMS Region Information Workspace Chapter 18. Log Manager Workspace Log Manager Workspace Chapter 19. Monitored Systems Summary Workspace Introducing the Monitored Systems Summary Workspace Typical Scenarios Chapter 20. Object Analysis Database Workspace Group Introducing the Object Analysis Database Workspace Group Object Analysis Database Workspace

6 Object Analysis Spacename Workspace Object Analysis Spacename Detail Workspace Typical Scenario Chapter 21. Subsystem Management Workspace Subsystem Management Workspace Chapter 22. System Status Workspace System Status Workspace Chapter 23. Thread Activity Workspace Group Introducing the Thread Activity Workspaces Thread Activity Workspace Thread Statistics Workspace Typical Scenarios Chapter 24. Utility Jobs Workspace Utility Jobs Workspace Chapter 25. Volume Activity Workspace Volume Activity Workspace Chapter 26. OMEGAMON XE for DB2 on z/os Situations Situations Delivered with OMEGAMON XE for DB2 on z/os Coupling Facility Situation Definitions Database Locks Situation Definitions Group Buffer Pool Predefined Situation Definitions Threads Situation Definitions DB2 Command Situation Definitions Index OMEGAMON XE for DB2 on z/os User s Guide, Version 300

7 List of Tables Table 1. Product Features Table 2. Organization of OMEGAMON XE for DB2 on z/os Information Table 3. OMEGAMON XE for DB2 on z/os Workspaces Table 4. Coupling Facility Structures Workspaces Table 5. GOA Volume Workspaces Table 6. GOA Thread Database Workspaces Table 7. GOA Volume Thread Workspaces Table 8. Group Buffer Pool Statistics Workspaces Table 9. Group Buffer Pool Structures Workspaces Table 10. Group Object Activity Database Workspaces Table 11. Object Analysis Database Workspaces Table 12. Thread Activity Workspaces

8 10 OMEGAMON XE for DB2 on z/os User s Guide, Version 300

9 P Preface Introduction This guide provides detailed information about the OMEGAMON XE for DB2 on z/os product and its workspaces. Who should use this guide This guide serves the following audiences: operators system programmers system administrators network administrators Candle sales force and field support Why you should use this guide This guide will help you understand how to use OMEGAMON XE to monitor your DB2. The guide supplements the OMEGAMON XE online help. Candle recommends that you reference this guide whenever you need additional information about the OMEGAMON XE for DB2 on z/os product and workspaces. 11

10 Documentation Set Documentation Set Overview Candle provides this User s Guide for OMEGAMON XE for DB2 on z/os. This manual supplements the online help provided with the product. You may wish to review manuals that comprise the OMEGAMON II for DB2 documentation set These manuals are useful should you need to review information provided by the underlying OMEGAMON II for DB2, Version 540 product. Where to look for more information For more information related to 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 online help provided with this and the other related products. 12 OMEGAMON XE for DB2 on z/os User s Guide, Version 300

11 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 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 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. 13

12 Adobe Portable Document Format 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 Adding annotations to PDF files If 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. 14 OMEGAMON XE for DB2 on z/os User s Guide, Version 300

13 15

14 16 OMEGAMON XE for DB2 on z/os User s Guide, Version 300

15 W What s New OMEGAMON XE for DB2 on z/os, Version 300 With Version 300, OMEGAMON XE for DB2 on z/os includes all the functionality of OMEGAMON XE for DB2plex, Version 220, as well as the functionality of OMEGAMON XE for DB2, Version 100. After installing OMEGAMON XE for DB2 on z/os, you can view the workspaces, attributes, and situations that make up both products. Additionally, with Version 300, OMEGAMON XE for DB2 on z/os provides support for Version 8 of the IBM DB2 product. Note: Version 8 of DB2 does not support hiperpools. If you use Version 8, the workspace fields for hiperpools will not display any data. 17

16 18 OMEGAMON XE for DB2 on z/os User s Guide, Version 300

17 1 Introducing OMEGAMON XE for DB2 on z/os Introduction This chapter introduces you to OMEGAMON XE for DB2 on z/os. It includes information about the DB2 product, user interface, and this release of DB2. Chapter contents OMEGAMON XE for DB2 on z/os Operating Environment OMEGAMON XE for DB2 on z/os How OMEGAMON XE for DB2 on z/os Assists You Introducing OMEGAMON XE for DB2 on z/os 19

18 OMEGAMON XE for DB2 on z/os Operating Environment OMEGAMON XE for DB2 on z/os Operating Environment Overview OMEGAMON XE for DB2 on z/os can help you to address the increasing challenges presented by today s technical environment. OMEGAMON XE assists you to better manage the performance of the systems that comprise your operating environment. In this unit you learn about the operating environment in which OMEGAMON XE for DB2 on z/os resides. What is OMEGAMON XE? OMEGAMON XE is a suite of products that assist you in monitoring your mainframe and distributed systems on a variety of platforms using a variety of workstations. OMEGAMON XE 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 workspaces 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 workspaces about system conditions create policies, which are a collection of activities that help you automate responses to events or routine operator tasks monitor for alerts on the systems and platforms you are managing trace the causes leading up to an alert 20 OMEGAMON XE for DB2 on z/os User s Guide, Version 300

19 OMEGAMON XE for DB2 on z/os Operating Environment OMEGAMON XE components OMEGAMON XE is a client-server-agent implementation that includes a client, that can be a CandleNet Portal workstation a Candle Management Workstation, used to manage work groups and work lists, data items, and managed system lists an OMEGAMON II product using a 3270 terminal session a server, known as the Candle Management Server (CMS ) 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. OMEGAMON XE for DB2 on z/os is such an agent. An additional feature package, OMEGAMON DE is available with OMEGAMON XE. This feature package provides all the capability of OMEGAMON XE, plus additional capabilities as described later in this chapter. What is CandleNet Portal? CandleNet Portal is a user interface that provides a birds-eye view of your enterprise that you can zoom into for a closer look. The 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. A CandleNet Portal table view is analogous to a CMW workspace. Like the CMW, CandleNet Portal permits you to view the results of evaluating situations at regular intervals to check that your applications and system resources are 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. Introducing OMEGAMON XE for DB2 on z/os 21

20 OMEGAMON XE for DB2 on z/os Operating Environment What is the Candle Management Workstation? The Candle Management Workstation (CMW) is an interface you use to manage work groups and work lists, data items, and managed system lists. Further Information about CandleNet Portal and the CMW Candle provides a complete set of documentation for OMEGAMON XE for DB2. Each manual contains a specific type of information to help you use the product. Relevant manuals are the product libraries for CandleNet Portal and Candle Management Workstation the installation documentation appropriate for your environment the online help for CandleNet Portal and the Candle Management Workstation What is OMEGAMON DE? The 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 OS/390. OMEGAMON DE provides all the capability of OMEGAMON XE, plus these additional capabilities: Multiple applications can be displayed 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. 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. 22 OMEGAMON XE for DB2 on z/os User s Guide, Version 300

21 OMEGAMON XE for DB2 on z/os Operating Environment You can define enterprise-specific Navigator views The Navigator physical view shows the hierarchy of your managed enterprise by operating platform and type of Candle agent. The Navigator business view shows the hierarchy of any managed objects defined through the CMW. You can also define Navigator views for any logical grouping, such as a departmental or site hierarchy. You can define a graphic view The graphic view enables you to retrieve and display real-time monitoring data from Candle agents. Using the graphic view, you can create a background image or import one, then place objects (Navigator items) on the image or have it done automatically using geographical coordinates. You can zoom in and you can add such graphics as floor plans and organization charts. You can integrate information provided by Candle s Universal Agent Candle s Universal Agent is an agent you can configure to monitor any data you collect. It lets you integrate data from virtually any platform and any source, such as custom applications, databases, systems, and subsystems. Your defined data providers are listed in the Navigator, and default workspaces are automatically created. OMEGAMON DE Policy Management adds automation capabilities. The Workflow editor enables you to design sets of automated system processes, called policies, to resolve system problems. A policy performs actions, schedules work to be performed by users, or automates manual tasks. Detailed information about OMEGAMON DE is provided in the CandleNet Portal online help. About the Workflow Editor If your product supports the use of the Workflow Editor, you can find information about its use in CandleNet Portal help and Using 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. Your OMEGAMON Alert Manager includes support for emitter activity programs, which can also be included in policies. Introducing OMEGAMON XE for DB2 on z/os 23

22 OMEGAMON XE for DB2 on z/os OMEGAMON XE for DB2 on z/os Overview In this unit you learn about the OMEGAMON XE for DB2 on z/os product features. OMEGAMON XE for DB2 on z/os can help you to address the increasing challenges in today s ever changing technical environment and to better manage the performance of your system. Product features OMEGAMON XE for DB2 on z/os brings a consolidated view of multiple DB2 systems to your workstation. It helps you monitor and gather consistent, accurate, and timely information that you need to effectively perform your job The following table shows the primary components of OMEGAMON XE for DB2 on z/os. Table 1. Product Features Feature Product-specific workspaces Product-specific attributes Predefined situations Description Provide real-time information about DB2 system performance Provide characteristics, information, or properties about your DB2 managed systems Provide predefined situations to begin monitoring managed systems immediately Using OMEGAMON XE for DB2 on z/os OMEGAMON XE for DB2 on z/os offers a central point of management for DB2 and provides a comprehensive means for gathering the information you need to detect and prevent problems with your DB2 systems. 24 OMEGAMON XE for DB2 on z/os User s Guide, Version 300

23 OMEGAMON XE for DB2 on z/os OMEGAMON XE lets you easily collect and analyze DB2-specific information, including: thread activity and statistics database lock conflict information coupling facility structure utilization group buffer pool structure utilization group buffer pool statistics object analysis allocation group object activity information volume use information With OMEGAMON XE for DB2 on z/os, system administrators can set threshold levels and flags to alert them when the system reaches these thresholds. Advanced monitoring facilities OMEGAMON XE for DB2 on z/os includes advanced monitoring facilities. User-defined and predefined situations based on thresholds to raise different types of alerts: critical, warning, and others At-a-glance status picture of all database servers The capability to monitor multiple servers simultaneously from one or more centralized workstations Planning and installation For information on planning for and installing OMEGAMON XE for DB2 on z/os, refer to the appropriate Candle installation manual. User interface OMEGAMON XE for DB2 on z/os can use the standard CandleNet Portal interface on Windows Introducing OMEGAMON XE for DB2 on z/os 25

24 How OMEGAMON XE for DB2 on z/os Assists You How OMEGAMON XE for DB2 on z/os Assists You Product Benefits OMEGAMON XE for DB2 on z/os provides several benefits. Simplifies application and system management by managing applications, platforms, and resources across your system. Increases 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. Enhances system performance by letting you integrate, monitor, and manage your system, environment, console, and mission-critical applications. OMEGAMON XE for DB2 on z/os alerts your system administrator when conditions in your environment meet threshold-based conditions. These alerts permit your system administrator to limit and to control system traffic. You can view data that OMEGAMON XE for DB2 on z/os gathers in workspaces that inform you of the status of your DB2 managed systems. Historical Data Collection You can use the facilities of CandleNet Portal s historical data collection function to store and save the data being collected by your OMEGAMON XE for DB2 agent or agents. The historical data collection function permits you to specify the attribute group or groups for which data is to be collected the interval at which data is to be collected the interval at which data is to be warehoused (if you choose to do so) the location (either at the agent or at the CMS) at which the collected data is to be stored Information about using the Historical Data Collection function can be found in the CandleNet Portal online Help and in the Historical Data Collection Guide for OMEGAMON XE and CandleNet Command Center. 26 OMEGAMON XE for DB2 on z/os User s Guide, Version 300

25 2 Learning About OMEGAMON XE for DB2 on z/os Introduction This chapter introduces you to the OMEGAMON XE for DB2 on z/os attributes, and predefined situations, and describes the information OMEGAMON XE for DB2 on z/os provides to assist you in monitoring your environment. Chapter contents Understanding OMEGAMON XE for DB2 on z/os Attributes Understanding OMEGAMON XE for DB2 on z/os Information Understanding OMEGAMON XE for DB2 on z/os Situations and Events 31 Using CandleNet Portal to Work with Workspaces Using CandleNet Portal to Work with Situations Learning About OMEGAMON XE for DB2 on z/os 27

26 Understanding OMEGAMON XE for DB2 on z/os Attributes Understanding OMEGAMON XE for DB2 on z/os Attributes Overview In this unit you learn about the OMEGAMON XE for DB2 on z/os attributes. Using OMEGAMON XE for DB2 on z/os attributes OMEGAMON XE for DB2 on z/os gathers data from remote agents residing on the managed systems of your DB2 network and stores this data in system elements called attributes. You can use OMEGAMON XE for DB2 on z/os attributes to build situations that monitor the performance of your DB2 network. To use OMEGAMON XE for DB2 on z/os attributes effectively, you must first understand the organization of an attribute. An attribute is made up of an attribute group and an attribute item. An attribute group refers to a unique characteristic of the data that is stored in the attribute. An attribute item stores data for a particular property of an attribute group. Thus this example attribute DB2_Lock_Conflict.Lock_Elapsed_Time comprises an attribute item, Lock_Elapsed_Time, that stores lock elapsed time data for the attribute group DB2_Lock_Conflict. For more information on attributes See the online help for OMEGAMON XE for DB2 on z/os for a complete description of each of the attribute groups and its attributes. 28 OMEGAMON XE for DB2 on z/os User s Guide, Version 300

27 Understanding OMEGAMON XE for DB2 on z/os Information Understanding OMEGAMON XE for DB2 on z/os Information Overview In this unit you learn about the information OMEGAMON XE for DB2 on z/os provides. OMEGAMON XE for DB2 on z/os information is displayed in CandleNet Portal in named workspaces. Within a given workspace, information may appear 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 charts, graphs, or other formats you can specify. Using OMEGAMON XE for DB2 on z/os information OMEGAMON XE for DB2 on z/os provides the ability to view information about each DB2 managed system that you are monitoring. You can use this information to monitor the performance of each DB2 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. Associating OMEGAMON XE for DB2 on z/os workspaces with attributes There is a direct relationship between OMEGAMON XE for DB2 on z/os attributes and workspaces. An attribute group corresponds to a workspace and attribute items correspond to workspace columns. For example, the Global Lock Conflicts workspace contains information that is collected in and represented by the DB2_Lock_Conflict attribute group. The DB2_Lock_Conflict.Lock_Elapsed_Time attribute item contains the information that is displayed in the Elapsed Time workspace column. Learning About OMEGAMON XE for DB2 on z/os 29

28 Understanding OMEGAMON XE for DB2 on z/os Information Each workspace displays real-time information for many of the DB2attributes. The DB2 workspaces are available to you, independent of whether you are using OMEGAMON XE for DB2 on z/os to monitor situations. For more information on workspaces For detailed information about working with OMEGAMON XE for DB2 on z/os information, see Using CandleNet Portal to Work with Workspaces on page OMEGAMON XE for DB2 on z/os User s Guide, Version 300

29 Understanding OMEGAMON XE for DB2 on z/os Situations and Events Understanding OMEGAMON XE for DB2 on z/os Situations and Events Overview In this unit you learn about OMEGAMON XE for DB2 on z/os situations that are shipped with the product. When using CandleNet Portal, you will see these referred to as predefined situations. Situations and Events A situation describes a condition you want to test. OMEGAMON XE for DB2 on z/os compares the situation with the values collected by the monitoring agent and raises an event if the condition is met. Every Candle agent comes with a set of predefined situations so you can begin monitoring as soon as you start using OMEGAMON XE for DB2 on z/os. You can edit these situations to match your environment or create your own. You can read a situation as, If this condition exists, then the situation is true. Associated with every situation is an event indicator. When the condition described in the situation becomes true, the event is raised. Event indicators can be critical, warning, or informational. A user monitoring the network for events can acknowledge an event to indicate it has been seen and the problem is being addressed. Using OMEGAMON XE for DB2 on z/os situations You can use the OMEGAMON XE for DB2 on z/os situations shipped with the product to begin monitoring your DB2 managed systems immediately as models for creating your own situations to monitor and manage, through localized automation, widely dispersed resources You can modify the situations you receive to contain values more appropriate for your system. However, Candle recommends that before changing these situations, you make a copy and keep that copy unmodified so that you can revert to the original situations should the need arise. Learning About OMEGAMON XE for DB2 on z/os 31

30 Understanding OMEGAMON XE for DB2 on z/os Situations and Events Most of the OMEGAMON XE for DB2 on z/os predefined situations have an alert status of either Critical or Warning. Information about OMEGAMON XE for DB2 on z/os Situations For more information on predefined situations, see the product s online help. See also OMEGAMON XE for DB2 on z/os Situations on page OMEGAMON XE for DB2 on z/os User s Guide, Version 300

31 Using CandleNet Portal to Work with Workspaces Using CandleNet Portal to Work with Workspaces Overview This unit provides a high-level overview of working with workspaces while using CandleNet Portal. For the most current in-depth information, refer to the online help provided with CandleNet Portal. The workspace is the working area in which CandleNet Portal presents information. As you select items, 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. Be aware that the changes you make to the workspace are lost when you switch to another workspace unless you Save them first. Another way to customize the workspace is to change the type of view or to add views to the workspace. Formats for CandleNet Portal information OMEGAMON XE information can be presented to you in any of the views below: Table view Pie chart view Bar chart view Plot chart view 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. Learning About OMEGAMON XE for DB2 on z/os 33

32 Using CandleNet Portal to Work with Workspaces Browser view, that permits you to open a browser to see HTML pages and Web sites. Opening a workspace Opening the default workspace Most items in the Navigator have a default workspace associated with them. Some items have multiple workspaces you can open, although only one workspace can be open in the CandleNet Portal application window at one time. To open the default workspace, in the Navigator, click the item name or its icon. Opening multiple workspaces CandleNet Portal enables you to have multiple workspaces for an item. If the Navigator item has more than one workspace associated with it, use View > Workspace to see and select from a list of alternate workspaces. Refreshing or reloading a workspace Once a workspace is open, it is not refreshed automatically. Rather, CandleNet Portal refreshes the table and chart views in the workspace only when you manually request they be refreshed or when the workspace is reloaded. You can, however, choose to automate the refresh at specified intervals. When choosing automatic refresh for a workspace, you should consider the impact of the refresh on system resources. To define automatic refresh for a workspace: 1. Open the View menu, then point to Refresh Every. 2. Click 5, 10, 15, 30, or 60 seconds, or On Demand. To refresh a workspace manually with the latest information, click Refresh. To manually reload the saved workspace and refresh the monitoring data, click Reload. Note that, if you made any changes to the workspace properties without saving them, the changes will be lost when a reload occurs. 34 OMEGAMON XE for DB2 on z/os User s Guide, Version 300

33 Using CandleNet Portal to Work with Workspaces Suspending or stopping a workspace CandleNet Portal receives monitoring data from the agents at timed intervals and, if you have defined automatic refresh for the workspace, refreshes the table and chart views in the workspace. The refreshes use system resources. You can control when the views are refreshed by suspending the refresh. You can also stop loading the workspace if it is not what you want or you plan to change it. To stop refreshing, click Suspend. You can then manually refresh the workspace, or you can click Resume to resume automatic refresh. To stop loading a workspace, click the CandleNet Portal Stop icon. Note that clicking your browser s Stop icon will not stop the loading of a CandleNet Portal workspace. Editing a workspace Your CandleNet Portal product comes with a set of predefined workspaces for every item in the Navigator's physical map. You can edit any of these workspaces to suit your environment. The changes you can make to a workspace include the following: Split a view horizontally or vertically into two separate views. Change the dimensions of the views by dragging the borders between them. Change a view to a different type, such as from a pie chart to a thermometer gauge. Edit the properties of any view to change the data displayed and how the view is styled. Build a link to another workspace so that you can link to the other workspace from this one at any time. Remove a view from the workspace. The adjacent view enlarges to fill the gap. When you are finished editing a workspace you must save your changes either as the current workspace or as a new workspace. If you do not save your changes, they will be lost when you open another workspace or end your work session. Learning About OMEGAMON XE for DB2 on z/os 35

34 Using CandleNet Portal to Work with Workspaces Any changes you make to a workspace are available to all other users on the network having the same ID. Saving the workspace Whatever changes you make to the workspace properties, such as adding or editing a view, are only temporary. They will be lost when you open another workspace or exit CandleNet Portal, unless you save the workspace. You can also save multiple workspaces for the same Navigator item. Click Save to replace the original workspace with the current workspace. If you do not want to replace the original workspace, save the current workspace under a new name. If this is a new workspace: 1. Open the File menu and select Save Workspace As. 2. Type a name for the new (modified) workspace in the text box and click OK. The name you specify must not be the same as the name of the predefined workspace that you modified. Result: The workspace is saved with the name you specify, and is available to all of your managed systems of the same managed system type. Note: The saved workspace is associated with your CandleNet Portal user ID. Users with a different ID will not see your changes. If you have edited the workspace but do not want to save your workspace, you can reload the saved workspace as described on page 34. Linking workspaces Some of your product s predefined workspaces may be linked to other related workspaces. Linking workspaces is a quick method for going from one workspace to another related workspace quickly. You can link from one workspace to another from the Navigator. Simply right-click on a workspace. In the pop-up window that appears, select the workspace to which you want to link. While using a workspace s table view, you can right-click within a cell in the table to display existing links to other related workspaces. 36 OMEGAMON XE for DB2 on z/os User s Guide, Version 300

35 Using CandleNet Portal to Work with Workspaces When a link is predefined for a row in a table view, an icon appears to the left of each row in the table. (The icon resembles two links in a chain.) When the icon is not shaded out, the link is valid for the row. The user can left-click the icon to navigate instantly to the next workspace. Right-clicking on the icon causes a pop-up menu to appear, showing all the links defined for the row. From this menu, you can select from the list of links or change the default link. You can define your own links using the Link Wizard by following the directions in CandleNet Portal s online help. Once a link is defined, you can link to the subject workspace from another workspace, edit the link, or remove a link definition. Note that the link will not be saved until the subject workspace is saved. Defining workspace properties Every workspace has properties for its views. You can right-click in an open view or any item in the Navigator to select and open the Properties editor. The Properties tree has a Views folder with folders for each type of view in the workspace. To edit the properties of a view, click its icon in the Properties tree. The properties open in the right frame with some or all of the following tabs: Query Filters Thresholds Configuration Style Specify what data should go in the chart or table Refine the view by filtering out unwanted data from the chart or table Establish threshold values and color indicators for a table view Specify the script to run or the connection to make whenever you open the terminal view Change the behavior and appearance of the view Opening an event workspace When the conditions of a situation have been met, an event indicator appears in the Navigator. You can investigate the event by opening its workspace. Learning About OMEGAMON XE for DB2 on z/os 37

36 Using CandleNet Portal to Work with Workspaces 1. In the Navigator move the mouse pointer over the alert indicator to open a flyover listing of the event (or events if the item has more than one true situation). 2. In the flyover listing click a situation name to open its workspace. Result: The Navigator moves to the event location and shows the situation name, and its event workspace opens. The event workspace shows two table views, one with the values of the attributes when the situation fired, and the other with their current values. It 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. Filtering information Filtering of OMEGAMON XE for DB2 on z/os information is accomplished in CandleNet Portal by linking from rows within the summary table view at the highest level of the workspace hierarchy to progressively lower-level workspaces. To link from a specific row, right-click within any cell in the row, then select Link to from the pop-up menu that CandleNet Portal displays. Selecting Link to causes a list of lower-level workspaces to be displayed. Select the one you want from the list. You know you have reached the bottom of a hierarchical group if Link to does not appear in the pop-up menu when you right-click in a row of a table view. Similarly, you will not be given the opportunity to link to a workspace that does not contain any meaningful data. For example, Link to will not provide a link to the Database Locks workspace if the current row of the summary table has a lock count of 0. Within a given workspace, the filtering criteria used to limit the data that is displayed are shown in the footer line of the workspace s table view. As you navigate further down the hierarchy, the amount of information in the footer tends to increase. To 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 to determine which rows to display. To save your filtering specifications, you must save the workspace before exiting. 38 OMEGAMON XE for DB2 on z/os User s Guide, Version 300

37 Using CandleNet Portal to Work with Workspaces Sorting Information Sorting is handled by simply clicking on a column heading. Click once and the workspace will be sorted in ascending order. Clicking a second time will resort the workspace into descending order. A third click returns you to the workspace s default sort. Learning About OMEGAMON XE for DB2 on z/os 39

38 Using CandleNet Portal to Work with Situations Using CandleNet Portal to Work with Situations Overview The Candle agent or agents that come with your OMEGAMON XE product have a set of predefined situations that you can use as-is or modify to meet your requirements. This unit provides a high-level overview of working with situations while using CandleNet Portal. For the most current in-depth information, refer to the online help provided with CandleNet Portal. The Situation editor You can display predefined situations and create your own situations using the Situation editor. The way to perform these functions is described below. The left frame of the Situation editor 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 opens with the following tabs: Condition Distribution Expert Advice Action Until See, add to, and edit the condition being tested See the systems to which the situation is assigned and assign the situation to systems Write comments or instructions to be read in the event workspace Specify a command to be sent to the system Reset a situation when another situation becomes true or after a specified time period. The Situation editor buttons let you Apply your changes by saving and starting the situation, and exit with (OK) or without (Cancel) saving your changes. Note that if you plan to edit multiple situations while in the Situation editor, click Apply after editing one situation to save your changes before selecting the next situation to edit (or creating a new one). Create a situation You can create and customize your own situations to monitor specific conditions in your enterprise. 40 OMEGAMON XE for DB2 on z/os User s Guide, Version 300