Configuration and Customization Guide OMEGAMON XE for DB2 on z/os

Transcription

1 Configuration and Customization Guide OMEGAMON XE for DB2 on z/os Version 300 G August 2004 Candle Corporation 100 North Sepulveda Blvd. El Segundo, California

2 Registered trademarks and service marks of Candle Corporation: AF/OPERATOR, AF/REMOTE, Availability Command Center, Candle, Candle CIRCUIT, Candle Command Center, Candle Direct logo, Candle edelivery, Candle Electronic Customer Support, Candle logo, Candle Management Server, Candle Management Workstation, CandleLight, CandleNet, CandleNet Command Center, CandleNet ebusiness Platform, CandleNet Portal, CL/CONFERENCE, CL/SUPERSESSION, CommandWatch, CT, CT/Data Server, CT/DS, DELTAMON, DEXAN, eba, eba*servicemonitor, eba*servicenetwork, ebusiness at the speed of light, ebusiness Assurance, ebusiness Institute, ELX, EPILOG, ESRA, ETEWatch, IntelliWatch, IntelliWatch Pinnacle, MQSecure, MQView, OMEGACENTER, OMEGAMON, OMEGAMON II, OMEGAMON Monitoring Agent, OMEGAMON Monitoring Agents, OMEGAVIEW, OMEGAVIEW II, PQEdit, Response Time Network, Roma, SitePulse, Solutions for Networked Applications, Solutions for Networked Businesses, TMA2000, Transplex, and Volcano. Trademarks and service marks of Candle Corporation: AF/Advanced Notification, AF/PERFORMER, Alert Adapter, Alert Adapter Plus, Alert Emitter, AMS, Amsys, AutoBridge, AUTOMATED FACILITIES, Availability Management Systems, Business Services Composer, Candle Alert, Candle Business Partner Logo, Candle Command Center/SentinelManager, Candle CommandPro, Candle esupport, Candle Insight, Candle InterFlow, Candle Managing what matters most, Candle Service Suite, Candle Technologies, CandleNet, CandleNet 2000, CandleNet Conversion, CandleNet ebp, CandleNet ebp Access for S.W.I.F.T., CandleNet ebp Administrator, CandleNet ebp Broker Access for Mercator or MQSI, CandleNet ebp Configuration, CandleNet ebp Connector, CandleNet ebp File Transfer, CandleNet ebp Host Connect, CandleNet ebp Object Access, CandleNet ebp Object Browser, CandleNet ebp Secure Access, CandleNet ebp Service Directory, CandleNet ebp Universal Connector, CandleNet ebp Workflow Access, CandleNet ebusiness Assurance, CandleNet ebusiness Exchange, CandleNet ebusiness Platform Administrator, CandleNet ebusiness Platform Connector, CandleNet ebusiness Platform Connectors, CandleNet ebusiness Platform Powered by Roma Technology, CandleNet ebusiness Platform Service Directory, Candle Vision, CCC, CCP, CCR2, CEBA, CECS, CICAT, CL/ENGINE, CL/GATEWAY, CL/TECHNOLOGY, CMS, CMW, Command & Control, Connect-Notes, Connect-Two, CSA ANALYZER, CT/ALS, CT/Application Logic Services, CT/DCS, CT/Distributed Computing Services, CT/Engine, CT/Implementation Services, CT/IX, CT/Workbench, CT/Workstation Server, CT/WS,!DB Logo,!DB/DASD,!DB/EXPLAIN,!DB/MIGRATOR,!DB/QUICKCHANGE,!DB/QUICKCOMPARE,!DB/SMU,!DB/Tools,!DB/WORKBENCH, Design Network, e2e, eba*se, ebaa, ebaauditor, eban, ebanetwork, ebaapractice, ebp, ebusiness Assurance Network, ebusiness at the speed of light, ebusiness at the speed of light logo, ebusiness Exchange, ebx, End-to-End, enotification, ENTERPRISE, Enterprise Candle Command Center, Enterprise Candle Management Workstation, Enterprise Reporter Plus, ER+, ERPNet, ETEWatch Customizer, HostBridge, InterFlow, Candle InterFlow, Lava Console, Managing what matters most, MessageMate, Messaging Mastered, Millennium Management Blueprint, MMNA, MQADMIN, MQEdit, MQEXPERT, MQMON, NBX, NC4, NetGlue, NetGlue Extra, NetMirror, NetScheduler, New Times, New Team, New Readiness, OMA, OMC Gateway, OMC Status Manager, OMEGACENTER Bridge, OMEGACENTER Gateway, OMEGACENTER Status Manager, OMEGAMON/e, OMEGAMON Management Center, OSM, PathWAI, PC COMPANION, Performance Pac, Powered by Roma Technology, PowerQ, PQConfiguration, PQScope, Roma Application Manager, Roma Broker, Roma BSP, Roma Connector, Roma Developer, Roma FS/A, Roma FS/Access, RomaNet, Roma Network, Roma Object Access, Roma Secure, Roma WF/Access, Roma Workflow Access, RTA, RTN, SentinelManager, Somerset, Somerset Systems, Status Monitor, The Millennium Alliance, The Millennium Alliance logo, The Millennium Management Network Alliance, Tracer, Unified Directory Services, WayPoint, and ZCopy. Trademarks and registered trademarks of other companies: AIX, DB2, MQSeries and WebSphere are registered trademarks of International Business Machines Corporation. Citrix, WinFrame, and ICA are registered trademarks of Citrix Systems, Inc. Multi-Win and MetaFrame are trademarks of Citrix Systems, Inc. SAP is a registered trademark and R/3 is a trademark of SAP AG. UNIX is a registered trademark in the U.S. and other countries, licensed exclusively through X/Open Company Ltd. HP-UX is a trademark of Hewlett-Packard Company. SunOS is a trademark of Sun Microsystems, Inc. All other company and product names used herein may be trademarks or registered trademarks of their respective owners. Copyright 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. 2 OMEGAMON XE for DB2 on z/os Configuration and Customization Guide, V300

