omegamon xe for mainframe networks,ഀ 唀猀攀爠ᤀ猀䜀甀椀搀攀...

User’s GuideOMEGAMON® XE

for Mainframe Networks

Version 100

GC32-9307-00

May 2002

Candle Corporation201 North Douglas Street

El Segundo, California 90245-9796

2 OMEGAMON XE for Mainframe Networks User’s Guide, V100

Registered trademarks and service marks of Candle Corporation: AF/OPERATOR, AF/PERFORMER, AF/REMOTE, Availability Command Center, Candle, Candle Command Center, Candle Direct logo, Candle Electronic Customer Support, Candle logo, Candle Management Server, Candle Management Workstation, Candle Technologies, CL/CONFERENCE, CL/SUPERSESSION, CommandWatch, CT, CT/Data Server, CT/DS, DELTAMON, eBA, eBA*ServiceMonitor, eBA*ServiceNetwork, eBusiness 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 Command Center, CandleNet eBP, CandleNet eBP Access, CandleNet eBP Administrator, CandleNet eBP Broker Access, CandleNet eBP Configuration, CandleNet eBP Connector, CandleNet eBP File Transfer, CandleNet eBP Host Connect, CandleNet eBP Object Access, CandleNet eBP Object Browser, CandleNet eBP Secure Access, CandleNet eBP Service Directory, CandleNet eBP Universal Connector, CandleNet eBP Workflow Access, CandleNet eBusiness Assurance, CandleNet eBusiness Exchange, CandleNet eBusiness Platform, CandleNet eBusiness Platform Administrator, CandleNet eBusiness Platform Connector, CandleNet eBusiness Platform Connectors, CandleNet eBusiness Platform Powered by Roma Technology, CandleNet eBusiness Platform Service Directory, CandleNet Portal, CCC, CCP, CEBA, CECS, CICAT, CL/ENGINE, CL/GATEWAY, CL/TECHNOLOGY, CMS, CMW, Command & Control, Connect-Notes, Connect-Two, CSA ANALYZER, CT/ALS, CT/Application Logic Services, CT/DCS, CT/Distributed Computing Services, CT/Engine, CT/Implementation Services, CT/IX, CT/Workbench, CT/Workstation Server, CT/WS, !DB Logo, !DB/DASD, !DB/EXPLAIN, !DB/MIGRATOR, !DB/QUICKCHANGE, !DB/QUICKCOMPARE, !DB/SMU, !DB/Tools, !DB/WORKBENCH, Design Network, DEXAN, e2e, eBAA, eBAAuditor, eBAN, eBANetwork, eBAAPractice, eBP, eBusiness Assurance 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 © April 2002, Candle Corporation, a California corporation. All rights reserved. International rights secured.

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

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

Contents 3

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Adobe Portable Document Format . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

What’s New . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Chapter 1. Introducing OMEGAMON XE for Mainframe Networks . . . . . . 13OMEGAMON XE for Mainframe Networks . . . . . . . . . . . . . . . . . . . . 14OMEGAMON XE for Mainframe Networks Operating Environment . 17

Chapter 2. Learning about OMEGAMON XE for Mainframe Networks . . . 21Understanding Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Understanding OMEGAMON XE for Mainframe Networks . . . . . . . . 23

Chapter 3. OMEGAMON XE for Mainframe Networks Workspaces . . . . . . 27Introducing OMEGAMON XE for Mainframe Networks Workspaces . 28Address Space Workspace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Applications Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Connections Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Gateways and Devices Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . 35Node Summary Workspace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Chapter 4. OMEGAMON XE for Mainframe Networks Predefined Situations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Introduction to Situations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Using Predefined Situations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Contents


Appendix A. Guide to Candle Customer Support . . . . . . . . . . . . . . . . . . . . . 43Base Maintenance Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Enhanced Support Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48Customer Support Contact Information. . . . . . . . . . . . . . . . . . . . . . . 50

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Preface 5

Preface

This user’s guide describes how to use OMEGAMON® XE for Mainframe Networks to monitor availability and performance of mainframe networks. This guide will help you

n become familiar with the predefined workspaces that report on your mainframe network systems

n anticipate and detect problems in using your mainframe network environment

n access specific information about events occurring in your environment

P

About This Book


About This Book

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

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

This manual assumes that you

