Configuration and Customization Guide€¦ · Configuration and Customization Guide OMEGAMON® XE...

Configuration and Customization GuideOMEGAMON® XE for DB2 on z/OS

Version 300

G251247100

August 2004

Candle Corporation100 North Sepulveda Blvd.

El Segundo, California 90245-9796

2 OMEGAMON XE for DB2 on z/OS Configuration and Customization Guide, V300

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 © May 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.

Contents

List of Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

List of Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9About this Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Adobe Portable Document Format . . . . . . . . . . . . . . . . . . . . . . . . . . 11Candle Customer Service and Satisfaction . . . . . . . . . . . . . . . . . . . . 13Documentation Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

Chapter 1. Start Here to Configure Products and Maintenance . . . . . . . . . 17Using the Checklists and Topics in this Chapter . . . . . . . . . . . . . . . . . 18Checklist: Prerequisites for Configuring Products . . . . . . . . . . . . . . . . 20Checklist: Starting CICAT and Accessing the Menu for Configuration 21Checklists: Configuring the Product Using CICAT . . . . . . . . . . . . . . . 22Checklists: Configuring the Product Outside of CICAT. . . . . . . . . . . . 28Checklists: Customizing the Product Outside of CICAT . . . . . . . . . . . 33Checklist: Updating the Configuration . . . . . . . . . . . . . . . . . . . . . . . . 34Using Advanced Features in CICAT. . . . . . . . . . . . . . . . . . . . . . . . . . 35

Chapter 2. Overview of Processes, Methods, and CICAT Modes . . . . . . . . 37Determining the Topics to Use in this Chapter . . . . . . . . . . . . . . . . . . 38Candle Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Processes for Installing, Configuring, and Maintaining Products. . . . . 40Background about CICAT Modes: Interactive and Batch . . . . . . . . . . 45

Chapter 3. Plan Your Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47Determining the Topics to Use in this Chapter . . . . . . . . . . . . . . . . . . 48Candle Products and Components . . . . . . . . . . . . . . . . . . . . . . . . . . 49Details about the Candle Products and Components . . . . . . . . . . . . . 52Determining the Components to Install and Configure . . . . . . . . . . . 54Requirements and Restrictions for OMEGAMON XE . . . . . . . . . . . . . 58

Contents 3

Chapter 4. Start CICAT and Access the Menu for Configuring . . . . . . . . . 59Determining the Topics to Use in This Chapter . . . . . . . . . . . . . . . . . 60Starting CICAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Accessing the Menu for Configuring the Product . . . . . . . . . . . . . . . . 62Using CICAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Chapter 5. Completing the Configuration Outside of CICAT . . . . . . . . . . . 65Determining the Topics to Use in this Chapter . . . . . . . . . . . . . . . . . . 66Copying the Procedures for the Started Task . . . . . . . . . . . . . . . . . . . 67Copying the VTAM Definition and Varying the VTAM Node Active . . 68Copying the Procedures for the Persistent Datastore . . . . . . . . . . . . . 69Completing the Configuration for a Non-local CMS. . . . . . . . . . . . . . 70Verifying the Configuration: Same Address Space . . . . . . . . . . . . . . . 71Verifying the Configuration: Different Address Space. . . . . . . . . . . . . 72Verifying the Configuration: CMS on a Different Platform . . . . . . . . . 73

Chapter 6. Completing the Customization . . . . . . . . . . . . . . . . . . . . . . . . . 75Determining the Topics to Use in this Chapter . . . . . . . . . . . . . . . . . . 76Migrating Your Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Specifying Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81Collecting and Storing Historical Data . . . . . . . . . . . . . . . . . . . . . . . . 82Enabling the Zoom Feature to Access a Session to OMEGAMON II. . 83

Chapter 7. Updating the Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Updating and Changing the Configuration . . . . . . . . . . . . . . . . . . . . 86

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87


List of Tables

Table 1. Symbols in Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Table 2. Advanced Features Available in CICAT . . . . . . . . . . . . . . . . . . . . . . . 35Table 3. Installing Products and Maintenance: A Comparison . . . . . . . . . . . . . 40Table 4. Installing and Configuring: A Comparison . . . . . . . . . . . . . . . . . . . . . 41Table 5. Example Tasks for Installing, Maintaining, and Configuring . . . . . . . . 42Table 6. Locating Information for Installing and Configuring. . . . . . . . . . . . . . 43Table 7. CICAT Modes: Interactive and Batch. . . . . . . . . . . . . . . . . . . . . . . . . 45Table 8. Overview of the Products and Components . . . . . . . . . . . . . . . . . . . 49Table 9. Details about the Relationships and Types of CMSs . . . . . . . . . . . . . . 52

Table 10. Determining the Products and Components You Will Need . . . . . . . . 54Table 11. Determining the Products and Components to Configure . . . . . . . . . 56Table 12. Locating information about configuring the product or component . . 57Table 13. Parameters You Can Use with the Command to Migrate Your Profile 79

List of Tables 5

List of Figures

FIGURE 1. Process for Verifying the Configuration: Same Address Space . . . . . 71FIGURE 2. Process for Verifying the Configuration: Different Address Space . . . 72FIGURE 3. Process for Verifying the Configuration: CMS on a Different Platform 73FIGURE 4. Process for Migrating Your OMEGAMON II Profile . . . . . . . . . . . . . . 77FIGURE 5. Process for Updating and Changing Your Configuration . . . . . . . . . . 86

List of Figures 7

Preface

P
This manual covers the configuration and customization for OMEGAMON® XE for DB2 on z/OS, Version 300.
Use this manual to configure and customize OMEGAMON XE for DB2 on z/OS Version 300.

This manual contains:

� a set of checklists you can use to complete the steps required to configure and customize the product

� an overview of the process for installing and configuring Candle products

� the planning information you should review before you configure the product

� information about using the Candle Installation and Configuration Assistance Tool (CICAT) to configure the product

� the instructions to follow to complete the manual configuration outside of CICAT and manual customization outside of CICAT (if any)

Preface 9

About this Book

About this Book

Who should read this bookThis guide is intended for the users of OMEGAMON XE for DB2 on z/OS, including product administrators and systems programmers.

Where to look for more informationFor 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 www.candle.com

� online help provided with this and the other related products.


Adobe Portable Document Format


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

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

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

3. On the Print pop-up, select one of the Print Range options for� All� Current page� Pages from: [ ] to: [ ]

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

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

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

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

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

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

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

Preface 11


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

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


http://www.adobe.com

Candle Customer Service and Satisfaction

Candle Customer Service and Satisfaction

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

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

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

eNotification notifies you of product updates and new releases.

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

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

Preface 13

http://www.candle.com

http://www.candle.com

Documentation Conventions


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

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

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

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

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

Variables and literals in command syntax examplesIn examples of command syntax for the OS/390, VM, OS/400, and NonStop Kernel platforms, uppercase letters indicate actual values (literals) that the user should type; lowercase letters indicate variables that represent data supplied by the user:

LOGON APPLID (cccccccc)

However, for the Windows and UNIX platforms, variables are shown in italics:

-candle.kzy.instrument.control.file=instrumentation_control_file_name-candle.kzy.agent.parms=agent_control_file_name

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



SymbolsThe following symbols may appear in command syntax:

Table 1. Symbols in Command Syntax

