Version 300 Release Guide OMEGAVIEW

GC32-9337-00 August 1999

Candle Corporation 201 North Douglas Street El Segundo, California 90245

Registered trademarks and service marks of Candle Corporation: AF/OPERATOR, AF/PERFORMER, AF/REMOTE, Availability Command Center, Candle Command Center, Candle Electronic Customer Support, Candle Logo, Candle Management Server, Candle Management Workstation, Candle Technologies, CL/CONFERENCE, CL/SUPERSESSION, CT, CT/Data Server, CT/DS, DB Logo, DB/QUICKCHANGE, DELTAMON, ETEWatch, IntelliWatch, MQSecure, MQView, OMEGACENTER, OMEGAMON, OMEGAMON/e, OMEGAMON II, OMEGAMON Monitoring Agent, OMEGAVIEW, OMEGAVIEW II, Solutions for Networked Businesses, and Transplex. Trademarks and service marks of Candle Corporation: Alert Adapter, Alert Adapter Plus, Alert Emitter, AMS, Amsys, AUTOMATED FACILITIES, Availability Management Systems, Candle Business Partner Logo, Candle Direct Logo, CandleLight, CCC, CECS, CICAT, CL/ENGINE, CL/GATEWAY, CL/TECHNOLOGY, CMS, CMW, Command & Control, CommandWatch, 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/DASD, DB/EXPLAIN, DB/MIGRATOR, DB/QUICKCOMPARE, DB/SMU, DB/Tools, DB/WORKBENCH, Design Network, DEXAN, eBA*ServiceMonitor, End-to-End, Enterprise Candle Command Center, Enterprise Candle Management Workstation, EPILOG, ERPNet, ESRA, HostBridge, IntelliWatch Pinnacle, Lava Console, Messaging Mastered, MQADMIN, MQEdit, MQEXPERT, MQMON, NBX, OMA, OMC Gateway, OMC Status Manager, OMEGACENTER Bridge, OMEGACENTER Gateway, OMEGACENTER Status Manager, OMEGAMON Management Center, OSM, PC COMPANION, Performance Pac, PowerQ, PQConfiguration, PQEdit, PQScope, Response Time Network, Roma, Roma Broker, Roma BSP, Roma Connector, Roma Developer, Roma FS/A, Roma FS/Access, Roma Network, Roma Systems Manager, RTA, RTN, SentinalManager, Solutions for Networked Applications, Status Monitor, Tracer, Unified Directory Services and Volcano. Trademarks and registered trademarks of other companies: AIX, DB2, and MQSeries 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. HU-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. ProtoView Development Corp. - Contains DataTable Version 3.0 Copyright 1989—1996 by ProtoView Development Corp. and distributed under license by Candle Corporation. Copyright  1999, 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; Communications on a Network, Patent Pending; End-to-End Response Time Measurement for Computer Programs, 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 Read This First

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Preface . . . . . . . . . . . . . . . . . . Adobe Portable Document Format Documentation Set . . . . . . . . . . In This Version

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Highlights . . . . . . . . . . . . . Features No Longer Supported Documentation Enhancements Candle Customer Support

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . .

Customer Support Phone Numbers

. . . . . . . . . . . . . . . . .

Contents

5

5 6 7 9

9 15 16 21

23

3

4

OMEGAVIEW Version 300 Release Guide

Read This First

Preface About this document

This OMEGAVIEW Version 300 Release Guide summarizes the new features and documentation revisions for the latest version of OMEGAVIEW. To receive this new version, contact your Candle Corporation account manager.

Read This First

5

Adobe Portable Document Format Introduction

Candle supplies documentation in the Adobe Portable Document Format (PDF). The Adobe Acrobat Reader prints 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 > Print Setup... and make your selections. A setting of 300 dpi is highly recommended as is duplex printing if your printer supports it. 2. To start printing, select File > Print on the Acrobat Reader Menu bar. 3. On the Print popup, select one of the Print Range options for Á Á Á

a single page a range of pages all of the document

4. (Optional) To fit oversize pages to the paper size currently loaded on your printer, select the Shrink to Fit option. Printing problems?