n have installed CandleNet Portal™n have installed OMEGAMON XE for Mainframe Networks

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

If you are unfamiliar with these concepts and tasks, please review the Administering OMEGAMON XE Products: CandleNet® Portal. 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 OMEGAMON XE for Mainframe Networks. Each of these sources contains a specific type of information to help you use the product. Relevant manuals are the

n OMEGAMON XE for Mainframe Networks User’s Guide, N354-6522

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

n OMEGAMON XE for Mainframe Networks V100 Configuration and Customization Guide N351-6556

Describes how to configure and customize OMEGAMON XE for Mainframe Networks.

n the documentation for CandleNet Portal that came with your OMEGAMON XE for Mainframe Networks product

Preface 7

About This Book

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

n the documentation for OMEGAMON XE that came with your OMEGAMON XE for Mainframe Networks product

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

n the installation documentation that came with your OMEGAMON XE for Mainframe Networks 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

n technical documentation CD-ROM that came with your product

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

n online help provided with this and the other related products

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

About This Book


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 Mainframe Networks User’s Guide, V100” in the subject line.

Preface 9

Adobe Portable Document Format


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

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

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

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

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

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

driver and printer should be the same. A setting of 300 dpi is recommended.)

n the printer driver you are using. (You may need a different printer driver or the Universal Printer driver from Adobe. This free printer driver is available at www.adobe.com.)

n the halftone/graphics color adjustment for printing color on black and white printers (check the printer properties under Start > Settings > Printer). For more information, see the online help for the Acrobat Reader.

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

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



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

http://www.adobe.com



What’s New 11

What’s New

Candle monitoring agents have a new nameCandle’s intelligent monitoring agents that comprise the OMEGAMON XE suite of products and use the CandleNet Portal user interface have been renamed. You will see the new names in the product help and documentation.

Within the application, some of the panels do not reflect the new product name. However, all of the intelligent functionality of OMEGAMON XE is available for these agents. The new product names will be added to the applications in a subsequent release.

W

Introducing OMEGAMON XE for Mainframe Networks 13

IntroducingOMEGAMON XE


Chapter introductionThis chapter introduces the features in OMEGAMON XE for Mainframe Networks and describes how this product can enhance the performance of your system.

Chapter contentsOMEGAMON XE for Mainframe Networks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14OMEGAMON XE for Mainframe Networks Operating Environment . . . . . . . . . . . 17

1

OMEGAMON XE for Mainframe Networks



OverviewSystems administrators face increasing challenges in an ever-changing technical environment. Candle Corporation developed CandleNet Portal and OMEGAMON XE for Mainframe Networks 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 Mainframe Networks.

Using OMEGAMON XE for Mainframe Networks and CandleNet Portal OMEGAMON XE for Mainframe Networks offers a central point of management for your mainframe networks. 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 hosts from a single workstation. The CandleNet Portal lets you easily collect and analyze specific information.

OMEGAMON XE for Mainframe Networks 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 Mainframe Networks, 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.



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

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

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

n Improve system performance —by letting you integrate, monitor, and manage your system, network, console, and mission-critical applications. OMEGAMON XE for Mainframe Networks alerts the CandleNet Portal and the Candle Management Workstation (CMW) when conditions on the system network meet or exceed predefined thresholds. These alerts notify your systems administrator to limit and control system usage. You can view data gathered by OMEGAMON XE for Mainframe Networks in tables and charts for the status of your mainframe networks.

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

Features to facilitate network managementOMEGAMON XE for Mainframe Networks includes the following features that facilitate network management:

n the ability to create situations from attributes

n historical data collection for long-term trending

n predefined situations and templates

Historical data collectionYou 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 Mainframe Networks agent or agents. The historical data collection function permits you to specify



n the attribute group or groups for which data is to be collected

n the interval at which data is to be collected

n the interval at which data is to be warehoused (if you choose to do so)

n 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™.

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


OMEGAMON XE for Mainframe Networks Operating Environment


OverviewOMEGAMON XE for Mainframe Networks can help you to address the increasing challenges presented by today’s technical environment. This section describes the operating environment in which the OMEGAMON XE for Mainframe Networks 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

n establish your own performance thresholds

n create situations, which are conditions to monitor

n create comprehensive reports about system conditions

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

n trace the causes leading up to an alert



Components of the environmentThe client-server-agent implementation includes