Symbol Usage

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

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

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

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

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

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

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

_ Default values are underscored. Example:

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

Preface 15

Start Here to ConfigureProducts and Maintenance1

IntroductionThis chapter contains a checklist or topic for each of the steps in the process for configuring products and maintenance, that you can use to:

� guide you through the steps in the process for configuring and customizing products and components

� verify that you have used all of the options in CICAT required for your specific situation

� verify that you have completed all the required steps outside of CICAT to configure and customize the products and components

� locate detailed information when you need background information or step-by-step instructions for a specific task

Chapter contentsHow to use the checklists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Checklist: Prerequisites for Configuring Products . . . . . . . . . . . . . . . . . . . 20Checklist: Starting CICAT and Accessing the Menu for Configuration . . . . 21Checklists: Configuring the Product Using CICAT . . . . . . . . . . . . . . . . . . . 22Checklists: Configuring the Product Outside of CICAT . . . . . . . . . . . . . . . 28Checklists: Customizing the Product Outside of CICAT . . . . . . . . . . . . . . . 33Checklist: Updating the Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Using Advanced Features in CICAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35

Start Here to Configure Products and Maintenance 17

Using the Checklists and Topics in this Chapter


How to use the checklists The tasks in the checklists are listed in the order they are performed. You use:

� the first column with the box to track the tasks you complete

� the next column(s) to determine the task

� the last column to locate background information or step-by-step instructions in the resources provided with the product (such as the online help and this guide)

If you are not familiar with Candle, CICAT, or the processIf you are not familiar with Candle terminology, CICAT, or the process of installing, maintaining, and configuring products, see Chapter 2 in this guide.

Determine the checklists and topics to use This chapter contains a checklist or topic for each of the steps in the process for installing, maintaining, and configuring products. In most cases, there is a checklist you can use to verify that you have completed all the tasks.

The following table shows the checklist or topic you should use for your tasks.

Task Checklists and Topics to Use in this Chapter Page #

Complete the configuration of the products or maintenance

! Checklist: Prerequisites for Configuring Products 20

! Checklist: Starting CICAT and Accessing the Menu for Configuration

21

! Checklists: Configuring the Product Using CICAT 22

! Checklists: Configuring the Product Outside of CICAT 28

! Checklists: Customizing the Product Outside of CICAT 33

! Using Advanced Features in CICAT 35



Update or change the configuration for the products

! Checklist: Starting CICAT and Accessing the Menu for Configuration

21

! Checklist: Updating the Configuration 34

! Using Advanced Features in CICAT 35

Task Checklists and Topics to Use in this Chapter Page #


Checklist: Prerequisites for Configuring Products

Checklist: Prerequisites for Configuring Products

Checklist: Prerequisites for configuring products The checklist contains the prerequisite actions you must have completed before you can begin to configure the product.

✓ Prerequisite Location of Information

! If you have not already done so, verify for the product you want to configure that:

! you have the required software

! you have the required DASD space

! the product versions can exist in the same CSI

Installation & Configuration of Candle Products on OS/390 and z/OS

! You must have installed the product and components using CICAT.

� Installation & Configuration of Candle Products on OS/390 and z/OS

� the online help in CICAT ! You must have created a runtime environment (RTE)

using CICAT.

! You must have completed the configuration for a Candle Management Server (CMS).

� Candle Management Server Configuration and Customization Guide

� the online help in CICAT

! If this is the first time you have used Candle products or you are not familiar with the terminology, CICAT, or the process, review an overview.

Chapter 2 in this guide

! If this is the first time you have used Candle products or you do not know the configuration you want, review the background, planning information, and migration information (if any).



Checklist: Starting CICAT and Accessing the Menu for Configuration

Checklist: Starting CICAT and Accessing the Menu for Configuration

Checklist: Start CICAT and access the configuration menuThe checklist contains the steps you perform to start CICAT and access the configuration menu.

✓ TaskLocation of Information

! Using TSO, start CICAT by executing shilev.INSTLIB. Chapter 4 in this guide

! On the CICAT Main Menu, select Configure products and complete the following options on the menu.

! If this is the first time you have used CICAT V300 to configure a Candle product, use Set up configuration environment to specify values that CICAT will use to build the JCL that allocates the runtime data sets for all the products you are configuring.

! Use Select product to configure to display a list of the products available and to select the product you want to configure using the S (Select product) select.

! On the Runtime Environments (RTEs) panel, either:

– if you want to configure an existing RTE, type C (Configure) in the Action field for the RTE

– if you want to create a new RTE, type A (Add) in the Action field and specify the values for the new RTE

! If you are configuring a product that communicates with the CMS, on the Product Configuration Selection Menu enter the selection number of the product or component.



Checklists: Configuring the Product Using CICAT


Background about the possible configurations The table lists the relationships of the CMS to OMEGAMON XE.

The table shows the possible configurations for the Candle Management Server (CMS) and OMEGAMON XE. You can use only one of the following configurations for a single RTE.

Candle Term Description of the Relationship

Local CMS that is installed in the same RTE as the agent

Non-local CMS that is installed on: � MVS, but is not installed and configured in the same RTE as the

agent � MVS, but is not installed and configured in the same CSI as the

agent (For example, the CMS is installed using a different INSTLIB.)

� a platform other than MVS (such as UNIX)

How You Want to Configure the CMS and OMEGAMON XE

Type of CMS to Use

Installed and configured in the same address space Local

Installed and configured in different address spaces Local

Non-local



Determine the checklist to use for configuring productsThe table contains the possible configurations and indicates the location of the checklist for the configuration procedures in CICAT that you need to use.

Relationship of the CMS and OMEGAMON XE

Type of CMS to Use

Checklist to Use

Installed and configured in the same address space

Local “CICAT configuration: Same address space” on page 24

Installed and configured in different address spaces

Local “CICAT configuration: Different address spaces and local CMS” on page 25

Non-local “CICAT configuration: Different address spaces and non-local CMS” on page 26



CICAT configuration: Same address spaceThe following checklist contains the steps you perform in CICAT to begin to configure OMEGAMON XE.

The steps are listed in the order they must be performed. Use the ✓ column to check off steps as you complete them.

✓ Location in CICAT

Configuration Step to Perform in CICAT

Location of Information

! Configure OMEGAMON XE Menu

Use Register with local CMS to specify the CMS for OMEGAMON XE.

Online help in CICAT


If you want to archive the data collected so that you can retrieve it at a later date, use Configure persistent datastore to specify the values for the Persistent Datastore (PDS).



Use Define DB2 subsystem to CMS to specify the IDs of the DB2 subsystems you want to monitor to the CMS. (If you use the default, CICAT automatically defines the DB2 subsystem IDs for you.)



Use Install Agent into local CMS to install the OMEGAMON XE for DB2 agent into the same address space as the CMS.



Use Complete the configuration to display a set of instructions for completing the configuration outside of CICAT. (The instructions are also covered in this guide.)


! Runtime Environments (RTEs) panel

Use L (Load libs after SMP/E) to load the target libraries to the runtime libraries for the RTE.




CICAT configuration: Different address spaces and local CMSThe following checklist contains the steps you perform in CICAT to begin to configure OMEGAMON XE.






Use Register with local CMS to specify the CMS for OMEGAMON XE.