Your printer ultimately determines the print quality of your output. Sometimes printing problems can occur. If you experience printing problems, potential areas to check are: Á

settings for your printer and printer driver. (The dpi settings for both your driver and printer should be the same. A setting of 300 dpi is recommended.)

Á

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

Á

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

Á

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

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

6

OMEGAVIEW Version 300 Release Guide

Documentation Set Introduction

Candle provides a complete set of documentation for OMEGAVIEW. Each manual in this documentation set contains a specific type of information to help you use the product. Candle welcomes your comments and suggestions for changes or additions to the documentation set. A user comment form, located at the back of each manual, provides simple instructions for communicating with Candle's Information Development department. You can also send email to [email protected]. Please include the product name, version, and book title in the subject line. To order additional manuals, contact Candle Customer Support. Table 1. OMEGAVIEW Documentation

Document Number

Document Name

Description

MV60-5643

OMEGAVIEW Version 300 Release Guide

Summarizes the new features and enhancements in this latest version of OMEGAVIEW.

IC51-5811

Installing Candle Products on MVS

Provides explicit instructions for installing OMEGAVIEW and applying maintenance.

MV51-5644

OMEGAVIEW Configuration and Customization Guide

Provides procedures for configuring and customizing OMEGAVIEW to meet your site's requirements.

MV54-5645

OMEGAVIEW User's Guide Explains how to use OMEGAVIEW to monitor your enterprise service level management.

MV52-5646

OMEGAVIEW Messages Manual

Describes the CT/Engine, Status Data Manager, and 3270 Interface messages that may be generated by OMEGAVIEW.

MV99-5647

3270 Interface to the Candle Command Center Using OMEGAVIEW

Summarizes the Candle Command Center 3270 interface to view alerts, access reports, access a console, and edit situations.

Read This First

7

8

OMEGAVIEW Version 300 Release Guide

In This Version

Highlights Introduction

This section presents the new features of Version 300. 3270 Interface to the Candle Command Center

Now you can access most key features of the Candle Command Center (CCC) on your 3270 terminals. This new interface displays an Enterprise-wide short-term history status bar, the Enterprise view, on your default OMEGAVIEW Main Status panel. From there you can reach panels that: Á

List managed aggregates and objects (Open as Details).

Á

Display short- and long-term history status bars for a managed object.

Á

List events for all or selected managed objects (Open as Events).

Á

Display initial attributes for a selected event (Open as Attributes).

Á

Provide the Reset Event action.

Á

Provide the Access Console action to access the SNA consoles for MVS-based managed system associated with an event.

Á

Provide the Zoom to CCC-Report action to access MVS-based CCC reports relevant to an event. This feature requires the same report access authority as the selections on the CCC-Reports pulldown menu.

Á

List situations, if you are authorized.

Á

Provide actions to stop and restart situations.

Á

Provide actions to edit the comparison value or operator within situation predicates.

In This Version

9

You can use 3270s to observe the conditions of any of your subsystems running on multiple platforms. You must continue to use a Candle Management Workstation (CMW) to define Á Á Á Á Á Á Á

managed objects templates, initial situations CMW user authorities workgroups and acknowledgements policies consoles

You enable the CCC 3270 interface during OMEGAVIEW Candle Installation and Configuration Assistance Tool (CICAT) configuration. Subsystem Logging Facility (SLF) Support

You can authorize users to access SLF data generated by Candle Command Center products. You can view SLF data from CCC products by selecting SLF from the CCC-Reports pulldown menu. Data appears on the SLF log only if the CCC product supports SLF and the data is trapped by AF/OPERATOR or OMEGACENTER Gateway for MVS. OMEGAMON Releases Supported

This release of OMEGAVIEW supports connections to:

10

Á

Versions 400 and 500 of OMEGAMON II products.

Á

Version 160 and 500 of OMEGAMON II for SMS.

OMEGAVIEW Version 300 Release Guide

Ease of Installation

OMEGAVIEW Version 300 uses CICAT Release 200 or above and requires CT/Engine Version 170. These new CICAT and CT/Engine releases improve the installation process in the following ways: Libraries