n a client, that can be

– a Candle Management Workstation (CMW) or

– a CandleNet Portal workstation

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

n monitoring agents that collect and distribute data to a CMS. OMEGAMON XE for Mainframe Networks is such an agent.

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 Mainframe Networks. When you are using OMEGAMON XE for Mainframe Networks and choose to install OMEGAMON DE, a new tab, called the Business View, appears at the bottom of your Navigator pane.

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

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

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

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

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.

Learning about OMEGAMON XE for Mainframe Networks 21

Learning aboutOMEGAMON XE


Chapter introductionThis chapter provides an overview for using the attributes and workspaces for OMEGAMON XE for Mainframe Networks. It also contains information on predefined situations and reflex automation for action situations.

Chapter contentsUnderstanding Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Understanding OMEGAMON XE for Mainframe Networks . . . . . . . . . . . . 23

2

Understanding Attributes


Understanding Attributes

Using attributesOMEGAMON XE for Mainframe Networks 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 mainframe network systems.

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

An attribute belongs to an attribute group.

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

n 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 within the <ATTRIBUTEGROUP> attribute group. Here is an example using one of the OMEGAMON XE for Mainframe Networks attributes:

<TCPIP_Applications>.<Total_Retransmits>

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


Understanding OMEGAMON XE for Mainframe Networks


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:

n Table view

n Pie chart view

n Bar chart view

n Plot chart view



n Needle gauge view

n Thermometer gauge view

n Notepad view

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

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

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

n 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 Mainframe Networks 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 Mainframe Networks Workspaces” on page 27.

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

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

n select the most effective threshold values for situations you create

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



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.

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



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.

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.

OMEGAMON XE for Mainframe Networks Workspaces 27

OMEGAMON XEfor Mainframe Networks

Workspaces

Chapter introductionThis chapter describes the OMEGAMON XE for Mainframe Networks workspaces that are shipped with the product.

Chapter contentsIntroducing OMEGAMON XE for Mainframe Networks Workspaces. . . . . 28Address Space Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29Applications Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Connections Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Gateways and Devices Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Node Summary Workspace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

3

Introducing OMEGAMON XE for Mainframe Networks Workspaces


Introducing OMEGAMON XE for Mainframe Networks Workspaces

OverviewThis chapter describes the default OMEGAMON XE for Mainframe Networks workspaces and explains how you might use them to monitor your mainframe network.

Predefined workspacesOMEGAMON XE for Mainframe Networks has several predefined workspaces. These are, in alphabetical order:

n Address Space

n Applications

n Connections

n Gateways and Devices

n Node Summary (The highest level workspace)

Accessing the workspacesYou can access a workspace by

n selecting its name from the list provided in the CandleNet Portal Navigator

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

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

n clicking on the View menu and selecting the workspace from the Workspace pull-down menu that is displayed.


Address Space Workspace


OverviewThe Address Space workspace displays the resource consumption of TCP/IP started tasks.

Components of the workspaceThis workspace includes a CPU Percentage chart, a Telnet Pool Usage chart, a Total CSA percentage chart, a CSA Percent Below 16MB chart, a Paging Rate chart, and an Address Space Summary table. Use the table view to get an overall picture of address space usage on a given host.

Using the workspaceYou can use the Address Space workspace to find out information such as:

n the total amount of CSA used

n the size of the Telnet pool

n the number of Telnet sessions in use

Based on the information this workspace provides, you can recommend changes, set up situations, and verify that your recommended changes improve performance.

ScenarioUse the attributes in the Address Space group to create situations that monitor a specific TCP/IP address space.

For example, you could create a situation using the Telnet_Pool_Percentage attribute. This situation would trigger a warning when the percent of the Telnet pool used exceeds a value you set.

Open the Address Space Workspace and compare the value for Telnet Pool Size with the value for Telnet Session Count. If the number of people using Telnet is close to the current pool size, you may want to reconfigure TCP/IP to allocate more slots for the Telnet pool. You can either increase the



Telnet pool size before starting TCP/IP again, or notify the user community when the situation triggers, and recycle TCP/IP after users have exited their Telnet sessions.

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 Mainframe Networks online Help.


Applications Workspace


OverviewThe Applications workspace displays performance measurement statistics by application name. All of these statistics are derived by summing the statistics for connections that were active at the end of the current sampling interval.

