OA66223: OMEGAMON DATA PROVIDER 2024 Q1 MAINTENANCE

Obtain the fix for this APAR.

APAR status

• Closed as unreproducible in next release.

Error description

• OMEGAMON DATA PROVIDER 2024 Q1 MAINTENANCE
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All OMEGAMON Data Provider users.            *
  ****************************************************************
  * PROBLEM DESCRIPTION: OMEGAMON DATA PROVIDER 2024 Q1          *
  *                      MAINTENANCE                             *
  ****************************************************************
  This APAR includes new features and minor fixes.
  
  New features
  ------------
  
  OMEGAMON Data Broker:
  
  -  New version of protocol between OMEGAMON Data Broker and
     OMEGAMON Data Connect.
  
     Version 2 of this protocol improves performance and
     reliability.
  
  -  Store parameters for queue capacity and cells are now
     optional.
  
     Previously, these parameters were required.
  
     Now, these parameters are optional, with default values.
     You can omit (remove) these parameters from your
     configuration member.
  
  -  Reusable sink parameters.
  
     You can now define reusable sink parameters separately from
     forwarders. Multiple forwarders can refer to the same set of
     reusable sink parameters. Reusable sink parameters make it
     easier to forward data from different sources to the same
     sink (the same instance of OMEGAMON Data Connect).
  
  -  Improved validation of configuration parameters.
  
     OMEGAMON Data Broker validates more configuration
     parameters at startup.
  
  OMEGAMON Data Connect:
  
  -  Support for new version of OMEGAMON Data Broker forwarder
     protocol.
  
     OMEGAMON Data Connect supports the new version 2 of the
     OMEGAMON Data Broker forwarder protocol.
  
  -  Improved validation of configuration parameters.
  
     Previously, OMEGAMON Data Connect silently ignored unknown
     parameters in the configuration file.
  
     Now, if the configuration file contains an unknown parameter,
     OMEGAMON Data Connect fails at startup.
  
     If your configuration file contains errors that were
     previously silently ignored, this is a breaking change.
     You must edit the configuration file and fix the issue.
  
  -  Configuration validator.
  
     The OMEGAMON Data Provider configuration validator is a new
     command-line tool that you can use to validate the two
     YAML-format OMEGAMON Data Provider configuration files:
     -  The OMEGAMON Data Connect configuration file
     -  If you are using OMEGAMON monitoring agents as a data
        source: the OMEGAMON Data Provider collection
        configuration member, RKANPARU(KAYOPEN)
  
  -  Sample shell script z/OS UNIX file now encoded using
     EBCDIC code page 1047
  
     You no longer need to activate automatic text conversion to
     run the sample shell script to start OMEGAMON Data Connect on
     z/OS UNIX.
  

Problem conclusion

Temporary fix

Comments

• User Action:
  New users installing OMEGAMON Data Provider for the first time:
  1. SMP/E Apply the fix.
  
  Existing users must follow these upgrade steps:
  1. If you have modified files in the OMEGAMON Data Connect
     directory (DDDEF name TKAYHFS), back up the modified files
     to another location.
     This PTF replaces all files in the OMEGAMON Data Connect
     directory.
  2. SMP/E Apply the fix.
  3. Perform the upgrade steps described in the OMEGAMON
     Data Provider product documentation (https://www.ibm.com/
     docs/SSFHX8_5.6.0/OMDP/source/kay-upgrade.html).
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UJ95209

Modules/Macros

• KAY11PAX KAY11ZIP KAY1BDP  KAY1LDP  KAY1ODP  KAY4BDP  KAY4LDP
  KAY4ODP  KAYB0001 KAYBNETL KAYOPEN  KAYSIP00 KAYSIS01 KAYSISDL
  

Fix information

• Fixed component name

  OMEGA DATA PROV

• Fixed component ID

  5698B6605

Applicable component levels

• R110 PSY UJ95209

     UP24/05/23 P F405

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.