Á

The FMIDs have been consolidated and the number of FMIDs has been reduced.

Á

The target and runtime libraries have been consolidated and the number of libraries has been reduced.

CICAT

Á

The runtime environment (RTE) concept has been introduced.

Á

CICAT configuration panels have been streamlined.

Á

CICAT configuration panels generate JCL streams that you submit as batch configuration jobs.

Á

CICAT improvements simplify the connection of Version 400 and Version 500 OMEGAMONs to OMEGAVIEW

Candle Management Server

Á

The CCC 3270 interface and OMEGAVIEW II for the Enterprise, use the Candle Management Server (CMS). CMS configuration requirements have been simplified: –

Multiple OMEGAVIEW address spaces can now be connected to a single hub CMS. OMEGAVIEW no longer requires a separate CMS for each OMEGAVIEW.

–

The hub CMS may now be mainframe or distributed.

–

OMEGAVIEW II for the Enterprise IRA agents now support the hub residing on a distributed platform, without the requirement for a remote MVS CMS.

In addition to simplified CMS installation, this improved OMEGAVIEW CMS configuration results in: – – –

reduced reconnection delays reduced timeouts reduced traffic

In This Version

11

Note: The SDM bridge cannot talk to multiple (MVS and non-MVS) CMSs

at the same time. It can only target a single CMS at a time. However, you can use multiple OMEGAVIEW/OMEGAVIEW II for the Enterprise address spaces to target multiple CMSs. New Session Parameters

When adding or changing a session definition, you can now specify these additional parameters: Á

Collector Session Timeout Interval specifies how long before the session times out because of no new status information.

Á

Session Automatic Reconnect Limit specifies how many times to connect to the session if it is unavailable or not responding. Recovery status displays on panels that list sessions. You see the number of attempts to reconnect or that the maximum was reached.

Intelligent Remote Agent (IRA) Support

In this release of OMEGAVIEW, to use any of the following features: Á

Connecting to OMEGAVIEW II for the Enterprise.

Á

Zooming to a CCC product.

Á

3270 interface to the Candle Command Center

you must enable an IRA during CICAT configuration. If you do not use the features listed above, there is no need to configure an IRA. Japanese Language Support

You can now access OMEGAVIEW using the Japanese language from a terminal using Japanese language emulation software. Some users can access OMEGAVIEW in English while those terminals running in Japanese emulation can access the same OMEGAVIEW in Japanese. You install Japanese language support during product installation. Candle provides Japanese panel text, help text, and online message text in libraries separate from English text. If selected, CICAT adds the Japanese text libraries to the OMEGAVIEW started task and generates a separate applid for Japanese language users to log on.

12

OMEGAVIEW Version 300 Release Guide

Japanese Language Considerations

Á

A single OMEGAVIEW address space can support Japanese as well as US English terminal users if Japanese language support is specified during CICAT definition of a runtime environment (RTE). As a result: –

CICAT adds Japanese language libraries to the OMEGAVIEW started task.

–

CICAT generates a separate logon applid for Japanese language users.

–

Some terminals can access OMEGAVIEW in English, while those running in Japanese emulation can access the same OMEGAVIEW in Japanese.

Á

To use OMEGAVIEW in Japanese, you must log onto the Japanese applid using a Japanese terminal or emulator which supports the EBCDIC double byte character set.

Á

When you zoom from OMEGAVIEW in Japanese to any of these products: OMEGAMON II for CICS, OMEGAMON II for DB2, OMEGAMON II for IMS, OMEGAMON II for MVS, or Candle Command Center for MQSeries, you access the Japanese version if it was configured and is currently available. Otherwise, you access the English version.

Á

Whether you use OMEGAVIEW in English or Japanese, you must enter the English applid when you use the Configuration Manager to define an OMEGAMON session to OMEGAVIEW. Thus, when Candle Customer Support is debugging a problem, trace and error messages are issued in English. The language of the applid in the session definition has no affect on zoom or data collection operations. If you inadvertently enter a non-English applid, the message Could not find version on first screen displays.

Á

The only reports in Japanese to which you can zoom from the OMEGAVIEW CCC 3270 interface are from Candle Command Center for MQSeries.