Components of the workspaceThis workspace includes a Current Byte Rate chart, a Current Datagram Rate chart, a Total Bytes chart, a Total Retransmissions chart, and an Application Summary table. Use the table view for a summary of how all applications are performing on a given host.

Using the workspaceYou can use the Applications workspace to find out information for each connected application such as:

n the number of inbound and outbound bytes

n the average number of datagrams transmitted

n the percentage of TCP/IP segments requiring retransmission

Based on the information this workspace provides, you can recommend changes, set up situations, and verify that your recommended changes improve performance.

ScenarioUse the attributes in the Applications group to create situations that monitor how your applications are using TCP/IP resources. Before creating the situation, however, use the historical reporting feature of CandleNet Portal to obtain a working baseline for what you want to monitor—byte rate, for example.

Create a situation using the Byte_Rate attribute to measure application throughput rate and to alert you if throughput increases significantly over the working baseline. This could indicate a high application workload and may



signify an impending performance problem. Consider load balancing, work rescheduling, and increasing performance.



Connections Workspace


OverviewThis workspace displays identifying and performance information for each TCP/IP connection and the application associated with it.

Components of the workspaceThis workspace includes a Current Byte Rate chart, a Current Datagram Rate chart, a Current Retransmits chart, a Round Trip Time (greater than 2 seconds) chart, and a Connections Summary table. Use the table view for a performance summary of each TCP/IP connection.

Using the workspaceYou can use the Connections workspace to find out information for each TCP/IP connection such as:

n the name of the local application using the connection

n the foreign and local socket addresses

n the connection number

You can see performance information such as:

n inbound, outbound, and total transmitted bytes

n inbound, outbound, and total transmitted datagrams

n the number of TCP retransmissions

Based on the information that this workspace provides, you can recommend changes, set up situations, and verify that your recommended changes improve performance.

ScenarioUse the Round_Trip_Time and Round_Trip_Variance attributes to create situations that can help you determine the cause of network congestion, whether it be host or route-related. Round trip variance is the statistical



variation of round trip times since the connection was established. Since round trip time is the trip time of the last segment sent, it is only meaningful in relation to round trip variance. Used together, however these values can indicate how healthy the route is through the network from sending host to receiving host and back.

A small variance indicates that the current round trip time can be used as an average. A high variance may indicate either:

n that the current round trip time may not represent the average

n that round trip times are sporadic

You may not want to rely upon variance for short sessions, or for a session that just started, since in either case few segments were transmitted. Variance is more accurate over longer, more robust sessions. If the problem is not route-related but most of the IP traffic through this address space is experiencing it, you may have to look into possible ESA system performance problems.



Gateways and Devices Workspace

Gateways and Devices Workspace

OverviewThis workspace displays status and information that identify gateways and devices for a TCP/IP address space.

Components of the workspaceThis workspace comprises two table views: a Devices table and a Gateways table.

Using the workspaceYou can use this workspace to monitor gateways and devices. The information in the table for devices includes:

n device name, address, and type

n status (active, inactive, ready)

n link name and type

n network where device is attached

The information in the table for gateways includes:

n IP address identifying the gateway

n first hop, which identifies the first router in the path to the remote host

n link name associated with the gateway

n subnet mask and value identifying the subnetwork and subnodes in the gateway host

Use this workspace to monitor network devices that may drop out of Ready status and to monitor the link status of gateways. Based on the information that this workspace provides, you can recommend changes, set up situations, and verify that your recommended changes improve availability.

Node Summary Workspace



OverviewThe Node Summary workspace is the highest-level workspace that is displayed, and it provides summary information for the selected node.

Components of the workspaceThis workspace includes a Resource Summary chart, a Traffic Summary chart, a Discard Percentages chart, a Fragmentation Percentages chart, a Reassembly Percentages chart, a Retransmission Percentage chart, a Throughput Rate chart, and a TCP/IP Summary table.

Using the workspaceYou can use the summary workspace to view short-term TCP/IP performance trends for

n resource use

n reassemblies

n fragmentation

n throughput

n discards

ScenariosUse the historical reporting feature to determine a baseline for TCP/IP performance on a specific node. You can then use this workspace to get an overall view of how your network is performing. From here you can navigate to other workspaces specific to applications, address space, connections, and hardware issues.