Use Specify Agent address space parameters to� specify the values for the address space � to select the local CMS



Use Create runtime members to generate the job that defines the address space and installs the agent into the address space.










CICAT configuration: Different address spaces and non-local CMSThe following checklist contains the steps you perform in CICAT to begin to configure OMEGAMON XE.












Use Specify Agent address space parameters to specify the values for the address space and either:� if the CMS is in another RTE for this

INSTLIB, select the non-local CMS from a list of CMSs

� if the CMS is in a different INSTLIB or another platform, specify the values for the non-local CMS by using the Advanced key (F5)



Use Create runtime members to generate the job that defines the address space and installs the agent into the address space.







Determining what to do nextSee “Checklists: Configuring the Product Outside of CICAT” on page 28.














Checklists: Configuring the Product Outside of CICAT


Reminder about the information availableIn addition to the detailed information provided in the online help in CICAT, CICAT contains a summary of the information contained in this guide.

The Complete the configuration option on the Configure OMEGAMON XEmenu also displays the manual steps you perform outside of CICAT to complete the configuration.

Determining the checklist to use The table contains the possible configurations and indicates the location of the checklist for the configuration procedures in CICAT that you need to use.

How You Configured the CMS and OMEGAMON XE

Type of CMS You Can Use

Checklist to Use

Installed and configured in the same address space

Local “Outside configuration: Same address space” on page 29

Installed and configured in different address spaces

Local “Outside configuration: Different address space and local CMS” on page 30

Non-local, but installed on OS/390

“Outside configuration: Different address space and non-local CMS” on page 31



Outside configuration: Same address space The steps are listed in the order they must be performed. Use the ✓ column to check off steps as you complete them.

✓ Configuration Steps to Perform Outside CICAT Location of the Information You

Will Need

! If you configured the Persistent Datastore, copy the procedures for the Persistent Datastore

“Copying the Procedures for the Persistent Datastore” on page 69

! Verify the configuration by:

! if you selected SNA as the communication protocol instead of TCP/IP, varying the node for the CMS active

! starting the started task for the CMS

“Prerequisites for verifying the configuration” on page 71

! If you want to: � customize the product to meet the requirements at your

site, see Checklists: Customizing the Product Outside of CICAT

� replicate the product or use the product on another MVS image, see Using Advanced Features in CICAT

Page 33

Page 35



Outside configuration: Different address space and local CMSThe steps are listed in the order they must be performed. Use the ✓ column to check off steps as you complete them.


Will Need

! Copy the procedure for the started task to the procedure library.

“Copying the Procedures for the Started Task” on page 67

! If you selected SNA as the communication protocol for the OMEGAMON XE agent, copy the VTAM definitions and vary the VTAM node active.

“Copying the VTAM Definition and Varying the VTAM Node Active” on page 68

! If you configured the Persistent Datastore, copy the procedures for the Persistent Datastore.



! varying the CMS VTAM major node active


! starting the started task for the agent

“Verifying the Configuration: Different Address Space” on page 72




Page 33

Page 35



Outside configuration: Different address space and non-local CMS The steps are listed in the order they must be performed. Use the ✓ column to check off steps as you complete them.


Will Need

! Copy the procedure for the started task to the procedure library.

“Copying the Procedures for the Started Task” on page 67

! If you selected SNA as the communication protocol for the OMEGAMON XE agent, copy the VTAM definitions and vary the VTAM node active.

“Copying the VTAM Definition and Varying the VTAM Node Active” on page 68

! If you configured the Persistent Datastore, copy the procedures for the Persistent Datastore.


! If the non-local CMS is installed on MVS, complete the configuration by:

! selecting the RTE that contains the non-local CMS

! registering with the local CMS in that RTE

! loading the libraries for the RTE with the non-local CMS

If the non-local CMS is installed on a platform other than MVS, complete the configuration on that platform

“Completing the Configuration for a Non-local CMS” on page 70

Installation guide for that platform




! if you selected SNA as the communication protocol instead of TCP/IP, varying the CMS VTAM major node active



If the non-local CMS is installed on a platform other than MVS, verify the configuration by:

! on the platform where the CMS is installed, starting the CMS


“Verifying the Configuration: Different Address Space” on page 72

“Verifying the Configuration: CMS on a Different Platform” on page 73




Page 33

Page 35


Will Need


Checklists: Customizing the Product Outside of CICAT

Checklists: Customizing the Product Outside of CICAT

Outside customizationThe steps listed in the following checklist for customization are optional. The checklist contains only steps you perform to customize the product for your site and are not required to make the product operational.


✓ Customization Steps to Perform Outside CICAT Location of the Information You

Will Need

! If you want to use the thresholds from your OMEGAMON II for DB2 profile, migrate your profile to OMEGAMON XE.

“Migrating Your Profile” on page 77

! Specify security for the agent. “Specifying security” on page 81

! Collect and store historical data that you can later use with reporting tools.

“Collecting and storing historical data” on page 82

! You can configure the Zoom feature in OMEGAVIEW so that you can access an OMEGAMON II host session and zoom to details about an alert or condition.

“Enabling the Zoom Feature to Access a Session to OMEGAMON II” on page 83

! If you want to replicate the product or use the product on another MVS image, see Using Advanced Features in CICAT

Page 35


Checklist: Updating the Configuration

Checklist: Updating the Configuration

Updating and changing the configuration In some cases, you will need to update the configuration for a product.

The following checklist contains the steps you perform inside and outside of CICAT to update the configuration.


✓ Location of the Information You

Will Need

! Make the changes you want to the configuration in CICAT and

! use the L (Load libs after SMP/E) select on the Runtime Environments (RTEs) panel in CICAT to load the target libraries to the runtime libraries

! perform the manual steps required to complete configuration outside of CICAT (if any)

“Updating the Configuration” on page 85

! If you want to replicate the product or use the product on another MVS image, see Using Advanced Features in CICAT

Page 35


Using Advanced Features in CICAT


Determine the advanced feature to use Use the following advanced features if you

� have completed the appropriate checklist for configuring products

� have completed the appropriate checklist for verifying that the configuration is complete

Table 2. Advanced Features Available in CICAT

TaskAdvanced

FeatureLocation of Information

Port an existing RTE to one or more MVS images, without reconfiguring the RTE for those MVS images

System Variable Support


Replicate and transport an RTE to one or more MVS images

Batch Mode Processing



Overview of Processes,Methods, and CICAT

Modes2
Overview
Review this chapter only if you are not familiar with Candle or the process for installing and configuring Candle products.

Chapter contentsDetermining the Topics to Use in this Chapter . . . . . . . . . . . . . . . . . . . . . 38Candle Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Processes for Installing, Configuring, and Maintaining Products . . . . . . . . 40Background about CICAT Modes: Interactive and Batch . . . . . . . . . . . . . 45

Overview of Processes, Methods, and CICAT Modes 37

Determining the Topics to Use in this Chapter


This chapter provides background information about Candle terminology, process, and the Candle Installation and Configuration Assistance Tool (CICAT).

If you are not familiar with the content, review all of the topics. These topics include:

� Candle terminology

� the process for installing products and the process for installing maintenance (including the similarities and differences between the two processes)

� the process for installing and configuring products and maintenance, and where the steps in the process are performed (including examples of the tasks performed during each of the steps in the process and where to locate the information you will need)

