IBM Program Directory for IBM Tivoli OMEGACENTER Gateway on z/os V3.4.1 Program Number 5608-C04 FMIDs AKOG340, AKAT340 for Use with OS/390 z/os Document Date: February 2005 GI11-4041-00
Note! Before using this information and the product it supports, be sure to read the general information under 7.0, Notices on page 11. Copyright International Business Machines Corporation 2004, 2005. All rights reserved. Note to U.S. Government Users Documentation related to restricted rights Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corp.
Contents 1.0 Introduction.................................................. 1 1.1 OMEGACENTER Gateway on z/os Description............................. 1 1.2 OMEGACENTER Gateway on z/os FMIDs................................ 2 2.0 Program Materials.............................................. 3 2.1 Basic Machine-Readable Material..................................... 3 2.2 Program Publications............................................. 3 2.2.1 Basic Program Publications...................................... 3 2.3 Publications Useful During Installation................................... 5 3.0 Program Support.............................................. 6 3.1 Program Services............................................... 6 3.2 Preventive Service Planning......................................... 6 3.3 Statement of Support Procedures..................................... 7 4.0 Program and Service Level Information................................ 8 4.1 Program Level Information.......................................... 8 4.2 Service Level Information.......................................... 8 5.0 Installation Requirements and Considerations............................ 9 5.1 Hardware Requirements........................................... 9 5.2 Software Requirements........................................... 9 6.0 Installation Instructions.......................................... 10 7.0 Notices..................................................... 11 7.1 Trademarks.................................................. 12 Contacting Customer Support......................................... 13 Figures 1. Basic Material: Unlicensed Publications................................. 4 2. Basic Material: Licensed Publications................................... 4 3. Basic Material: Other Unlicensed or Licensed Publications...................... 4 4. Publications Useful During Installation.................................. 5 5. PSP Upgrade and Subset ID........................................ 6 6. Component IDs............................................... 7 Copyright IBM Corp. 2004, 2005 iii
iv OMEGACENTER Gateway on z/os Program Directory
1.0 Introduction This Program Directory is intended for the system programmer responsible for program installation and maintenance. It contains information concerning the material and procedures associated with the installation of IBM Tivoli OMEGACENTER Gateway on z/os. This publication refers to IBM Tivoli OMEGACENTER Gateway on z/os as OMEGACENTER Gateway on z/os. The Program Directory contains the following sections: 2.0, Program Materials on page 3 identifies the basic program materials and documentation for OMEGACENTER Gateway on z/os. 3.0, Program Support on page 6 describes the IBM support available for OMEGACENTER Gateway on z/os. 4.0, Program and Service Level Information on page 8 lists the APARs (program level) and PTFs (service level) incorporated into OMEGACENTER Gateway on z/os. 5.0, Installation Requirements and Considerations on page 9 identifies the resources and considerations required for installing and using OMEGACENTER Gateway on z/os. 6.0, Installation Instructions on page 10 provides detailed installation instructions for OMEGACENTER Gateway on z/os. It also describes the procedures for activating the functions of OMEGACENTER Gateway on z/os, or refers to appropriate publications. 1.1 OMEGACENTER Gateway on z/os Description OMEGACENTER Gateway on z/os is a bridge between OMEGACENTER and the rest of your enterprise. It enables two-way communication between Candle's OMEGACENTER products and other products, including: console automation products NetView ASCII hosts in a distributed systems environment Working together with OMEGAVIEW, AF/OPERATOR lets you see host and network status information on a single panel. OMEGAVIEW is Candle's status display product that uses status lights to show, at a glance, the health of systems being monitored. Also included with your shipment of OMEGACENTER Gateway on z/os is IBM Tivoli Alert Adapter for Omegacenter Gateway which comprises two programs that perform complementary functions: an alert adapter program that monitors MVS consoles for messages indicating critical events and sends alert information to the Candle Management Server (CMS) an alert emitter program that redirects alert information sent by the CMS to an OG/MVS automation script Copyright IBM Corp. 2004, 2005 1
1.2 OMEGACENTER Gateway on z/os FMIDs OMEGACENTER Gateway on z/os consists of the following FMIDs: AKOG340 AKAT340 AKLV180 AKAM150 AKCI200 AKDS350 2 OMEGACENTER Gateway on z/os Program Directory
2.0 Program Materials An IBM program is identified by a program number. The program number for OMEGACENTER Gateway on z/os is 5608-C04. Basic Machine-Readable Materials are materials that are supplied under the base license and feature numbers, and are required for the use of the product. The program announcement material describes the features supported by OMEGACENTER Gateway on z/os. Ask your IBM representative for this information if you have not already received a copy. 2.1 Basic Machine-Readable Material The distribution medium for this program is magnetic tape or downloadable files. It is installed using SMP/E, and is in SMP/E RELFILE format. If you obtained IBM Tivoli OMEGACENTER Gateway on z/os via physical delivery from IBM software manufacturing you should have received the following materials: Tape: OMC/GATEWAY 1/3 Product RLEV 426 Vol 1/2, VOLSER=PV 287 Tape: IBM REXX v13 ALTERNATE LIBRARY 2/3 Product Vol 2, VOLSER=PN 332 Tape: OMC/GATEWAY 3/3 Service MAINT 447 VOL 2/2, VOLSER=PZ 6 6 Tape: AA for OMC Gateway v15 1/2 Product Tape RLEV 426 Vol 1/1, VOLSER=PV 292 Tape: AA for OMC/GATEWAY v15 2/2 Service Tape MAINT 447 VOL 1/1, VOLSER=PZ 6 9 GI11-4 41 IBM Tivoli OMEGACENTER Gateway on z/os Program Directory LCD7-617 Candle Products CD-ROM - Windows, OS/4, Tandem GC32-9218 Installing Candle Products on Windows SCD7-63 Candle Technical Documentation CD-ROM GC32-9214 Installation & Configuration of Candle Products on OS/39 and z/os GC32-9384 IPLA License Info If entitlement has already been established you can also download IBM Tivoli OMEGACENTER Gateway on z/os electronically from https://www14.software.ibm.com/webapp/iwm/web/prelogin.do?source=omegamon. 2.2 Program Publications The following sections identify the basic publications for OMEGACENTER Gateway on z/os. 2.2.1 Basic Program Publications Figure 1 identifies the basic unlicensed program publications for OMEGACENTER Gateway on z/os. One copy of each of these publications is included when you order the basic materials for OMEGACENTER Gateway on z/os. For additional copies, contact your IBM representative. Copyright IBM Corp. 2004, 2005 3
Figure 1. Basic Material: Unlicensed Publications Publication Title Installation & Configuration of Candle Products on OS/390 and z/os Installing Candle Products on Windows Form Number GC32-9214 GC32-9218 Figure 2 identifies the basic licensed program publications for OMEGACENTER Gateway on z/os. Figure 2. Basic Material: Licensed Publications Publication Title Form Number How Available Candle Products CD-ROM - Windows, OS/400, Tandem LCD7-0617 in IBM package Candle Technical Documentation CD-ROM SCD7-0630 in IBM package Figure 3 identifies the basic unlicensed or licensed publications that are not available in hardcopy form, but are available through the internet or other media for OMEGACENTER Gateway on z/os. Figure 3 (Page 1 of 2). Basic Material: Other Unlicensed or Licensed Publications Publication Title Form Number How Available IBM Tivoli OMEGACENTER Gateway on z/os User's Guide GC32-9231 see note below IBM Tivoli OMEGACENTER Gateway on z/os Configuration and Customization Guide IBM Tivoli OMEGACENTER Gateway on z/os Command Reference Manual IBM Tivoli OMEGACENTER Gateway on z/os Connecting OMEGACENTER Gateway for MVS and AF/REMOTE Using TCP/IP IBM Tivoli OMEGACENTER Gateway on z/os OMEGAMON II FOR SMS Data Interface IBM Tivoli OMEGACENTER Gateway on z/os Using the Subsystem Logging Facility IBM Tivoli OMEGACENTER Status Manager for MVS User's Guide GC32-9228 GC32-9229 GC32-9227 GC32-9230 GC32-9232 GC32-9233 see note below see note below see note below see note below see note below see note below 4 OMEGACENTER Gateway on z/os Program Directory
Figure 3 (Page 2 of 2). Basic Material: Other Unlicensed or Licensed Publications Publication Title IBM Tivoli Alert Adapter for Omegacenter Gateway Configuration and Customization Guide Form Number GC32-9148 How Available see note below Note: http://publib.boulder.ibm.com/tividd/td/ibmtivoliomegacentergatewayformvs3.4.html http://publib.boulder.ibm.com/tividd/td/ibmtivoliomegacenterstatusmanagerformvs3.4.html http://publib.boulder.ibm.com/tividd/td/ibmtivolialertadapterforomegacentergatewayformvs1.5.html The OMEGACENTER Gateway on z/os product manuals and all other Tivoli product manuals can be found at the Tivoli Information Center url listed below: http://publib.boulder.ibm.com/tividd/td/tdprodlist.html The OMEGACENTER Gateway on z/os Program Directory, along with other Tivoli Program Directories can be found by following links to the product from the support web site listed below: http://www-3.ibm.com/software/sysmgmt/products/support/ 2.3 Publications Useful During Installation The publications listed in Figure 4 may be useful during the installation of OMEGACENTER Gateway on z/os. To order copies, contact your IBM representative or visit the IBM Publications Center on the World Wide Web at: http://www.ibm.com/shop/publications/order Figure 4. Publications Useful During Installation Publication Title IBM SMP/E for z/os and OS/390 User's Guide IBM SMP/E for z/os and OS/390 Commands IBM SMP/E for z/os and OS/390 Reference IBM SMP/E for z/os and OS/390 Messages, Codes, and Diagnosis Installation & Configuration of Candle Products on OS/390 and z/os Form Number SA22-7773 SA22-7771 SA22-7772 GA22-7770 GC32-9214 Program Materials 5
3.0 Program Support This section describes the IBM support available for OMEGACENTER Gateway on z/os. 3.1 Program Services Contact your IBM and/or Tivoli representative for specific information about available program services. You can find information in the "IBM Software Support Guide" at the following Web site: http://www-3.ibm.com/software/sysmgmt/products/support/. The handbook provides information about how to contact Customer Support, depending on the severity of your problem, and the following information: Registration and eligibility Telephone numbers and e-mail addresses, depending on the country in which you are located What information you should gather before contact support 3.2 Preventive Service Planning Before installing OMEGACENTER Gateway on z/os, you should review the current Preventive Service Planning (PSP) information. It can be accessed by using S/390 SoftwareXcel or from the web at https://techsupport.services.ibm.com/server/390.psp390 For program support, access the Software Support web site at http://www-3.ibm.com/software/support/ PSP Buckets are identified by UPGRADEs, which specify product levels, and SUBSETs, which specify the FMIDs for a product level. The UPGRADE and SUBSET values for OMEGACENTER Gateway on z/os are: Figure 5. PSP Upgrade and Subset ID UPGRADE SUBSET Description OMGWOG340 AKOG340 OMEGACENTER Gateway MVS OMGWOG340 AKAT340 OMEGACENTER Status Manager OMGWOG340 AKLV180 CT/ENGINE OMGWAM150 AKAM150 Alert OMEGACENTER GW MVS OMGWAM150 AKCI200 CICAT CONFIG SERVICES OMGWAM150 AKDS350 MVS CMS 6 Copyright IBM Corp. 2004, 2005
3.3 Statement of Support Procedures Report any difficulties you have using this program to your IBM Support Center. If an APAR is required, the Support Center will provide the address to which any needed documentation can be sent. Figure 6 on page 7 identifies the component IDs (COMPID) for OMEGACENTER Gateway on z/os. Figure 6. Component IDs FMID COMPID Component Name AKOG340 5608A3400 OMEGACENTER GW MVS 340 AKAT340 5608A3401 OMEGACENTER STATUS M 340 AKLV180 5608A41CE CT ENGINE 180 AKAM150 5608A5500 ALERT ADAPTER OMCGW 150 AKCI200 5608A41CC CICAT CONFIG SERVICE 200 AKDS350 5608A2800 MVS CMS 350 RETAIN Release Program Support 7
4.0 Program and Service Level Information This section identifies the program and any relevant service levels of OMEGACENTER Gateway on z/os. The program level refers to the APAR fixes incorporated into the program. The service level refers to the PTFs incorporated into the program. 4.1 Program Level Information The following levelset APAR fixes are available in the IBM maintenance stream for OMEGACENTER Gateway on z/os to incorporate all prior Candle Corporation maintenance and allow you to apply any subsequent maintenance that may be needed through the normal IBM maintenance procedures. PTFs are available from IBMLINK, from the product's online support page http://www-306.ibm.com/software/sysmgmt/products/support/ibmtivoliomegacentergatewayformvs.html, or from the Shop zseries url https://www14.software.ibm.com/webapp/shopzseries/shopzseries.jsp. ESO tapes are also available for OMEGACENTER Gateway on z/os. The level set APARs are listed by FMID. FMID APAR PTF COMP ID DESCRIPTION ------- ------- ------- --------- --------------------------- AKOG34 OA 9485 UA14565 56 8A34 OMEGACENTER Gateway for MVS AKOG34 OA 9676 UA14885 56 8A34 OMEGACENTER Gateway for MVS AKOG34 OA 9724 UA1495 56 8A34 OMEGACENTER Gateway for MVS AKAT34 OA 9387 UA14478 56 8A34 1 OMEGACENTER Status Manager for MVS AKLV18 OA 9477 UA14554 56 8A41CE CT/ENGINE AKLV18 OA 9583 UA147 3 56 8A41CE CT/ENGINE AKAM15 OA 9 9 UA1449 56 8A55 Alert Adapter for OMC Gateway MVS AKCI2 OA 94 5 UA14487 56 8A41CC CICAT Configurator AKCI2 OA 9526 UA14593 56 8A41CC CICAT Configurator AKCI2 OA 9527 UA14594 56 8A41CC CICAT Configurator AKCI2 OA 9528 UA14595 56 8A41CC CICAT Configurator AKCI2 OA 9529 UA14596 56 8A41CC CICAT Configurator AKCI2 OA 953 UA14597 56 8A41CC CICAT Configurator AKCI2 OA 9531 UA14598 56 8A41CC CICAT Configurator AKDS35 OA 9463 UA1457 56 8A28 Candle Management Server for MVS 4.2 Service Level Information No PTFs against this release of OMEGACENTER Gateway on z/os have been incorporated into the product tape. 8 Copyright IBM Corp. 2004, 2005
5.0 Installation Requirements and Considerations The following sections identify the system requirements for installing and activating OMEGACENTER Gateway on z/os. 5.1 Hardware Requirements Any zseries hardware that can support the software requirements listed below. 5.2 Software Requirements z/os 1.4 or higher (5694-A01) OMEGACENTER Gateway on z/os installs in the z/os (Z038) SREL. Copyright IBM Corp. 2004, 2005 9
6.0 Installation Instructions Installation instructions for OMEGACENTER Gateway on z/os are contained in a publication titled Installation & Configuration of Candle Products on OS/390 and z/os (GC32-9214). It is distributed in hardcopy form with your product and can also be found online at: http://publib.boulder.ibm.com/tividd/td/ibmtivolicandleinstallationdocumentation3.5_lnk.html. 10 Copyright IBM Corp. 2004, 2005
7.0 Notices References in this document to IBM products, programs, or services do not imply that IBM intends to make these available in all countries in which IBM operates. Any reference to an IBM product, program, or service is not intended to state or imply that only IBM's product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe on any of IBM's intellectual property rights may be used instead of the IBM product, program, or service. Evaluation and verification of operation in conjunction with other products, except those expressly designated by IBM, is the user's responsibility. APAR numbers are provided in this document to assist in locating PTFs that may be required. Ongoing problem reporting may result in additional APARs being created. Therefore, the APAR lists in this document may not be complete. To obtain current service recommendations and to identify current product service requirements, always contact the IBM Customer Support Center or use S/390 SoftwareXcel to obtain the current "PSP Bucket". IBM may have patents or pending patent applications covering subject matter in this document. The furnishing of this document does not give you any license to these patents. You can send license inquiries, in writing, to the IBM Director of Licensing IBM Corporation North Castle Drive Armonk, New York 10504-1785 USA For online versions of this book, we authorize you to: Copy, modify, and print the documentation contained on the media, for use within your enterprise, provided you reproduce the copyright notice, all warning statements, and other required statements on each copy or partial copy. Transfer the original unaltered copy of the documentation when you transfer the related IBM product (which may be either machines you own, or programs, if the program's license terms permit a transfer). You must, at the same time, destroy all other copies of the documentation. You are responsible for payment of any taxes, including personal property taxes, resulting from this authorization. THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow the exclusion of implied warranties, so the above exclusion may not apply to you. Copyright IBM Corp. 2004, 2005 11
Your failure to comply with the terms above terminates this authorization. Upon termination, you must destroy your machine readable documentation. 7.1 Trademarks The following terms are trademarks of the IBM Corporation in the United States or other countries or both: CBPDO IBM Tivoli OMEGAMON NetView Candle CICS z/os CICAT OMEGACENTER Gateway OMEGACENTER Status Manager 12 OMEGACENTER Gateway on z/os Program Directory
Contacting Customer Support For support for this or any Tivoli product, you can contact Tivoli Customer Support in one of the following ways: Submit a problem management record (PMR) electronically at IBMSERV/IBMLINK. Submit a problem management record (PMR) electronically from our Web site at http://www-3.ibm.com/software/sysmgmt/products/support/ You can also review the IBM Software Support Guide, which is available on the Web site listed above. An End of Support Matrix is provided as well which will tell you when products you are using are nearing the end of support date for a particular version or release. When you contact Tivoli Customer Support, be prepared to provide identification information for your company so that support personnel can readily assist you. Company identification information may also be needed to access various online services available on the Web site. The support Web site offers extensive information, including a guide to support services (the IBM Software Support Guide); frequently asked questions (FAQs); and documentation for all Tivoli products, including Release Notes, Redbooks, and Whitepapers. The documentation for some product releases is available in both PDF and HTML formats. Translated documents are also available for some product releases. 13
IBM Printed in U.S.A. GI11-4 41-