Á

The CCC 3270 interface displays alerts, situations, and attributes in Japanese or English depending on your language selection. You can modify the predicate operations and values in the same language as they are displayed. However, you must enter certain OMEGAVIEW status item information in English.

In This Version

13

Problem Management Alerts

Changes to data in the Problem Management panel can now be transmitted from OMEGAVIEW to trigger alerts to AF/OPERATOR or OMEGACENTER Gateway for MVS. These products can use REXX execs to trap the alerts and capture the data. The problem management panel now includes these new fields: Action Description Prompt Instead of entering freeform text, you can press F4 and select from the predefined values ACKNOWLEDGE or RESET.

14

Start Fix Date

Date on which problem resolution began.

End Fix Date

Date on which you expect the problem to be resolved.

Duration

Instead of End Fix Time, you can enter how long you expect problem resolution to take. End Fix Time is computed from this.

OMEGAVIEW Version 300 Release Guide

Features No Longer Supported Pre-Version 120 OMEGAVIEW Releases

As of October 1, 1999, releases of OMEGAVIEW prior to Version 120 will no longer be supported. They are not Year 2000 compliant. Pre-Version 400 OMEGAMON Releases

This release of OMEGAVIEW no longer supports these sessions: Á

OMEGAMON II products prior to version 400.

Á

OMEGAMON II for SMS prior to version 160.

In This Version

15

Documentation Enhancements Introduction

This section describes revised documentation for Version 300. 3270 Interface to the Candle Command Center Using OMEGAVIEW

This document describes the Candle Command Center 3270 Interface in the following chapters:

16

Á

Overview, including requirements, terminology, and when to use the Candle Management Workstation.

Á

Displaying Alerts and Events, including panels, actions, and a navigation chart.

Á

Editing Situations, including panels, actions, and a navigation chart.

Á

Accessing a Console, including a scenario of typical usage

Á

Accessing MVS-based Reports, including how to authorize access to the reports and SLF information.

Á

MVS-based Report Summaries, including what the CCC products provide and an overview of each report.

OMEGAVIEW Version 300 Release Guide

OMEGAVIEW Configuration and Customization Guide

This guide tells you how to configure and customize OMEGAVIEW for your site. It contains more information than previous versions, divided into four parts: Á

Configuring OMEGAVIEW Using CICAT

Á

Customizing OMEGAVIEW Using the Configuration Manager

Á

Appendixes

The new CICAT procedure and panels are described, including Á

what is a runtime environment

Á

SMP/E considerations

Á

defining and managing runtime environments

Á

configuring from a Multi-Product Quick Install tape

Á

enabling the 3270 Interface to CCC

Á

enabling an Intelligent Remote Agent (IRA)

Á

enabling Japanese language support

The “Working with Sessions” chapter describes the new session definition parameters.

In This Version

17

OMEGAVIEW User's Guide

This guide provides more information than previous versions, including Á

updated valid zoom destinations in the “Using the Zoom Feature” chapter

Á

updated information in the “Status Item Qualifiers” appendix

OMEGAVIEW Messages Manual

This manual contains the error messages that may be written on the log from these OMEGAVIEW components: Á

CT/Engine

Á

Status Data Manager (SDM)

Á

3270 Interface to CCC

As usual, each message includes:

18

Á

an explanation

Á

diagnostic information

Á

what the system does

Á

what you should do

Á

the type of message

OMEGAVIEW Version 300 Release Guide

Online Helps

Á

Panel-level helps have been added for every panel and field included in the new features of this release.

Á

Helps provide comprehensive, context-sensitive assistance when and where you need it.

In This Version

19

20

OMEGAVIEW Version 300 Release Guide

Candle Customer Support

Introduction

Candle Corporation offers a comprehensive maintenance and support plan to ensure you realize the greatest value possible from your Candle software investments. We have more than 200 technicians worldwide, committed to providing you with prompt resolutions to your support requests. Customer Support hours of operation are from 5:30 A.M. to 5:00 P.M., Pacific Time. In the event of an after-hours or weekend emergency, Candle's computerized call management system ensures that a technician will return your call within one hour. For customers located outside of North America, after-hours and weekend support is provided by Candle Customer Support locations in the United States. Electronic Support