3 Contents List of Tables List of Figures Preface About this Book Adobe Portable Document Format Candle Customer Service and Satisfaction Documentation Conventions Chapter 1. Start Here to Configure Products and Maintenance Using the Checklists and Topics in this Chapter Checklist: Prerequisites for Configuring Products Checklist: Starting CICAT and Accessing the Menu for Configuration 21 Checklists: Configuring the Product Using CICAT Checklists: Configuring the Product Outside of CICAT Checklists: Customizing the Product Outside of CICAT Checklist: Updating the Configuration Using Advanced Features in CICAT Chapter 2. Overview of Processes, Methods, and CICAT Modes Determining the Topics to Use in this Chapter Candle Terminology Processes for Installing, Configuring, and Maintaining Products Background about CICAT Modes: Interactive and Batch Chapter 3. Plan Your Configuration Determining the Topics to Use in this Chapter Candle Products and Components Details about the Candle Products and Components Determining the Components to Install and Configure Requirements and Restrictions for OMEGAMON XE Contents 3

4 Chapter 4. Start CICAT and Access the Menu for Configuring Determining the Topics to Use in This Chapter Starting CICAT Accessing the Menu for Configuring the Product Using CICAT Chapter 5. Completing the Configuration Outside of CICAT Determining the Topics to Use in this Chapter Copying the Procedures for the Started Task Copying the VTAM Definition and Varying the VTAM Node Active.. 68 Copying the Procedures for the Persistent Datastore Completing the Configuration for a Non-local CMS Verifying the Configuration: Same Address Space Verifying the Configuration: Different Address Space Verifying the Configuration: CMS on a Different Platform Chapter 6. Completing the Customization Determining the Topics to Use in this Chapter Migrating Your Profile Specifying Security Collecting and Storing Historical Data Enabling the Zoom Feature to Access a Session to OMEGAMON II.. 83 Chapter 7. Updating the Configuration Updating and Changing the Configuration Index OMEGAMON XE for DB2 on z/os Configuration and Customization Guide, V300

5 List of Tables Table 1. Symbols in Command Syntax Table 2. Advanced Features Available in CICAT Table 3. Installing Products and Maintenance: A Comparison Table 4. Installing and Configuring: A Comparison Table 5. Example Tasks for Installing, Maintaining, and Configuring Table 6. Locating Information for Installing and Configuring Table 7. CICAT Modes: Interactive and Batch Table 8. Overview of the Products and Components Table 9. Details about the Relationships and Types of CMSs Table 10. Determining the Products and Components You Will Need Table 11. Determining the Products and Components to Configure Table 12. Locating information about configuring the product or component.. 57 Table 13. Parameters You Can Use with the Command to Migrate Your Profile 79 List of Tables 5

