------------------------------------------------------------------------- IBM(R) Tivoli(R) OMEGAMON(R) XE for IMS on z/OS Application Support Files Version 5 Release 1 Fix Pack 05 Fix pack: 5.1.0-TIV-KIP-FP0005 Licensed material - Property of IBM © Copyright IBM Corporation 2005, 2016. ------------------------------------------------------------------------- CONTENTS 1 About this fix pack 2 Installation, migration, upgrade, and configuration information 3 Service history 4 Support information 5 Notices and trademarks ========================================================================= 1.0 ABOUT THIS FIX PACK ========================================================================= Set the font to monospace to better view this file. This is the README document for the OMEGAMON XE for IMS on z/OS Application Support Files for z/OS maintenance update Fix Pack 5. The following product application support files are included in fix pack: IBM Tivoli OMEGAMON XE for IMS on z/OS V5.1.0 It includes the fixes for these APARs: OA49177 Re-signed Java resources JAR files OA46121 Provide product positioning for future IBM enhancements. OA43987 TEP Client support for Oracle Java 7 u51 OA41599 Re-signed Java resources JAR files It includes the fixes for these defects: - Update to TEP LTERM Status workspace column headings. Messages Processed is now Messages Dequeued. Messages Currently Queued to Messages Enqueued. This fix pack includes all maintenance since GA of IBM Tivoli OMEGAMON XE for IMS on z/OS V5.1.0. This release can be applied directly to the base V5.1.0 product release or any previous fix pack or interim fix level. ----------------------- 1.1 Cross-Product compatibility ----------------------- - If you are installing any of the application support files from this image into an environment running IBM Tivoli Monitoring (ITM) Version 6.3.0, then ITM V6.3.0 Fix Pack 6 (6.3.0-TIV-ITM-FP0006) or higher is required. - IBM Tivoli Monitoring version 6.2.3 can be obtained by ordering either 5724-C04 IBM Tivoli Monitoring through Passport Advantage or 5698-A79 IBM Tivoli Monitoring Services on z/OS through ShopzSeries. - You must upgrade your TEPS and Hub TEMS on a distributed platform to the required level of ITM maintenance prior to installing the OMEGAMON application support files with this image. ========================================================================= 2.0 INSTALLATION, MIGRATION, UPGRADE, AND CONFIGURATION INFORMATION ========================================================================= ----------------------- 2.1 Hardware and Software Requirements ----------------------- This maintenance update requires: - IBM Tivoli Monitoring (ITM) V6.3.0 Fix Pack 6 or higher. - Installation of IBM Tivoli OMEGAMON Application Support Files for z/OS V5.1.0 Publication number LCD7-5139. - Installation of IBM Tivoli OMEGAMON XE for IMS on z/OS V5.1.0 requires APAR OA49177 - This maintenance update includes a renewed Java certificate (Valid from: 08/02/15 07:00 PM until: 11/01/18 06:59 PM). If you have previously installed a language pack image, you must install the corresponding language pack image with the matching certificate. If you have not done so already, you are recommended to install Tivoli Enterprise Portal Server at IBM Tivoli Monitoring V6.3.0 Fixpack 6 or higher, which includes the matching Java certificate for this component. - This maintenance update includes renewed support for Oracle Java 7 u51. If you have previously installed a language pack image, you must install the corresponding language pack deliverable. Refer to the "Recommended Maintenance" technote #1660437 to locate the full list of IBM Tivoli OMEGAMON product maintenance deliverables which contain the renewed Java support for Oracle Java 7: http://www-01.ibm.com/support/docview.wss?uid=swg21660437 - Refer to technote #1269613 to locate the current language pack image: http://www-1.ibm.com/support/docview.wss?uid=swg21269613 ----------------------- 2.2 Installation steps: ----------------------- - Before proceeding with the installation process, please make note of these important points: - If using the ITMSuper tool, it is suggested that you run the tool before installing the fix pack to create a baseline snapshot of your Tivoli Monitoring environment which can be used to compare against a second ITMSuper snapshot collected after applying this fix pack. The baseline snapshot can be done by selecting the Topology, Connectivity, and TEMS Servers tabs and saving the session. Information about the ITMSuper tool can be found at the following URL: http://www-01.ibm.com/software/brandcatalog/ismlibrary/details?catalog.label=1TW10TM6L - It is recommended you make a record of the version, release, maintenance and fixpack level of the existing install by running the KinCInfo command on Windows systems or the cinfo command on UNIX or Linux systems. After the installation of the maintenance completes, this will help in validating the installation. On Windows systems: - \installITM\KinCInfo -t cp On UNIX or Linux systems: - /bin/cinfo -t cp - Following these steps to install: a. Copy the maintenance update zip or tar file to the Tivoli Enterprise Monitoring Server(s) and Tivoli Enterprise Portal Server system(s). b. Extract the maintenance update zip or tar file, using a command such as: On Windows systems: - unzip -v 5.1.0-TIV-KIP-FP0005.zip On UNIX or Linux systems: - if the version of tar used supports z, then tar -zxvf 5.1.0-TIV-KIP-FP0005.tar.gz - if the version of tar used does not support z, then gunzip 5.1.0-TIV-ITM_KIP-FP0005.tar.gz tar -xvf 5.1.0-TIV-KIP-FP0005.tar c. As a best practice, it is recommended that Tivoli Enterprise Portal Server and Tivoli Enterprise Monitoring Server running on the distributed platform where this fix pack is to be installed be stopped manually prior to performing this fix pack installation. While the Distributed installer will attempt to stop all running processes, there are times when a running process will fail to stop and lead to unexpected upgrade failures if the upgrade is allowed to continue. If any process fails to stop during a manual shutdown, restart the system before proceeding with the upgrade. d. Start the distributed installer by using the following command from within the install directory: On Windows systems: - WINDOWS\setup.exe On UNIX or Linux systems: - install.sh e. Follow the on-screen installation instructions. Please make note of the following points during the post-installation configuration steps if you are adding application support to the TEMS. - If you are adding the application support files for products and this is the first time you have attempted installation of the application support files for this product, select the "New" option which will add the default managed system groups to all applicable situations from the product support packages being seeded for the first time. Modifications are not made to managed system groups in previously upgraded product support packages. "New" is the default. - If you are updating the application support files for products which were previously installed (upgrade), select the "All" option which will add the default managed system groups to all applicable situations. "None" is the default. f Post-installation, you can validate your installation by running the KinCInfo command on Windows systems or the cinfo command on UNIX or Linux systems and comparing the version information to that which recorded prior to the installation. Sample output for the KinCInfo command on Windows systems to list product components installed in the manager server and/or portal server: \installITM\KinCInfo -t ip PC APPLICATION SUPPORT DESC PLAT APP VER IP OMEGAMON XE for IMS on z/OS WICMS 05.10.05.00 IP OMEGAMON XE for IMS on z/OS WICNS 05.10.05.00 IP OMEGAMON XE for IMS on z/OS WIXEB 05.10.05.00 IP OMEGAMON XE for IMS on z/OS WIXEW 05.10.05.00 Sample output for the cinfo command on Linux or UNIX systems to list product components installed in the manager server and/or portal server: /bin/cinfo -t ip PC PRODUCT DESC PLAT APP VER ip OMEGAMON XE for IMS on z/OS tms 05.10.05.00 ip OMEGAMON XE for IMS on z/OS tmd 05.10.05.00 ip OMEGAMON XE for IMS on z/OS tps 05.10.05.00 ip OMEGAMON XE for IMS on z/OS tpw 05.10.05.00 Where Version Format is: VV.RM.FF.II (V: Version; R: Release; M: Modification; F: Fix; I: Interim Fix) ----------------------- 2.3 Known limitations, problems, and workarounds ----------------------- - The following message will appear during the installation of the application support from this image into a TEMS running on a Linux or UNIX platform: KCIIN2463W Warning: This installation media does not contain any components which can be run on the current system platform architecture. To install components which can run on this system, please locate the installation media containing files similar to .jar. If you are installing application support, continue with the installation to see a list of support files. This message can be ignored, as this image only contains application support files. Press enter to continue with the installation. - If you are using this DVD to update the application support files for products which were previously installed, you may receive the following warning message: WARNING - you are about to install the SAME version of OMEGAMON XE for IMS on z/OS V5.1.0 05.10.05 Do you want to install the SAME version [ y or n; "n" is default ]? If you have previously installed one of the releases listed in section 3.0 SERVICE HISTORY, you should reply "y" to this message; otherwise, this message is an indication that you have already applied a release which is at a later level of maintenance than is included on this DVD. - You may see the following warning message when you are installing the application support on a Linux or UNIX system: "KCIIN1421W WARNING - unable to copy eclipse agent plugin file /products/itm/ls3263/cw/iehs/kip/eclipse/plugins/com.ibm.kip.doc" If you see this message, no action is required. Press Enter to continue. - During the install of IBM Tivoli OMEGAMON Application Support Files for z/OS V5.1.0 into an environment running IBM Tivoli Monitoring V6.2.3 on Windows, if the following installation error message is received: "Unable to copy a file to the drive where Program Files exists, cannot continue." Refer to the technote #1403443 for workaround details. http://www-01.ibm.com/support/docview.wss?uid=swg21403443. - If you are running your TEPS on Linux on System z and you use the manual method to add application support to a non-local TEMS running on z/OS, prior to installing the OMEGAMON XE application support files from this DVD, you should delete the OMEGAMON XE agent catalog (KIPCAT) and attribute files (KIPATR) from the &rhilev.&rte.RKANDATV file allocated to your non-local TEMS on z/OS. If you do not delete these files, you may encounter the following problem: Problem Description: When a TEPS is running on Linux on System z, if an attempt to FTP the catalog (kip.cat) and attribute (kip.atr) files from Manage Tivoli Enterprise Monitoring Services (MTEMS) fails, review the itm_config.trc log for the following error messages: ITMinstall.ftptems.SupportFileList transferFiles __ERROR__ (traceKey:1329933202902) sun.net.ftp.FtpProtocolException: PORT :503 EPSV ALL received - PORT not allowed after EPSV ALL If you encounter this problem, the following workaround is recommended: Execute the following command in logs directory: grep "PORT not allowed after EPSV ALL" itm_config*.trc If it returns the following text: sun.net.ftp.FtpProtocolException: PORT :503 EPSV ALL received - PORT not allowed after EPSV ALL then delete the selected catalog and attribute files from the non-local TEMS running on z/OS and retry the file transfer, using Manage Tivoli Enterprise Monitoring Services (MTEMS) or use another FTP client to replace existing catalog and attribute files on z/OS. - If you are using the TEP Webstart client you may see a pop-up dialog box during start-up indicating that the application's digital signature has expired. If you click the "More Information..." link on the pop-up dialog box, the following message will be shown: "Although the application has a digital signature, the application's associated file (JNLP) does not have one. A digital signature ensures that a file is from a vendor and that it has not been altered." This message can be safely ignored as the associated file (JNLP) is intentionally unsigned. Click "Close" to close the "More Information" dialog box and then click "Run" to continue with the TEP Webstart client start-up. ========================================================================= 3.0 SERVICE HISTORY ========================================================================= This refreshed image supersedes prior maintenance updates: - IBM Tivoli OMEGAMON XE for IMS on z/OS V5.1.0 fix packs: 5.1.0-TIV-KI5-FP0001 5.1.0-TIV-KI5-FP0002 5.1.0-TIV-KI5-FP0003 5.1.0-TIV-KI5-FP0004 ----------------------- 3.1 Product fix history ----------------------- The following APARs are addressed in this maintenance update: OA49177 Re-signed Java resources JAR files. Problem Summary: Java Certificate will expire April 2016. Update product to tolerate future IBM product announcements. Additional data attributes are introduced. A new level of Self-Describing agent is provided. Conclusion: The Java Certificate has been updated to be valid from 08/01/2015 to 11/01/2015. Self-Describing agent data updates are available to match Fix pack 5.1.0-TIV-KIP-FP0005. OA46121 Introduce product positioning modifications. Problem Summary: Update product to tolerate future IBM product announcements. Update to LTERM Status workspace column headings. Conclusion: Prepare product to tolerate future IBM product announcements. Messages Processed is now Messages Dequeued. Messages Currently Queued to Messages Enqueued. OA43987 TEP Client support for Oracle Java 7 u51 Problem Summary: Oracle Java 7 u51 provides additional security updates that require that all JAR files used in applet or Java Web Start deployments have the permissions attribute set in the JAR manifest file. This requirement will affect the TEP client, both browser and Java Web Start modes. Without compliance with this requirement, the TEP client may not start after downloading. A new level of Self-Describing agent is provided. See the following Technote/FLASH for detailed symptoms of the problem: http://www-01.ibm.com/support/docview.wss?uid=swg21659560 Conclusion: The supplied application support for OMEGAMON XE for IMS has been rebuilt to comply with the new security requirements of Oracle Java 7 u51. OA41599 Re-signed Java resources JAR files. Problem Summary: Java Certificate will expire June 2013. Update product to tolerate future IBM product announcements. Additional data attributes are introduced. A new level of Self-Describing agent is provided. Conclusion: The Java Certificate has been updated to be valid until April 2016. ========================================================================= 4.0 SUPPORT INFORMATION ========================================================================= If you have a problem with your IBM software, you want to resolve it quickly. This section describes options for obtaining support for IBM software products. ----------------------- 4.1 Using IBM Support Assistant ----------------------- The IBM Support Assistant is a free, stand-alone application that you can install on any workstation. You can then enhance the application by installing product-specific plug-in modules for the IBM products you use. The IBM Support Assistant saves you time searching product, support, and educational resources. The IBM Support Assistant helps you gather support information when you need to open a problem management record (PMR), which you can then use to track the problem. The product-specific plug-in modules provide you with the following resources: - Support links - Education links - Ability to submit problem management reports For more information, see the IBM Support Assistant Web site at: http://www.ibm.com/software/support/isa If your product does not use IBM Support Assistant, use the links to support topics in your information center. In the navigation frame, check the links for resources listed in the ibm.com and related resource section where you can search the following resources: - Support and assistance (includes search capability of IBM technotes and IBM downloads for interim fixes and workarounds) - Training and certification - IBM developerWorks - IBM Redbooks - General product information If you cannot find the solution to your problem in the information center, search the following internet resources for the latest information that might help you resolve your problem: - Forums and newsgroups - Search engines ----------------------- 4.2 Obtaining Fixes ----------------------- A product fix might be available to resolve your problem. To determine what fixes are available for your IBM software product, follow these steps: - Go to the IBM Software Support Web site at http://www.ibm.com/software/support - Under Find product support, click "All IBM Software (A-Z)". This opens the software product list. - In the software product list, select the "Tivoli OMEGAMON XE" product which you are interested in, for example, "Tivoli OMEGAMON XE for IMS on z/OS" listed under "T". This opens the IBM Tivoli OMEGAMON XE for IMS on z/OS support site. - You can also search for keywords or a specific APAR; for tips on refining your search, click "Search tips". Click the APAR abstract to read the description and optionally download the fix. - In the "Find downloads and drivers by product" section, select one software category from the "Category" list. - Select one product from the "Sub-category" list. - Type more search terms in the "Search within results" if you want to refine your search. - Click "Search". - From the list of downloads returned by your search, click the name of a fix to read the description of the fix and to optionally download the fix. For more information about the types of fixes that are available, see the IBM Software Support Handbook at http://techsupport.services.ibm.com/guides/handbook.html ----------------------- 4.3 Receiving weekly support updates ----------------------- To receive weekly e-mail notifications about fixes and other software support news, follow these steps: - Go to the IBM Software Support Web site at http://www.ibm.com/software/support. - Click "My notifications", under "Stay informed", on the side of the page. - If you have already registered for "My notifications", sign in and skip to the next step. If you have not registered, click "register now". Complete the registration form using your e-mail address as your IBM ID and click "Submit". - Click "Edit profile". - In the "Products" list, select "Software". A second list is displayed. - In the second list, select a product segment, for example, "Systems Management". A third list is displayed. - In the third list, select a product sub-segment, for example, "System Performance". A list of applicable products is displayed. - Select the products for which you want to receive updates, for example, IBM Tivoli OMEGAMON XE for IMS on z/OS. - Click Add products. - After selecting all products that are of interest to you, click Subscribe to email on the Edit profile tab. - Select Please send these documents by weekly email. - Update your e-mail address as needed. - In the Documents list, select Software. - Select the types of documents that you want to receive information about. - Click Update. If you experience problems with the My support feature, you can obtain help in one of the following ways: Online: Send an e-mail message to erchelp@ca.ibm.com, describing your problem. By phone: Call 1-800-IBM-4You (1-800-426-4968). ----------------------- 4.4 Contacting IBM Software Support ----------------------- For support for this or any IBM product, you can contact IBM Software 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 the support Web site at: http://www.ibm.com/software/sysmgmt/products/support/ You can also review the IBM Software Support Handbook, which is available on the Web site listed above. An End of Support Matrix is provided that tells you when products you are using are nearing the end of support date for a particular version or release. When you contact IBM Software Support, be prepared to provide identification information for your company so that support personnel can readily assist you. Company identification information might 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 Handbook); frequently asked questions (FAQs); and documentation for all 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. To contact IBM Software support, follow these steps: - Determining the business impact When you report a problem to IBM, you are asked to supply a severity level. Therefore, you need to understand and assess the business impact of the problem that you are reporting. Use the following criteria: Severity 1 The problem has a critical business impact. You are unable to use the program, resulting in a critical impact on operations. This condition requires an immediate solution. Severity 2 The problem has a significant business impact. The program is usable, but it is severely limited. Severity 3 The problem has some business impact. The program is usable, but less significant features (not critical to operations) are unavailable. Severity 4 The problem has minimal business impact. The problem causes little impact on operations, or a reasonable circumvention to the problem was implemented. - Describing problems and gathering information When describing a problem to IBM, be as specific as possible. Include all relevant background information so that IBM Software Support specialists can help you solve the problem efficiently. To save time, know the answers to these questions: - What software versions were you running when the problem occurred? - Do you have logs, traces, and messages that are related to the problem symptoms? IBM Software Support is likely to ask for this information. - Can you re-create the problem? If so, what steps were performed to re-create the problem? - Did you make any changes to the system? For example, did you make changes to the hardware, operating system, networking software, and so on. - Are you currently using a workaround for the problem? If so, be prepared to explain the workaround when you report the problem. - Submitting problems You can submit your problem to IBM Software Support in one of two ways: Online Click Submit and track problems on the IBM Software Support site at http://www.ibm.com/software/support/probsub.html. Type your information into the appropriate problem submission form. By phone For the phone number to call in your country, go to the contacts page of the IBM Software Support Handbook at http://techsupport.services.ibm.com/guides/contacts.html and click the name of your geographic region. If the problem you submit is for a software defect or for missing or inaccurate documentation, IBM Software Support creates an Authorized Program Analysis Report (APAR). The APAR describes the problem in detail. Whenever possible, IBM Software Support provides a workaround that you can implement until the APAR is resolved and a fix is delivered. IBM publishes resolved APARs on the Software Support Web site daily, so that other users who experience the same problem can benefit from the same resolution. ========================================================================= 5.0 NOTICES AND TRADEMARKS ========================================================================= ----------------------- 5.1 Notices: ----------------------- This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any =functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described 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: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: IBM World Trade Asia Corporation Licensing 2-31 Roppongi 3-chome, Minato-ku Tokyo 106, Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement might not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurement may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information may contain examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: This information may contain sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, serviceability, or function of these programs. You may copy, modify, and distribute these sample programs in any form without payment to IBM for the purposes of developing, using, marketing, or distributing application programs conforming to IBM's application programming interfaces. ----------------------- 5.2 Trademarks: ----------------------- IBM, CICS, OMEGAMON, Tivoli, Tivoli Enterprise, z/OS, zSeries, pSeries, AIX, IBMLink, S/390, ibm.com, IBM DeveloperWorks, Passport Advantage, Rational, Lotus, eServer, and IBM Redbooks are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. Intel and Pentium are trademarks of Intel Corporation in the United States, other countries, or both. Linux is a trademark of Linus Torvalds in the United States, other countries, or both. Microsoft(R) and Windows are registered trademarks of Microsoft Corporation in the United States, other countries, or both. Solaris(TM), Java(TM) and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. UNIX(R)is a registered trademark of The Open Group in the United States and other countries. Other company, product, and service names may be trademarks or service marks of others. =========================================================================