------------------------------------------------------------------------
IBM OMEGAMON for Db2 PE on z/OS Application Support
Files Version 5 Release 5 Fix Pack 3(V5.5.0 Fix Pack 3)

Licensed material - Property of IBM and Rocket Software

(C) Copyright Rocket Software, Inc. 2016, 2022
(C) Copyright IBM Corporation 2005, 2016
 
------------------------------------------------------------------------

CONTENTS

1  About this release
2  Installation, migration, upgrade, and configuration information
3  Service history
4  Support information
5  Notices and trademarks


=========================================================================
1.0 ABOUT THIS RELEASE
=========================================================================

This is the README document for the OMEGAMON for Db2 PE on z/OS 
Application Support Files maintenance update Fix Pack 3.

The following product application support files are included:

  IBM OMEGAMON for Db2 PE on z/OS V5
  
  It includes the fixes for these APARs:
  
  PH48555 - Java certificate has been renewed 
  
  PH46145 - Buffer Pool and SQL count workspace update.
  
  PH46359 - Support new and changed Latch classes in E3270UI
  
  PH32267 - changed semantics for QBACSYIT in E3270UI
  
  PH42014 - Add missing ZPARMS


-----------------------
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.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 to the required level
   of ITM maintenance prior to installing the OMEGAMON application 
   support files with this image.

   Additionally, you should review technote Application Support 
   below, which contains a list of the Tivoli OMEGAMON, Tivoli 
   Netview, and Tivoli Advanced Products.  Refer to this technote:

  http://www.ibm.com/support/pages/locating-ibm-z-monitoring-suite-application-support-files

-  For language support DVD which is compatible with this image, 
   refer to this technote:
   http://www.ibm.com/support/pages/locating-ibm-z-monitoring-suite-application-support-files

-  If you would like to use enhanced 3270UI
   embedded data feature to view more detailed information about the
   currently executing SQL statement, you must also install the
   application support files for IBM DB2 Query Monitor V3.2.


=======================================================================
2.0 INSTALLATION, MIGRATION, UPGRADE, AND CONFIGURATION INFORMATION
=======================================================================

-----------------------
2.1 Hardware and Software Requirements
-----------------------

- IBM Tivoli Monitoring (ITM) V6.3.0 Fix Pack 6 or higher. 

- Installation of IBM OMEGAMON for Db2 PE on z/OS V5   

- Refer to technote #1290883  for a complete list recommended   
  maintenance levels: 
  http://www.ibm.com/support/docview.wss?uid=swg21290883 


-----------------------
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 release 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 release. 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.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. 
    You can find instruction on cinfo/KinCInfo command in the 
    post-install step in this section. 

- 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.5.0-TIV-KD5-FP0003.zip
 
     On UNIX or Linux systems:
     - if the version of tar used supports z, then
       tar -zxvf 5.5.0-TIV-KD5-FP0003.tar.gz

     - if the version of tar used does not support z, then
       gunzip 5.5.0-TIV-KD5-FP0003.tar.gz
       tar -xvf 5.5.0-TIV-KD5-FP0003.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 release is to be installed be 
     stopped manually prior to performing this 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.
		
- 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 recorded
  prior to the installation. 

  On Windows systems: 
  - <INSTALL HOME>\installITM\KinCInfo -t dp
  
  On UNIX or Linux systems:  
  - <INSTALL HOME>/bin/cinfo -t dp

  Sample output for the KinCInfo command on Windows systems to list
  product components installed in the manager server and/or portal 
  server:

  <INSTALL HOME>\installITM\KinCInfo -t dp

  PC  APPLICATION SUPPORT DESC     PLAT   APP VER              
  DP  OMEGAMON for Db2 PE on zOS   WICMS  05.50.03.00
  DP  OMEGAMON for Db2 PE on zOS   WICNS  05.50.03.00
  DP  OMEGAMON for Db2 PE on zOS   WIXEB  05.50.03.00
  DP  OMEGAMON for Db2 PE on zOS   WIXEW  05.50.03.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:

  <INSTALL HOME>/bin/cinfo -t dp    

  PC  APPLICATION SUPPORT DESC     PLAT   APP VER              
  DP  OMEGAMON for Db2 PE on zOS   WICMS  05.50.03.00
  DP  OMEGAMON for Db2 PE on zOS   WICNS  05.50.03.00
  DP  OMEGAMON for Db2 PE on zOS   WIXEB  05.50.03.00
  DP  OMEGAMON for Db2 PE on zOS   WIXEW  05.50.03.00 



-----------------------
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 OMEGAMON for Db2 PE on z/OS V5 fix packs:
  None. 
  5.5.0-TIV-KD5-FP0001
  5.5.0-TIV-KD5-FP0002


-----------------------
3.1 Product fix history
-----------------------

PH48549 - The Java certificate used to sign the resource file 
          expires February 20 2023.		

  Problem Summary:
    The Java certificates used by the TEP browser and TEP webstart 
	clients will expire Feb 20, 2023. You might start receiving an 
	expired Java certifcate warning until you install application 
	support files that have been signed with the renewed Java 
	certificate.

  Conclusion:
    Renewed the Java certificate. The signer certificate will 
	expire on 2025-08-07. The timestamp will expire on 2031-11-09.


PH46145 - Updated Buffer Pool Management workspace.
		  Updated SQL counts workspaces.
		  Updated Group Buffer Pool Statistics workspace.
		  
  Problem Summary:
    Comparing with E3270UI Workspaces were out of sync. 

  Conclusion:
    All fields have been added.
	
	
PH42014 - Added missing ZPARMS counters

   Problem Summary:
      Added missing ZPARMS counters.

   Conclusion:
      - ZPARM is updated yo be in sync
        with E3270UI


PH46169 - QBACSYIT semantics change
	Problem Summary:
      QBACSYIT semantics change

	Conclusion:
	  - QBACSYIT semantics changed to avoid ambiguity in Batch 
	    Accounting trace/report, CSV and Enhanced 3270 UI.
		

PH46359 - New latch classes added in Db2 V13 DSNDQVLS.
	Problem Summary:
      New latch classes added in Db2 V13 DSNDQVLS.
	Conclusion:
	  - Show new latch classes in system latch counters workspace
        KO2LOK2 on E3270UI.

=========================================================================
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:  

http://www.ibm.com/software/support/handbook.html


For support for IBM products included 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.ibm.com/software/sysmgmt/products/support/lifecycle/


-----------------------
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/

- In the "Support 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 "Support notifications" section, select "Product 
  notifications".
- Enter Product in Product Lookup.  Click on Subscribe. 
- Click on "Delivery preferences" to change your e-mail address, 
  e-mail frequency, format and/or your language preference.  
- Click on "Submit" when you have completed your updates.

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 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 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 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"), 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 DISCLAIMS 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 will not be liable to you or indemnify you for any claims related 
    to the Excluded Components  IBM 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

=========================================================================