� modes available for working in CICAT and the tasks they are used to complete (Interactive Mode and Batch Mode)

38 OMEGAMON XE for DB2 Configuration and Customization Guide, Version 300

Candle Terminology

Candle Terminology

Terminology

The following list contains some of the terms used in this guide and defines those terms.

Candle Installation and Configuration Assistance Tool (CICAT)

Tool used to: � install new products or new versions of products� install maintenance for existing products� begin the configuration of products or maintenance

(if required for that particular maintenance)

Component Product or feature provided by Candle that is a separate started task

Configuring Making a product operational by completing the configuration of the product inside CICAT and completing the manual steps required outside of CICAT

Cumulative Maintenance

Maintenance through a given date that is customer approved

Customizing Modifying the defaults for options and settings and other changes that reflect the needs of your site

Installing Loading the contents of the Candle product and maintenance and installing a product

Migrating Preserving the customized data so that you can use it in a newer version of the product

Preventive Maintenance

Maintenance through a given date that is customer approved, but not yet included in Cumulative Maintenance

Runtime Environments (RTEs)

A group of runtime libraries that execute Candle products on an MVS image

Runtime libraries Libraries in the RTE that are used by the product when the product is started

Target libraries SMP/E controlled libraries that contain the source from the distribution media


Processes for Installing, Configuring, and Maintaining Products


Processes for installing products and maintenance: a comparison

The following illustration shows the steps in the process and compares the steps you perform when:

� installing new products or new versions of existing products

� installing maintenance for existing products

Table 3. Installing Products and Maintenance: A Comparison

Step in the ProcessRequired to Install

Products?Required to Install

Maintenance?

Prepare to install products and maintenance X X

Load and start CICAT X X

Install products and components X

Install maintenance (if any) X X

Begin to configure the products and components

X X

Complete the configuration of products and components by performing the manual steps required to make the product operational

X

Once configured, complete the manual steps to customize the product for your site (if any)

X

If you want to replicate Candle products or use Candle products on other MVS images, use some of the advanced features in CICAT designed to make this implementation easier

X X



Processes for installing and configuring products: a comparison

The following illustration shows the steps in the process and compares the steps you perform when:

� installing new products or new versions of existing products

� installing maintenance for existing products

Table 4. Installing and Configuring: A Comparison

Step in the ProcessPerformed in

CICAT?Performed Outside

of CICAT?

Prepare to install products and maintenance X

Load and start CICAT V300 X (if CICAT has been previously installed)

X (if you are installing CICAT for the first

time)

Install products and components X

Install maintenance (if any) X

Begin to configure the products and components

X


X


X

If you want to replicate Candle products or use Candle products on other MVS images, use some of the advanced features in CICAT designed to make this implementation easier

X



Example tasks in the process The table shows some examples of tasks you perform.

Table 5. Example Tasks for Installing, Maintaining, and Configuring

Step in the Broad Process Examples of Tasks

Prepare to install products and maintenance

� Review the software and space requirements for CICAT and the products and components you want to install

� Perform optional steps to prepare, such as backup your existing data sets

Load and start CICAT � Review the available files and the information in the DOCFILE

� If you are using CICAT for the first time and do not have an earlier version of CICAT installed, load CICAT from the distribution media

Install products and components

� Specify the high-level qualifiers for the product libraries � Allocate the product libraries � Receive and apply product components

Install maintenance (if any) � Review information about the PTFs provided in the DOCFILE

� Receive and apply product maintenance

Begin to configure the product and components

� Inside CICAT, create or select the RTE that will contain the product you want to configure

� Inside CICAT, specify basic configuration values for the product


� Outside of CICAT, manually copy members and libraries required by the product

� Outside of CICAT, verify the configuration by starting the product and displaying data in the user interface


� For some products, specify the security settings� For some products, specify the monitoring options

specific to your site



Where to find the information you will need The table shows the steps in the process and where to locate the information you will need.

If you want to replicate or use Candle products on other images, use some of the advanced features in CICAT

� Use Batch Mode to replicate and transport RTEs � Port an existing RTE to one or more MVS images

without reconfiguring the RTE for those MVS images

Table 6. Locating Information for Installing and Configuring

Step in the Broad Process Where to Locate Information about Procedures

Where to Locate Information about

Specific Values

Outside of CICAT, prepare to install products and maintenance



If you are: � migrating from CICAT

V200, load and start CICAT V300 using CICAT V200

� installing CICAT V300 for the first time, load and start CICAT outside of CICAT



Using CICAT, install products and components



Using CICAT, install maintenance (if any)



Table 5. Example Tasks for Installing, Maintaining, and Configuring

Step in the Broad Process Examples of Tasks



Using CICAT, begin to configure the products and components



Outside of CICAT, complete the configuration of products and components by performing the manual steps required to make the product operational

This guide

The Complete the configuration option on the Configure OMEGAMON XE Menu


Outside of CICAT, complete the manual steps to customize the product for your site (if any)

This guide Online help in CICAT

If you want to replicate Candle products or use products on other images, use some of the advanced features in CICAT



Table 6. Locating Information for Installing and Configuring

Step in the Broad Process Where to Locate Information about Procedures

Where to Locate Information about

Specific Values


Background about CICAT Modes: Interactive and Batch


Modes provided in CICAT

CICAT has two modes:

� Interactive Mode

� Batch Mode

The following table provides a description for each of the two modes.

Table 7. CICAT Modes: Interactive and Batch

Mode Description

Interactive ISPF panel-driven facility that assists you in specifying parameters and tailoring jobs for � installing and configuring new products � installing and configuring new versions of products � installing maintenance

Batch Facility that creates a single batch job that you can use to build, configure, and load an RTE. This single job performs all of the same RTE processing as the interactive CICAT.

Batch Mode is a simple and useful way of replicating RTEs to other MVS systems.


Plan Your Configuration

3
Overview
This chapter contains information that you should review before configuring products and maintenance. This chapter:

� contains background about the products and components

� helps you determine the components to configure

Chapter contentsDetermining the Topics to Use in this Chapter . . . . . . . . . . . . . . . . . . . . . 48Candle Products and Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49Details about the Candle Products and Components . . . . . . . . . . . . . . . . 52Determining the Components to Install and Configure . . . . . . . . . . . . . . . 54Requirements and Restrictions for OMEGAMON XE . . . . . . . . . . . . . . . . 58

Plan Your Configuration 47



Relationship of the topics in this chapter and the checklists

This chapter contains topics that correspond to the tasks in Checklist: Prerequisites for Configuring Products in Chapter 1.

Determining the topics to use in this chapter

If you are not sure of the topics you will need in this chapter or you are not using a checklist, review the matrix to determine the pages to use in this chapter. The R indicates that topic is required. The O indicates the topic is optional.

Page Numbers for Topics

49 52 54 58

Determine the products and components to configure and whether or not the products and components have manual steps performed outside of CICAT

O

Review details provided for some of the products and components

O

Review information about Candle products and components

O

Review the requirements and restrictions for the products

R


Candle Products and Components


Background about how CICAT installs products and components When you use CICAT, CICAT automatically installs all the required and optional products and components.

In most cases, you must also configure the components to make them available.

Background about the products and components The following table shows all the product and components available with the Candle products that monitor DB2 and DB2 subsystems.

Table 8. Overview of the Products and Components