6 6 OMEGAMON XE for DB2 on z/os Configuration and Customization Guide, V300

7 List of Figures FIGURE 1. Process for Verifying the Configuration: Same Address Space FIGURE 2. Process for Verifying the Configuration: Different Address Space FIGURE 3. Process for Verifying the Configuration: CMS on a Different Platform 73 FIGURE 4. Process for Migrating Your OMEGAMON II Profile FIGURE 5. Process for Updating and Changing Your Configuration List of Figures 7

8 8 OMEGAMON XE for DB2 on z/os Configuration and Customization Guide, V300

9 P Preface 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

10 About this Book About this Book Who should read this book This 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 information For more information related to this product and other related products, please see the: technical documentation CD-ROM that came with your product technical documentation information available on the Candle Web site at online help provided with this and the other related products. 10 OMEGAMON XE for DB2 on z/os Configuration and Customization Guide, V300

11 Adobe Portable Document Format Adobe Portable Document Format Printing this book Candle supplies documentation in the Adobe Portable Document Format (PDF). The Adobe Acrobat Reader will print PDF documents with the fonts, formatting, and graphics in the original document. To print a Candle document, do the following: 1. Specify the print options for your system. From the Acrobat Reader Menu bar, select File > Page Setup and make your selections. A setting of 300 dpi is highly recommended as is duplex printing if your printer supports this option. 2. To start printing, select File > Print... on the Acrobat Reader Menu bar. 3. On the Print pop-up, select one of the Print Range options for All Current page Pages from: [ ] to: [ ] 4. (Optional). Select the Shrink to Fit option if you need to fit oversize pages to the paper size currently loaded on your printer. Printing problems? The print quality of your output is ultimately determined by your printer. Sometimes printing problems can occur. If you experience printing problems, potential areas to check are: settings for your printer and printer driver. (The dpi settings for both your driver and printer should be the same. A setting of 300 dpi is recommended.) the printer driver you are using. (You may need a different printer driver or the Universal Printer driver from Adobe. This free printer driver is available at the halftone/graphics color adjustment for printing color on black and white printers (check the printer properties under Start > Settings > Printer). For more information, see the online help for the Acrobat Reader. the amount of available memory in your printer. (Insufficient memory can cause a document or graphics to fail to print.) For additional information on printing problems, refer to the documentation for your printer or contact your printer manufacturer. Preface 11

12 Adobe Portable Document Format Contacting Adobe If additional information is needed about Adobe Acrobat Reader or printing problems, see the Readme.pdf file that ships with Adobe Acrobat Reader or contact Adobe at Adding annotations to PDF files If you have purchased the Adobe Acrobat application, you can add annotations to Candle documentation in.pdf format. See the Adobe product for instructions on using the Acrobat annotations tool and its features. 12 OMEGAMON XE for DB2 on z/os Configuration and Customization Guide, V300

13 Candle Customer Service and Satisfaction Candle Customer Service and Satisfaction Background To 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 edelivery allows you to create and update service requests opened with Customer Service and Satisfaction (CSS). 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 for detailed customer service information. Candle Customer Service and Satisfaction contacts You will find the most current information about how to contact Candle CSS by telephone or on the Candle Web site. Go to the support section, and choose the link to Support Contacts to locate your regional support center. Preface 13

14 Documentation Conventions Documentation Conventions Introduction Candle documentation adheres to accepted typographical conventions for command syntax. Conventions specific to Candle documentation are discussed in the following sections. Panels and figures The panels and figures in this document are representations. Actual product panels may differ. Required blanks The slashed-b ( ) character in examples represents a required blank. The following example illustrates the location of two required blanks. Revision bars eba*servicemonitor Revision bars ( ) may appear in the left margin to identify new or updated material. Variables and literals in command syntax examples In 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. 14 OMEGAMON XE for DB2 on z/os Configuration and Customization Guide, V300

15 Documentation Conventions Symbols The 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 NO In 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

16 Documentation Conventions 16 OMEGAMON XE for DB2 on z/os Configuration and Customization Guide, V300

17 1 Start Here to Configure Products and Maintenance Introduction This 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 contents How to use the checklists Checklist: Prerequisites for Configuring Products Checklist: Starting CICAT and Accessing the Menu for Configuration Checklists: Configuring the Product Using CICAT Checklists: Configuring the Product Outside of CICAT Checklists: Customizing the Product Outside of CICAT Checklist: Updating the Configuration Using Advanced Features in CICAT Start Here to Configure Products and Maintenance 17

18 Using the Checklists and Topics in this Chapter 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 process If 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 OMEGAMON XE for DB2 on z/os Configuration and Customization Guide, V300

19 Using the Checklists and Topics in this Chapter Task Checklists and Topics to Use in this Chapter Page # Update or change the configuration for the products! Checklist: Starting CICAT and Accessing the Menu for Configuration! Checklist: Updating the Configuration 34! Using Advanced Features in CICAT Start Here to Configure Products and Maintenance 19

20 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! You must have installed the product and components using CICAT.! You must have created a runtime environment (RTE) using CICAT.! You must have completed the configuration for a Candle Management Server (CMS).! 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.! 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). Installation & Configuration of Candle Products on OS/390 and z/os Installation & Configuration of Candle Products on OS/390 and z/os the online help in CICAT Candle Management Server Configuration and Customization Guide the online help in CICAT Chapter 2 in this guide Chapter 3 in this guide 20 OMEGAMON XE for DB2 on z/os Configuration and Customization Guide, V300