For example, examine the Resource Summary chart. If the bar showing the throughput rate is unusually high, you may have one or more applications with high throughput requirements taxing your system and network resources.



This can lead to unacceptable response times for the application in question and for other applications using this node.

Open the Applications workspace and create or use predefined situations that monitor applications with high resource requirements and trigger exceptions when resources exceed predefined thresholds. Use the Byte_Rate and Datagram_Rate attributes to measure throughput.

It may also help to detect applications with high or changing resource requirements for capacity planning purposes. Throughput exceptions can alert you to changing resource demands and portend a need to increase or balance capacity.

For another example, in the Node Summary workspace, examine the Discard Percentages chart. If the output discard percentage is higher than your established baseline, it may be because:

n TCP output segments were undeliverable because there were no routes available.

n One or more segments were two large for the next host in the route, but the no frag bit was set, so that host could not receive the segments.

For diagnostic procedures see the IBM Communications Server IP Diagnosis Guide.

OMEGAMON XE for Mainframe Networks Predefined Situations 39

OMEGAMON XEfor Mainframe Networks

Predefined Situations

Chapter introductionThis chapter describes the OMEGAMON XE for Mainframe Networks predefined situations.

Chapter contentsIntroduction to Situations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Using Situations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Using Predefined Situations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

4

Introduction to Situations



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

What is a predefined situation?The Candle agents that 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 OMEGAMON XE for Mainframe Networks. 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 a backup, if necessary.

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

n create a situation

n save a situation

n display a situation

n edit a situation

n start, stop, or delete a situation

n 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

OMEGAMON XE for Mainframe Networks Predefined Situations 41


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

Using Predefined Situations


Using Predefined Situations

OverviewOMEGAMON XE for Mainframe Networks includes product-provided situations that are distributed and activated to start up on each system running the agent. You can customize product-provided situations to make them more appropriate for your site, or use them as models for creating other situations that suit your needs. For example, you can add a node ID or a severity to a product-provided situation to filter network events down to smaller sets of relevant activities. However, you must distribute any new situations you create to the managed systems you monitor.

Creating situationsGroup attributes correspond to the columns in the table views shown for OMEGAMON XE for Mainframe Networks. Use these attributes to create situations that alert you to the events in which you are interested, and to integrate mainframe network events with the events you monitor with Candle agents.

Further informationFor more information about the predefined situations included with OMEGAMON XE for Mainframe Networks, refer to the online help. For information about creating and customizing situations, refer to the CandleNet Portal online help.

Guide to Candle Customer Support 43

Guide to CandleCustomer Support

IntroductionCandle Corporation is committed to producing top-quality software products and services. To assist you with making effective use of our products in your business environment, Candle is also committed to providing easy-to-use, responsive customer support.

Precision, speed, availability, predictability—these terms describe our products and Customer Support services.

Included in this Guide to Candle Customer Support is information about the following:

Base Maintenance Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44– Telephone Support– eSupport– Description of Severity Levels– Service-level objectives– Recording and monitoring calls for quality purposes– Customer Support Escalations– Above and Beyond

Enhanced Support Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48– Assigned Support Center Representative (ASCR)– Maintenance Assessment Services (MAS)– Multi-Services Manager (MSM)

Customer Support Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . 50– Link to Worldwide Support Telephone and E-mail information

A

Base Maintenance Plan



OverviewCandle offers a comprehensive Base Maintenance Plan to ensure that you realize the greatest value possible from your Candle software investments. We have more than 200 technicians providing support worldwide, committed to being responsive and to providing expedient resolutions to support requests. Technicians are available worldwide at all times during the local business day. In the event of an after-hours or weekend emergency, our computerized call management and forwarding system will ensure that a technician responds to Severity One situations within one hour. For customers outside of North America, after-hours and weekend support is provided in English language only by Candle Customer Support technicians located in the United States.

Telephone supportCandle provides consistently reliable levels of service—thanks to our worldwide support network of dedicated experts trained for specific products and operating systems. You will always work with a professional who truly understands your problem.

We use an online interactive problem management system to log and track all customer-reported support requests. We give your support request immediate attention by routing the issue to the appropriate technical resource, regardless of geographic location.

Level 0 Support is where your call to Candle Customer Support is first handled. Your support request is recorded in our problem management system, then transferred to the appropriate Level 1 support team. We provide Level 0 manual interaction with our customers because we support more than 170 products. We feel our customers would prefer personal interaction to a complex VRU or IVR selection menu.