Component Name or Category Purpose

Platform(s) for Product or Component

CandleNet Command Center® interface

Component that is the graphical user interface (GUI) you use to display and work with data provided by the CMS or agent. These include: � the Windows based GUI Candle Management

Workstation® (CMW™) that communicates with the CMS

� the Java based GUI CandleNet Portal® (CNP) that communicates with the CMS (The interface can be run in desktop or browser mode.)

� the Java based GUI CandleLight Workstation that communicates directly with an agent one agent at a time (automatically installed with the CMW).

� Windows 2000



OMEGAMON XE and agents

Component that monitors systems, subsystems, and applications on the system where they are installed. The component: � collects data and monitors performance � provide data and performance information to

the CMS � receive instructions from the CMS � issue commands to the system or application

you are monitoring Agents can be: � OMEGAMON XE (Collect performance and

analysis data.)� Alert Adapters (Monitors alerts and relay the

information from console or message logs, network management products, and system management product.)

� Alert Emitters (Monitors events or exceptions in products running under the control of the CMS and relay them back for corrective action (if applicable).)

� Gateways (Communicate events to a management application running on a supported platform using a network service.)

Platform appropriate for the system or software being monitored

Candle Management Server (CMS)

Component that: � consolidates the data collected by the agent

and distributes the data to the CCC interface � in some cases, receives commands from the

CCC interface and distributes them to the appropriate agent

� stores historical data and prototypes for configuration in the form of seed data

� Windows 2000� MVS � UNIX

Candle Subsystem

Component that is an MVS subsystem that runs in its own address space that provides dynamic I/O activity to OMEGAMON II

MVS





Event Manager Using the Common Interface (CI), is the environment where data for object and volume analysis is performed

MVS

OMEGAMON II Component that collects and displays data in the OMEGAMON II user interface(s). These include: � the menu driven CUA interface that is IBM

SAA/CUA compliant � the facility that allows multiple OMEGAMON

IIs execute in the same address space and that communicates with all of them, the Common Interface (CI)

� for some OMEGAMON IIs, the command driven Classic interface

MVS

OMEGAVIEW® Product that can be used to: � display data from all the OMEGAMON IIs in a

single location � display an OMEGAMON II session in an

OMEGAMON XE for DB2 on z/OS so that the condition that caused an alert can be researched in OMEGAMON II

MVS

Persistent Datastore (PDS)

Component that records and stores historical data that you can access using a CCC interface

MVS




Details about the Candle Products and Components


Details about the relationships and types of CMSsThe following table shows the types of CMSs, the relationship for the type, and a description of the relationship.

Table 9. Details about the Relationships and Types of CMSs

Relationship Candle Term

Description

CMS to CMS relationship

Hub CMS that:� receives data from agents and Remote CMSs in the

environment � communicates data and to and receives command from

an interface

Remote CMS that: � receives data from agents � communicates data to the Hub CMS only (It does not

communicate directly with an interface.)

CMS to agent relationship

Local CMS that is installed in the same RTE as the agent

Non-local CMS that is installed on: � MVS, but is not installed and configured in the same RTE

as the agent. � MVS, but is not installed and configured in the same CSI

as the agent. (For example, the CMS is installed using a different INSTLIB.)

� a platform other than MVS (such as UNIX)



Details about OMEGAMON XE for DB2 on z/OSOMEGAMON XE for DB2 on z/OS is an agent that you can use to monitor the performance of DB2 subsystems.

The data collected by OMEGAMON XE for DB2 on z/OS can then be displayed using CandleNet Portal® or the Candle Management Workstation®

For example, you can use OMEGAMON XE for DB2 on z/OS to monitor the performance of these characteristics of DB2 subsystems:

� buffer pool management

� CICS connections and threads

� DDF conversations and statistics

� the data sharing groups between DB2 subsystems

� the shared resources between DB2 subsystems

� volume use information

� group buffer pool statistics

� thread activity and statistics


Determining the Components to Install and Configure


Components that can be shared by more than one productIn some cases, a product or component can be shared by more than one product. If you have already installed and configured these types of components, you can use the existing component.

For example, you can use the Candle Management Server (CMS) with more than one Candle product.

If you are going to use an existing component, the component must be current. You must have installed and configured the component for another Candle product at the same level.

Determining the products and components you will needThe following table shows the products and components available with the products. The table also indicates:

� which products use the components and whether or not they are required (R) or optional (O) (A blank indicates that the product does not use the component.)

� whether or not the component can be shared

� additional information that might help you decide whether or not you want to configure the component (if any)

Table 10. Determining the Products and Components You Will Need

Component Name or Category O

ME

GA

MO

N X

Efo

r D

B2

on

z/O

S

Can be Shared?

Additional Information (If Any)

Candle Management Server (CMS)

R Y

OMEGAMON II O N



Candle Subsystem R Y Required only if you configure OMEGAMON II.

Candle recommends that you use one Candle Subsystem for all the Candle products and components you install and configure.

Event Manager O N Required only if you configure OMEGAMON II.

Requires that the Common Interface (CI) be configured and started.

If you do not configure this component for OMEGAMON XE for DB2 on z/OS, you will not receive data for: � Object Analysis Database� GOA Thread Database� Group Object Activity Database� GOA Volume Thread� GOA Volume

OMEGAVIEW® O Y Configure this component only if you want to access an OMEGAMON II session using the zoom feature.

Agents R Y

Persistent Datastore (PDS)

O N You can configure the PDS with the CMS or with the agent (depending on how you choose to configure the agent).

CandleNet Command Center® interface

R Y

Component Name or Category O

ME

GA

MO

N X

Efo

r D

B2

on

z/O

S

Can be Shared?

Additional Information (If Any)



Determining whether or not you have to configure the products and components

The table shows the components and indicates whether or not you must:

� configure the component using CICAT to make the component available to the product

� perform manual steps outside of CICAT to configure the component to make it available to the product.

Table 11. Determining the Products and Components to Configure

Component Name or Category Configure Using CICAT?

Requires Manual Steps Outside of

CICAT?

Candle Management Server (CMS) Y Y

OMEGAMON II Y Y

Candle Subsystem Y Y

Event Manager Y Y

OMEGAVIEW® Y Y

Agents Y Y

Persistent Datastore (PDS) Y Y

CandleNet Command Center® interface N/A N/A



Locating information about configuring the product or componentThe table shows where you can locate information about configuring the product or component if it is not included in this guide.

Table 12. Locating information about configuring the product or component

Component Name or Category Location of Information for Configuring

the Product or Component

Candle Management Server (CMS) Installation & Configuration of Candle Products on OS/390 and z/OS

OMEGAMON II Configuration and Customization Guide for the product

Candle Subsystem Configuration and Customization Guide for OMEGAMON II

Event Manager Configuration and Customization Guide for OMEGAMON II

OMEGAVIEW® Configuration and Customization Guide for the product

Agents This guide

Persistent Datastore (PDS) Historical Data Collection Guide for OMEGAMON XE and CandleNet Command Center

CandleNet Command Center® interface Installing Candle Products on Windows and OS/2


Requirements and Restrictions for OMEGAMON XE

Requirements and Restrictions for OMEGAMON XE

Requirements and RestrictionsIf you want to install more than one product that monitors DB2 in the same CSI, you must use the following versions of the products.

