PH16135: NEW FUNCTION

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New Function
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: OMEGAMON XE for DB2 PE/DB2 PM                *
  *                 users of components:                         *
  *                 -   Batch Reporting                          *
  *                 -   PDB                                      *
  *                 -   CSV                                      *
  ****************************************************************
  * PROBLEM DESCRIPTION: New Function:                           *
  *                      Add zHyperLink counters to PDB and CSV. *
  *                                                              *
  *                      Changes / Fixes:                        *
  *                      -   The CPU time reported in fields ZHL *
  *                          READ CPU USED and ZHL CPU TIME READ *
  *                          is currently reported as the number *
  *                          of microseconds.  It is changed to  *
  *                          HH:MM:SS.xxxxxx format, where the   *
  *                          last digit is microseconds.         *
  *                      -   The statistics report and           *
  *                          statistics trace may show total     *
  *                          values for ZHYPERLINK READ I/O      *
  *                          instead of the delta value for the  *
  *                          interval being reported.            *
  *                      -   The statistics reports in section   *
  *                          TOTAL  READ OPERATIONS show more    *
  *                          accurate values.                    *
  ****************************************************************
  * RECOMMENDATION: Apply the provided PTF.                      *
  *                 1. To avoid inconsistent data in OMPE        *
  *                 reports related to Db2 section QW0199        *
  *                 (defined in Db2 macro DSNDQW02), input data  *
  *                 must be collected on Db2 subsystems with the *
  *                 PTF for PH07641 applied.                     *
  *                 2. Db2 may report ZHPLINK activity for       *
  *                 objects that do not use zHyperLink.  This    *
  *                 issue will be fixed by the PTF for OA58649   *
  *                 and that PTF should be applied when          *
  *                 available.                                   *
  ****************************************************************
  - The CPU time reported in fields ZHL READ CPU USED and ZHL CPU
  TIME READ is currently reported as the number of microseconds
  instead of the more traditional HH:MM:SS.xxxxxx format.
  - The statistics report and statistics trace show snapshot total
  values for ZHYPERLINK READ I/O instead of delta values from the
  previous interval.
  

Problem conclusion

Temporary fix

Comments

• - Batch accounting reports logic was updated to report fields
  ZHL READ CPU USED and ZHL CPU TIME READ values in the
  HH:MM:SS.xxxxxx format.
  - Batch statistics reports logic was updated to report delta
  values in field ZHYPERLINK READ I/O.
  - Provide updated members in the TKO2SAMP and TKANSAMF
  libraries for externalization of the new fields introduced via
  PH04126 into OMPE CSV layouts and PDB Db2 tables.
  
  
  
  Search Keywords:
  IFCID199 ZHYPERLINK STATISTICS ACCOUNTING PDB CSV
  

APAR Information

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

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

  UI68880

Modules/Macros

• BPOMAWRT BPOMAXA0 BPOQAPVA BPOQCREC BPOQINEX BPOQRIOA BPOQTPFC
  DGOAACUM DGOABFBU DGOABFGE DGOABFPK DGOABORD DGOABORE DGOABSBU
  DGOABSGE DGOABSPK DGOACALC DGOACFBU DGOACFGE DGOACFPK DGOACMER
  DGOACOMP DGOACREC DGOACSBU DGOACSGE DGOACSPK DGOADFBU DGOADFDF
  DGOADFGE DGOADFGP DGOADFPK DGOADFXC DGOADSBU DGOADSGE DGOADSPK
  DGOAEX20 DGOAEXIT DGOAFGEN DGOAFILE DGOAFORM DGOAIREC DGOAIREP
  DGOALFBU DGOALFGE DGOALFPK DGOALSBU DGOALSGE DGOALSPK DGOAMTRC
  DGOARCAL DGOAREDB DGOAREDC DGOAREDD DGOAREDG DGOAREDI DGOAREDM
  DGOAREDP DGOAREDR DGOAREDX DGOATRAC DGOATREC DGOAUPDB DGOAZMER
  DGOAZREC DGOBARAL DGOBARDD DGOBARLK DGOBARLO DGOBARPK DGOBARPO
  DGOBARPT DGOBARRI DGOBARRL DGOBARSH DGOBARSP DGOBARSQ DGOBARTE
  DGOBARTM DGOBATAL DGOBATDD DGOBATLK DGOBATLO DGOBATPK DGOBATPO
  DGOBATPT DGOBATRI DGOBATRL DGOBATSH DGOBATSP DGOBATSQ DGOBATTM
  DGOBGENL DGOFECA2 DGOFECAL DGOFEDAT DGOFEDPM DGOFPDPM DGOFPRF0
  DGOFPRIC DGOFSBST DGOLADLK DGOLATIM DGOLCREC DGOLIREC DGOLREDC
  DGOLTRAC DGOLXRES DGOMEXA0 DGOMEXST DGOMLAFD DGOMLEXD DGOMTADJ
  DGOMTFLR DGOMTLCK DGOMTLST DGOMTPKG DGOMTPOP DGOMTREF DGONF140
  DGONF150 DGONF160 DGONF170 DGONF180 DGONF190 DGONF191 DGONF200
  DGONFILE DGONTRAC DGORAEXT DGORCREC DGORINEX DGORIREP DGORPACC
  DGORRCAP DGORRCOM DGORRDDF DGORRSQL DGORRTHR DGORUACC DGORZREP
  DGOSBBUF DGOSBSET DGOSCBUF DGOSCSET DGOSDBUF DGOSDDDF DGOSDSET
  DGOSI199 DGOSLBUF DGOSLDDF DGOSLSET DGOSPREP DGOSREPM DGOSUPDB
  DGOTAPVA DGOTARAD DGOTCREC DGOTINEX DGOVDB2C DGOVDB2F DGOVDMSG
  DGOVDSS  DGOVEE00 DGOVEEDR DGOVHMM0 DGOVHMM1 DGOVMUAE DGOVPMOV
  DGOVSADJ DGOVSADK DGOVSAGG DGOVSCS3 DGOVSCT1 DGOVSCT2 DGOVSCTH
  DGOVSDDF DGOVSDTS DGOVSFLR DGOVSLOC DGOVSTAG DGOVSTDS DGOVSTQL
  DGOVSUTL DGOVUELD DGOWB106 DGOWC106 DGOWD106 DGOWD202 DGOWDSFP
  DGOWL106 DGOWUPDB DGOXCREC DGOXCREP DGOXD000 DGOXF000 DGOXF001
  DGOXF002 DGOXF003 DGOXF004 DGOXF005 DGOXF006 DGOXF008 DGOXF009
  DGOXFSQL DGOXR000 DGOXS001 DGOXS002 DGOXS003 DGOXS004 DGOXS005
  DGOXS006 DGOXT000 DGOXT001 DGOXT002 DGOXT003 DGOXT004 DGOXT005
  DGOXT006 FPECHATS FPECHTRN FPEMEXA0 FPEPAFBU FPEPAFGE FPEPAFPK
  FPEPASBU FPEPASGE FPEPASPK FPEPSBUF FPEPSSET FPEPW106 FPEUCBPR
  FPEUCXSX FPEUFTDS FPEUFTS2 FPEUIFC2 FPEUIFCI FPEUNIDT FPEVDB2C
  FPEVDB2F FPEVMMM  FPEVOPM  FPEVSFLR FPEVSPMM HABFBU   HABFGE
  

Fix information

• Fixed component name

  OM XE DB2PE/PM

• Fixed component ID

  5655OPE00

Applicable component levels

• R540 PSY UI68880

     UP20/04/25 P F004

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.