------------------------------------------------------------------------ IBM(R) Tivoli(R) OMEGAMON(R) XE on z/OS Monitor Feature for JVM Application Support Files Version 5 Release 3 Fix Pack 02 Fix pack: 5.3.0-TIV-KJJ-FP0002 Licensed material - Property of IBM © Copyright IBM Corporation 2015, 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 on z/OS Monitoring Feature for JVM Application Support Files for z/OS maintenance update Fix Pack 02. The following product application support files are included in fix pack: OMEGAMON XE on z/OS Monitoring Feature for JVM It includes the fixes for these APARs: OA50242 Various fixes which are included in PTF UA81330 It includes the fixes for these defects: - Warning and Critical situations may both be recognized due to an overlapping range on the product provided situations. This fix pack includes all maintenance since GA of IBM Tivoli OMEGAMON XE on z/OS Monitoring Feature for JVM V5.3.0. This release can be applied directly to the base V5.3.0 product release or any previous fix pack or interim fix level. IBM Tivoli OMEGAMON XE on z/OS Monitoring Feature for JVM ----------------------- 1.1 Cross-Product compatibility ----------------------- - This Fix Pack requires IBM Tivoli Monitoring (ITM) Version 6.3.0 Fix Pack 6 (6.3.0-TIV-ITM-FP0006) or higher version of ITM is required. - IBM Tivoli Monitoring version 6.3.0 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 XE on z/OS Monitoring Feature for JVM V5.3.0. - IBM Tivoli OMEGAMON XE on z/OS Monitoring Feature for JVM PTF: UA81330. ----------------------- 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.3.0-TIV-KJJ-FP0002.zip On UNIX or Linux systems: - if the version of tar used supports z, then tar -zxvf 5.3.0-TIV-KJJ-FP0002.tar.gz - if the version of tar used does not support z, then gunzip 5.3.0-TIV-ITM_KJJ-FP0002.tar.gz tar -xvf 5.3.0-TIV-KJJ-FP0002.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 jj PC APPLICATION SUPPORT DESC PLAT APP VER JJ OMEGAMON XE on z/OS Monitoring Feature WICMS 05.30.02.00 JJ OMEGAMON XE on z/OS Monitoring Feature WICNS 05.30.02.00 JJ OMEGAMON XE on z/OS Monitoring Feature WIXEB 05.30.02.00 JJ OMEGAMON XE on z/OS Monitoring Feature WIXEW 05.30.02.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 jj OMEGAMON XE on z/OS Monitoring Feature tms 05.30.02.00 jj OMEGAMON XE on z/OS Monitoring Feature tmd 05.30.02.00 jj OMEGAMON XE on z/OS Monitoring Feature tps 05.30.02.00 jj OMEGAMON XE on z/OS Monitoring Feature tpw 05.30.02.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 ----------------------- - 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 on z/OS Monitoring Feature for JVM V5.3.0 05.30.02 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. - 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 on z/OS Monitoring Feature for JVM V5.3.0 fix packs: 5.3.0-TIV-KJJ-FP0001 5.3.0-TIV-KJJ-FP0002 ----------------------- 3.1 Product fix history ----------------------- The following APARs are addressed in this maintenance update: OA50242 Various fixes which are included in PTF UA81330 Problem Summary: Both Warning and Critical situations for the same metric may fire at the same time. No environment data was collected for a JVM. Workspace help for KJJTHD is incomplete. WebSphere JVMs are not properly identified. The Java agent does not properly report the build stamp. SDA level is now 05300200. ========================================================================= 4.0 SUPPORT INFORMATION ========================================================================= ----------------------- 4.1 Contacting IBM Software Support ----------------------- 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 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 on z/OS Monitoring Feature for JVM" listed under "T". This opens the IBM Tivoli OMEGAMON XE on z/OS Monitoring Feature for JVM 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.2 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 on z/OS Monitoring Feature for JVM. - 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.3 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. =========================================================================