� OMEGAMON XE for DB2 on z/OS Version 300

� OMEGAMON II for DB2 Version 540


Start CICAT and Access theMenu for Configuring4

OverviewThis chapter provides detailed information about

� starting CICAT

� accessing the menu in CICAT for configuring the product

� using CICAT defaults and restrictions, and some of the commands available to assist while using CICAT to install products and maintenance

Chapter contentsDetermining the Topics to Use in This Chapter . . . . . . . . . . . . . . . . . . . . . 60Starting CICAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61Accessing the Menu for Configuring the Product. . . . . . . . . . . . . . . . . . . . 62Using CICAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Start CICAT and Access the Menu for Configuring 59

Determining the Topics to Use in This Chapter

Determining the Topics to Use in This Chapter

Relationship of the topics in this chapter and the checklistsThis chapter contains topics that correspond to the tasks in Checklist: Starting CICAT and Accessing the Menu for Configuration in Chapter 1.

This chapter also contains a topic that covers some additional information about using CICAT (such as CICAT defaults and commands).


If you are not sure of the topics you will need in this chapter or you are not using a checklist, review the matrix to determine the pages to use in this chapter. The R indicates that the topic is required. The O indicates the topic is optional.


page61

page62

page63

Start CICAT R

Access the menu for configuring the product in CICAT R

Review information about restrictions, defaults, commands, and functions

O


Starting CICAT

Starting CICAT

Start CICAT

Follow these steps to start CICAT.

1. Log onto a TSO session.

2. Invoke ISPF.

3. Go to a TSO command line. (In most cases, this is option 6 on the ISPF Primary Option Menu.)

4. Enter the following command:

EX ‘shilev.INSTLIB’

(where shilev is the high-level qualifier you specified for CICAT)

Result: CICAT first displays the copyright panel and then the CICAT Main Menu. (Both the copyright panel and the CICAT Main Menu display the version and release of CICAT.)


Accessing the Menu for Configuring the Product

Accessing the Menu for Configuring the Product

Select the product to configure and access the menu

Follow these steps to access the Configure OMEGAMON XE Menu.

1. If this is the first time you have used CICAT V300 to configure a product, from the CICAT Main Menu select Configure products > Set up configuration environment.

2. From the CICAT Main Menu, select Configure products > Select product to configure.(Only those packages that are eligible to be configured are listed on this panel.)

3. On the Product Selection Menu, specify S to select a product to be configured. You can only select one product at a time for configuration.Result: CICAT displays the Runtime Environments (RTEs) panel.

4. On the Runtime Environments (RTEs) panel, specify: � to use an existing RTE, the C (Configure) select

� to create a new RTE, the A (Add), B (Build libraries), and C (Configure) selects

Result: CICAT displays the Product Configuration Selection Menu.

5. On the Product Configuration Selection Menu, select the component you want to configure.Result: CICAT displays the Configure OMEGAMON XE Menu.


Using CICAT

Using CICAT

Defaults provided with CICAT

Whenever possible, CICAT provides defaults for fields and options. These defaults

� when provided, should be sufficient to complete the installation of products and maintenance

� can be changed to values specific to your site

Assistance provided in CICAT

Whenever possible, CICAT checks the values you specify and verifies that you have specified the required values. If CICAT detects an error or omission, it displays a short message.

Display requirements in ISPF

If you are using a 3270 Model 2 (24 x 80) display, you must turn off the pre-defined function (PF) keys so that the CICAT panels are not truncated.

To turn off the pre-defined function keys, type PFSHOW on any command line and press Enter until the function keys no longer appear.

Restrictions

The length of the high-level qualifier for the runtime libraries must be 26 characters or less.

You cannot use

� the ampersand character (&) as input data in CICAT interactive or batch mode

� the ISPF feature for edit recovery

(If the ISPF RECOVERY ON command is entered, edits will produce a recovery error message. Enter the RECOVERY OFF command to suppress the error messages.)


Using CICAT

Commands and functions

The following list shows some of the commands and functions available in CICAT, that you can use for navigation and to display information.

Advanced key On some panels for configuring products, displays panels where you can specify specialized values (such as values for the Persistent Datastore for a CMS).

End key Returns to the previous panel.

Enter key Accepts the values you have specified and displays the next panel in the process.

HELP command Displays information about a panel or the extended description for a message.

README command Displays the README for the current version of CICAT.

README APP command Displays information about default applids for started tasks and VTAM, and how CICAT processes VTAM applids.

README ERR command Displays a list of CLIST error codes and descriptions (for both interactive and batch mode).

README SYS command Displays a information about system variable support.

UTIL command Displays the Installation Services and Utilities menu.


Completing the ConfigurationOutside of CICAT5

IntroductionThis chapter contains information about the manual steps you must perform outside of CICAT to complete the configuration of OMEGAMON XE . This chapter provides:

� the step-by-step instructions for completing the configuration outside of CICAT

� the procedure to follow to verify the configuration of the OMEGAMON XE agent

Chapter contentsDetermining the Topics to Use in this Chapter . . . . . . . . . . . . . . . . . . . . . 66Copying the Procedures for the Started Task. . . . . . . . . . . . . . . . . . . . . . . 67Copying the VTAM Definition and Varying the VTAM Node Active . . . . . 68Copying the Procedures for the Persistent Datastore . . . . . . . . . . . . . . . . . 69Completing the Configuration for a Non-local CMS . . . . . . . . . . . . . . . . . 70Verifying the Configuration: Same Address Space . . . . . . . . . . . . . . . . . . 71Verifying the Configuration: Different Address Space . . . . . . . . . . . . . . . . 72Verifying the Configuration: CMS on a Different Platform. . . . . . . . . . . . . 73

Completing the Configuration Outside of CICAT 65




This chapter contains topics that correspond to the tasks in Checklists: Configuring the Product Outside of CICAT in Chapter 1.


If you are not sure of the topics you will need in this chapter or you are not using a checklist, review the matrix to determine the pages to use in this chapter.

The R indicates that you must review the topic to determine whether or not it is required.


67 68 69 70 71 72 73

The agent and CMS are installed and configured in the same address space

R R R

The agent and CMS are installed in different address spaces and the CMS is a local CMS

R R R R

The agent and CMS are installed in different address spaces and the CMS is a non-local CMS

R R R R R


Copying the Procedures for the Started Task

Copying the Procedures for the Started Task

Background about the started tasks When you use CICAT to install and configure a product or component, CICAT creates the started task procedures.

You must copy the started task procedures to your procedure library (PROCLIB) to complete the configuration.

Copy the procedures for the started tasks to your procedure library You must copy the started task procedures for the product from rhilev.midlev.RKANSAM to your procedure library (PROCLIB).


Copying the VTAM Definition and Varying the VTAM Node Active

Copying the VTAM Definition and Varying the VTAM Node Active

Background about the VTAM definitions and the VTAM major nodeIf you configured OMEGAMON XE to use SNA as the communication protocol, CICAT created VTAM definitions.

To complete the configuration, you must:

� copy the VTAM definition to VTAMLST

� vary the VTAM major node active

Copy VTAM definitions and vary the VTAM major node activeFollow this procedure to complete the configuration for the SNA communication protocol.