Candle provides information and support services using Á

Candle's home page at www.candle.com. You can use the Candle Web site to – – – – – – –

Á

open problem records access maintenance information order products or maintenance access IBM compatibility information download fix packs for distributed products read news and alerts scan a list of scheduled Candle education classes

Candle Electronic Customer Support (CECS), an electronic customer support facility. You can access this facility through the IBM Global Network. You can use CECS to – – – – –

open problem records search our database for solutions to known problems look for answers to commonly asked questions read news and alerts scan a list of scheduled Candle education classes

Both CECS and the Candle Web site are available 24 hours a day, 7 days per week.

Candle Customer Support

21

Telephone Support

Our support network consists of product specialists who work with you to solve your problem. Candle uses an online problem management system to log and track all support requests. Your request is immediately routed to the appropriate technical resource. When you call to report a problem, please have the following information:

22

Á

your Candle personal ID (PID) number

Á

the release level of the Candle product

Á

the release level of IBM or other vendor software

Á

identifying information and dates of recently applied maintenance to your Candle product or IBM product

Á

a detailed description of the problem (including the error message) and the events preceding the problem

Á

a description of any unusual events that occurred before the problem

OMEGAVIEW Version 300 Release Guide

Customer Support Phone Numbers Telephone North America

Fax

(800) 328-1811 (310) 535-3636

(310) 727-4204

Belgium/Luxembourg

+32 (0) 3 270 95 60

+32 (0) 3 270 95 41

France

+33 (0) 1 53 61 60 60

+33 (0) 1 53 61 06 16

Germany/Switzerland/ Austria

+49 (0) 89 54 554 333

+49 (0) 89 54 554 170

Italy - Freephone

800 80992

Netherlands

+31 (0) 30 600 35 50

+31 (0) 30 600 35 10

Scandinavia

+46 (0)8 444 5940

+46 (0)8 623 1855

U.K.

+44 (0)161 437 5224

+44 (0)161 437 5225

Europe

(Southern Europe, Middle East and South Africa Agents call U.K.) Asia Pacific English Hub

+61 2 9954 1818

Australia

+61 2 8912 9898

Hong Kong

800 908 457

India

+61 2 8912 9898

Indonesia

0018 03061 2061

Malaysia

1800 803 459

New Zealand

0800 449 596

Philippines

1800 1612 0096

Singapore

800 616 2075

Thailand

0018 00612 1045

Asia Pacific Japanese Hub

+81 3 5562 6992

+81 3 5562 6995

Asia Pacific Korean Hub

+82 2 552 8744

+82 2 552 8746

Asia Pacific Mandarin Hub

+88 62 2739 3223

+88 62 2378 5993

Asia Pacific e-mail address: [email protected]

When your local support office is unavailable, you can contact Candle's North America support center. If USADirect service is available in your country, use the 800 telephone number. If USADirect service is not available, ask your international operator for assistance in calling Candle's local (310) number.

Candle Customer Support

23

Incident Documentation

You may be asked to send incident documentation to the Candle Customer Support Center. On the outside of all packages you send, please write the incident number given to you by the Customer Support representative. Send tapes containing the incident information to the following address, unless directed otherwise by your Customer Support representative: Candle Customer Support Candle Support Center, Incident number 2ð1 North Douglas Street El Segundo, CA 9ð245

Send all other relevant documentation, such as diskettes or paper documentation, to the address provided by your Customer Support representative. Ensuring Your Satisfaction with Customer Support

Candle Customer Support is committed to achieving high customer satisfaction ratings in all areas. These include Á Á Á Á Á

connecting you to a support representative promptly providing you with the appropriate fixes answering support questions filling your shipping orders supplying documentation

If you have a concern that has not been resolved to your satisfaction, you can open a complaint ticket. All tickets are logged and tracked to ensure responsiveness and closure. Using the ticket information, a manager will contact you promptly to resolve your problem.

24

OMEGAVIEW Version 300 Release Guide