------------------------------------------------------------------------ IBM Tivoli OMEGAMON XE on z/OS Version 5 Release 3 Fixpack 4 Fix Pack: 5.3.0-TIV-KM5-FP0004 Licensed material - Property of IBM and UNICOM Systems, Inc. © Copyright IBM Corporation 2005, 2016 and UNICOM Systems, Inc. 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 ========================================================================= NOTE: Set the font to monospace to better view this file. This maintenance update is Fix Pack 4 for Tivoli OMEGAMON XE on z/OS V5.3.0. The following product application support files are included: 5.3.0-TIV-KM5-FP0004.zip (includes both Windows and Unix files) It includes fix pack feature support for the following APAR: OA51082 (PTF UA82561) - Provides the corresponding application support jar files delivered via SMP/E. - Provides product provided queries, attribute groups, attributes and historical data configuration features for two new near term history tables: 1. Address Space CPU Summary History 2. LPAR Summary History ----------------------- 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) V6.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.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. - 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. - If you are using the Tivoli Enterprise Portal Browser Client or the Tivoli Enterprise Portal Java Webstart Client with IBM Tivoli Monitoring (ITM) V6.3.0, you should review IBM Technote #1672459 and perform the recommended workarounds, which includes installing provisional maintenance. Refer to technote #1672459 for important information regarding the latest Java Support requirements. http://www.ibm.com/support/docview.wss?uid=swg21672459 Additionally, you should review technote #1660437, which contains a list of the Tivoli OMEGAMON, Tivoli Netview, and Tivoli Advanced Products fixpacks that must also be installed to resolve Java related security issues. Refer to technote #1660437 for important information regarding the latest Agent fixpack requirements for Java Security Support. http://www.ibm.com/support/docview.wss?uid=swg21660437 - The language support DVD which is compatible with this image is LCD7-5138-05 IBM Tivoli OMEGAMON XE z/OS V5.1.0, 5.1.1, 5.2.0, and 5.3.0. ========================================================================= 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 (6.3.0-TIV-ITM-FP0006) or higher. - Installation of IBM Tivoli OMEGAMON XE on z/OS V5.3.0 requires PTF(s): UA82561. - This fixpack includes all maintenance since GA of OMEGAMON XE on z/OS V5.3.0. This fixpack can be applied directly to the base V5.3.0 product release or any previous fix pack or interim fix level. - This maintenance update includes a renewed Java certificate (Valid from: 8/2/15 7:00 PM until: 11/1/18 6: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. ----------------------- 2.2 Installation, migration, upgrade, and configuration notes ----------------------- If you are using the "Tivoli Enterprise Portal Desktop Client", you will need to install only desktop client component from the DVD wherever you have previously installed the "Tivoli Enterprise Portal Desktop Client". - If you are installing or upgrading IBM Tivoli OMEGAMON XE on z/OS V5.3.0 Support Files for z/OS from this image on a Windows platform, during the installation process when you are presented with the list to "Select the features setup will install", you should unselect the box labeled "Verify prerequisites". Verification of prerequisites is not applicable to this image, as this image only contains application support files. - If you are installing IBM Tivoli OMEGAMON Application Support Files for z/OS from this image on a Windows platform and you will be seeding a Tivoli Enterprise Management Server remotely (ie., on another platform), before you start the installation, copy file KDSTSNS.exe from directory \BIN\ to \CNPS\ . - If you are installing or upgrading IBM Tivoli OMEGAMON Application Support Files for z/OS from this image, you must select the appropriate option as indicated below when adding application support to the TEMS. - If you are using this DVD to add the application support files for products and this is the first time you have attempted installation of the application support files for this product or if you are using this DVD to update 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. If you are installing application support to products to a TEMS running on Linux or UNIX, and you are using the command line interface, specify the "ALL" option: cd &installHome/bin ./itmcmd support -f upgrade -s ALL -t tems_name pc ... - 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. NOTE: 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 product name V 5.3.0 fp:nn.nn Do you want to install the SAME version [ y or n; "n" is default ]? If you have previously installed one of the fix packs 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 fix pack which is at a later level of maintenance than is included on this DVD. - If you are upgrading IBM Tivoli OMEGAMON on z/OS V5.3.0 from V4.2.0 and you do not have OMEGAMON XE ON z/OS V4.2.0 interim fix 10 (4.2.0.1-TIV-KM5-IF0010) installed, after installing the application support files for OMEGAMON on z/OS V5.3.0 from this image or via the self describing agent feature, you must complete the following steps: - If you are upgrading application support to a TEPS running on Linux or UNIX: 1. Make a backup copy of km5.jar and tep.jnlp (refer to directory location in step 2&3). 2. Remove file km5.jar from //cw/km5.jar 3. Edit //cw/tep.jnlp and remove the line that references km5.jar. It will look something like this: "" 4. Recycle the TEPS. 5. Clear the java cache and java certificates on each TEP client where TEP Browser or Java Webstart will be used. - If you are upgrading application support to a TEPS running on Windows: 1. Make a backup copy of km5.jar and tep.jnlp (refer to directory location in step 2&3). 2. Remove file km5.jar from \CNB\classes\km5.jar 3. Edit \CNB\classes\tep.jnlp and remove the line that references km5.jar. It will look something like this: "" 4. Recycle the TEPS. 5. Clear the java cache and java certificates on each TEP client where TEP Browser or Java Webstart will be used. ----------------------- 2.3 Known limitations, problems, and workarounds ----------------------- - After installing application support from this image, if you observe unresolved strings from the TEP navigator view using the TEP browser client or TEP Java webstart client, refer to the "Master list of ITM TEP/Java issues" identified in IBM technote #1672459: http://www.ibm.com/support/docview.wss?uid=swg21672459 Confirm that you have installed workarounds for any unresolved Java issues. For example, Oracle Java 7u55 and IBM Java 7 SR7 introduced an issue where both the Java WebStart and browser client versions of the Tivoli Enterprise Portal client fail to start. The workaround for this problem is documented in IBM technote #12671147: http://www.ibm.com/support/docview.wss?uid=swg21671147 ========================================================================= 3.0 SERVICE HISTORY ========================================================================= This refreshed image supersedes prior maintenance updates: - IBM Tivoli OMEGAMON XE on z/OS V5.3.0: Release DVD: IBM Tivoli OMEGAMON Application Support Files for z/OS V5.3.0 DVD - IBM Tivoli OMEGAMON XE on z/OS V5.3.0 fix packs and interim fixes: 5.3.0-TIV-KM5-FP0001 5.3.0.1-TIV-KM5-IF0001 5.3.0-TIV-KM5-FP0002 5.3.0.2-TIV-KM5-IF0001 5.3.0-TIV-KM5-FP0003 ----------------------- 3.1 Product fix history ----------------------- The following APARs are addressed in this maintenance update: OA51082: Growth of Tables and Attributes: OMEGAMON data is organized into tables with attributes defined for these tables. OMEGAMON supports versioning of these tables and attributes to allow users to run old versions in parallel with new versions. This enhancement dramatically increases the ability to support multiple versions simultaneously. Multiple DDSs: The OMEGAMON product uses the RMF Distributed Data Server (DDS) to supply some real time and all enhanced 3270UI history data. This enhancement provides the ability to specify which DDS to use when multiple DDS servers are available. MZAP/MLST commands: The OMEGAMON ON Z/OS agent has been modified to allow for the display and zapping of memory from the enhanced 3270UI. This new function may be invoked programmatically or may be accessed via the Memory menu item in the View pulldown of the enhanced 3270UI. This function requires the addition of new SAF defintions in order to enable it (see the HOLD data for additional information). Near Term History: Two workspaces have been added in the enhanced 3270UI that support multiple metrics for both an LPAR and an address space by 5-minute intervals over a specified summary time interval. In addition, zoom navigation has been added to allow direct navigation from an existing execution and delay workspace's device volume to an existing wokspace displaying address spaces with I/O active against the selected volume. Incorrect LPAR Group Capacity metrics displayed: Underlying code behind the OMEGAMON 3270 SYS major command's RMSU minor command has been modified to correct scaling of a component in the calculation of Average Group Capacity% and Average Used MSUs/Hour. See about this fix pack for more details regarding issues addressed by this fix pack. ========================================================================= 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. Options for obtaining support for IBM software products is maintained in the IBM Software Support Handbook, which is available from this link: https://www-304.ibm.com/webapp/set2/sas/f/handbook/getsupport.html For support for IBM products includes on this DVD, contact IBM Software Support. Use this link to obtain worldwide contact information for IBM product support: http://www.ibm.com/planetwide/region.html IBM problem management records (PMR) can be submitted using one of the following methods: - 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/ 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. Here is a link to the IBM Software Support Web site: http://www.ibm.com/software/support/ Product Lifecycle information is provided that indicates when the IBM products that you are using are nearing the end of support date for a particular version or release. Support Lifecycle information can be obtained from this link: http://www-304.ibm.com/software/sysmgmt/products/support/lifecycle/ ----------------------- 4.1 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/ - In the "Notifications" section, select "Sign in to create, manage or view your subscriptions". - If you have not registered, you will be prompted to complete the registration form using your e-mail address as your IBM ID. - After you have completed your registration and successfully signed in, in the "Notifications" section, select "Manage all my subscriptions". - Select the "Subscribe" tab and follow the instructions to select your product subscription(s). You may also "Create a subscription by selecting a product family." - After selecting all products that are of interest to you, under the "Notify me by" section, select "Email", and select the frequency and format of the email. - Click "Submit" from the bottom of the page. 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). ========================================================================= 5.0 NOTICES AND TRADEMARKS ========================================================================= ----------------------- 5.1 Notices: ----------------------- Notices INTERNATIONAL BUSINESS MACHINES CORPORATION AND UNICOM SYSTEMS, INC. (“UNICOM”) 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 jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may 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 and UNICOM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Microsoft, Windows, and Windows Server are trademarks of Microsoft Corporation in the United States, other countries, or both. Intel, Intel logo, Intel Inside, Intel Inside logo, Intel Centrino, Intel Centrino logo, Celeron, Intel Xeon, Intel SpeedStep, Itanium, and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. Other company, product, or service names may be trademarks or service marks of others. THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION The license agreement for this product refers you to this file for details concerning terms and conditions applicable to third party software code included in this product, and for certain notices and other information IBM and/or UNICOM must provide to you under its license to certain software code. The relevant terms and conditions, notices and other information are provided or referenced below. Please note that any non-English version of the licenses below is unofficial and is provided to you for your convenience only. The English version of the licenses below, provided as part of the English version of this file, is the official version. Notwithstanding the terms and conditions of any other agreement you may have with IBM or any of its related or affiliated entities (collectively "IBM") and/or UNICOM or any of its related or affiliated entities, the third party software code identified below are "Excluded Components" and are subject to the following terms and conditions: the Excluded Components are provided on an "AS IS" basis IBM AND UNICOM DISCLAIM ANY AND ALL EXPRESS AND IMPLIED WARRANTIES AND CONDITIONS WITH RESPECT TO THE EXCLUDED COMPONENTS, INCLUDING, BUT NOT LIMITED TO, THE WARRANTY OF NON-INFRINGEMENT OR INTERFERENCE AND THE IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE IBM and UNICOM will not be liable to you or indemnify you for any claims related to the Excluded Components IBM and UNICOM will not be liable for any direct, indirect, incidental, special, exemplary, punitive or consequential damages with respect to the Excluded Components. ----------------------- 5.2 Trademarks: ----------------------- Copyright and trademark information http://www.ibm.com/legal/copytrade.shtml =========================================================================