1. Copy the VTAM definition from rhilev.midlev.RKANSAM to VTAMLST. The VTAM definition in rhilev.midlev.RKANSAM has the same name you specified using CICAT for either:

� the VTAM major node

� the Candle global VTAM major node (The default is KCANDLE1.)

2. Vary the VTAM major node active using the following command. V NET,ACT,ID=ccccccccc

The ccccccccc indicates the name for the VTAM major node you specified using CICAT for either:

� the VTAM major node

� the Candle global VTAM major node


Copying the Procedures for the Persistent Datastore

Copying the Procedures for the Persistent Datastore

Background about the procedures for the persistent data storeThe persistent data store (CT/PDS) is used to store the data for historical collection.

When you install and configure the CT/PDS using CICAT, CICAT creates the procedures for the CT/PDS.

If you decided to configure the CT/PDS, you must copy these procedures to your procedure library (PROCLIB) to complete the configuration.

Copy the procedures to your procedure library If you configured the CT/PDS, you must copy the following procedures from rhilev.midlev.RKANSAM to your procedure library (PROCLIB).

� pdsmprefix1

� pdsmprefix2

The value for pdsmprefix is the unique prefix you specified for the maintenance procedure using CICAT. The default is KPDPROC.


Completing the Configuration for a Non-local CMS

Completing the Configuration for a Non-local CMS

Completing the configuration: non-local CMS on MVS If you are completing the configuration for a non-local Candle Management Server (CMS) that is installed on MVS, you must complete the steps listed in this table to register with the non-local CMS on MVS.

Completing the configuration: non-local CMS on a platform other than MVS

If the CMS is installed on a platform other than MVS, see the Installation Guide for that platform.

Step Action

1 Perform the appropriate action. � If the CMS is installed and configured in a different RTE in the same

CSI, return to the Runtime Environments (RTEs) panel.� If the CMS is installed and configured in a different CSI, access CICAT

in that CSI and access the Runtime Environments (RTEs) panel.

2 On the Runtime Environments (RTEs) panel, use the C (Configure) action code to select the RTE where the non-local CMS is installed and configured.

3 On the Product Configuration Selection Menu, select the product.

4 On the Configure OMEGAMON XE Menu, select Register with local CMS.

5 On the Runtime Environments (RTEs) panel, use the L (Load libs after SMP/E) to load the target libraries to the runtime libraries for the RTE.


Verifying the Configuration: Same Address Space

Verifying the Configuration: Same Address Space

Prerequisites for verifying the configurationIn addition to completing the configuration for the product, you must also have:

� completed the configuration of the interface you want to use

� completed the configuration of the CMS on the appropriate platform (including seeding the CMS using the interface)

Process to follow to verify the configuration Follow this process to verify the configuration by starting the product. Follow this process only if:

� the CMS is installed on MVS

� the product and the CMS are installed in the same address space

FIGURE 1. Process for Verifying the Configuration: Same Address Space

If the Candle Management Server (CMS) is not already running, vary the CMS VTAM major node active.

.

If the CMS is not already running, start the started task for the CMS.

Using the appropriate CandleNet Portal interface, connect to the Hub CMS and use theinterface to verify that the data for the product is being displayed.


Verifying the Configuration: Different Address Space

Verifying the Configuration: Different Address Space

Prerequisites for verifying the configurationIn addition to completing the configuration for the product, you must also have completed the configuration of the:

� interface you want to use

� CMS on the appropriate platform (including seeding the CMS)


� the CMS is installed on MVS

� the agent and CMS are in different address spaces

FIGURE 2. Process for Verifying the Configuration: Different Address Space

If you selected SNA as the communication protocol for the agent instead of TCP/IP and the CMS is not already running, vary the CMS VTAM major nodeactive.

If the CMS is not already running, start the started task for the CMS.

Start the started task for the product and components you configured.

Using the appropriate CandleNet Portal interface, connect to the Hub CMSand use the interface to verify that the data for the product is being displayed.


Verifying the Configuration: CMS on a Different Platform


Prerequisites for verifying the configurationIn addition to completing the configuration for the product, you must also have:

� completed the configuration of the interface you want to use

� completed the configuration of the CMS on the appropriate platform (including seeding the CMS using the interface)


� you installed the agent on MVS

� the CMS in installed on a different platform

FIGURE 3. Process for Verifying the Configuration: CMS on a Different Platform

.

If the CMS is not already running, start CMS on the platform where it is installed.(For information about using a CMS on a different platform, see the InstallationGuide for that platform.)

Start the started task for the product and components you configured.

Using the appropriate CandleNet Portal interface, connect to the Hub CMSand use the interface to verify that the data for the product is being displayed.


Completing the Customization

6
Introduction
This chapter contains information about the manual steps you must perform outside of CICAT to complete the customization.

Chapter contentsDetermining the Topics to Use in this Chapter . . . . . . . . . . . . . . . . . . . . . 76Migrating Your Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77Specifying security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81Collecting and storing historical data . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82Enabling the Zoom Feature to Access a Session to OMEGAMON II . . . . . 83

Completing the Customization 75




This chapter contains topics that correspond to the tasks in Checklists: Customizing the Product Outside of CICAT in Chapter 1.


The tasks listed in the following table for customization are optional. The table contains only steps you perform to customize the product for your site and are not required to make the product operational.

If you are not sure of the topics you will need in this chapter or you are not using a checklist, review the matrix to determine the pages to use in this chapter. The O indicates the tasks in the topic are optional.


77 81 82 83

Collect and store historical data that you can later use with reporting tools

O

If you are installing OMEGAMON XE for DB2plex and you want to access a session in OMEGAMON II, enable the Zoom feature

O

Migrate your existing OMEGAMON II profile so that the thresholds in the profile can be used as predefined situations in OMEGAMON XE

O

Specify security for the product O


Migrating Your Profile


Background about migrating your profile CandleNet Portal provides a utility that you can use to migrate your existing OMEGAMON II profile so that the thresholds in the profile can be used as predefined situations in OMEGAMON XE.

Prerequisites for migrating your profile You must have CandleNet Portal installed on your workstation to access the utility. (The utility you use to migrate your existing OMEGAMON II profile is provided with CandleNet Portal.)

Overview of the process of migrating your profile The illustration shows the process for migrating your existing OMEGAMON II profile so that the thresholds in the profile can be used as predefined situations in OMEGAMON XE.

FIGURE 4. Process for Migrating Your OMEGAMON II Profile

.

Prepare the profile to be migrated by exporting and transferring the profile to the workstation where you have CandleNet Portal installed.

.

On the workstation, run the utility to create the equivalent predefined situations.

.

Make the predefined situations available by seeding the situations with the Candle Management Server (CMS).



Preparing the profile for migrationPerform the following steps to prepare the profile to be migrated.

Migrating the profile using the command for utility Once you have prepared the profile for migration, follow this procedure to migrate the profile using the command for the utility.

The following table:

� lists the parameters available with the KXEMIGR command

� indicates whether or not the parameter is required (Parameters with default values are optional.)

� provides a description of the purpose of the parameter

Step Action

1 Export the file that contains the profile.

2 Using a program that transfers files, transfer the file that contains the profile to the workstation where CandleNet Portal is installed.

3 On the workstation, copy the file to drive:\Candle\CNPS.

For example, if you have installed CandleNet Portal on your c: drive, you would copy the file to the c:\Candle\CNPS directory.