21 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 menu The checklist contains the steps you perform to start CICAT and access the configuration menu. Task Location 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. Chapter 4 in this guide Start Here to Configure Products and Maintenance 21

22 Checklists: Configuring the Product Using CICAT Checklists: Configuring the Product Using CICAT Background about the possible configurations The table lists the relationships of the CMS to OMEGAMON XE. Local Candle Term Non-local Description of the Relationship CMS that is installed in the same RTE as the agent 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) 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. How You Want to Configure the CMS and OMEGAMON XE Installed and configured in the same address space Installed and configured in different address spaces Type of CMS to Use Local Local Non-local 22 OMEGAMON XE for DB2 on z/os Configuration and Customization Guide, V300

23 Checklists: Configuring the Product Using CICAT Determine the checklist to use for configuring products The 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 Installed and configured in the same address space Installed and configured in different address spaces Type of CMS to Use Local Local Non-local Checklist to Use CICAT configuration: Same address space on page 24 CICAT configuration: Different address spaces and local CMS on page 25 CICAT configuration: Different address spaces and non-local CMS on page 26 Start Here to Configure Products and Maintenance 23

24 Checklists: Configuring the Product Using CICAT CICAT configuration: Same address space The 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! Configure OMEGAMON XE Menu! Configure OMEGAMON XE Menu! Configure OMEGAMON XE Menu! Configure OMEGAMON XE Menu! Configure OMEGAMON XE Menu! Runtime Environments (RTEs) panel Configuration Step to Perform in CICAT Use Register with local CMS to specify the CMS for OMEGAMON XE. 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.) Use L (Load libs after SMP/E) to load the target libraries to the runtime libraries for the RTE. Location of Information Online help in CICAT Online help in CICAT Online help in CICAT Online help in CICAT Online help in CICAT Online help in CICAT 24 OMEGAMON XE for DB2 on z/os Configuration and Customization Guide, V300

25 Checklists: Configuring the Product Using CICAT CICAT configuration: Different address spaces and local CMS The 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! Configure OMEGAMON XE Menu! Configure OMEGAMON XE Menu! Configure OMEGAMON XE Menu! Configure OMEGAMON XE Menu! Configure OMEGAMON XE Menu Use Register with local CMS to specify the CMS for OMEGAMON XE. 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 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. 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 Complete the configuration to display a set of instructions for completing the configuration outside of CICAT. (The instructions are also covered in this guide.) Online help in CICAT Online help in CICAT Online help in CICAT Online help in CICAT Online help in CICAT Online help in CICAT Start Here to Configure Products and Maintenance 25

26 Checklists: Configuring the Product Using CICAT Location in CICAT! Runtime Environments (RTEs) panel Configuration Step to Perform in CICAT Use L (Load libs after SMP/E) to load the target libraries to the runtime libraries for the RTE. Location of Information Online help in CICAT CICAT configuration: Different address spaces and non-local CMS The 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! Configure OMEGAMON XE Menu! Configure OMEGAMON XE Menu! Configure OMEGAMON XE Menu Configuration Step to Perform in CICAT 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 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. Location of Information Online help in CICAT Online help in CICAT Online help in CICAT 26 OMEGAMON XE for DB2 on z/os Configuration and Customization Guide, V300