Level 1 Support is the service provided for initial support requests. Our Level 1 team offers problem determination assistance, problem analysis, problem resolutions, installation assistance, and preventative and corrective service information. They also provide product usage assistance.



Level 2 Support is engaged if Level 1 cannot provide a resolution to your problem. Our Level 2 technicians are equipped to analyze and reproduce errors or to determine that an error is not reproducible. Problems that cannot be resolved by Level 2 are escalated to Candle’s Level 3 R&D support team.

Level 3 Support is engaged if a problem is identified in Candle product code. At Level 3, efforts are made to provide error correction, circumvention or notification that a correction or circumvention is not available. Level 3 support provides available maintenance modifications and maintenance delivery to correct appropriate documentation or product code errors.

eSupportIn order to facilitate the support process, Candle also provides eSupport, an electronic full-service information and customer support facility, via the World Wide Web at www.candle.com/support/. eSupport allows you to open a new service request and update existing service requests, as well as update information in your customer profile. New and updated service requests are queued to a support technician for immediate action. And we can respond to your request electronically or by telephone—it is your choice.

eSupport also contains a continually expanding knowledge base that customers can tap into at any time for self-service access to product and maintenance information.

The Candle Web Site and eSupport can be accessed 24 hours a day, 7 days a week by using your authorized Candle user ID and password.

Description of Candle severity levelsResponses to customer-reported product issues and usage questions are prioritized within Candle according to Severity Code assignment. Customers set their own Severity Levels when contacting a support center. This ensures that we respond according to your individual business requirements.

Severity 1 Crisis

A crisis affects your ability to conduct business, and no procedural workaround exists. The system or application may be down.

Severity 2High

A high-impact problem indicates significant business effect to you. The program is usable but severely limited.

http://www.candle.com/support/



Candle has established the following service-level objectives:

Severity 3Moderate

A moderate-impact problem involves partial, non-critical functionality loss or a reasonable workaround to the problem. A “fix” may be provided in a future release.

Severity 4Low

A low-impact problem is a “how-to” or an advisory question.

Severity 5Enhancement Request

This is a request for software or documentation enhancement. Our business units review all requests for possible incorporation into a future release of the product.

Call Status Severity 1 Goal

Severity 2 Goal

Severity 3 Goal

Severity 4 Goal

Severity 5Goal

First Call Time to Answer

90% within one minute

Level 1 Response(Normal Business Hours)

90% within 5 minutes

90% within one hour

Level 2 Response

(Normal Business Hours)

Warm Transfer

90% within two hours

90% within eight hours

Scheduled follow-up (status update)

Hourly or as agreed

Daily or as agreed

Weekly or as agreed Notification is made when an enhancement is incorporated into a generally available product.

Notification is made when a fix is incorporated into a generally available product.

The above information is for guideline purposes only. Candle does not guarantee or warrant the above service levels. This information is valid as of October 1999 and is subject to change without prior notice.



Recording and Monitoring Calls for Quality PurposesCandle is committed to customer satisfaction. To ensure that our customers receive high levels of service, quality and professionalism, we’ll monitor and possibly record incoming and outgoing Customer Support calls. The information gleaned from these calls will help us serve you better. If you prefer that your telephone call with Candle Customer Support in North America not be monitored or recorded, please advise the representative when you call us at (800) 328-1811 or (310) 535-3636.

Customer Support EscalationsCandle Customer Support is committed to achieving high satisfaction ratings from our customers. However, we realize that you may occasionally have support issues that need to be escalated to Candle management. In those instances, we offer the following simple escalation procedure:

If you experience dissatisfaction with Candle Customer Support at any time, please escalate your concern by calling the Candle support location closest to you. Ask to speak to a Customer Support manager. During standard business hours, a Customer Support manager will be available to talk with you or will return your call. If you elect to hold for a manager, you will be connected with someone as soon as possible. If you wish a return call, please tell the Candle representative coordinating your call when you will be available. After contacting you, the Customer Support manager will develop an action plan to resolve your issue. All escalations or complaints received about support issues are logged and tracked to ensure responsiveness and closure.

Above and BeyondWhat differentiates Candle’s support services from our competitors? We go the extra mile by offering the following as part of our Base Maintenance Plan:

n Unlimited multi-language defect, installation and operations supportn eSupport using the World Wide Webn Regularly scheduled product updates and maintenance provided at no

additional chargen Over 200 specialized technicians providing expert support for your

Candle products

Enhanced Support Services



OverviewOur Base Maintenance Plan provides a high level of software support in a packaged offering. However, in addition to this plan, we have additional fee-based support services to meet unique customer needs.

The following are some examples of our added-value support services:

n Assigned Support Center Representative Services (ASCR)

– An assigned focal point for managing support escalation needs– Proactive notification of available software fixes– Proactive notification of product version updates– Weekly conference calls with your ASCR to review active problem

records– Monthly performance reviews of Candle Customer Support service

levels– Optional on-site visits (extra charges may apply)

n Maintenance Assessment Service (MAS)

– On-site assessment services– Advice about product maintenance and implementation– Training your staff to develop efficient and focused procedures to

reduce overall cost of ownership of your Candle software products– Analysis of your Candle product environment: versions, updates,

code correction history, incident history and product configurations– Reviews to ensure that purchased Candle products and solutions are

used effectively

n Multi-Services Manager (MSM)

Multi-Services Manager provides highly valued services to customers requiring on-site full time expertise to complement their technical resources.



– Dedicated on-site Candle resource (6 months or one year) at your site to help ensure maximum use and effectiveness of your Candle products

– Liaison for all Candle product support activities, coordination and assistance with implementation of all product updates and maintenance releases

– Works with your staff to understand business needs and systems requirements

– Possesses technical and systems management skills to enhance your staff’s knowledge and expertise

– Other projects as defined in Statement of Work for MSM services

Customer Support Contact Information


Customer Support Contact Information

Link to Worldwide Support Telephone and E-mail informationTo contact Customer Support, the current list of telephone numbers and e-mail addresses can be found on the Candle Web site, www.candle.com/support/.

Select Support Contacts from the list on the left of the page.

http://www.candle.com/support/

Index 51

Index

AAddress Space workspace 29Adobe 9Applications workspace 31ASCR

assigned support center representative 48assigned support center representative

ASCR 48attribute group

definition of 22attributes

organization of 22structure of 22workspaces and 24

BByte_Rate attribute

using, in a situation 31, 37

CCandleNet Portal

described 18formats for information 23using, to view and manage

performance 14Connections workspace 33customer service

telephone support 44customer support

base maintenance plan 44contact information 50enhanced support services 48eSupport 45severity levels 45

DDatagram_Rate attribute

using, in a situation 37documentation set 6

Eemail to Candle 8eSupport

customer support 45

GGateways and Devices workspace 35

Hhistorical data collection

described 15documentation of 16

Mmainframe networks

CandleNet Portal and 14maintenance assessment service

MAS 48managed systems

attributes and 22MAS

maintenance assessment service 48monitoring agents

example of 18MSM

multi-services manager 48multi-services manager

MSM 48

Nnetwork management

features described 15Node Summary workspace 36


OOMEGAMON XE

components of 18definition 17–18

OMEGAMON XE for Mainframe Networksbenefits described 15

Ppredefined situations

definition 40documentation of 42

printing problems 9properties

available for workspaces 25

Rremote monitoring agents

attributes and 22Round_Trip_Time attribute

using, in a situation 33Round_Trip_Variance attribute

using, in a situation 33

Sscenarios

Address Space workspace 29Applications workspace 31Connections workspace 33Node Summary workspace 36

severity levelscustomer support 45

situation editorfeatures 40

situationsattributes and 22definition 40distribution of 42using the situation editor 40

status informationexample of 24

Ttable views 23telephone support

customer service 44Telnet_Pool_Percentage attribute

using, in a situation 29

Uusing workspaces 23

Vviewing

attribute information 24

Wworkspace

definition of 23workspaces 23

accessing 28Address Space 29Applications 31associating with attributes 24CandleNet Portal, described 14Connections 33Gateways and Devices 35Node Summary 36predefined 28properties of 25using to investigate events 25

omegamon xe for mainframe networks,ഀ 唀猀攀爠ᤀ猀 䜀甀椀搀攀...

Documents

omegamon xe for mainframe networks,ഀ 唀猀攀爠ᤀ猀䜀甀椀搀攀...