Step Action

1 On the workstation, open a DOS session.

2 Change the directory in the DOS session to drive:\Candle\CNPS.

3 At the prompt, specify the following command.

KXEMIGR <options> profile pp <outfile> <ctl>

Result: The utility creates the file that contains the migrated profile, the control file, and the log (if any).



Table 13. Parameters You Can Use with the Command to Migrate Your Profile

Parameter Required? Purpose

profile Yes Specifies the name of the file that you exported that contains the profile.

pp Yes Specifies the product code.

outfile No Specifies the name of the file that will contain the migrated profile. The default is Kpp_UPD.SQL (where pp is the 2 character product code).

ctl No Specifies the name of the product control file. The default is KppPROD.txt (where pp is the 2 character product code).

options No Specifies the following option. � To display diagnostic messages for the utility, specify

-v. � To display help, specify -?. � To migrate predefined situations with the status of

critical and exclude the migration of situtations with a status of warning, specify -nw.



Completing the migration by seeding the file with the CMS For the predefined situations to be available to CandleNet Portal, you must seed the predefined situations with the CMS. Follow this procedure to seed the predefined situations with the CMS.

Step Action

1 On the workstation, select the Start command.

2 On the Start menu, select the Programs command.

3 On the Programs menu, select the command for Candle products.

4 On the menu, select the Manage Candle Services command.

Result: The program displays the Manage Candle Services dialog.

5 On the Action menu, select the Advanced command.

6 On the Advanced menu, select the Seed CMS command.

Result: The program displays the Seed CMS dialog.

7 On the Seed CMS dialog, specify the options you want.

For a CMS on your workstation, select the On this computer radio button and the Monitoring and automation definitions check box.

For a CMS installed on a different computer, select the On a different computer radio button and the Monitoring and automation definitions check box.

Result: The program displays the Select Product to Seed CMS dialog.

8 On the Select Product to Seed CMS dialog, select the migration data for OMEGAMON XE for DB2.

9 Select the OK button.

Result: The program seeds the CMS and saves any messages or errors in the log file.


Specifying Security

Specifying Security

Specifying security Security for OMEGAMON XE is controlled using the Candle Management Workstation® (CMW). For example, user access and user authorities are granted using the CMW.

For information about specifying security, see the Administering OMEGAMON Products: CandleNet Portal.


Collecting and Storing Historical Data

Collecting and Storing Historical Data

Collecting and storing historical data You can customize OMEGAMON XE to collect and store historical data. You can then use:

� a CandleNet Command Center® interface to display short term history

� a reporting tool to display the long term history stored using one of the available methods

For information about collecting and storing historical data, see the Historical Data Collection Guide for OMEGAMON XE and CandleNet Command Center.


Enabling the Zoom Feature to Access a Session to OMEGAMON II


Background about the Zoom featureYou can use the Zoom feature to research the cause of an alert by displaying and reviewing the conditions raised by the OMEGAMON II product.

Prerequisites for using the Zoom featureYou must have installed and configured the:

� OMEGAMON XE for DB2plex product

� the corresponding OMEGAMON II

� OMEGAVIEW

You must have a logon ID for OMEGAVIEW with administrator authority.

Procedure to follow to use the Zoom feature Follow this procedure to enable the Zoom feature in OMEGAMON XE.

1. Log on to an OMEGAVIEW session.

2. On the Tools menu, select Tools > Configuration Manager.

3. On the Session Type pop-up, select the session type appropriate for the OMEGAMON II.

4. On the Add Session Information pop-up, complete the fields and press Enter.

5. On the Configuration Manager panel, confirm that the OMEGAMON II sessions you want to zoom to are active. (If the session is not active, type R in the select field to start a new session.)

6. Exit OMEGAVIEW.


Updating the Configuration

7
Introduction
This chapter contains information about updating and changing your configuration.

Chapter contentsUpdating and Changing the Configuration . . . . . . . . . . . . . . . . . . . . . . . . 86

Updating the Configuration 85

Updating and Changing the Configuration

Updating and Changing the Configuration

Example of a change to the configuration that requires manual stepsIf the changes you make in CICAT are to configuration values that also require manual steps outside of CICAT, you must also perform the steps outside of CICAT when you update or change the values in CICAT.

For example, if you are using the persistent data store and you change the prefix for the procedure using CICAT, you must also copy the renamed procedure to your PROCLIB.

For step-by-step instructions for these tasks, see Chapter 5 in this guide.

Overview of the process for updating or changing your configurationThe illustration shows the process for updating or changing your configuration.

FIGURE 5. Process for Updating and Changing Your Configuration

.Using CICAT, make the changes you want to the configuration.

.

On the Runtime Environments (RTEs) panel in CICAT, use the L (Load libs after SMP/E select to load the target libraries to the runtime libraries.

.

If the changes are to values that require manual steps outside of CICAT to complete the configuration, perform the appropriate steps.


Index

definition 53

AAbout 10accessing

menu for configuring 21, 62accessing the menu

checklist 21Adobe portable document format 11advanced features 35Advanced key 64agent

53

Bbatch mode processing 35, 45

CCandle Installation and Configuration

Assistance Tool (CICAT) 39Candle terminology 39Candle Web site 13CandleNet Portal

definition 53changing the configuration 86checklists 17, 18CICAT

accessing the menu for configuring 62commands 64defaults 63definition 39displaying information in 64functions 64modes 45release 61restrictions 63starting 61

version 61CMS

configuring for non-local 70seeding for migrated profiles 80

components 39definition of shared 49

configuringdefinition 39inside CICAT 24migrating your profile 78outside of CICAT 28prerequisites 20updating or changing 86

creating a new RTE 62cumulative maintenance 39customizing

definition 39detailed procedures 75

Ddefaults provided with CICAT 63displaying information in CICAT 64

Eedit recovery 63End key 64Enter key 64

Gglobal VTAM major node 68

HHELP command 63, 64

Iinstalling

Index 87

definition 39interactive mode 45invoking ISPF 61ISPF display requirements 63

KKXEMIGR command and parameters 78

Mmenu for configuring 62migrating 39modes in CICAT 45

Nnon-local CMS

definition 70

PPDF files, adding annotations 12PFSHOW command 63predefined situations

migrating existing profiles 80preventive maintenance

definition 39printing problems 11procedures

copying for the persistent datastore 69copying for the started tasks 67

processesconfiguring products 41installing maintenance 40installing products 40

PROCLIBpersistent datastore 69started tasks 67

profile migration 77

RREADME APP command 64README command 64README ERR command 64

README SYS command 64RECOVERY OFF command 63RECOVERY ON command 63restrictions in CICAT 63RTE 39Runtime Environments (RTEs) 39

Ssecurity

specifying 81specifying security 81started tasks

copying procedures 67starting CICAT 21, 61system variable support 35

Tterminology 39

Uupdating

detailed procedures 85the configuration 86

usingchecklists in this guide 18

using an existing RTE 62UTIL command 64

VVTAMLST

copying the VTAM definition 68

WWeb site, Candle 13

ZZoom feature 83


Configuration and Customization Guide€¦ · Configuration and Customization Guide OMEGAMON® XE...

Documents

Transcript of Configuration and Customization Guide€¦ · Configuration and Customization Guide OMEGAMON® XE...