27 Checklists: Configuring the Product Using CICAT Location in CICAT! Configure OMEGAMON XE Menu! Configure OMEGAMON XE Menu! Runtime Environments (RTEs) panel Configuration Step to Perform 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 Complete the configuration to display a set of instructions for completing the configuration outside of CICAT. (The instructions are also covered in this guide.) Use L (Load libs after SMP/E) to load the target libraries to the runtime libraries for the RTE. Location of Information Online help in CICAT Online help in CICAT Online help in CICAT Determining what to do next See Checklists: Configuring the Product Outside of CICAT on page 28. Start Here to Configure Products and Maintenance 27

28 Checklists: Configuring the Product Outside of CICAT Checklists: Configuring the Product Outside of CICAT Reminder about the information available In 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 Installed and configured in the same address space Installed and configured in different address spaces Type of CMS You Can Use Local Local Non-local, but installed on OS/390 Checklist to Use Outside configuration: Same address space on page 29 Outside configuration: Different address space and local CMS on page 30 Outside configuration: Different address space and non-local CMS on page OMEGAMON XE for DB2 on z/os Configuration and Customization Guide, V300

29 Checklists: Configuring the Product Outside of CICAT 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! 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! 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 Copying the Procedures for the Persistent Datastore on page 69 Prerequisites for verifying the configuration on page 71 Page 33 Page 35 Start Here to Configure Products and Maintenance 29

30 Checklists: Configuring the Product Outside of CICAT Outside configuration: Different address space and local CMS 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! Copy the procedure for the started task to the procedure library.! If you selected SNA as the communication protocol for the OMEGAMON XE agent, copy the VTAM definitions and vary the VTAM node active.! If you configured the Persistent Datastore, copy the procedures for the Persistent Datastore.! Verify the configuration by:! varying the CMS VTAM major node active! starting the started task for the CMS! starting the started task for the agent! 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 Copying the Procedures for the Started Task on page 67 Copying the VTAM Definition and Varying the VTAM Node Active on page 68 Copying the Procedures for the Persistent Datastore on page 69 Verifying the Configuration: Different Address Space on page 72 Page 33 Page OMEGAMON XE for DB2 on z/os Configuration and Customization Guide, V300

31 Checklists: Configuring the Product Outside of CICAT 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. Configuration Steps to Perform Outside CICAT Location of the Information You Will Need! Copy the procedure for the started task to the procedure library.! If you selected SNA as the communication protocol for the OMEGAMON XE agent, copy the VTAM definitions and vary the VTAM node active.! 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 Copying the Procedures for the Started Task on page 67 Copying the VTAM Definition and Varying the VTAM Node Active on page 68 Copying the Procedures for the Persistent Datastore on page 69 Completing the Configuration for a Non-local CMS on page 70 If the non-local CMS is installed on a platform other than MVS, complete the configuration on that platform Installation guide for that platform Start Here to Configure Products and Maintenance 31

32 Checklists: Configuring the Product Outside of CICAT Configuration Steps to Perform Outside CICAT Location of the Information You Will Need! Verify the configuration by:! if you selected SNA as the communication protocol instead of TCP/IP, varying the CMS VTAM major node active! starting the started task for the CMS! starting the started task for the agent Verifying the Configuration: Different Address Space on page 72 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! starting the started task for the agent! 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 Verifying the Configuration: CMS on a Different Platform on page 73 Page 33 Page OMEGAMON XE for DB2 on z/os Configuration and Customization Guide, V300

33 Checklists: Customizing the Product Outside of CICAT Checklists: Customizing the Product Outside of CICAT Outside customization The 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. The steps are listed in the order they must be performed. Use the column to check off steps as you complete them. 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.! 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.! If you want to replicate the product or use the product on another MVS image, see Using Advanced Features in CICAT Collecting and storing historical data on page 82 Enabling the Zoom Feature to Access a Session to OMEGAMON II on page 83 Page 35 Start Here to Configure Products and Maintenance 33

34 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. The steps are listed in the order they must be performed. Use the column to check off steps as you complete them.! 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)! If you want to replicate the product or use the product on another MVS image, see Using Advanced Features in CICAT Location of the Information You Will Need Updating the Configuration on page 85 Page OMEGAMON XE for DB2 on z/os Configuration and Customization Guide, V300

35 Using Advanced Features in CICAT 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 Task Port an existing RTE to one or more MVS images, without reconfiguring the RTE for those MVS images Replicate and transport an RTE to one or more MVS images Advanced Feature System Variable Support Batch Mode Processing Location of Information Installation & Configuration of Candle Products on OS/390 and z/os Installation & Configuration of Candle Products on OS/390 and z/os Start Here to Configure Products and Maintenance 35

