installing candle products -...
TRANSCRIPT
Installing Candle Productson OS/400
Version CT350
GC32-9216-00
June 2004
Candle Corporation100 North Sepulveda Blvd.
El Segundo, California 90245
2 Installing Candle Products on OS/400 (version CT350)
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 © June 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 3
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Adobe Portable Document Format . . . . . . . . . . . . . . . . . . . . . . . . . . 12Documentation Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Candle Customer Service and Satisfaction . . . . . . . . . . . . . . . . . . . . 16How to Proceed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
What’s New in This Release . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Chapter 1. Preparing for Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23What Are OMEGAMON XE and OMEGAMON DE? . . . . . . . . . . . . . 24CandleNet Portal Components in This Package. . . . . . . . . . . . . . . . . 30Step 1. Determining Where to Install Each Component . . . . . . . . . . . 31Step 2. Checking Order of Component Installation or Upgrade . . . . . 33Step 3. Checking Agent Installation Prerequisites. . . . . . . . . . . . . . . . 34Step 4. Verifying TCP/IP Configuration, If Necessary . . . . . . . . . . . . . 36Step 5. Deleting Old Versions of Agents, If Necessary . . . . . . . . . . . . 37Step 6. Preparing Your WebSphere MQ Environment, If Necessary . . 38Step 7. Checking the Installer’s Authority Level . . . . . . . . . . . . . . . . . 39Step 8. Compiling Information About Your AS/400 System. . . . . . . . 40Configuring OMEGAMON XE Across a Firewall . . . . . . . . . . . . . . . . 42
Chapter 2. Installing and Configuring the Monitoring Agent for OS/400. . . 45Step 1. Installing or Upgrading the Monitoring Agent for OS/400 . . . 46Step 2. Configuring the Monitoring Agent for OS/400 . . . . . . . . . . . . 53Step 3. Verifying the Installation and Configuration . . . . . . . . . . . . . . 56
Chapter 3. Installing and Configuring OMEGAMON XE for WebSphere MQ Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59Step 1. Installing or Upgrading OMEGAMON XE for WebSphere MQ Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
Contents
4 Installing Candle Products on OS/400 (version CT350)
Step 2. Configuring the OMEGAMON XE for WebSphere MQ Configuration Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66Step 3. Verifying the Installation and Configuration . . . . . . . . . . . . . . 69
Chapter 4. Installing and Configuring OMEGAMON XE for WebSphere MQ Monitoring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Step 1. Installing or Upgrading OMEGAMON XE for WebSphere MQ Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72Step 2. Configuring the OMEGAMON XE for WebSphere MQ Monitoring Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78Step 3. Verifying the Installation and Configuration . . . . . . . . . . . . . . 82Step 4. Customizing Monitoring Options (optional) . . . . . . . . . . . . . . 85
Appendix A. Additional Configuration Steps for SNA Environments . . . . . . . 89If Your Site Also Runs the Monitoring Agent for OS/400 . . . . . . . . . . 90If Your Site Does Not Run the Monitoring Agent for OS/400 . . . . . . . 94
Appendix B. Deleting OMEGAMON XE Components . . . . . . . . . . . . . . . . . 97
Appendix C. Altering the Size of Historical Data Files . . . . . . . . . . . . . . . . . . 99
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Tables 5
Table 1. Symbols in Command Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Table 2. Products and Versions for Current Release . . . . . . . . . . . . . . . . . . . . 19Table 3. Parameters for the Configure OMA (CFGOMA) Dialog . . . . . . . . . . . 53Table 4. Parameters for the Configure OMA (CFGOMAMC) Dialog . . . . . . . . 66Table 5. Parameters for the Configure OMA (CFGOMAMQ) Dialog . . . . . . . . 78
Tables
Figures 7
Figure 1. OMEGAMON XE Platform Components . . . . . . . . . . . . . . . . . . . . . . 25Figure 2. Configuration Including a Remote CMS . . . . . . . . . . . . . . . . . . . . . . 29
Figures
Preface 9
Preface
IntroductionThis guide explains how to install OMEGAMON® XE on the OS/400 operating system.
The following Candle® products comprise the OMEGAMON XE product family on OS/400:
� OMEGAMON XE for OS/400
� OMEGAMON XE for WebSphere MQ Configuration
� OMEGAMON XE for WebSphere MQ Monitoring
The term “installation” in this guide refers to the following tasks:
� Copying agent software from the Candle Products CD-ROM to the OS/400 system
� Installing agent software using the RSTLICPGM program
� Establishing network connections between the agents and a Candle Management Server® (CMS™) to make the product operational
� Starting the agents to verify that they were successfully installed
Preface contentsAbout This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Adobe Portable Document Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12Documentation Conventions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Candle Customer Service and Satisfaction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16How to Proceed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
P
About This Book
10 Installing Candle Products on OS/400 (version CT350)
About This Book
Who should read this bookThis guide was written for systems, maintenance, or installation programmers, as well as Candle system administrators. Although most operating system commands necessary to complete the tasks in this guide are provided, it is assumed that users of this guide are familiar with the OS/400 operating system or have access to system manuals. If appropriate, users should also have a working knowledge of IBM’s WebSphere MQ product.
Users of this guide must know the planned configuration for their OMEGAMON XE environment. They should consult with their Candle system administrator to ensure that they know where the CMS, CandleNet Portal® Servers, Candle Management Workstation® (CMW™), CandleNet Portal, and the agents are to be installed.
Scope of this bookIn addition to installation instructions, this guide also contains information to help you manage your OMEGAMON XE environment, such as how to delete old versions of agents.
This guide contains instructions to make the product operational with a minimal configuration. This guide does not contain instructions for implementing advanced configuration or customization features such as customizing the monitoring options associated with OMEGAMON XE for WebSphere MQ Monitoring or securing the configuration database.
This guide does not contain instructions on how to use OMEGAMON XE. For example, it does not explain how to view reports using the CandleNet Portal interface.
This guide does not explain how to install prerequisite software such as the OS/400 operating system or the WebSphere MQ application. That information can be found in the related IBM installation documentation.
This guide addresses issues that are specific to installing Candle product components. General issues such as maintaining, fine-tuning, or securing your OMEGAMON XE environment as a whole are beyond the scope of this guide.
Preface 11
About This Book
Documentation set informationThis guide covers the OS/400 operating system platform; however most Candle installations comprise several platforms. Refer to the following guides:
� Installation and Configuration of Candle Products on OS/390 and z/OS
� Candle Management Server on OS/390 and z/OS Configuration and Customization Guide
� Installing Candle Products on Windows
� Installing Candle Products on HP NonStop Kernel
Note: The operating system formerly known as Tandem NonStop Kernel has been renamed to HP NonStop Kernel.
� Installing Candle Products on UNIX
As in previous releases, product-specific Configuration and Customization Guides may also be provided.
Where to look for more informationFor more information about a Candle product, see:
� Online help.
� Technical documentation CD-ROM (if one came with the product).
� Documentation information available on the Candle Web site at https://www.candle.com/www1/techdocs/red.html.
We would like to hear from youCandle welcomes your comments and suggestions for changes or additions to the documentation set. A user comment form, located at the back of each manual, provides simple instructions for communicating with the Candle Information Development department. You can also send E-mail to [email protected]. Please include "Installing Candle Products on OS/400 (version CT350)" in the subject line.
Adobe Portable Document Format
12 Installing Candle Products on OS/400 (version CT350)
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 13
Adobe Portable Document Format
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.
Documentation Conventions
14 Installing Candle Products on OS/400 (version CT350)
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.
Preface 15
Documentation Conventions
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.
Candle Customer Service and Satisfaction
16 Installing Candle Products on OS/400 (version CT350)
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 17
How to Proceed
How to Proceed
About the two-phase installation processThe installation is a two-phase process as follows:
1. Planning and preparation.In this phase you will verify that prerequisite hardware and software is in place, that you are installing the components of OMEGAMON XE in the correct order, that you have sufficient disk space, and that you have compiled all site-specific values that are required during the installation.
Completing these steps ensures that your installation will be performed as efficiently as possible.
2. Installation and basic configuration.In this phase you will restore the agent software to the AS/400 machine(s) where you want to install and copy it to appropriate libraries. You will then define agent-to-CMS and CandleNet Portal connections.
Note: The agent software is shipped on the Candle Products CD-ROM as OS/400 licensed program products in save file (*SAVF) format. Once a save file is installed on any AS/400 system, it can be transferred, using FTP or SNADS, to other AS/400 systems. You do not need to send the CD-ROM to each system where you plan to install the agent.
When you complete the above steps OMEGAMON XE will be operational for your site; however, you may want to perform more advanced configuration or customization of the agents you installed.
What’s New in This Release 19
What’s New in This Release
Major enhancements and changes affecting installation of the OMEGAMON XE product family are summarized below.
Product versionsThe information in this installation guide applies to the products and versions shown below, some of which involve enhancements from the previous release.
Table 2. Products and Versions for Current Release
Product Version
Alert Adapter™ for OMEGACENTER Gateway™ for MVS 150
Alert Adapter for Peregrine ServiceCenter 202
Alert Adapter for Remedy ARS 202
Alert Adapter for TME 10 NetView for AIX 200
Alert Adapter for AF/Remote® 121
CandleNet Portal 195
CMS 350
CMW 350
Command & Control™ 110
Log Alert Agent 200
OMEGAMON Alert Manager for HP OpenView IT/Operations 201
OMEGAMON Alert Manager for HP OpenView NNM 201
OMEGAMON Alert Manager for Tivoli/Enterprise Console 250
W
20 Installing Candle Products on OS/400 (version CT350)
OMEGAMON DE 195
OMEGAMON Monitoring Agent® for eBA Solutions 251
OMEGAMON Web Services 350
OMEGAMON XE for BEA WebLogic Server 130
OMEGAMON XE for CICS 100
OMEGAMON XE for CICSplex 220
OMEGAMON XE for DB2 Universal Database (DB2 UDB) 102
OMEGAMON XE for DB2plex 220
OMEGAMON XE for IBM Cryptographic Coprocessors 100
OMEGAMON XE for IMS 100
OMEGAMON XE for IMSplex 220
OMEGAMON XE for Linux 120
OMEGAMON XE for Microsoft SQL Server 301
OMEGAMON XE for Mainframe Networks 100
OMEGAMON XE for NetWare 301
OMEGAMON XE for Oracle 301
OMEGAMON XE for OS/390 140
OMEGAMON XE for OS/390 UNIX System Services 220
OMEGAMON XE for OS/400 300
OMEGAMON XE for R/3™ a 301
OMEGAMON XE for Storage 100
OMEGAMON XE for Sybase 301
OMEGAMON XE for Sysplex 220
OMEGAMON XE for Tuxedo 301
OMEGAMON XE for UNIX 201
OMEGAMON XE for WebSphere Application Server 120
OMEGAMON XE for WebSphere Integration Brokers 120
Table 2. Products and Versions for Current Release (continued)
Product Version
What’s New in This Release 21
Renamed products or platforms� The product formerly known as Candle Command Center® for MQSeries
has been renamed to OMEGAMON XE for WebSphere MQ Monitoring.
� The product formerly known as Candle Command Center for MQSeries Configuration has been renamed to OMEGAMON XE for WebSphere MQ Configuration.
Supported versions of OS/400For the monitoring agent for OS/400, OMEGAMON XE for WebSphere MQ Monitoring, and OMEGAMON XE for WebSphere MQ Configuration, Candle no longer supports versions 4r5 and below of the OS/400 operating system. See “Step 3. Checking Agent Installation Prerequisites” on page 34.
OMEGAMON XE for WebSphere MQ Configuration 360
OMEGAMON XE for WebSphere MQ Monitoring 360
OMEGAMON XE for Windows 301
OMEGAMON XE for Windows Management Web Service 100
OMEGAVIEW II® for the Enterprise 300
Universal Agent 410
Warehouse Proxy 350
a. R/3 is a trademark of SAP AG.
CandleNet Portal (version 195)
CandleNet Portal supersedes the CMW as the primary interface into your OMEGAMON XE products. CandleNet Portal (version 195) is included in the current release. For information on installing CandleNet Portal, refer to Installing Candle Products on Windows.
CMS (version 350)
Version 350 of the CMS is included in the current release.
Table 2. Products and Versions for Current Release (continued)
Product Version
Preparing for Installation 23
Preparing for Installation
IntroductionOMEGAMON XE operates on an enterprise-wide basis. Its components run on various machines on up to six operating system platforms networked together through one of two network protocols. Moreover, the individuals who install or upgrade OMEGAMON XE and its prerequisite software are often geographically-dispersed. For these reasons, ensuring the successful installation of OMEGAMON XE requires coordination, planning, and preparation.
Chapter contentsWhat Are OMEGAMON XE and OMEGAMON DE?. . . . . . . . . . . . . . . . . . . . . . . 24CandleNet Portal Components in This Package. . . . . . . . . . . . . . . . . . . . . . . . . . . 30Step 1. Determining Where to Install Each Component. . . . . . . . . . . . . . . . . . . . . 31Step 2. Checking Order of Component Installation or Upgrade. . . . . . . . . . . . . . . 33Step 3. Checking Agent Installation Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . 34Step 4. Verifying TCP/IP Configuration, If Necessary. . . . . . . . . . . . . . . . . . . . . . . 36Step 5. Deleting Old Versions of Agents, If Necessary . . . . . . . . . . . . . . . . . . . . . . 37Step 6. Preparing Your WebSphere MQ Environment, If Necessary. . . . . . . . . . . . 38Step 7. Checking the Installer’s Authority Level. . . . . . . . . . . . . . . . . . . . . . . . . . . 39Step 8. Compiling Information About Your AS/400 System. . . . . . . . . . . . . . . . . . 40Configuring OMEGAMON XE Across a Firewall . . . . . . . . . . . . . . . . . . . . . . . . . . 42
1
What Are OMEGAMON XE and OMEGAMON DE?
24 Installing Candle Products on OS/400 (version CT350)
What Are OMEGAMON XE and OMEGAMON DE?
What OMEGAMON XE doesOMEGAMON XE is a suite of Candle products that monitor and manage system and network applications on a variety of platforms. These products keep track of the availability and performance of all parts of your enterprise from one or more designated workstations, and provide reports you can use to track trends and troubleshoot problems.
How you can use OMEGAMON XEYou can use OMEGAMON XE to:
� Create situations (conditions to test when monitoring).
� Establish performance thresholds, and raise alerts when thresholds are exceeded or values are matched.
� Trace the causes leading up to an alert.
� Create and send commands to systems in your managed enterprise by means of the Take Action feature.
� Create comprehensive reports about system conditions.
� Define your own queries, using the attributes from an installed agent or from an ODBC-compliant data source, to monitor conditions of particular interest.
Components of the OMEGAMON XE platformThe client, server, and agent implementation includes
� A client, CandleNet Portal, with a Java-based user interface for viewing and monitoring your enterprise. CandleNet Portal offers two modes of operation: desktop and browser.
� A CandleNet Portal Server, placed between the client and the CMS, that enables retrieval, manipulation, and analysis of data from the agents. The CandleNet Portal Server is the central repository for all user data.
Preparing for Installation 25
What Are OMEGAMON XE and OMEGAMON DE?
� A CMS, which acts as a collection and control point for alerts received from the agents, and collects their performance and availability data. It also serves as a repository for historical data. The CMS runs on OS/390, z/OS, UNIX, or Windows XP Professional Edition or Windows 2000.
� Agents installed on the systems or subsystems you want to monitor. These agents collect and distribute data to a CMS.
� (if necessary) A CMW, required primarily for the maintenance task of removing obsolete managed systems from the user interface. Although the CandleNet Portal client replaces the CMW as the user interface for your Candle monitored environment, the CMW still offers some features not otherwise available, such as the Universal Message Console and the Policy Microscope.
Figure 1. OMEGAMON XE Platform Components
Managed SystemsCMS
CMW
CandleNet Portal
desktop mode
browser modeBrowser ClientCandle Web server
CandleNetPortaldatabase
CandleNet Portal Server
What Are OMEGAMON XE and OMEGAMON DE?
26 Installing Candle Products on OS/400 (version CT350)
What OMEGAMON DE doesOMEGAMON DE offers a dashboard view of your enterprise. It gives you a single point of control for managing the resources your business-critical applications rely on, including a range of operating systems, servers, databases, mainframes, and Web components. For example, a typical IT network might have a Web server running on Windows, an application server running on UNIX, a database on OS/390, and a transaction processor on CICS on the mainframe. OMEGAMON DE brings all these views together in a single window, so you can see when any component is not working as expected.
What CandleNet Portal doesRunning on Windows XP Professional Edition or Windows 2000, CandleNet Portal is the interface into your OMEGAMON XE products. In the same way you use your browser home page as a starting point for navigating the Internet, you use CandleNet Portal to get a high-level overview of your network environment. One section of the window displays the Navigator, a tree-like view of your monitored network, with alert icons that appear when problems arise. The rest of the window is filled with views pertinent to the chosen item in the Navigator tree. From the top level or from your home workspace, you can navigate to specific locations to check activity and investigate problems.
Also see “CandleNet Portal Components in This Package” on page 30.
Two modes of operation� Desktop mode, whereby the CandleNet Portal client is installed on your
workstation and runs as a desktop application.
� Browser mode, whereby the administrator installs the CandleNet Portal Browser Client with the CandleNet Portal Server and Candle web client on the same machine. You can then start CandleNet Portal from your browser, at which time the thin client software is downloaded to your system and thereafter only for software updates.
When using CandleNet Portal in browser mode, you can start it from any workstation by entering the web server URL.
Preparing for Installation 27
What Are OMEGAMON XE and OMEGAMON DE?
What the agents doThe agents are the data collectors. The agents monitor systems, subsystems, or applications, collect data, and pass the data to CandleNet Portal or the CMW through the CMS. The agents pass commands from the user to the system, subsystem, or application. An agent interacts with a single system or application and, in most cases, resides on the same machine where the system or application is running.
Types of agents include:
� Monitoring agents
These agents collect performance and analysis data for many systems (such as UNIX), subsystems (such as WebSphere MQ), and applications (such as R/3).
� Alert Managers
These agents monitor non-Candle monitoring products for a remote system, subsystem, or application, and relay alert information to the CMS.
Sources of alerts include console and message logs, network-management products, and system-management products. An Alert Adapter also may have an Alert Emitter™ feature that can export Candle alerts to a non-Candle monitoring product.
� Alert Emitters
These agents monitor events (that is, exceptions) from any product running under control of the CMS and, if applicable, relay them to the monitored system, subsystem, or application for corrective action.
� Gateways
These agents communicate events to a management application running on a supported platform using a network service. Examples include the SNMP Gateways, which communicate events to an SNMP management application running on AIX or Windows.
Agents run on OS/390, z/OS, UNIX, Windows XP Professional Edition, Windows 2000, Windows 2003 Server, HP NonStop Kernel, and OS/400; however, not all agents are supported on all platforms.
What Are OMEGAMON XE and OMEGAMON DE?
28 Installing Candle Products on OS/400 (version CT350)
CMSThe CMS can run as a stand-alone server, or as a remote server in a hierarchy of servers that report to a master server called the hub CMS. A CMS can be installed on UNIX, OS/390, z/OS, Windows XP Professional Edition, or Windows 2000.
Hub CMS
The hub CMS serves as the focal point for managing your environment. The hub CMS may receive data from:
� Agents running on the same or remote systems.
� Other CMSs running as remote servers in a hierarchical configuration.
Depending on the complexity of your environment, the number of agents you install, and the amount of data you choose to collect, a single CMS may be all that you need. Or, you may want to configure a hierarchical set of CMSs where remote CMSs report to a hub CMS to distribute the activity.
Remote CMSs
If large amounts of network data are to be collected, excessive traffic can be minimized with the installation of remote CMSs which collect data from the agent and forward it to the hub CMS. Each remote CMS must reside on its own machine and have a unique CMS name (node), but the architectures of various remote CMSs may differ from each other as well as from the hub.
Naming your CMS
You must decide how the CMSs are to be named. In general, the names selected should be short, but meaningful within your environment. For the best performance, Candle recommends that you use the following guidelines:
� Each name must be unique. One name cannot match another CMS name for its entire length. (For example, “candle” and “candleremote” are unique and permitted; “server1” and “server1” are not unique and not permitted).
� Each name must begin with an alpha character. No blanks or special characters (“$#@”) can be used. An underline (“ _ “) is permitted and conforms to ISO 9660 standards.
� Each name must be between 2 and 32 characters in length.
� CMS naming is case-sensitive on all platforms.
Preparing for Installation 29
What Are OMEGAMON XE and OMEGAMON DE?
Figure 2. Configuration Including a Remote CMS
CandleNet Portal Server or CMW
CandleNet Portal Components in This Package
30 Installing Candle Products on OS/400 (version CT350)
CandleNet Portal Components in This Package
CandleNet PortalCandleNet Portal includes its own server and two types of client interface components. Here is a brief description of the components you can install at your site.
CandleNet Portal Server
The CandleNet Portal Server communicates directly with your hub CMS. Install at least one CandleNet Portal Server in your network to deploy CandleNet Portal.
CandleNet Portal Browser Client interface
The installation choice labeled “CandleNet Portal Client (Browser Edition)“ installs Java-based interface support and the Candle web server on the same systems as your CandleNet Portal Server.
Once the Browser Client component is installed and configured as a web site, users can enter the URL for the web site to start CandleNet Portal browser mode.
CandleNet Portal Desktop Client interface
The installation choice labeled “CandleNet Portal Client (Desktop Edition)” installs a Java-based graphical user interface on a Windows workstation. Once the Desktop Client is installed and configured, you can use it to start CandleNet Portal in desktop mode.
Candle products compatible with this releaseFor a list of the Candle products that are compatible with CandleNet Portal (version 195), see the What’s New in This Release chapter of this manual.
Preparing for Installation 31
Step 1. Determining Where to Install Each Component
Step 1. Determining Where to Install Each Component
Purpose of this stepThis step ensures that you know where (on which operating systems and which machines) to install each component of OMEGAMON XE.
In order to complete the install, you must know the name of each machine involved in the installation.
Procedure
1. Determine where you want to collect data generated by the agents.This is where you must install the CMS. Depending upon the complexity of your environment, the number of agents you install, and the amount of data you choose to collect, you may need to install multiple CMSs. Multiple CMSs can run in a hierarchy of servers where remote CMSs collect data from their agents and report the data to a hub CMS. Your site may also have multiple hierarchies of servers, each with its own hub. Note that only a hub CMS can have a CMW connected to it.
Your site may install a CMS on OS/390, z/OS, UNIX, or Windows XP Professional Edition or Windows 2000. Refer to the guides listed below, as needed, for instructions:
� Installation and Configuration of Candle Products on OS/390 and z/OS
� Candle Management Server on OS/390 and z/OS Configuration and Customization Guide
� Installing Candle Products on UNIX
� Installing Candle Products on Windows
Note: OMEGAMON XE for WebSphere MQ Monitoring supports all the platforms listed above. However, OMEGAMON XE for WebSphere MQ Configuration does not support a CMS on Solaris. Note further that OMEGAMON XE for WebSphere MQ Configuration does not support a hot-standby CMS.
Step 1. Determining Where to Install Each Component
32 Installing Candle Products on OS/400 (version CT350)
2. Determine where you want to install CandleNet Portals and (if necessary) the CMW. Your site may install these on Windows XP Professional Edition or Windows 2000. Refer to Installing Candle Products on Windows for instructions.
3. Determine which communication protocol you will use.The components of OMEGAMON XE communicate through either TCP/IP or SNA.
4. Determine which systems you want to monitor and where they are running.This is where you must install the agents.
Preparing for Installation 33
Step 2. Checking Order of Component Installation or Upgrade
Step 2. Checking Order of Component Installation or Upgrade
Purpose of this stepThis step ensures that new and existing customers install or upgrade their CMS, CandleNet Portal, CMW, and agents in the correct order.
ProcedureNew and existing customers should install or upgrade in the following order:
1. Hub CMS2. Remote CMS3. CandleNet Portal Server and CandleNet Portal Browser Client4. CandleNet Portal Desktop Client and (if necessary) CMW5. Agents
Note: Once the CMSs have been installed, the CMW and the agents can be installed in any order.
For new customers, this order provides maximum efficiency. For existing customers, this order prevents communication problems between components.
Step 3. Checking Agent Installation Prerequisites
34 Installing Candle Products on OS/400 (version CT350)
Step 3. Checking Agent Installation Prerequisites
Purpose of this stepThis step ensures that prerequisite requirements have been met before installing any of the following agents on OS/400:
� Monitoring agent for OS/400
� OMEGAMON XE for WebSphere MQ Monitoring agent
� OMEGAMON XE for WebSphere MQ Configuration agent
ProcedureReview the requirements in the sections below and verify that your site is in compliance before installing any of the above agents.
Note: The space required to run the agents is increased significantly depending upon how many random user-spaces you create. Each user-space requires 16 MB of hard disk space.
Monitoring agent for OS/400
Hardware requirements� RISC-based system
� 5250 nonprogrammable workstation or any workstation running 5250 emulation connected to the AS/400 system
� 20 MB disk space to install
� 19 MB disk space to run
� 64 MB RAM to run
Software requirements� OS/400 (versions 5r1 or higher)
Note: Customers using Candle’s monitoring agent for OS/400 (versions 300 or 400) running on an operating system of OS/400 (versions 4r5 or lower) are encouraged to upgrade to an operating system of OS/400 (version 5r1 or higher).
Preparing for Installation 35
Step 3. Checking Agent Installation Prerequisites
� TCP/IP Communication Utilities
Note: To check for the existence on your system of the TCP/IP Communication Utilities, refer to “Step 8. Compiling Information About Your AS/400 System” on page 40.
OMEGAMON XE for WebSphere MQ Monitoring and OMEGAMON XE for WebSphere MQ Configuration agents
Hardware requirements� RISC system
� 5250 non-programmable workstation or any workstation running 5250 emulation connected to the AS/400 system
� 50 MB disk space to install
� 19 MB disk space to execute
Software Requirements� WebSphere MQ (version 5.2) running on OS/400 (versions 5r1 or 5r2)
� TCP/IP Communication Utilities
Note: To check for the existence on your system of the TCP/IP Communications Utilities refer to “Step 8. Compiling Information About Your AS/400 System” on page 40.
Step 4. Verifying TCP/IP Configuration, If Necessary
36 Installing Candle Products on OS/400 (version CT350)
Step 4. Verifying TCP/IP Configuration, If Necessary
Purpose of this stepThis step ensures that your TCP/IP network services are configured to return the fully qualified hostname of the CMS and the agents (for example: “#HostName.candle.com”). This configuration is necessary to minimize the risk of inconsistent values being returned for the host name.
If your site uses SNA for network communications, you do not need to complete this step; skip to “Step 5. Deleting Old Versions of Agents, If Necessary” on page 37.
Procedure
1. If your site uses DNS, verify that it is configured to return the fully qualified hostname of the CMS and the agents (for example: “#hostName.candle.com”).
2. Confirm that you have configured TCP/IP with the correct parameters, as follows:1. From an OS/400 command line, enter
CFGTCP
2. Select “Work with TCP/IP host tables entries”.3. Confirm that the first entry in the Host Name column is the fully qualified
hostname associated with the IP address of the OS/400 machine where you will install the CMS or agent (for example: “#hostName.candle.com”). If it is not, change it now to the fully qualified host name.
4. Return to the Configure TCP/IP menu and select “Change TCP/IP domain information”.
5. Confirm that a host name and domain name are provided and that they match the entry you just confirmed in the TCP/IP Host Table.
6. Confirm that the first entry for “Host name search priority” is “*LOCAL”.
Preparing for Installation 37
Step 5. Deleting Old Versions of Agents, If Necessary
Step 5. Deleting Old Versions of Agents, If Necessary
Purpose of this stepYou must complete this step if are currently running any agents and want to replace them with the version supplied at this release. For example, if you are currently running the OMEGAMON XE for WebSphere MQ Monitoring agent, you must delete it before you install the version of that agent that is supplied with this release.
If you are a new customer and are not running any agents, skip to “Step 6. Preparing Your WebSphere MQ Environment, If Necessary” on page 38.
This step deletes from your system any versions of agents prior to the version supplied with this release. This step is necessary due to architectural changes in the new agents.
Procedure
1. Verify that the earlier version of the agent is not running. From an OS/400 command line, enter:
ENDOMA
2. Delete the agent. From an OS/400 command line, enter:DLTLICPGM LICPGM(0Kppvvv)
where:
pp is:
– “A4” for the monitoring agent for OS/400.
– “MQ” for the OMEGAMON XE for WebSphere MQ Monitoring agent.
– “MC” for the OMEGAMON XE for WebSphere MQ Configuration agent.
vvv is:
the earlier version (for example: “430”).
Step 6. Preparing Your WebSphere MQ Environment, If Necessary
38 Installing Candle Products on OS/400 (version CT350)
Step 6. Preparing Your WebSphere MQ Environment, If Necessary
Purpose of this stepThis step ensures that your site has a properly configured WebSphere MQ environment before proceeding with the installation of the OMEGAMON XE for WebSphere MQ Monitoring agent.
If you are not installing the OMEGAMON XE for WebSphere MQ Monitoring agent, skip to “Step 7. Checking the Installer’s Authority Level” on page 39.
ProcedureVerify that you are in compliance with the prerequisites below:
� The agents for OMEGAMON XE for WebSphere MQ Configuration and OMEGAMON XE for WebSphere MQ Monitoring each use a WebSphere MQ license. Verify that your site has enough licenses to install the agents for OMEGAMON XE for WebSphere MQ Configuration and OMEGAMON XE for WebSphere MQ Monitoring.
� The instructions in this guide assume that WebSphere MQ default objects, such as SYSTEM.DEFAULT.MODEL.QUEUE, exist. If they do not currently exist in your environment, you must create them before attempting to start the agent.
� If you want to monitor WebSphere MQ events, ensure that the following WebSphere MQ parameters are enabled (refer to your WebSphere MQ documentation if necessary):
– INHIBTEV
– LOCALEV
– PERFMEV
– REMOTEEV
– STRSTPEV
Preparing for Installation 39
Step 7. Checking the Installer’s Authority Level
Step 7. Checking the Installer’s Authority Level
Purpose of this stepThis step ensures that the user that will install and configure OMEGAMON XE has the proper authority.
ProcedureVerify that the user who will install and configure OMEGAMON XE has Security Officer (*SECOFR) authority on the AS/400 system where the installation will take place.
Step 8. Compiling Information About Your AS/400 System
40 Installing Candle Products on OS/400 (version CT350)
Step 8. Compiling Information About Your AS/400 System
Purpose of this stepThis step provides information that is needed before or during the installation and configuration of OMEGAMON XE.
ProcedureReview each section below and complete the steps to obtain the information.
Verifying that the IBM OMEGAMON/400 agent is not installed
OMEGAMON XE and the IBM OMEGAMON/400 agent cannot be installed on the same system.
Before installing any component of OMEGAMON XE you must check for the existence of the IBM OMEGAMON/400 agent and delete it if it is present using the steps below.
1. Access an OS/400 command line and enter the following command:GO LICPGM
2. At the Work with Licensed Programs, enter 12
(Delete licensed programs).
3. Check in the Licensed Program column for entry “57xxES1” (the IBM Omegamon/400 agent).
4. If the entry exists, enter 4
in the Option column next to it to delete.
Verifying which version of OS/400 you are running
1. Access an OS/400 command line and enter the following command:DSPSFWRSC
2. Press “F11” to display software resources.
3. In the Resource ID column, look for “57xx999”.
Preparing for Installation 41
Step 8. Compiling Information About Your AS/400 System
4. Check the corresponding Release column for the version number; for example, “V5R1M0”.
Verifying that the TCP/IP Utilities is installed, if necessary
If the components that you are installing require the TCP/IP Utilities, check for its presence as follows:
1. Access an OS/400 command line, and enter the following command:GO LICPGM
2. At the Work with Licensed Programs enter 10
(Display installed licensed programs).
3. Look for the following entry: “*COMPATIBLE TCP/IP Connectivity Utilities for AS/400”.
4. If the TCP/IP Utilities is not installed, you must install it. It is supplied as part of the operating system
Verifying the primary language of your AS/400 system
During installation you will be required to know whether or not the primary language of your AS/400 system is English. To determine this, complete the steps below:
1. Access an OS/400 command line and enter the following command:GO LICPGM
2. Enter 20
(Display installed secondary languages).
The Display Installed Secondary Languages dialog is displayed.
3. Note the primary language and description displayed in the upper left corner. An English system is primary language “2924”, description “English”.
4. Press “Enter” to continue.
Configuring OMEGAMON XE Across a Firewall
42 Installing Candle Products on OS/400 (version CT350)
Configuring OMEGAMON XE Across a Firewall
OverviewThis section provides an overview of Candle’s implementation of firewall support. It explains basic concepts and gives sample scenarios of various configurations. This section does not include specific steps for configuring OMEGAMON XE across a firewall; those steps can be found either in the installation chapters of this guide or in the other platform-specific installation guides, depending upon which operating systems you are configuring on.
Basic implementationAt this release, OMEGAMON XE supports most common firewall configurations, including those that use address translation (application proxy firewall is a notable exception). To enable this support, Candle uses the IP.PIPE socket address family, a TCP-based protocol that opens a single port on the firewall for communication by OMEGAMON XE components. If your target OMEGAMON XE environment includes a firewall between any CandleNet Command Center® (CCC™) components, you must specify IP.PIPE as your communication protocol during configuration. No other special configuration is needed unless your firewall also uses address translation.
Implementation with address translationAddress translation is an enhanced security feature of some firewall configurations. With this feature, components that must be reached across the firewall have two unique, but corresponding addresses: the external address (valid for components outside the firewall) and the internal address (valid for components inside the firewall).
With regard to OMEGAMON XE, the component that typically must be reached for connection is the CMS; however, the Warehouse Proxy, which runs on Windows as a server-type application, must also be accessible to clients and would also require an external and internal address. A component on either side of the firewall only knows about the address that is valid for its side (its “partition”).
To accommodate sites with address translation, Candle uses a partition-naming strategy. This strategy requires two steps:
Preparing for Installation 43
Configuring OMEGAMON XE Across a Firewall
� The creation of a text file called a partition file as part of the configuration of a hub or remote CMS (or Warehouse Proxy). The partition file contains an entry that defines that component’s address in the other partition.
� The specification of a partition name (any alphanumeric string up to 32 characters), as part of the configuration of any agent, a hub or remote CMS, a CMW, or Warehouse Proxy. A partition name must be specified for each component regardless of which side of the firewall it resides in.
Sample scenariosAssuming that your site has one firewall, there would be two partitions: one outside the firewall, one inside the firewall. In the sample scenarios that follow we will specify the names OUTSIDE and INSIDE, respectively, for these partitions. (If your site’s configuration includes more than one firewall, Candle recommends that you contact Candle customer service for assistance in configuring OMEGAMON XE.)
Note: Whatever the platform, the command-line examples in the following scenarios adhere to the UNIX and Windows text formatting conventions for literals and variables.
Scenario 1: hub CMS INSIDE, agents and CMW OUTSIDE
As part of the configuration of the hub CMS, we specify the name of the partition that it resides in INSIDE. We also create a partition file parthub.txt, containing the following entry:
OUTSIDE ip.pipe:hub’s_external_address
OUTSIDE is the partition name outside the firewall and hub’s_external_address is the address of the hub CMS that is valid for the agents and the CMW.
As part of the configuration of each agent and the CMW, we specify the name of the partition that each resides in OUTSIDE.
When an agent or the CMW starts, parthub.txt is searched for an entry that matches the partition name OUTSIDE and sees the CMS address that is valid for the agents and the CMW (the external address).
Scenario 2: hub and remote CMSs INSIDE, agents OUTSIDE
Note: In Scenarios 2 and 3 we will assume that all agents report to the remote CMS.
Configuring OMEGAMON XE Across a Firewall
44 Installing Candle Products on OS/400 (version CT350)
As part of the configuration of the hub CMS, we specify the name of the partition that it resides in INSIDE. No partition file is needed because the only component that reports to it (the remote CMS) is also inside the firewall.
As part of the configuration of the remote CMS, we specify the name of the partition that it resides in INSIDE. A partition file partremote.txt must also be created at the remote CMS. It contains the following entries:
OUTSIDE ip.pipe:remote’s_external_address
When configuring the agents (all of which are outside the firewall, reporting to the remote CMS), we specify the name of the partition that they reside in OUTSIDE. When the agents start, partremote.txt is searched for an entry that matches the partition name OUTSIDE and sees the remote CMS address that is valid for them (the external address).
Scenario 3: hub CMS INSIDE, remote CMS and agents OUTSIDE
As part of the configuration of the hub CMS, we specify the name of the partition that it resides in INSIDE. We also create a partition file parthub.txt, containing the following entry:
OUTSIDE ip.pipe:hub’s_external_address
OUTSIDE is the partition name outside the firewall and hub’s_external_address is the address of the hub CMS that is valid for the remote CMS.
As part of the configuration of both the agents and the remote CMS, we specify the name of the partition they reside in OUTSIDE.
A partition file partremote.txt also must be created at the remote CMS. It contains the following entry:
INSIDE ip.pipe:remote’s_internal_address
If the hub CMS needs to communicate with the remote CMS (for example, to issue a report request from an agent that is connected to the remote CMS), partremote.txt is searched for an entry that matches the partition name INSIDE and sees the remote CMS address that is valid for it (the internal address).
Installing and Configuring the Monitoring Agent for OS/400 45
Installing and Configuring theMonitoring Agent for OS/400
IntroductionThis chapter contains step-by-step instructions for installing and configuring the monitoring agent for OS/400.
Before you begin, verify that your site is in compliance with the agent’s hardware and software prerequisites listed in “Step 3. Checking Agent Installation Prerequisites” on page 34.
Chapter contents
Step 1. Installing or Upgrading the Monitoring Agent for OS/400 . . . . . . . . . . . . . 46
Step 2. Configuring the Monitoring Agent for OS/400 . . . . . . . . . . . . . . . . . . . . . . 53Step 3. Verifying the Installation and Configuration. . . . . . . . . . . . . . . . . . . . . . . . 56
2
Step 1. Installing or Upgrading the Monitoring Agent for OS/400
46 Installing Candle Products on OS/400 (version CT350)
Step 1. Installing or Upgrading the Monitoring Agent for OS/400
Purpose of this stepThis step loads the software for the monitoring agent for OS/400 from the Candle Products CD-ROM and uses the Restore Licensed Program to complete its installation.
Two procedures are provided:
� Install from a PC CD-ROM
� Install from an AS/400 CD-ROM
Use one of the two procedures, whichever is most convenient for your site. These procedures assume that you have completed the steps in “Preparing for Installation” on page 23.
Note: Be aware of the variable “vvv” that is included in the following text. The variable “vvv” should be replaced with:
–“430” for OS/400 (version A4O36025 and prior)
–“440” for OS/400 (version A4O36026)
Installing from a PC CD-ROM
1. Sign on as “QSECOFR” or with a profile with an equivalent special authority (SPCAUT)...� *ALLOBJ
� *AUDIT
� *IOSYSCFG
� *JOBCTL
� *SAVSYS
� *SECADM
� *SERVICE
� *SPLCTL
2. Access an OS/400 command line.
Installing and Configuring the Monitoring Agent for OS/400 47
Step 1. Installing or Upgrading the Monitoring Agent for OS/400
3. Check that the system value QALWOBJRST is set to “*ALL”.
1. Enter this command:WRKSYSVAL QALWOBJRST
2. Select “5” (Display), and verify that the value is set to “*ALL”. If it is set to any other value, record those values below:
QALWOBJRST___________________________________________________
4. Press “Enter” to continue.
5. If QALWOBJRST was set to “*ALL”, continue with step 6. below; otherwise, do the following:1. On the Work with System Values dialog, enter
2
to change the values.
2. On the Change System Value dialog, change the existing values to *ALL.
3. Press “Enter” to save your change.4. Press “F3” to return.
6. At the OS/400 command line, create an AS/400 library for OMEGAMON XE installation:
CRTLIB CCCINST TEXT(‘CANDLE INSTALL LIBRARY’)
7. Create a save file in the CCCINST library:CRTSAVF CCCINST/A4SAVF TEXT(‘A4 INSTALL PRODUCT’)
8. Insert the Candle Products CD-ROM into the CD-ROM drive.
9. From a DOS prompt, start an ftp session:FTP machinename
where machinename is the name of the target OS/400 machine.
10. When prompted, enter your OS/400 user ID and password.
11. Change the ftp type to binary:BINARY
12. Transfer the software for the monitoring agent for OS/400 from the CD-ROM to the OS/400 machine:
PUT e:\OS400\CMA\A4vvvCMA.SAV CCCINST/A4SAVF (REPLACE
Step 1. Installing or Upgrading the Monitoring Agent for OS/400
48 Installing Candle Products on OS/400 (version CT350)
where e is your PC CD-ROM drive.
13. End your ftp session:QUIT
14. From an OS/400 command line, install the software for the monitoring agent for OS/400 (do one of the following):� If you are installing the product on a system that is English upper and
lower case (language ID 2924), do the following:
A. Enter the following command:RSTLICPGM LICPGM(0KA4vvv) DEV(*SAVF) SAVF(CCCINST/A4SAVF)
B. Proceed to step 15. below.� If you are installing on a non-language ID 2924 system, do the following:
A. Check for the existence of the KA4LNG work library.a. If the KA4LNG library exists, clear it:
CLRLIB KA4LNG
b. If the KA4LNG library does not exist, create it:CRTLIB KA4LNG
B. Enter the following two commands:RSTLICPGM LICPGM(0KA4vvv) DEV(*SAVF) RSTOBJ(*PGM) SAVF(CCCINST/A4SAVF)
RSTLICPGM LICPGM(0KA4vvv) DEV(*SAVF) RSTOBJ(*LNG) LNG(2924) SAVF(CCCINST/A4SAVF) LNGLIB(QKA4LNG)
C. If you intend to install other agents, leave the QALWOBJRST value set to “*ALL” until you are finished; otherwise, change it back to the value(s) you recorded earlier.
D. If you will be installing the agent on another AS/400 machine, use ftp or another file transfer program to copy the save file to it.
15. (optional) Delete the installation library, which is no longer needed:DLTLIB CCCINST
Installation of the monitoring agent for OS/400 is complete.
16. Proceed to “Step 2. Configuring the Monitoring Agent for OS/400” on page 53.
Installing and Configuring the Monitoring Agent for OS/400 49
Step 1. Installing or Upgrading the Monitoring Agent for OS/400
Installing from an AS/400 CD-ROM
1. Sign on as “QSECOFR” or with a profile with an equivalent special authority (SPCAUT)...:� *ALLOBJ
� *AUDIT
� *IOSYSCFG
� *JOBCTL
� *SAVSYS
� *SECADM
� *SERVICE
� *SPLCTL
2. Access an OS/400 command line.
3. Check that the system value QALWOBJRST is set to “*ALL”.1. Enter this command:
WRKSYSVAL QALWOBJRST
2. Select “5” (Display), and verify that the value is set to “*ALL”. If it is set to any other value(s), record those value(s) below:
QALWOBJRST___________________________________________________
4. Press “Enter” to continue.
5. If QALWOBJRST was set to other value(s), do the following:1. On the Work with System Values dialog, enter
2
to change the values.
2. On the Change System Value dialog, change the existing values to *ALL
3. Press “Enter” to save your change.4. Press “F3” to return.
6. Create an AS/400 library for the OMEGAMON XE Installation.CRTLIB CCCINST TEXT(‘CANDLE INSTALL LIBRARY’)
7. Create a save file in the CCCINST library:
Step 1. Installing or Upgrading the Monitoring Agent for OS/400
50 Installing Candle Products on OS/400 (version CT350)
CRTSAVF CCCINST/A4SAVF TEXT(‘A4 INSTALL PRODUCT’)
8. Create a work folder.1. Enter this command:
WRKFLR
2. Select “1” (Create Folder), then specify A4FLR
for the folder name.
9. Insert the Candle CD-ROM into the CD-ROM drive and enter:WRKLNK QOPT
The Work with Object Links screen displays the qopt object link.
10. Select “5” (Next Level) at the qopt object link to select the next object link, the volume ID (volid) of the CD-ROM. Record this value for use during installation:
VOL ID _____________________________________________________
11. Continue to select “5” for each link level until the following path is displayed:/QOPT/volid/OS400/CMA
where volid is the volume ID of the CD-ROM.
12. Look for file A4vvvCMA.SAV,
13. Copy this .SAV file to QDLS:CPY OBJ(‘/QOPT/volid/OS400/CMA/A4vvvCMA.SAV’)TODIR(‘/QDLS/A4FLR’)
where volid is the volume ID of the CD-ROM,
14. From an OS/400 command line, start an ftp session:FTP machinename
where machinename is the name of the target OS/400 machine.
15. Enter your user ID and password.
16. Change the file type to binary:BINARY
17. EnterNAMEFMT 1
Installing and Configuring the Monitoring Agent for OS/400 51
Step 1. Installing or Upgrading the Monitoring Agent for OS/400
18. On the command line, enterPUT /QDLS/A4FLR/A4vvvCMA.SAV /QSYS.LIB/CCCINST.LIB/A4SAVF.SAVF
19. End your ftp session:QUIT
20. From an OS/400 command line, install the software for the monitoring agent for OS/400. Do one of the following:� If you are installing the product on a system that is English upper and
lower case (language ID 2924), do the following:
A. Enter the following:RSTLICPGM LICPGM(0KA4vvv) DEV(*SAVF) SAVF(CCCINST/A4SAVF)
B. Proceed to Step 21. below.� If you are installing the product on a system that has a Primary Language
other than feature 2924 (upper and lower case English) do the following:
A. Check for the existence of the KA4LNG work library.a. If the KA4LNG library exists, clear it:
CLRLIB KA4LNG
b. If the KA4LNG library does not exist, create it:CRTLIB KA4LNG
B. Enter the following two commands:RSTLICPGM LICPGM(0KA4vvv) DEV(*SAVF) RSTOBJ(*PGM) SAVF(CCCINST/A4SAVF)
RSTLICPGM LICPGM(0KA4vvv) DEV(*SAVF) RSTOBJ(*LNG) LNG(2924) SAVF(CCCINST/A4SAVF) LNGLIB(QKA4LNG)
C. If you intend to install agents, leave the QALWOBJRST value set to “*ALL” until you are finished; otherwise, change it back to the values you recorded earlier.
21. Delete the installation objects that are no longer needed1. Enter this command:
DLTLIB CCCINST
2. Delete A4vvvCMA.SAV from your folder:WRKDOC FLR(A4FLR)
Step 1. Installing or Upgrading the Monitoring Agent for OS/400
52 Installing Candle Products on OS/400 (version CT350)
3. Select “4” for A4vvvCMA.SAV.4. Press “Enter” to delete5. Press “Enter” again to return to the command line.6. Delete the installation folder:
WRKFLR
7. Select “4” for A4FLR, press “Enter” to delete, then press “F3” to return to the command line.
Installation of the monitoring agent for OS/400 is complete.
22. Proceed to “Step 2. Configuring the Monitoring Agent for OS/400” on page 53.
Installing and Configuring the Monitoring Agent for OS/400 53
Step 2. Configuring the Monitoring Agent for OS/400
Step 2. Configuring the Monitoring Agent for OS/400
Purpose of this stepThis step establishes the necessary network connections between the monitoring agent for OS/400 and the CMS to which it will report. Online Help is available by pressing “F1”.
Procedure
1. From an OS/400 command line enter this command:GO OMA
2. Enter 4
to select Configure Omegamon Monitoring Agent.
The Configure OMA (CFGOMA) dialog is displayed.
3. Enter your site’s values for the displayed parameters using the guidelines below.If your site is using a firewall through which any Candle components will communicate, be sure to read “Configuring OMEGAMON XE Across a Firewall” on page 27 before you begin this step.
Table 3. Parameters for the Configure OMA (CFGOMA) Dialog
Parameter Description
CMS SNA location The SNA location of the CMS that this agent will report to. If you will not use SNA, enter “*NONE”. If the correct SNA location was previously defined, enter “*SAME” to retrieve it. If you need to define a new SNA location (which can be the Control Point Name or the remote location name) enter its name (for example: S10B6322).
CMS TCP/IP address The TCP/IP address or host name of the machine where the CMS that this agent will report to resides. If you will not use TCP/IP, enter “*NONE”. If the correct TCP/IP address or host name was previously defined, enter “*SAME” to retrieve it. If you need to define a different TCP/IP address or host name, enter it (for example: 129.0.132.45 or NEWYORK).
Step 2. Configuring the Monitoring Agent for OS/400
54 Installing Candle Products on OS/400 (version CT350)
IP Pipe Address If the monitoring agent for OS/400 must connect to the CMS through a firewall, you must use IP.PIPE. Specify the IP Pipe address or host name of the machine where the CMS resides.
If you will not use IP Pipe, enter “*NONE”.
Secondary CMS SNA location
The SNA location of a secondary CMS that this agent will report to if it cannot communicate with the primary CMS at startup.
Secondary CMS IP address
The TCP/IP address or host name of the machine where a secondary CMS resides. The agent will report to this CMS if it cannot communicate with the primary CMS at startup.
Secondary IP Pipe Address
The IP Pipe address or host name of the machine where a secondary CMS resides. The agent will report to this CMS if it cannot communicate with the primary CMS at startup.
Partition Name (Required only by sites with firewalls that use address translation.) The name of the partition that this monitoring agent for OS/400 resides in (up to 32 alphanumeric characters).
Firewall in use If the monitoring agent for OS/400 must connect to the CMS through a firewall, enter “*YES”. If not, retain the default of “*NO”.
CMS TCP/IP port address
The listening port of the CMS that this agent will report to (usually 1918). If your site uses SNA or IP Pipe, ignore this field. If the correct port address was previously defined, enter “*SAME” to retrieve it. If you need to specify a different CMS port address, enter it (up to six numeric characters).
CMS SNA port address
The listening port of the CMS that this agent will report to (usually 1918). If your site uses TCP/IP or IP Pipe, ignore this field. If the correct port address was previously defined, enter “*SAME” to retrieve it. If you need to specify a different CMS port address, enter it (up to six numeric characters).
CMS IP.PIPE port address
The listening port of the CMS that this agent will report to (usually 1918). If your site uses TCP/IP or SNA, ignore this field. If you need to specify a different CMS port address, enter it (up to six numeric characters).
Action user profile The user authority under which user action should be administered. Retain the default value of QAUTOMON to grant user system operator authority.
Table 3. Parameters for the Configure OMA (CFGOMA) Dialog (continued)
Installing and Configuring the Monitoring Agent for OS/400 55
Step 2. Configuring the Monitoring Agent for OS/400
Note: You can specify values for CMS SNA location, CMS TCP/IP address, and IP.PIPE address. The system will check them in order. If you specify “*NONE” for all CMS and Secondary CMS parameters, the monitoring agent for OS/400 looks for your CandleLight® workstation at start-up.
If you are reconfiguring the agent, the changes will take effect the next time the agent is started.
Configuration of the monitoring agent for OS/400 is complete.
4. Proceed to “Step 3. Verifying the Installation and Configuration” on page 56.
SNA transaction program
This prompt is displayed only if you entered a value (or “*SAME”) for CMS SNA location.
The name of the SNA transaction program. Candle recommends retaining the default value of KDTMSNAP.
Library This prompt is displayed only if you entered a value (or “*SAME”) for SNA location.
The name of the SNA transaction program library. Candle recommends retaining the default value of KMSCMS.
Transaction program (backup)
This prompt is displayed only if you entered a value (or “*SAME”) for Secondary CMS SNA location.
The name of the SNA transaction program. Candle recommends retaining the default value of KDTMSNAP.
Library This prompt is displayed only if you entered a value (or “*SAME”) for Secondary CMS SNA location.
The name of the SNA transaction program library. Candle recommends retaining the default value of KMSCMS.
Table 3. Parameters for the Configure OMA (CFGOMA) Dialog (continued)
Step 3. Verifying the Installation and Configuration
56 Installing Candle Products on OS/400 (version CT350)
Step 3. Verifying the Installation and Configuration
Purpose of this stepThis step starts (and optionally stops) the monitoring agent for OS/400 to verify that it was installed and configured properly.
Note: If you are using SNA for your agent-to-CMS connection, you may need to complete additional configuration steps. Refer to “Additional Configuration Steps for SNA Environments” on page 89 before you attempt to start the agent.
Procedure
Starting the agent
1. Verify that the CMS that the agent connects to is started.
2. From an OS/400 command line enter this command:GO OMA
3. Enter 2
to select Start Omegamon Monitoring Agent.
4. Verify that the following messages are displayed: Omegamon Monitoring Agent startup in progress
Candle Management Server located
Note: It may be several minutes before the “Online” status is shown in the CandleNet Portal Managed System Status workspace (log on to CandleNet Portal, right-click the Enterprise icon and, from the pop-up menu, select “Workspace > Managed System Status”) or, if you installed a CMW, in the managed system list at your CMW.
5. Repeat the above steps on each system where you want to start the monitoring agent for OS/400.
Stopping the agent (optional)
To stop the monitoring agent for OS/400 use the following procedure:
1. From an OS/400 command line enter this command:
Installing and Configuring the Monitoring Agent for OS/400 57
Step 3. Verifying the Installation and Configuration
GO OMA
2. Enter 3
to select End Omegamon Monitoring Agent.
3. Press “F4” to see options for ending the agent, and specify one of the following:� “*IMMED” to shut down immediately
� “*CNTRLD” for a controlled shutdown. With a controlled shutdown, you can also specify the following options:
– “Delay time”, in seconds. Shutdown is delayed for the time interval that you specify, allowing the agent to complete operations.
– “Allow abnormal end if needed (YES, NO)”. If you enter “YES“ any jobs that have not ended normally after 10 minutes will shut down abnormally.
4. Look for a message that states that Omegamon Monitoring Agent ended.Verification of the installation and configuration of the monitoring agent for OS/400 is complete.
Step 3. Verifying the Installation and Configuration
58 Installing Candle Products on OS/400 (version CT350)
Installing and Configuring OMEGAMON XE for WebSphere MQ Configuration 59
Installing and ConfiguringOMEGAMON XE for
WebSphere MQ Configuration
IntroductionThis chapter contains step-by-step instructions for installing and configuring the OMEGAMON XE for WebSphere MQ Configuration agent.
Before you begin, verify that your site is in compliance with the agent’s hardware and software prerequisites listed in “Step 3. Checking Agent Installation Prerequisites” on page 34.
Chapter contents
Step 1. Installing or Upgrading OMEGAMON XE for WebSphere MQ Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Step 2. Configuring the OMEGAMON XE for WebSphere MQ Configuration Agent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66Step 3. Verifying the Installation and Configuration. . . . . . . . . . . . . . . . . . . . . . . . 69
3
Step 1. Installing or Upgrading OMEGAMON XE for WebSphere MQ Configuration
60 Installing Candle Products on OS/400 (version CT350)
Step 1. Installing or Upgrading OMEGAMON XE for WebSphere MQ Configuration
Purpose of this stepThis step loads the software for the OMEGAMON XE for WebSphere MQ Configuration agent from the Candle Products CD-ROM and uses the Restore Licensed Program to complete its installation.
Two procedures are provided:
� Install from a PC CD-ROM
� Install from an AS/400 CD-ROM
Use one of the two procedures, whichever is most convenient for your site. These procedures assume that you have completed the steps in “Preparing for Installation” on page 23.
Note: Be aware of the variable “vvv” that is included in the following text. The variable “vvv” should be replaced with:
–“450” for OS/400 (versions 5r1 or 5r2) with WebSphere MQ (versions 5.2 or 5.3)
Installing from a PC CD-ROM
1. Access an OS/400 command line.
2. Check that the system value QALWOBJRST is set to “*ALL”.1. Enter this command:
WRKSYSVAL QALWOBJRST
2. Select “5” (Display), and verify that the value is set to “*ALL”. If it is set to any other value(s), record those value(s) below:
QALWOBJRST_____________________________________________
3. Press “Enter” to continue.
4. If QALWOBJRST was set to “*ALL”, continue with step 5 below; otherwise, do the following:1. On the Work with System Values dialog, enter
2
Installing and Configuring OMEGAMON XE for WebSphere MQ Configuration 61
Step 1. Installing or Upgrading OMEGAMON XE for WebSphere MQ Configuration
to change the values.
2. On the Change System Value dialog, change the existing values to *ALL.
3. Press “Enter” to save your change.4. Press “F3” to return.
5. At the OS/400 command line, create an AS/400 library for OMEGAMON XE installation:
CRTLIB CCCINST TEXT(‘CANDLE INSTALL LIBRARY’)
6. Create a save file in the CCCINST library:CRTSAVF CCCINST/MCSAVF TEXT(‘MC INSTALL PRODUCT’)
7. Insert the Candle Products CD-ROM into the CD-ROM drive.
8. From a DOS prompt, start an ftp session:FTP machinename
where machinename is the name of the target OS/400 machine.
9. When prompted, enter your OS/400 user ID and password.
10. Change the ftp type to binary:BINARY
11. Transfer the software for the OMEGAMON XE for WebSphere MQ Configuration agent from the CD-ROM to the OS/400 machine:
PUT e:\OS400\CMA\MCvvvCMA.SAV CCCINST/MCSAVF (REPLACE
where e is your PC CD-ROM drive.
12. End your ftp session:QUIT
13. From an OS/400 command line, install the software for the OMEGAMON XE for WebSphere MQ Configuration agent (do one of the following):� If you are installing the product on a system that is English upper and
lower case (language ID 2924), do the following:
A. Enter the following command:RSTLICPGM LICPGM(0KMCvvv) DEV(*SAVF) SAVF(CCCINST/MCSAVF)
B. Proceed to step 14. below.� If you are installing on a non-language ID 2924 system, do the following:
Step 1. Installing or Upgrading OMEGAMON XE for WebSphere MQ Configuration
62 Installing Candle Products on OS/400 (version CT350)
A. Check for the existence of the KMCLNG work library.a. If the KMCLNG library exists, clear it:
CLRLIB KMCLNG
b. If the KMCLNG library does not exist, create it:CRTLIB KMCLNG
B. Enter the following commands:RSTLICPGM LICPGM(0KMCvvv) DEV(*SAVF) RSTOBJ(*PGM)SAVF(CCCINST/MCSAVF)
RSTLICPGM LICPGM(0KMCvvv) DEV(*SAVF) RSTOBJ(*LNG) LNG(2924) SAVF(CCCINST/MCSAVF) LNGLIB(QKMCLNG)
SAVF(CCCINST/MCSAVF)
This creates or recreates a library named KMCLIB containing all the file transfer utilities components and definitions required to run the software for the OMEGAMON XE for WebSphere MQ Configuration agent.
14. If you intend to install other agents, leave the QALWOBJRST value set to “*ALL” until you are finished; otherwise, change it back to the value(s) you recorded earlier.
15. If you will be installing the agent on another AS/400 machine, use ftp or another file transfer program to copy the save file to it.
16. Delete the installation library, which is no longer needed:DLTLIB CCCINST
Installation of the software for the OMEGAMON XE for WebSphere MQ Configuration agent is complete.
17. Proceed to “Step 2. Configuring the OMEGAMON XE for WebSphere MQ Configuration Agent” on page 66.
Installing from an AS/400 CD-ROM:
1. Access an OS/400 command line.
2. Check that the system value QALWOBJRST is set to “*ALL.“
3. Enter this command:WRKSYSVAL QALWOBJRST
Installing and Configuring OMEGAMON XE for WebSphere MQ Configuration 63
Step 1. Installing or Upgrading OMEGAMON XE for WebSphere MQ Configuration
4. Select “5” (Display), and verify that the value is set to “*ALL”. If it is set to any other value(s), record those value(s) below:QALWOBJRST _____________________________________________
5. Press “Enter” to continue.
6. If QALWOBJRST was set to “*ALL”, continue with step 5 below; otherwise, do the following:1. On the Work with System Values dialog, enter
2
to change the values.
2. On the Change System Value dialog, change the existing values to *ALL.
3. Press “Enter” to save your change.4. Press “F3” to return.
7. Create an AS/400 library for OMEGAMON XE installation:CRTLIB CCCINST TEXT(‘CANDLE INSTALL LIBRARY’)
8. Create a save file in the CCCINST library:CRTSAVF CCCINST/MCSAVF TEXT(‘MC INSTALL PRODUCT’)
9. Create a work folder.1. Enter this command:
WRKFLR
2. Select “1” (Create Folder), then specify MCFLR
for the folder name.
10. Insert the Candle Products CD-ROM into the CD-ROM drive and enter:WRKLNK QOPT
The Work with Object Links screen displays the qopt object link.
11. Select “5” (Next Level) at the qopt object link to select the next object link, the volume ID (volid) of the CD-ROM. Record this value for use during installation:
VOL ID _____________________________________________________
12. Continue to select “5” for each link level until the following path is displayed:
Step 1. Installing or Upgrading OMEGAMON XE for WebSphere MQ Configuration
64 Installing Candle Products on OS/400 (version CT350)
/QOPT/volid/OS400/CMA
where volid is the volume ID of the CD-ROM.
13. Look for file MCvvvCMA.SAV.
14. Copy this .SAV file to QDLS:CPY OBJ(‘/QOPT/volid/OS400/CMA/MCvvvCMA.SAV’)TODIR(‘/QDLS/MCFLR’)
where volid is the volume ID of the CD-ROM.
15. From an OS/400 command line, start an ftp session:FTP machinename
where machinename is the name of the target OS/400 machine.
16. Enter your user ID and password.
17. Change the file type to binary:BINARY
18. EnterNAMEFMT 1
19. On the command line, enterPUT /QDLS/MCFLR/MCvvvCMA.SAV /QSYS.LIB/CCCINST.LIB/MCSAVF.SAVF
20. End your ftp session:QUIT
21. From an OS/400 command line, install the software for the OMEGAMON XE for WebSphere MQ Configuration agent (do one of the following):� If you are installing the product on a system that is English upper and
lower case (language ID 2924), do the following:
A. Enter the following command:RSTLICPGM LICPGM(0KMCvvv) DEV(*SAVF) SAVF(CCCINST/MCSAVF)
B. Proceed to step 22. below.� If you are installing on a non-language ID 2924 system, do the following:
A. Check for the existence of the KMCLNG work library.a. If the KMCLNG library exists, clear it:
CLRLIB KMCLNG
Installing and Configuring OMEGAMON XE for WebSphere MQ Configuration 65
Step 1. Installing or Upgrading OMEGAMON XE for WebSphere MQ Configuration
b. If the KMCLNG library does not exist, create it:CRTLIB KMCLNG
B. Enter the following commands:RSTLICPGM LICPGM(0KMCvvv) DEV(*SAVF) RSTOBJ(*PGM) SAVF(CCCINST/MCSAVF)
RSTLICPGM LICPGM(0KMCvvv) DEV(*SAVF) RSTOBJ(*LNG) LNG(2924) SAVF(CCCINST/MCSAVF) LNGLIB(QKMCLNG)
This creates or recreates a library named KMCLIB containing all the file transfer utilities components and definitions required to run the software for the OMEGAMON XE for WebSphere MQ Configuration agent.
22. If you intend to install other agents, leave the QALWOBJRST value set to “*ALL” until you are finished; otherwise, change it back to the values you recorded earlier.
23. Delete the installation objects that are no longer needed1. Enter this command:
DLTLIB CCCINST
2. Delete MCvvvCMA.SAV from your folder:WRKDOC FLR(MCFLR)
3. Select “4” for MCvvvCMA.SAV.4. Press “Enter” to delete.5. Press “F3” to return to the command line.6. Delete the installation folder:
WRKFLR
7. Select “4” for MCFLR. 8. Press “Enter” to delete. 9. Press “F3” to return to the command line.Installation of the software for the OMEGAMON XE for WebSphere MQ Configuration agent is complete.
24. Proceed to “Step 2. Configuring the OMEGAMON XE for WebSphere MQ Configuration Agent” on page 66.
Step 2. Configuring the OMEGAMON XE for WebSphere MQ Configuration Agent
66 Installing Candle Products on OS/400 (version CT350)
Step 2. Configuring the OMEGAMON XE for WebSphere MQ Configuration Agent
Purpose of this stepThis step establishes the necessary network connections between the OMEGAMON XE for WebSphere MQ Configuration agent and the CMS to which it will report. Online Help is available by pressing “F1”.
Procedure
1. From an OS/400 command line, enter this commandGO OMAMC
2. Enter 4
to select Configure CCC for MQSeries Configuration Agent.
The Configure OMA (CFGOMAMC) dialog is displayed.
3. Enter your site’s values for the displayed parameters using the guidelines below.If your site is using a firewall through which any Candle components will communicate, be sure to read “Configuring OMEGAMON XE Across a Firewall” on page 27 before you begin this step.
Table 4. Parameters for the Configure OMA (CFGOMAMC) Dialog
Parameter Description
CMS SNA location The SNA location of the CMS that this agent will report to. If you will not use SNA, enter “*NONE”. If the correct SNA location was previously defined, enter “*SAME“ to retrieve it. If you need to define a new SNA location (which can be the Control Point Name or the remote location name) enter its name (for example: S10B6322).
CMS TCP/IP address The TCP/IP address or host name of the machine where the CMS that this agent will report to resides. If you will not use TCP/IP, enter “*NONE”. If the correct TCP/IP address or host name was previously defined, enter “*SAME” to retrieve it. If you need to define a different TCP/IP address or host name, enter it (for example: 129.0.132.45 or NEWYORK).
Installing and Configuring OMEGAMON XE for WebSphere MQ Configuration 67
Step 2. Configuring the OMEGAMON XE for WebSphere MQ Configuration Agent
CMS IP.PIPE Address If the OMEGAMON XE for WebSphere MQ Configuration agent must connect to the CMS through a firewall, you must use IP.PIPE. Specify the IP.PIPE address or host name of the machine where the CMS resides.
If you will not use IP.PIPE, enter “*NONE”.
Secondary CMS SNA location
The SNA location of a secondary CMS that this agent will report to if it cannot communicate with the primary CMS at startup.
Secondary CMS IP address
The TCP/IP address or host name of the machine where a secondary CMS resides. The agent will report to this CMS if it cannot communicate with the primary CMS at startup.
Secondary CMS IP.PIPE Address
The IP.PIPE address or host name of the machine where a secondary CMS resides. The agent will report to this CMS if it cannot communicate with the primary CMS at startup.
Partition Name (Required only by sites with firewalls that use address translation.) The name of the partition that this OMEGAMON XE for WebSphere MQ Configuration agent resides in (up to 32 alphanumeric characters).
Firewall in use If the OMEGAMON XE for WebSphere MQ Configuration agent must connect to the CMS through a firewall, enter “*YES”. If not, retain the default of “*NO”.
CMS TCP/IP port address
The listening port of the CMS that this agent will report to (usually 1918). If your site uses SNA or IP.PIPE, ignore this field. If the correct port address was previously defined, enter “*SAME”.to retrieve it. If you need to specify a different CMS port address, enter it (up to six numeric characters).
CMS SNA port address
The listening port of the CMS that this agent will report to (usually 1918). If your site uses TCP/IP or IP.PIPE, ignore this field. If the correct port address was previously defined, enter “*SAME” to retrieve it. If you need to specify a different CMS port address, enter it (up to six numeric characters).
CMS IP.PIPE port address
The listening port of the CMS that this agent will report to (usually 1918). If your site uses TCP/IP or SNA, ignore this field. If you need to specify a different CMS port address, enter it (up to six numeric characters).
Action user profile The user authority under which user action should be administered. Retain the default value of QAUTOMON to grant user system operator authority.
Table 4. Parameters for the Configure OMA (CFGOMAMC) Dialog (continued)
Step 2. Configuring the OMEGAMON XE for WebSphere MQ Configuration Agent
68 Installing Candle Products on OS/400 (version CT350)
Note: You can specify values for CMS SNA Location, CMS TCP/IP address, and IP.PIPE address. The system will check them in order. If you specify *NONE for all CMS and Secondary CMS parameters, the OMEGAMON XE for WebSphere MQ Configuration agent looks for your CandleLight workstation at start-up.
If you are reconfiguring the agent, the changes will take effect the next time the agent is started.
Configuration of the OMEGAMON XE for WebSphere MQ Configuration agent is complete.
4. Proceed to “Step 3. Verifying the Installation and Configuration” on page 69.
SNA transaction program
This prompt is displayed only if you entered a value (or “*SAME”) for CMS SNA location.
The name of the SNA transaction program. Candle recommends retaining the default value of KDTMSNAP.
Library This prompt is displayed only if you entered a value (or “*SAME”) for SNA location.
The name of the SNA transaction program library. Candle recommends retaining the default value of KMSCMS.
Transaction program (backup)
This prompt is displayed only if you entered a value (or “*SAME”) for Secondary CMS SNA location.
The name of the SNA transaction program. Candle recommends retaining the default value of KDTMSNAP.
Library This prompt is displayed only if you entered a value (or “*SAME”) for Secondary CMS SNA location.
The name of the SNA transaction program library. Candle recommends retaining the default value of KMSCMS.
Table 4. Parameters for the Configure OMA (CFGOMAMC) Dialog (continued)
Installing and Configuring OMEGAMON XE for WebSphere MQ Configuration 69
Step 3. Verifying the Installation and Configuration
Step 3. Verifying the Installation and Configuration
Purpose of this stepThis step starts (and optionally stops) the OMEGAMON XE for WebSphere MQ Configuration agent, verifying that it has been installed and configured properly.
Note: If you are using SNA for your agent-to-CMS connection, you may need to complete additional configuration steps. Refer to “Additional Configuration Steps for SNA Environments” on page 89 before you attempt to start the agent.
Procedure
Start the agent
1. Verify that the CMS that the agent connects to is started.
2. From an OS/400 command line, enter this command:GO OMAMC
3. Enter 2
to select Start CCC for MQSeries Configuration Agent.
4. Verify that the following messages are displayed:Omegamon Monitoring Agent startup in progress
Candle Management Server located
Note: It may be several minutes before the “Online” status is shown in the CandleNet Portal Managed System Status workspace (log on to CandleNet Portal, right-click the Enterprise icon and, from the pop-up menu, select “Workspace > Managed System Status”) or, if you installed a CMW, in the managed system list at your CMW.
5. Repeat the above steps on each system where you want to start the OMEGAMON XE for WebSphere MQ Configuration agent.
Step 3. Verifying the Installation and Configuration
70 Installing Candle Products on OS/400 (version CT350)
Stopping the agent (optional)
To stop the OMEGAMON XE for WebSphere MQ Configuration agent, use the following procedure:
1. From an OS/400 command line enter this command:GO OMAMC
2. Enter 3
to select End CCC for MQSeries Configuration Agent.
3. Press “F4” to see options for ending the agent, and specify one of the following:� “*IMMED” to shut down immediately
� “*CNTRLD” for a controlled shutdown. With a controlled shutdown, you can also specify the following options:
– “Delay time”, in seconds. Shutdown is delayed for the time interval that you specify, allowing the agent to complete operations.
– “Allow abnormal end if needed (YES, NO)”. If you enter “YES”, any jobs that have not ended normally after 10 minutes will shut down abnormally.
4. Look for a message that states that Omegamon Monitoring Agent ended.Verification of the installation and configuration of the OMEGAMON XE for WebSphere MQ Configuration agent is complete.
Installing and Configuring OMEGAMON XE for WebSphere MQ Monitoring 71
Installing and ConfiguringOMEGAMON XE for
WebSphere MQ Monitoring
IntroductionThis chapter contains step-by-step instructions for installing and configuring the OMEGAMON XE for WebSphere MQ Monitoring agent.
Before you begin, verify that your site is in compliance with the agent’s hardware and software prerequisites listed in “Step 3. Checking Agent Installation Prerequisites” on page 34.
Note: Be sure that QMQMADM authority is given to the KMQ User Profile as the default setting.
Chapter contents
Step 1. Installing or Upgrading OMEGAMON XE for WebSphere MQ Monitoring. 72
Step 2. Configuring the OMEGAMON XE for WebSphere MQ Monitoring Agent . 78Step 3. Verifying the Installation and Configuration. . . . . . . . . . . . . . . . . . . . . . . . 82Step 4. Customizing Monitoring Options (optional) . . . . . . . . . . . . . . . . . . . . . . . . 85
4
Step 1. Installing or Upgrading OMEGAMON XE for WebSphere MQ Monitoring
72 Installing Candle Products on OS/400 (version CT350)
Step 1. Installing or Upgrading OMEGAMON XE for WebSphere MQ Monitoring
Purpose of this stepThis step loads the software for the OMEGAMON XE for WebSphere MQ Monitoring agent from the Candle Products CD-ROM and uses the Restore Licensed Program to complete its installation.
Two procedures are provided:
� Install from a PC CD-ROM
� Install from an AS/400 CD-ROM
Use one of the two procedures, whichever is most convenient for your site. These procedures assume that you have completed the steps in “Preparing for Installation” on page 23.
Note: Be aware of the variable “vvv” that is included in the following text. The variable “vvv” should be replaced with:
–“450” for OS/400 (versions 5r1, or 5r2) with WebSphere MQ (versions 5.2 or 5.3)
Installing from a PC CD-ROM
1. Access an OS/400 command line.
2. Check that the system value QALWOBJRST is set to “*ALL.“
3. Enter this command:WRKSYSVAL QALWOBJRST
10. Select “5” (Display), and verify that the value is set to “*ALL”. If it is set to any other value(s), record those value(s) below:
QALWOBJRST___________________________________________________
4. Press “Enter” to continue.
5. If QALWOBJRST was set to “*ALL”, continue with step 6. below; otherwise, do the following:1. On the Work with System Values dialog, enter
2
Installing and Configuring OMEGAMON XE for WebSphere MQ Monitoring 73
Step 1. Installing or Upgrading OMEGAMON XE for WebSphere MQ Monitoring
to change the values.
2. On the Change System Value dialog, change the existing values to *ALL
3. Press “Enter” to save your change.4. Press “F3” to return.
6. At the OS/400 command line, create an AS/400 library for OMEGAMON XE installation:
CRTLIB CCCINST TEXT(‘CANDLE INSTALL LIBRARY’)
7. Create a save file in the CCCINST library:CRTSAVF CCCINST/MQSAVF TEXT(‘MQ INSTALL PRODUCT’)
8. Insert the Candle Products CD-ROM into the CD-ROM drive.
9. From a DOS prompt, start an ftp session:FTP machinename
where machinename is the name of the target OS/400 machine.
10. When prompted, enter your OS/400 user ID and password.
11. Change the ftp type to binary:BINARY
12. Transfer the software for the OMEGAMON XE for WebSphere MQ Monitoring agent from the CD-ROM to the OS/400 machine:
PUT e:\OS400\CMA\MQvvvCMA.SAV CCCINST/MQSAVF (REPLACE
where e: is your PC CD-ROM drive.
13. End your ftp session:QUIT
14. From an OS/400 command line, install the software for the OMEGAMON XE for WebSphere MQ Monitoring agent (do one of the following):� If you are installing the product on a system that is English upper and
lower case (language ID 2924), do the following:
A. Enter the following command:RSTLICPGM LICPGM(0KMQvvv) DEV(*SAVF) SAVF(CCCINST/MQSAVF)
B. Proceed to step 15. below.� If you are installing on a non-language ID 2924 system, do the following:
Step 1. Installing or Upgrading OMEGAMON XE for WebSphere MQ Monitoring
74 Installing Candle Products on OS/400 (version CT350)
A. Check for the existence of the KMQLNG work library.a. If the KMQLNG library exists, clear it:
CLRLIB KMQLNG
b. If the KMQLNG library does not exist, create it:CRTLIB KMQLNG
B. Enter the following commands:RSTLICPGM LICPGM(0KMQvvv) DEV(*SAVF) RSTOBJ(*PGM) SAVF(CCCINST/MQSAVF)
RSTLICPGM LICPGM(0KMQvvv) DEV(*SAVF) RSTOBJ(*LNG) LNG(2924) SAVF(CCCINST/MQSAVF) LNGLIB(QKMQLNG)
This creates or recreates a library named KMQLIB containing all the file transfer utilities components and definitions required to run the OMEGAMON XE for WebSphere MQ Monitoring agent.
15. If you intend to install other agents, leave the QALWOBJRST value set to “*ALL” until you are finished; otherwise, change it back to the value(s) you recorded earlier.
16. If you will be installing the agent on another AS/400 machine, use ftp or another file transfer program to copy the save file to it.
17. Delete the installation library, which is no longer needed:DLTLIB CCCINST
Installation of the OMEGAMON XE for WebSphere MQ Monitoring agent is complete.
18. Proceed to “Step 2. Configuring the OMEGAMON XE for WebSphere MQ Monitoring Agent” on page 78.
Installing from an AS/400 CD-ROM:
1. Access an OS/400 command line.
2. Check that the system value QALWOBJRST is set to “*ALL.“
3. Enter this command:WRKSYSVAL QALWOBJRST
Installing and Configuring OMEGAMON XE for WebSphere MQ Monitoring 75
Step 1. Installing or Upgrading OMEGAMON XE for WebSphere MQ Monitoring
4. Select “5” (Display), and verify that the value is set to “*ALL”. If it is set to any other values, record those values below:QALWOBJRST___________________________________________________
5. Press “Enter” to continue.
6. If QALWOBJRST was set to other values, do the following:1. On the Work with System Values dialog, enter
2
to change the values.
2. On the Change System Value dialog, change the existing values to *ALL
3. Press “Enter” to save your change.4. Press “F3” to return.
7. Create an AS/400 library for OMEGAMON XE installation:CRTLIB CCCINST TEXT(‘CANDLE INSTALL LIBRARY’)
8. Create a save file in the CCCINST library:CRTSAVF CCCINST/MQSAVF TEXT(‘MQ INSTALL PRODUCT’)
9. Create a work folder.1. Enter this command:
WRKFLR
2. Select “1” (Create Folder), then specify MQFLR
for the folder name.
10. Insert the Candle CD-ROM into the CD-ROM drive and enter:WRKLNK QOPT
The Work with Object Links screen displays the qopt object link.
11. Select “5” (Next Level) at the qopt object link to select the next object link, the volume ID (volid) of the CD-ROM. Record this value for use during installation:
VOL ID _____________________________________________________
12. Continue to select “5” for each link level until the following path is displayed:/QOPT/volid/OS400/CMA
Step 1. Installing or Upgrading OMEGAMON XE for WebSphere MQ Monitoring
76 Installing Candle Products on OS/400 (version CT350)
where volid is the volume ID of the CD-ROM.
13. Look for file MQvvvCMA.SAV.
14. Copy this .SAV file to QDLS:CPY OBJ(‘/QOPT/volid/OS400/CMA/MQvvvCMA.SAV’)TODIR(‘/QDLS/MQFLR’)
where volid is the volume ID of the CD-ROM.
15. From an OS/400 command line, start an ftp session:FTP machinename
where machinename is the name of the target OS/400 machine.
16. Enter your user ID and password.
17. Change the file type to binary:BINARY
18. Enter: NAMEFMT 1
19. On the command line, enter:PUT /QDLS/MQFLR/MQvvvCMA.SAV /QSYS.LIB/CCCINST.LIB/MQSAVF.SAVF
20. End your ftp session:QUIT
21. From an OS/400 command line, install the software for the OMEGAMON XE for WebSphere MQ Monitoring agent (do one of the following):� If you are installing the product on a system that is English upper and
lower case (language ID 2924), do the following:
A. enter the following command:RSTLICPGM LICPGM(0KMQvvv) DEV(*SAVF) SAVF(CCCINST/MQSAVF)
B. Proceed to step 22. below.� If you are installing on a non-language ID 2924 system, do the following:
A. Check for the existence of the KMQLNG work library.a. If the KMQLNG library exists, clear it:
CLRLIB KMQLNG
b. If the KMQLNG library does not exist, create it:
Installing and Configuring OMEGAMON XE for WebSphere MQ Monitoring 77
Step 1. Installing or Upgrading OMEGAMON XE for WebSphere MQ Monitoring
CRTLIB KMQLNG
B. Enter the following commands:RSTLICPGM LICPGM(0KMQvvv) DEV(*SAVF) RSTOBJ(*PGM) SAVF(CCCINST/MQSAVF)
RSTLICPGM LICPGM(0KMQvvv) DEV(*SAVF) RSTOBJ(*LNG) LNG(2924) SAVF(CCCINST/MQSAVF) LNGLIB(QKMQLNG)
This creates or recreates a library named KMQLIB containing all the file transfer utilities components and definitions required to run the OMEGAMON XE for WebSphere MQ Monitoring agent.
22. If you intend to install other agents, leave the QALWOBJRST value set to “*ALL” until you are finished; otherwise, change it back to the value(s) you recorded earlier.
23. Delete the installation objects that are no longer needed1. Enter this command:
DLTLIB CCCINST
2. Delete MQvvvCMA.SAV from your folder:WRKDOC FLR(MQFLR)
3. Select “4” for MQvvvCMA.SAV.4. Press “Enter” to delete5. Press “Enter” again to return to the command line.6. Delete the installation folder:
WRKFLR
7. Select “4” for MQFLR.8. Press “Enter” to delete9. Press “F3” to return to the command line.Installation of the OMEGAMON XE for WebSphere MQ Monitoring agent is complete.
24. Proceed to “Step 2. Configuring the OMEGAMON XE for WebSphere MQ Monitoring Agent” on page 78.
Step 2. Configuring the OMEGAMON XE for WebSphere MQ Monitoring Agent
78 Installing Candle Products on OS/400 (version CT350)
Step 2. Configuring the OMEGAMON XE for WebSphere MQ Monitoring Agent
Purpose of this stepThis step establishes the necessary network connections between the OMEGAMON XE for WebSphere MQ Monitoring agent and the CMS to which it will report. Online Help is available by pressing “F1”.
Procedure
1. From an OS/400 command line enter this commandWRKOMAMQ
The Add OMEGAMON Agent for WebSphere MQ dialog displays.
(If this is not the first access, a different dialog displays; press “F6” to display the Add OMEGAMON Agent for WebSphere MQ dialog.)
2. Enter the name of the Queue Manager that this agent will monitor, along with a text description, and press “Enter”.The Configure OMA (CFGOMAMQ) dialog displays.
3. Enter your site’s values for the displayed parameters using the guidelines below.If your site is using a firewall through which any Candle components will communicate, be sure to read “Configuring OMEGAMON XE Across a Firewall” on page 27 before you begin this step.
Table 5. Parameters for the Configure OMA (CFGOMAMQ) Dialog
Parameter Description
CMS SNA location The SNA location of the CMS that this agent will report to. If you will not use SNA, enter “*NONE”. If the correct SNA location was previously defined, enter “*SAME“ to retrieve it. If you need to define a new SNA location (which can be the Control Point Name or the remote location name) enter its name (for example: S10B6322).
Installing and Configuring OMEGAMON XE for WebSphere MQ Monitoring 79
Step 2. Configuring the OMEGAMON XE for WebSphere MQ Monitoring Agent
CMS TCP/IP address The TCP/IP address or host name of the machine where the CMS that this agent will report to resides. If you will not use TCP/IP, enter “*NONE”. If the correct TCP/IP address or host name was previously defined, enter “*SAME” to retrieve it. If you need to define a different TCP/IP address or host name, enter it (for example: 129.0.132.45 or NEWYORK).
CMS IP.PIPE Address If the OMEGAMON XE for WebSphere MQ Monitoring agent must connect to the CMS through a firewall, you must use IP.PIPE. Specify the IP.PIPE address or host name of the machine where the CMS resides.
If you will not use IP.PIPE, enter “*NONE”.
Secondary CMS SNA location
The SNA location of a secondary CMS that this agent will report to if it cannot communicate with the primary CMS at startup.
Secondary CMS IP address
The TCP/IP address or host name of the machine where a secondary CMS resides. The agent will report to this CMS if it cannot communicate with the primary CMS at startup.
Secondary CMS IP.PIPE Address
The IP.PIPE address or host name of the machine where a secondary CMS resides. The agent will report to this CMS if it cannot communicate with the primary CMS at startup.
Partition Name (Required only by sites with firewalls that use address translation.) The name of the partition that this OMEGAMON XE for WebSphere MQ Monitoring agent resides in (up to 32 alphanumeric characters).
Firewall in use If the OMEGAMON XE for WebSphere MQ Monitoring agent must connect to the CMS through a firewall, enter “*YES”. If not, retain the default of *NO.
CMS TCP/IP port address
The listening port of the CMS that this agent will report to (usually 1918). If your site uses SNA or IP.PIPE, ignore this field. If the correct port address was previously defined, enter “*SAME” to retrieve it. If you need to specify a different CMS port address, enter it (up to six numeric characters).
CMS SNA port address
The listening port of the CMS that this agent will report to (usually 1918). If your site uses TCP/IP or IP.PIPE, ignore this field. If the correct port address was previously defined, enter “*SAME” to retrieve it. If you need to specify a different CMS port address, enter it (up to six numeric characters).
Table 5. Parameters for the Configure OMA (CFGOMAMQ) Dialog (continued)
Step 2. Configuring the OMEGAMON XE for WebSphere MQ Monitoring Agent
80 Installing Candle Products on OS/400 (version CT350)
Note: You can specify values for CMS SNA Location, CMS TCP/IP address, and IP.PIPE address. The system will check them in order. If you specify “*NONE” for all CMS and Secondary CMS parameters, the OMEGAMON XE for WebSphere MQ Monitoring agent looks for your CandleLight workstation at start-up.
4. Read the Options choices and Function Key choices available for each dialog to determine which keys to press to save and exit the dialog.If you are reconfiguring the agent, the changes will take effect the next time the agent is started.
CMS IP.PIPE port address
The listening port of the CMS that this agent will report to (usually 1918). If your site uses TCP/IP or SNA, ignore this field. If you need to specify a different CMS port address, enter it (up to six numeric characters).
Action user profile The user authority under which user action should be administered. Retain the default value of QAUTOMON to grant user system operator authority.
SNA transaction program
This prompt is displayed only if you entered a value (or “*SAME”) for CMS SNA location.
The name of the SNA transaction program. Candle recommends retaining the default value of KDTMSNAP.
Library This prompt is displayed only if you entered a value (or “*SAME”) for SNA location.
The name of the SNA transaction program library. Candle recommends retaining the default value of KMSCMS.
Transaction program (backup)
This prompt is displayed only if you entered a value (or “*SAME”) for Secondary CMS SNA location.
The name of the SNA transaction program. Candle recommends retaining the default value of KDTMSNAP.
Library This prompt is displayed only if you entered a value (or “*SAME”) for Secondary CMS SNA location.
The name of the SNA transaction program library. Candle recommends retaining the default value of KMSCMS.
Table 5. Parameters for the Configure OMA (CFGOMAMQ) Dialog (continued)
Installing and Configuring OMEGAMON XE for WebSphere MQ Monitoring 81
Step 2. Configuring the OMEGAMON XE for WebSphere MQ Monitoring Agent
5. If you are configuring multiple agents for OMEGAMON XE for WebSphere MQ Monitoring, repeat these steps. The first agent Added is automatically assigned suffix 00001, the second agent Added is automatically assigned suffix 00002, and so on.Configuration of the OMEGAMON XE for WebSphere MQ Monitoring agent is complete.
6. Proceed to “Step 3. Verifying the Installation and Configuration” on page 82.
Step 3. Verifying the Installation and Configuration
82 Installing Candle Products on OS/400 (version CT350)
Step 3. Verifying the Installation and Configuration
Purpose of this stepThis step starts (and optionally stops) the OMEGAMON XE for WebSphere MQ Monitoring agent, verifying that it has been installed and configured properly.
Note: If you are using SNA for your agent-to-CMS connection, you may need to complete additional configuration steps. Refer to “Additional Configuration Steps for SNA Environments” on page 89 before you attempt to start the agent.
Procedure
Starting the agent
1. Verify that the CMS that the agent connects to is started.
2. From an OS/400 command line, enter this command:WRKOMAMQ
The Work with Candle Monitoring Agent for WebSphere MQ dialog displays.
3. Enter 14
in the Option column next to the agent that you want to start.
The Status column indicates when the agent is started.
4. Enter 5
in the Option column next to the agent to display its log. Verify that the following message is displayed (Scroll up to the top of the log to see it):
Candle Management Server located
Note: It may be several minutes before the online status is shown in the CandleNet Portal Managed System Status workspace (log on to CandleNet Portal, right-click the Enterprise icon and, from the pop-up menu, select “Workspace > Managed System Status”) or, if you installed a CMW, in the managed system list at your CMW.
Installing and Configuring OMEGAMON XE for WebSphere MQ Monitoring 83
Step 3. Verifying the Installation and Configuration
5. Repeat these steps on each system where you want to start the OMEGAMON XE for WebSphere MQ Monitoring agent.
Stopping the agent (optional)
To stop the OMEGAMON XE for WebSphere MQ Monitoring agent, use the following procedure:
1. From an OS/400 command line, enter this command:WRKOMAMQ
The Work with Candle Monitoring Agent for WebSphere MQ dialog displays.
2. Enter 15
in the Option column next to the agent that you want to stop (end).
The End OMEGAMON Monitoring Agent dialog displays.
3. Recommended default values are supplied in the dialog. Here are options for ending the agent:� “*CNTRLD” for a controlled shutdown. With a controlled shutdown, you
can also specify the following options:
– “Delay time”, in seconds. Shutdown is delayed for the time interval that you specify, allowing the agent to complete operations.
– “Allow abnormal end if needed (YES, NO)”. If you enter “YES”, any jobs that have not ended normally after 10 minutes will shut down abnormally.
Press “Enter” to proceed.
4. The Work with Candle Monitoring Agent for WebSphere MQ dialog displays.The Status column indicates the agent is “Ending...” then, eventually, “Not Started”.
5. Enter 5
in the Option column next to the agent to display its log.
Look for a message that states that job KMQnnnnn completed normally.
Verification of the installation and configuration of the OMEGAMON XE for WebSphere MQ Monitoring agent is complete.
Step 3. Verifying the Installation and Configuration
84 Installing Candle Products on OS/400 (version CT350)
6. Proceed to “Step 4. Customizing Monitoring Options (optional)” on page 85.
Installing and Configuring OMEGAMON XE for WebSphere MQ Monitoring 85
Step 4. Customizing Monitoring Options (optional)
Step 4. Customizing Monitoring Options (optional)
Purpose of this stepThis step enables you to customize monitoring options for a single queue manager. Default monitoring options are set at installation; however, you can change the defaults by using the agent management program to specify options in the KMQLIB/MQnnnnn monitoring file associated with the agent. This file is read when the OMEGAMON XE for WebSphere MQ Monitoring agent is started.
ProcedureTo edit the monitoring file, follow these steps.
1. If you are unfamiliar with the various monitoring options and the commands to enable them, refer to the OMEGAMON XE for WebSphere MQ Monitoring User’s Guide.If you want to collect historical data, you must set the HISTORY option to “YES” on the PERFORM STARTMON statement in the monitoring file. Refer also to the Historical Data Collection Guide for OMEGAMON XE and CandleNet Command Center for additional instructions related to historical data collection.
2. When you are ready to customize the monitoring file, from an OS/400 command line enter the following command:
WRKOMAMQ
Step 4. Customizing Monitoring Options (optional)
86 Installing Candle Products on OS/400 (version CT350)
The main dialog for working with the OMEGAMON XE for WebSphere MQ Monitoring agent displays
On this dialog, multiple agents for OMEGAMON XE for WebSphere MQ Monitoring can be listed. These agents on an OS/400 system are differentiated by a unique 5-character numeric suffix. The first agent Added is automatically assigned suffix 00001, the second agent Added is automatically assigned suffix 00002, and so on.
The files associated with each agent are also automatically suffixed. For example, the monitoring file for each agent is named in the form: MQnnnnn
where nnnnn is the automatically assigned 5-character numeric suffix.
3. Enter 2
in the Option column next to the agent whose monitoring file you want to change.
The dialog for changing the OMEGAMON XE for WebSphere MQ Monitoring agent displays.
4. Press “F8” to change the monitoring file associated with the agent.An editing dialog opens.
5. Insert, delete, or modify monitoring option commands, as your site requires. Adhere to these editing rules:� To continue a command onto the next line, end the current line with a
hyphen (“-”).
Work with Candle Monitoring Agent for WebSphere MQ System MYSYSTEM
Type Option, press Enter
2=Change, 4=Delete, 5=Display OMA Log, 14=Start, 15=End
Option Agent for MQ Manager... Suffix Status
MYSYSTEM 00001 Not Started
Installing and Configuring OMEGAMON XE for WebSphere MQ Monitoring 87
Step 4. Customizing Monitoring Options (optional)
� Parameters you set when grouping objects are effective for all the objects in the group.
� You can override parameters for an object in a group by explicitly defining parameters for that object.
6. When you have finished customizing the monitoring file, press “F3” to save your changes and exit. Press “F3“ twice more to exit the interface.
7. Verify that the queue manager and its command server are running.
8. Restart the agent for your changes to take effect.Customization of the OMEGAMON XE for WebSphere MQ Monitoring agent is complete.
Step 4. Customizing Monitoring Options (optional)
88 Installing Candle Products on OS/400 (version CT350)
Additional Configuration Steps for SNA Environments 89
Additional ConfigurationSteps for SNA Environments
IntroductionThis appendix contains additional agent configuration steps that must be performed by sites that meet all of the following criteria:
� Your site is using the SNA communications protocol.
� The agents you installed on AS/400 are all reporting to the same CMS.
� The CMS that the agents report to resides on a different system.
Two sets of additional configuration steps are given:
� Steps for sites that will run the monitoring agent for OS/400
� Steps for sites that will not run the monitoring agent for OS/400
Complete one set of steps. In either case, be sure that you have already completed the basic installation and configuration steps for the agents as described in the installation chapters.
Appendix contents
If Your Site Also Runs the Monitoring Agent for OS/400 . . . . . . . . . . . . . . . . . . . . 90
If Your Site Does Not Run the Monitoring Agent for OS/400 . . . . . . . . . . . . . . . . . 94
A
If Your Site Also Runs the Monitoring Agent for OS/400
90 Installing Candle Products on OS/400 (version CT350)
If Your Site Also Runs the Monitoring Agent for OS/400
Who must complete this stepYou must complete this step if the following conditions are true:
� Your CMS is running on a platform other than AS/400.
� The monitoring agent for OS/400 is running on this system.
� All agents on this system report to the same CMS.
PrerequisitesBefore you begin, verify the following:
1. The subsystem to which the communications device has been allocated has been verified. One method of verification involves varying the device off and on, then examining the QSYSOPR message queue for the CPF1273 message: “Communications device device_name was allocated to subsystem subsystem_name”. You can also check for this message using the following command:DSPLOG LOG(QHST) MSGID(CPF1273)
2. If the device was not allocated to the production subsystem (QAUTOMON), add a communications entry to the subsystem where the device was allocated (in other words, if the subsystem is QCMN, the command would be:ADDCMNE SBSD(QCMN) DEV(*APPC) JOBD(QAUTOMON/QAUTOMON) DFTUSR(QAUTOMON) MODE(CANCTDCS))
3. Once the entry has been made, the device must be varied off and on to pick up the change.
Note: You may want to look for any subsystem that has a communications entry for “*ALL” devices and “*ANY” mode. This communications entry will cause the subsystem to try to allocate your device if your current subsystem is ended. In this case you will need to add a communications entry to this subsystem description as well.
Additional Configuration Steps for SNA Environments 91
If Your Site Also Runs the Monitoring Agent for OS/400
Configuration steps
1. Make the following file update for the OMEGAMON XE for WebSphere MQ Monitoring agent:1. Edit physical file member KMQTMP/KMSPARM(KBBENV).2. Change the first line of this file from “CMS_TABLEPATH=KMQTMP” to
CMS_TABLEPATH=QAUTOTMP
2. Make the following file update for the OMEGAMON XE for WebSphere MQ Configuration agent:1. Edit physical file member KMCTMP/KMSPARM(KBBENV).2. Change the first line of this file from “CMS_TABLEPATH=KMCTMP” to
CMS_TABLEPATH=QAUTOTMP
Agent startup steps
1. Verify that the monitoring agent for OS/400 has been started first, before the agents for OMEGAMON XE for WebSphere MQ Monitoring and OMEGAMON XE for WebSphere MQ Configuration (or any other agent).
2. Verify that an LU6.2 connection is active between this system and the one where the CMS is located.
3. Start the OMEGAMON XE for WebSphere MQ Monitoring agent as follows from an OS/400 command line (you may want to use these commands to create a CL program for future use):
ADDLIBLE LIB(QCPA)
ADDLIBLE LIB(KMQLIB)
ADDLIBLE LIB(KMQTMP)
ADDLIBLE LIB(QAUTOTMP)
CHGCURLIB CURLIB(KMQTMP)
SBMJOB CMD(CALL PGM(KMQLIB/KMQAGENT) PARM('KMQLIB/SAMPLE(TXT)')) JOBD(KMQLIB/KMQJOBD) JOBQ(QAUTOMON/QAUTOMON) JOB(MQAGENT) USER(KMQ)
4. Start the OMEGAMON XE for WebSphere MQ Configuration agent as follows from an OS/400 command line (you may want to use these commands to create a CL program for future use):
ADDLIBLE LIB(QCPA)
If Your Site Also Runs the Monitoring Agent for OS/400
92 Installing Candle Products on OS/400 (version CT350)
ADDLIBLE LIB(KMCLIB)
ADDLIBLE LIB(KMCTMP)
ADDLIBLE LIB(QAUTOTMP)
CHGCURLIB CURLIB(KMCTMP)
SBMJOB CMD(CALL PGM(KMCLIB/KMC_AGENT)JOBD(KMCLIB/KMCJOBD) JOBQ(QAUTOMON/QAUTOMON) JOB(MCAGENT) USER(KMC)
Agent shutdown steps
Note: If you shut down the monitoring agent for OS/400 it will shutdown all agents currently running. Follow the steps below if you want to shutdown only the agents for OMEGAMON XE for WebSphere MQ Configuration and OMEGAMON XE for WebSphere MQ Monitoring.
Shutting down the OMEGAMON XE for WebSphere MQ Monitoring agent
1. To stop the OMEGAMON XE for WebSphere MQ Monitoring agent, issue the following command:
WRKACTJOB SBS(QAUTOMON)
2. Search for the job MQAGENT with a type of BCH and end this job by pressing “OPTION(*CNTRL-D)”, which will end all of the MQAGENT jobs in the subsystem QAUTOMON.When all MQAGENT jobs (type BCH and BCI) have ended, the agent is stopped.
Shutting down the OMEGAMON XE for WebSphere MQ Configuration agent
1. To stop the OMEGAMON XE for WebSphere MQ Configuration agent, issue the following command:
WRKACTJOB SBS(QAUTOMON)
2. Search for the job MCAGENT with a type of BCH and end this job by pressing “OPTION(*CNTRL-D)”, which will end all of the MCAGENT jobs in the subsystem QAUTOMON.When all MCAGENT jobs (type BCH and BCI) have ended, the agent is down.
Additional Configuration Steps for SNA Environments 93
If Your Site Also Runs the Monitoring Agent for OS/400
Agent cleanup steps
1. Verify that the agents are not running.
2. To perform a cleanup of the OMEGAMON XE for WebSphere MQ Monitoring agent, issue the following command:
DLTDTAQ DTAQ(KMQTMP/QA1*)
3. To perform a cleanup of the OMEGAMON XE for WebSphere MQ Configuration agent, issue the following command:
DLTDTAQ DTAQ(KMCTMP/QA1*)
If Your Site Does Not Run the Monitoring Agent for OS/400
94 Installing Candle Products on OS/400 (version CT350)
If Your Site Does Not Run the Monitoring Agent for OS/400
Who must complete this stepYou must complete this step if the following conditions are true:
� Your CMS is running on a platform other than AS/400.
� The monitoring agent for OS/400 is not running on this system.
� All agents on this system report to the same CMS.
PrerequisiteThe communications device must be allocated to subsystem KMQLIB. One method of verification involves examining the QSYSOPR message queue for the CPF1273 message: “Communications device device_name was allocated to subsystem KMQLIB”. You can also check for this message using the following command:
DSPLOG LOG(QHST) MSGID(CPF1273)
Configuration steps
1. Configure OMEGAMON XE for WebSphere MQ Monitoring as described in “Step 2. Configuring the OMEGAMON XE for WebSphere MQ Monitoring Agent” on page 78.
2. Issue the following commands:CHGPJE SBSD(KMQLIB/KMQLIB) PGM(KMQLIB/KDTMSNAP) USER(KMQ)
CRTLIB KMSCMS
CRTDUPOBJ OBJ(KDTMSNAP) FROMLIB(KMQLIB) OBJTYPE(*PGM)TOLIB(KMSCMS)
3. Configure the OMEGAMON XE for WebSphere MQ Configuration agent as described in “Step 2. Configuring the OMEGAMON XE for WebSphere MQ Configuration Agent” on page 66.
4. Update physical file member KMCTMP/KMSPARM(KBBENV), as follows:Change the first line of this file from “CMS_TABLEPATH=KMCTMP” to
CMS_TABLEPATH=KMQTMP
Additional Configuration Steps for SNA Environments 95
If Your Site Does Not Run the Monitoring Agent for OS/400
Agent startup steps
1. Verify that the LU6.2 connection between this system and the one where the CMS resides is not active.
2. To start the OMEGAMON XE for WebSphere MQ Monitoring agent, issue the following commands from an OS/400 command line:
ADDLIBLE LIB(QCPA)
ADDLIBLE LIB(KMQLIB)
ADDLIBLE LIB(KMQTMP)
CHGCURLIB CURLIB(KMQTMP)
STRSBS SBSD(KMQLIB/KMQLIB)
3. Vary on the device for the system you are planning to connect to and verify that it was allocated to subsystem KMQLIB. 1. One method of verification involves examining the QSYSOPR message
queue for the CPF1273 message: “Communications device device_name was allocated to subsystem KMQLIB”. You can also check for this message using the following command:DSPLOG LOG(QHST) MSGID(CPF1273)
2. Issue the following commands:STRPJ SBS(KMQLIB) PGM(KMQLIB/KDTMSNAH)
STRPJ SBS(KMQLIB) PGM(KMQLIB/KDTMSNAP)
SBMJOB CMD(CALL PGM(KMQLIB/KMQAGENT)PARM('KMQLIB/SAMPLE(TXT)')) JOB(MQAGENT) JOBD(KMQLIB/KMQJOBD) JOBQ(KMQLIB/KMQJOBQ) USER(KMQ)
4. To start the OMEGAMON XE for WebSphere MQ Configuration agent, begin the startup of the agent once the subsystem KMQLIB has been verified and the two pre-start jobs have been started. To start the agent, issue the following from an OS/400 command line (you may want to use these commands to create a CL program for future use):
ADDLIBLE LIB(QCPA)
ADDLIBLE LIB(KMCLIB)
ADDLIBLE LIB(KMCTMP)
CHGCURLIB CURLIB(KMCTMP)
If Your Site Does Not Run the Monitoring Agent for OS/400
96 Installing Candle Products on OS/400 (version CT350)
SBMJOB CMD(CALL PGM(KMCLIB/KMC_AGENT) JOBD(MQAGENT)JOBD(KMQLIB/KMQJOBD) JOBQ(KMQLIB/KMQJOBQ) USER(KMQ)
Agent shutdown steps
Shutting down the OMEGAMON XE for WebSphere MQ Monitoring agent
1. To stop the OMEGAMON XE for WebSphere MQ Monitoring agent, issue the following command:
WRKACTJOB SBS(KMQLIB)
2. Search for the job MQAGENT with a type of BCH and end this job by pressing “OPTION(*CNTRL-D)”, which will end all of the MQAGENT jobs in the subsystem KMQLIB.When all MQAGENT jobs (type BCH and BCI) have ended, the agent is stopped.
Shutting down the OMEGAMON XE for WebSphere MQ Configuration agent
1. To stop the OMEGAMON XE for WebSphere MQ Configuration agent, issue the following command:
WRKACTJOB SBS(KMQLIB)
2. Search for the job MCAGENT with a type of BCH and end this job by pressing “OPTION(*CNTRL-D)”, which will end all of the MCAGENT jobs in the subsystem KMQLIB.When all MCAGENT jobs (type BCH and BCI) have ended, the agent is stopped.
Agent cleanup steps
1. Verify that the agents are not running.
2. To perform a cleanup of the OMEGAMON XE for WebSphere MQ Monitoring agent, issue the following command:
DLTDTAQ DTAQ(KMQTMP/QA1*)
3. To perform a cleanup of the OMEGAMON XE for WebSphere MQ Configuration agent, issue the following command:
DLTDTAQ DTAQ(KMCTMP/QA1*)
Deleting OMEGAMON XE Components 97
Deleting OMEGAMON XEComponents
This appendix explains how to delete agents or a CMS from your system
ProcedureComplete the steps below for each component that you want to delete.
1. Stop both the CMS and the agents that report to it.
2. Press “F3” to exit from the product menu to release the object lock.
3. From an OS/400 command line, enterDSPSFWRSC
4. Scroll down until you see in the Description column the OMEGAMON XE component that you want to delete.
5. Record the licensed program ID for the component, which is on the left under the column for Resource ID.Licensed program ID __________________________________________
6. Press “Enter“ to continue.
7. From an OS/400 command line, enter:DLTLICPGM LICPGM(licpgm)
where licpgm is the licensed program ID that you recorded in step 5.
B
Altering the Size of Historical Data Files 99
Altering the Size ofHistorical Data Files
IntroductionAs supplied on your product tape, the agent components of OMEGAMON XE for OS/400 are configured to report real-time monitoring data. However, your site may have decided to reconfigure the agents to collect historical monitoring data as well.
Historical data is stored in special files called historical data files. The default file size of each of these files 13000 records. Depending upon the amount of data you are collecting, your site may need to increase the file size.
If you find it necessary to alter the size of your historical data files, use the procedure below. If you would like more information about how to configure any agent to collect historical data, refer to the User’s Guide for that agent.
ProcedureTo alter the size of historical data files, do the following:
1. From an AS/400 command prompt, enter this command:CRTPF FILE(QUSRSYS)/filename) RCDLEN(length) SIZE(primary secondary numexts)
where:
– filename is QMQ_LH for Queue Statistics or QMCH_LH for Channel Statistics.
– length is 436 for Queue Statistics, 672 for Channel Statistics, and 2516 for Event History.
– primary is the number of records initially allocated.
– secondary is the number of records allocated per file extension.
C
100 Installing Candle Products on OS/400 (version CT350)
– numexts is the number of extensions.
Example
To alter the size of the Queue Statistics historical file so that it has an initial size of 11000 records, with four extensions of 1000 to a total length of 15000 records, you would enter the following command:
CRTPT FILE(QUSRSYS)/QMQ_LH) RCDLEN(436) SIZE (11000 1000 4)
Glossary 101
A
address A location of data, usually in main memory or on a disk.
Adobe Acrobat Reader An application that allows you to view various types of files.
affinity A symbol for dependence on, or support of, a certain collection of agents that may be installed as a unit on a user’s system.
agent An executable file that gathers and distributes information about system performance. There is always one agent per managed system.
alert A warning message that appears at a console to indicate that an event has occurred that may require intervention.
Alert Adapter An agent that monitors and relays alerts to OMEGAMON XE products.
Alert Emitter A feature of an Alert Adapter that acts as an agent and relays OMEGAMON XE data to other products. The destination can be either Candle or third-party products.
Alert Manager An agent that monitors non-Candle monitoring products for a remote system, subsystem, or
application, and relays alert information to the CMS.
architecture Term used in this guide to refer to the operating system upon which a product is intended to execute.Also used as a variable, arch, in many Candle commands.
argument A value or reference passed to a function, procedure, subroutine, command or program, by the caller. There are many different conventions for passing arguments to functions and procedures including call-by-value, call-by-name, call-by-need. These affect whether the value of the argument is computed by the caller or the callee (the function) and whether the callee can modify the value of the argument as seen by the caller (if it is a variable). Arguments to a program are usually given after the command name.
AS/400 An IBM minicomputer for small business and departmental users, released in 1988 and still in production.
attribute A discrete characteristic or piece of information, or a property of that information, such as type, source, or severity, about a managed system. CandleNet Portal users use attributes to build predicates.
Glossary
B
102 Installing Candle Products on OS/400 (version CT350)
authorization The process of granting or denying access to a network resource. Most computer security systems are based on a two-step process. The first stage is authentication, which ensures that a user is who he or she claims to be. The second stage is authorization, which allows the user access to various resources based on the user's identity.
B
browser A software application used to locate and display Web pages.
C
Candle Management Server (CMS) The host data management component in an OMEGAMON XE environment. It sends out requests to, and receives data from, managed systems having a monitoring agent or Alert Adapter installed. It also sends the information it receives to the CandleNet Portal.
Candle Management Workstation (CMW) A workstation that may be a component of an OMEGAMON XE environment. It provides a programmable workstation-based graphical user interface for OMEGAMON XE, and allows users to define and control all the monitoring and automation that OMEGAMON XE products provide. The CMW uses symbol and color changes to reflect the
status changes of every object you are monitoring.
CandleNet Portal A Java-based programmable graphical user interface that allows the user to view, define and control all the monitoring and automation of the CT environment.
CandleNet Portal Server A collection of software services for the CandleNet Portal that enables retrieval, manipulation, and analysis of data from agents. It connects to both the CandleNet Portal and the CMS.
Candle Technologies (CT) An integrated, layered architecture consisting of data access, communication, and presentation components that enable cross-platform operation and integration of data for systems management applications.
client an application that runs on a personal computer or workstation and relies on a server to perform some operations. For example, an e-mail client is an application that enables you to send and receive e-mail.
client and server An architecture in which the client (personal computer or workstation) is the requesting machine and the server is the supplying machine. Servers can be high-speed microcomputers, minicomputers or even mainframes. The client provides the user interface and may perform some or all of the application processing. A database server maintains the databases and processes requests from the client to
Glossary 103
D
extract data from or update the database. An application server provides additional business processing for the clients. Client and server architecture is the equivalent of a mainframe system on a network of smaller computers.
CMS See Candle Management Server (CMS).
CMW See Candle Management Workstation (CMW).
command A character string which tells a program to perform a specific action. Most commands take arguments which either modify the action performed or supply it with input. Commands may be typed by the user or read from a file by a command interpreter. It is also common to refer to menu items as commands.
CT See Candle Technologies (CT).
D
database server A stand-alone computer in a local area network that holds and manages the database. It implies that database management functions, such as locating the actual record being requested, is performed in the server computer.
development environment An integrated suite of tools to aid the development of software in a particular language or for a particular application. Usually, this consists of a compiler and editor and may also include one or more
of a debugger, profiler, and source code manager.
development tool See development environment.
distributed environment A collection of (probably heterogeneous) automata whose distribution is transparent to the user so that the system appears as one local machine. This is in contrast to a network, where the user is aware that there are several machines, and their location, storage replication, load balancing and functionality is not transparent. Distributed systems usually use some kind of client and server organization.
DNS See Domain Name System (DNS).
domain A specific phase of the software life cycle in which a developer works. Domains define developers' and users' areas of responsibility and the scope of possible relationships between products.
Domain Name System (DNS) An Internet service that translates domain names into IP addresses. Because domain names are alphabetic, they're easier to remember. The Internet however, is really based on IP addresses. Every time you use a domain name, therefore, a DNS service must translate the name into the corresponding IP address. For example, the domain name www.example.com might translate to 198.105.232.4.
E
104 Installing Candle Products on OS/400 (version CT350)
E
environment variable A variable that is bound in the current environment. When evaluating an expression in some environment, the evaluation of a variable consists of looking up its name in the environment and substituting its value.
event A change in the status of a situation being monitored.
executable A binary file containing a program in machine language which is ready to be executed (run).
F
File Transfer Protocol (FTP) A client-server protocol which allows a user on one computer to transfer files to and from another computer over a TCP/IP network. Also the client program the user executes to transfer files.
filter A higher-order function which takes a predicate and a list and returns those elements of the list for which the predicate is true.
firewall Router or access server, or several routers or access servers, designated as a buffer between any connected public networks and a private network. A firewall router uses access lists and other methods to ensure the security of the private network.
framework The component of an agent that provides an interval timer and
manager objects for managing agents and requests.
FTP See File Transfer Protocol (FTP).
function A method of evaluating the information that an attribute supplies. The functions used in CandleNet Portal are
1. Average *AVG2. Count *COUNT3. Make time *TIME4. Maximum *MAX5. Minimum *MIN6. String scan *SCAN7. Substring *STR8. Sum *SUM9. Value
G
Gateway An agent that communicates events to any management application.
H
historical data collection A capability of reports that enables the user to access monitoring data in order to analyze past system performance.
host A computer system that is accessed by a user working at a remote location. Typically, the term is used when there are two computer systems connected by modems and telephone lines. The system that contains the data
Glossary 105
I
is called the host, while the computer at which the user sits is called the remote terminal.
hostname The unique name by which a computer is known on a network, used to identify it in electronic mail, Usenet news, or other forms of electronic information interchange. On the Internet, the hostname is an ASCII string which consists of a local part and a domain name. The hostname is translated into an Internet address either via the /etc/hosts file, NIS or by the DNS or resolver. It is possible for one computer to have several hostnames (aliases) though one is designated as its canonical name.
hub A central host system that collects the status of the situations and policies running on your managed systems.
hub server A centrally configured CMS. The hub server accepts data from other servers (the remote servers) and from agents.
I
individual managed object A managed object that corresponds to a single resource at the user’s site.
installer A utility program to ease the installation of another, probably larger, application. It is also possible for hardware to have an installer accompany it, to install any low level device drivers required.
instance An individual object of a certain class. While a class is just the type definition, an actual usage of a class is called "instance". Each instance of a class can have different values for its instance variables.
Internet Protocol (IP) The network layer for the TCP/IP protocol suite widely used on Ethernet networks, defined in STD 5, RFC 791. IP is a connectionless, best-effort packet switching protocol. It provides packet routing, fragmentation and re-assembly through the data link layer.
IP See Internet Protocol (IP).
K
keyword One of a fixed set of symbols built into the syntax of a language. Typical keywords would be if, then, else, print, goto, while, switch. There are usually restrictions about reusing keywords as names for user-defined objects such as variables or procedures. Languages vary as to what is provided as a keyword and what is a library routine, for example some languages provide keywords for input/output operations whereas in others these are library routines.
L
library A collection of subroutines and functions stored in one or more files,
M
106 Installing Candle Products on OS/400 (version CT350)
usually in compiled form, for linking with other programs. Libraries are one of the earliest forms of organized code reuse. They are often supplied by the operating system or software development environment developer to be used in many different programs. The routines in a library may be general purpose or designed for some specific function such as three dimensional animated graphics. Libraries are linked with the user's program to form a complete executable. The linking may be static linking or, in some systems, dynamic linking.
literal A constant made available to a process, by inclusion in the executable text. Most modern systems do not allow texts to modify themselves during execution, so literals are indeed constant; their value is written at compile-time and is read-only at runtime. In contrast, values placed in variables or files and accessed by the process via a symbolic name, can be changed during execution. This may be an asset. For example, messages can be given in a choice of languages by placing the translation in a file. Literals are used when such modification is not desired. Also see variable.
log CandleNet Portal records changes to situations and EIB objects in a log.
logical unit (LU) A primary component of SNA, an LU is a type of Network Addressable Unit that enables end users to communicate with each other and gain access to SNA network resources.
Logical Unit 6.2 (LU6.2) A type of logical unit that governs peer-to-peer SNA communications. LU6.2 supports general communication between programs in a distributed processing environment. LU6.2 is characterized by a peer relationship between session partners, efficient use of a session for multiple transactions, comprehensive end-to-end error processing and a generic application program interface consisting of structured verbs that are mapped into a product implementation.
LU See logical unit (LU).
LU6.2 See Logical Unit 6.2 (LU6.2).
M
managed object A visual representation, typically an icon, of one or more situations being monitored on one or more managed systems. As the status of a situation changes, the appearance of a managed object icon on your workstation changes.
managed system Any system, such as UNIX, Windows, or OS/390, that a CT is monitoring. When a new instance of a type of managed system comes online for the first time, information about it is placed automatically in the Managed Systems icon in the CandleNet Portal main window. See also type of managed system.
Glossary 107
N
monitoring agent A process that probes a managed system for data and can make a managed system look like a set of objects on a CandleNet Portal.
N
node A single computer within a network of computers.
O
OMEGAMON The name under which Candle delivers CT to its customers. See Candle Technologies (CT).
operand An argument of an operator or of a machine language instruction.
operator A symbol used as a function, with infix syntax if it has two arguments (such as +) or prefix syntax if it has only one (such as Boolean NOT). Many languages use operators for built-in functions such as arithmetic and logic.
P
parameter See argument.
partition In a firewall environment, a term used to designate either the public network (outside the firewall) or the private network (inside the firewall).
permission The ability to access (read, write, execute, traverse, etc.) a file or directory. Depending on the operating
system, each file may have different permissions for different kinds of access and different users or groups of users.
platform The underlying hardware or software for a system. The platform defines a standard around which a system can be developed. Once the platform has been defined, software developers can produce appropriate software and managers can purchase appropriate hardware and applications. The term is often used as a synonym of operating system.
policy A collection of activities that provides the capability of automating responses to events or routine operator tasks.
port number The “channel” that is used for one or more components to communicate with one another via a communications protocol. There are three recognized ranges of port numbers: The Well Known Ports from 0 through 1023, the Registered Ports from 1024 through 49151, and the Dynamic and Private Ports from 49152 through 65535. Candle’s reserved port number is 1918.
predicate The major portion of a situation that functions to compare a system condition (attribute) to a value. Predicates are of the form:
system condition - compared to - value
An example of a predicate isCPU usage - greater than - 90%
Q
108 Installing Candle Products on OS/400 (version CT350)
protocol A communications protocol is a set of rules or standard designed so that computers can exchange information with a minimum of errors.
Q
query A user's (or agent's) request for information, generally as a formal request to a database or search engine.
R
Reduced Instruction Set Computer (RISC) A processor whose design is based on the rapid execution of a sequence of simple instructions rather than on the provision of a large variety of complex instructions
relational operator Predicate operators that compare attributes to a compare value. The six relational operators are
1. Greater than2. Less than3. Equal to4. Not equal to5. Greater than or equal to6. Less than or equal to
remote server Remote CMSs accept data from agents and report that data to a hub CMS. They are optional components of the CT environment that must communicate with a hub CMS first in order to send communication to a
CandleNet Portal. It does so by collecting data from local agents and transmitting it to a hub CMS.
report Displays of data from managed systems. The data may be real-time or historical. Users filter the displays and produce charts.
RISC See Reduced Instruction Set Computer (RISC).
S
situation A logical expression involving one or more system conditions (attributes) that the user wants to monitor that are of the form:
If - system condition - compared to - value - is true
An example of a situation is:IF - CPU usage - GT - 90% - TRUE
IF and TRUE appear in every situation.
SNA See System Network Architecture (SNA).
state An indication associated with an icon, color, and severity level of the status of a managed object at any particular point in time. The five predefined states that each managed object can reflect are:
Unknown
Critical
Warning
Not Monitored
Glossary 109
T
You can customize the default colors and add new states as needed.
status The TRUE or FALSE condition of a situation assigned to a managed object.
System Network Architecture (SNA) An IBM communications network protocol that connects systems and programs under any operating system image and allows them to participate in distributed processing.
system administrator CandleNet Portal users who have full access to data, full authority to product functions, and who can authorize and establish access and privileges for other users. By default, the first user of CandleNet Portal is a system administrator.
T
table A construction that holds the data returned from an agent when the agent returns data to a CMS in response to a request. It has a one-to-one correspondence to the agent it represents.
TCP/IP See Transmission Control Protocol/Internet Protocol (TCP/IP).
template A model the developer uses to create managed objects. Every managed object you create inherits the characteristics and behaviors of its template.
Transmission Control Protocol/Internet Protocol (TCP/IP). An open, highly portable communications protocol. TCP provides transport protocol functions which ensure that the total number of bytes sent is received correctly at the other end. IP provides the routing mechanism.
type of managed system An operating system, subsystem, or application system type that a CT agent is monitoring. Situation attributes are restricted to a specific managed system type.
V
value A predicate function that uses the raw value of an attribute. A value can be a number, text string, attribute, or modified attribute. Use this function with all relational operators.
variable A symbol or name that stands for a value. Variables can represent numeric values, characters, character strings, or memory addresses. Also see literal.
view A way of looking at information about an object. Each view displays information in a different format. CandleNet Portal has the following views:
1. Details2. Events3. Graphic4. Historical
W
110 Installing Candle Products on OS/400 (version CT350)
5. Icons6. Settings
Not all objects have every view.
W
workspace A collection of panels (views) in CandleNet Portal that represent system and application conditions.
Index 111
Index
Aaddress translation 42Adobe portable document format 12agents 25, 27
cleanup 93, 96configuring 94
additional 89deleting old versions 37platforms 27starting 91, 95stopping 92, 96types 27
Alert Adapters 27Alert Emitters 27Alert Managers 27allocating communications devices to
subsystems 90altering
historical data filessize 99
AS/400 CD-ROMinstalling from
OMEGAMON XE for WebSphere MQ Configuration 62
OMEGAMON XE for WebSphere MQ Monitoring 74
OS/400 monitoring agent 49authority level 39
Bbrowser mode 26, 30
CCandle Command Center for MQSeries
Configuration, renamed 21Candle Command Center for MQSeries,
renamed 21Candle Management Server 25, 28
fully qualified hostname 36naming conventions 28platforms 25, 28, 31remote 28version 21
Candle Management Workstation 25Candle Web site 11, 16CandleLight Workstation 55, 68, 80CandleNet Portal 24, 26
compatible Candle products 19, 30components 30platforms 32version 21
CandleNet Portal Browser Client 26, 30CandleNet Portal Desktop Client 26, 30CandleNet Portal Server 24, 30cleanup
agents 93, 96CMS
see Candle Management ServerCMW
see Candle Management Workstationcommunications
devicesallocating to subsystems 90
protocols 32components
CandleNet Portal 30deleting 97locations 31OMEGAMON XE 24order of installation 33transferring 17
configurationwith remote Candle Management
Server 29configuring
agents 94
D
112 Installing Candle Products on OS/400 (version CT350)
additional 89OMEGAMON XE for WebSphere MQ
Configuration 66OMEGAMON XE for WebSphere MQ
Monitoring 78OS/400 monitoring agent 53SNA environments 89
customizingOMEGAMON XE for WebSphere MQ
Monitoring 85
Ddefault objects for WebSphere MQ 38deleting
components 97old versions of agents 37
desktop mode 26, 30DNS 36documents
related 11
Ffirewalls
address translation 42application proxy 42IP.PIPE 42partition-naming strategy 42sample scenarios 43support for 42Warehouse Proxy 42
fully qualified hostname 36functions of OMEGAMON XE 24
GGateways 27
Hhistorical data files
altering size 99Hot Standby 31
IIBM OMEGAMON/400 agent
verifying not installed 40IP.PIPE
firewalls 42
Llanguage, primary 41locations of components 31
Mmonitoring agents 27
Nnaming conventions for Candle
Management Server 28
OOMEGAMON DE
overview 26OMEGAMON XE
components 24order of installation 33
functions 24overview 24
OMEGAMON XE for WebSphere MQ Configuration
configuring 66installing from AS/400 CD-ROM 62installing from PC CD-ROM 60prerequisites 35starting 69stopping 70upgrading 60verifying
installation and configuration 69OMEGAMON XE for WebSphere MQ
Monitoringconfiguring 78customizing 85installing from AS/400 CD-ROM 74
Index 113
P
installing from PC CD-ROM 72prerequisites 35starting 82stopping 83upgrading 72verifying
installation and configuration 82operating systems
agents 27Candle Management Server 25, 28, 31CandleNet Portal 32renamed 21
order of component installations 33OS/400 monitoring agent
configuring 53additional 90
installing from AS/400 CD-ROM 49installing from PC CD-ROM 46prerequisites 34starting 56stopping 56upgrading 46verifying
installation and configuration 56installed version 40
Ppartition-naming strategy 42PC CD-ROM
installing fromOMEGAMON XE for WebSphere MQ
Configuration 60OMEGAMON XE for WebSphere MQ
Monitoring 72OS/400 monitoring agent 46
PDF files, adding annotations 13platforms
agents 27Candle Management Server 25, 28, 31CandleNet Portal 32renamed 21
prerequisites 34OMEGAMON XE for WebSphere MQ
Configuration 35OMEGAMON XE for WebSphere MQ
Monitoring 35OS/400 monitoring agent 34TCP/IP 36
printing problems 12products
on OS/400 9renamed 21
products and versions compatible with this release of CandleNet Portal 19
products compatible with this release of CandleNet Portal 30
protocols 32
Rrelated documents 11related information 11remote Candle Management Server 28
configuration 29renamed products or platforms 21
Sscope of this guide 10SNA environments
configuring 89SNMP Gateways 27starting
agents 91, 95OMEGAMON XE for WebSphere MQ
Configuration 69OMEGAMON XE for WebSphere MQ
Monitoring 82OS/400 monitoring agent 56
stoppingagents 92, 96OMEGAMON XE for WebSphere MQ
Configuration 70OMEGAMON XE for WebSphere MQ
Monitoring 83OS/400 monitoring agent 56
subsystems allocation 90
T
114 Installing Candle Products on OS/400 (version CT350)
TTCP/IP
prerequisites 36verifying
utlities installed 41thin client 26transferring
components 17
Uupgrading
OMEGAMON XE for WebSphere MQ Configuration 60
OMEGAMON XE for WebSphere MQ Monitoring 72
OS/400 monitoring agent 46user authority level
verifying 39
Vverifying
IBM OMEGAMON/400 agent, not installed 40
installation and configuration 56OMEGAMON XE for WebSphere MQ
Configuration 69OMEGAMON XE for WebSphere MQ
Monitoring 82language 41TCP/IP utilities installed 41user authority level 39version of OS/400 monitoring agent 40
versions of products in this release 19
WWarehouse Proxy
firewalls 42Web site, Candle 11, 16WebSphere MQ
default objects 38events 38preparing environment 38