36 Using Advanced Features in CICAT 36 OMEGAMON XE for DB2 on z/os Configuration and Customization Guide, V300

37 2 Overview of Processes, Methods, and CICAT Modes Overview Review this chapter only if you are not familiar with Candle or the process for installing and configuring Candle products. Chapter contents Determining the Topics to Use in this Chapter Candle Terminology Processes for Installing, Configuring, and Maintaining Products Background about CICAT Modes: Interactive and Batch Overview of Processes, Methods, and CICAT Modes 37

38 Determining the Topics to Use in this Chapter 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

39 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) Component Configuring Cumulative Maintenance Customizing Installing Migrating Preventive Maintenance Runtime Environments (RTEs) Runtime libraries Target libraries 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) Product or feature provided by Candle that is a separate started task Making a product operational by completing the configuration of the product inside CICAT and completing the manual steps required outside of CICAT Maintenance through a given date that is customer approved Modifying the defaults for options and settings and other changes that reflect the needs of your site Loading the contents of the Candle product and maintenance and installing a product Preserving the customized data so that you can use it in a newer version of the product Maintenance through a given date that is customer approved, but not yet included in Cumulative Maintenance A group of runtime libraries that execute Candle products on an MVS image Libraries in the RTE that are used by the product when the product is started SMP/E controlled libraries that contain the source from the distribution media Overview of Processes, Methods, and CICAT Modes 39

40 Processes for Installing, Configuring, and Maintaining Products 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 Process Required 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 Install maintenance (if any) X X Begin to configure the products and components Complete the configuration of products and components by performing the manual steps required to make the product operational Once configured, complete the manual steps to customize the product for your site (if any) 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 X X X X X 40 OMEGAMON XE for DB2 Configuration and Customization Guide, Version 300

41 Processes for Installing, Configuring, and Maintaining Products 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 Process Prepare to install products and maintenance Load and start CICAT V300 Install products and components Install maintenance (if any) Begin to configure the products and components Complete the configuration of products and components by performing the manual steps required to make the product operational Once configured, complete the manual steps to customize the product for your site (if any) 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 Performed in CICAT? X X (if CICAT has been previously installed) X X X X Performed Outside of CICAT? X (if you are installing CICAT for the first time) X X Overview of Processes, Methods, and CICAT Modes 41

42 Processes for Installing, Configuring, and Maintaining Products 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 Prepare to install products and maintenance Examples of Tasks 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 Complete the configuration of products and components by performing the manual steps required to make the product operational Once configured, complete the manual steps to customize the product for your site (if any) 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 42 OMEGAMON XE for DB2 Configuration and Customization Guide, Version 300

43 Processes for Installing, Configuring, and Maintaining Products Table 5. Example Tasks for Installing, Maintaining, and Configuring Step in the Broad Process If you want to replicate or use Candle products on other images, use some of the advanced features in CICAT Examples of Tasks 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 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. Table 6. Locating Information for Installing and Configuring Step in the Broad Process 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) Where to Locate Information about Procedures Installation & Configuration of Candle Products on OS/390 and z/os Installation & Configuration of Candle Products on OS/390 and z/os Installation & Configuration of Candle Products on OS/390 and z/os Installation & Configuration of Candle Products on OS/390 and z/os Where to Locate Information about Specific Values Installation & Configuration of Candle Products on OS/390 and z/os Installation & Configuration of Candle Products on OS/390 and z/os Online help in CICAT Online help in CICAT Overview of Processes, Methods, and CICAT Modes 43

44 Processes for Installing, Configuring, and Maintaining Products Table 6. Locating Information for Installing and Configuring Step in the Broad Process 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 Outside of CICAT, complete the manual steps to customize the product for your site (if any) If you want to replicate Candle products or use products on other images, use some of the advanced features in CICAT Where to Locate Information about Procedures Installation & Configuration of Candle Products on OS/390 and z/os This guide The Complete the configuration option on the Configure OMEGAMON XE Menu This guide Installation & Configuration of Candle Products on OS/390 and z/os Where to Locate Information about Specific Values Online help in CICAT Online help in CICAT Online help in CICAT Online help in CICAT 44 OMEGAMON XE for DB2 Configuration and Customization Guide, Version 300