PM55790: SOME SENSOR DATA ELEMENTS HAVE INCORRECT VALUES

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• This APAR addresses the following problems of the DB Sensor:
  - DB_UNUSED_BYTES and DBX_UNUSED_BYTES do not contain the
  recent value for online VSAM KSDS even if TOSIXCFGRP is
  specified
   - DB_NUM_FSE_MIN has incorrect value when the database is
  HISAM.
   - Average Database Record length that reported in the HD
  Pointer Checker DATABASE RECORD STATISTICS is different from
  DB_AVG_DBREC_LENGTH.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: IBM IMS High Performance Pointer Checker for *
  *                 z/OS Version 3 Release 1 (FMID=HPC2310)      *
  *                 users who run HD Pointer Checker (HDPC).     *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR addresses the following       *
  *                      problems of the Database Sensor:        *
  *                      - DB_NUM_FSE_MIN and                    *
  *                        DB_AVG_NUM_NOREUSE_FSE                *
  *                        have incorrect values.                *
  *                      - Average Database Record length        *
  *                       that reported in the HD Pointer        *
  *                       Checker DATABASE RECORD                *
  *                       STATISTICS is different from           *
  *                       DB_AVG_DBREC_LENGTH.                   *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR fixes the the following errors:
  
  1. DB_NUM_FSE_MIN has incorrect value.
  
   When SENSOR=YES is specified to the PROCCTL data set,
   Database Sensor runs in HDPC job and it generates Sensor data.
   However, DB_NUM_FSE_MIN and DB_AVG_NUM_NOREUSE_FSE values were
   incorrect. This APAR fixes the values.
  
  2. Average Database Record length that reported in the
   HDPC DATABASE RECORD STATISTICS is different from
   the Sensor data DB_AVG_DBREC_LENGTH. This is because DB Sensor
   includes the padding area in the database record length.
   The padding area is added by IMS to adjust the segment length
   to even value. This difference is confusable.
   To resolve this issue, HD Pointer Checker adds a new
   information
   "AVERAGE DB RECORD LENGTH INCLUDING SEGMENT PAD"
   in the HDPC reports that are
   "Partition Statistics report" and "Database Statistics
   report".
   The report changes are always effective after this APAR
   regardless the DB Sensor is used or not.
  
   APAR dependency
   If you specify SENSOR=YES to the PROCCTL statement,
  it is required to apply APAR PM55789 for IMS Database
  Reorganization Expert for z/OS Version 4 Release 1
  (FMID=H25N410).
  
   Migration consideration
   This APAR changes the internal layout of DBDEFCTL data set.
   Ths DBDEFCTL is used for IMS HP Image Copy Multiple-step HASH
   Check option.
   The old format of DBDEFCTL can be used after this APAR.
   It is not required to regenerate the DBDEFCTL.
  

Problem conclusion

• The following modules and macros have been modified to fix
  the errors:
  
  FABGORGT FABKCOLL FABPACCP FABPACKE FABPACTL FABPADBS FABPAHIT
  FABPALLC FABPANAL FABPAOPS FABPAPRS FABPARCK FABPARPS FABPASPM
  FABPAWDS FABPBCTL FABPCMP2 FABPDBS0 FABPDCT  FABPDDST FABPECTL
  FABPESTM FABPE35E FABPGET1 FABPHAPI FABPHCTL FABPHEVL FABPHEVS
  FABPHEXM FABPHEXS FABPHINI FABPHPSD FABPHPUT FABPHRCK FABPHSDA
  FABPHSHI FABPHSIX FABPHTRM FABPLBLD FABPLBLX FABPMAIN FABPMSGT
  FABPMSUM FABPOPEX FABPOUT1 FABPPCTL FABPPILE FABPPMAP FABPPSDA
  FABPPSIX FABPRDEF FABPRORG FABPSCMP FABPSCTL FABPSDA0 FABPSEND
  FABPSHI0 FABPSIT  FABPSIX0 FABPSNAP FABPSSUP FABPSTAP FABPSTE0
  FABPSUMM FABPTGEN FABPUCB0 FABPUCDD FABPUCMP FABPUDBR FABPUDB1
  FABPUDCT FABPUDET FABPUDSR FABPUDTB FABPUGET FABPUHDR FABPUHTC
  FABPUMAI FABPUMAP FABPUPHR FABPURND FABPURTO FABPUSPM FABPVCB
  FABPXCTL FABPXPHR FABPXRCK
  
  Documentation Changes:
  Note: The section numbers are those of the BookManager (BKMGR)
  book.
  The documentation is modified as follows:
  ==============================================================
    IMS High Performance Pointer Checker for z/OS, V3R1,
    User's Guide (SC19240101)
  ==============================================================
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2.0        HD Pointer Checker
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  --------------------------------------------------------------
  2.2         Operating instructions for the HD Pointer Checker
              processor
  2.2.3       Output
  2.2.3.4     STATIPRT data set
  2.2.3.4.15  Partition Statistics report and Database Statistics
              report
  --------------------------------------------------------------
  The following description is added:
  
     AVERAGE DB RECORD PREFIX LENGTH
         The average lengths of prefixes in database records.
  
  |  AVERAGE DB RECORD LENGTH INCLUDING SEGMENT PAD
  |      The average lengths of database records.
  |      Prefix parts, data parts and padding area of all segment
  |      types are included.
  
  Figure 42 reports will be modified as follows:
  
                           AVERAGE DB RECORD LENGTH =        795.8
                    AVERAGE DB RECORD PREFIX LENGTH =        208.1
  |  AVERAGE DB RECORD LENGTH INCLUDING SEGMENT PAD =        810.3
  

Temporary fix

Comments

• ×**** PE12/03/12 PTF IN ERROR. SEE APAR PM60254  FOR DESCRIPTION
  

APAR Information

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

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

  UK76118

Modules/Macros

• FABGORGT FABKCOLL FABPACCP FABPACKE FABPACTL
  FABPADBS FABPAHIT FABPALLC FABPANAL FABPAOPS FABPAPRS FABPARCK
  FABPARPS FABPASPM FABPAWDS FABPBCTL FABPCMP2 FABPDBS0 FABPDDST
  FABPECTL FABPESTM FABPE35E FABPGET1 FABPHAPI FABPHCTL FABPHEVL
  FABPHEVS FABPHEXM FABPHEXS FABPHINI FABPHPSD FABPHPUT FABPHRCK
  FABPHSDA FABPHSHI FABPHSIX FABPHTRM FABPLBLD FABPLBLX FABPMAIN
  FABPMSGT FABPMSUM FABPOPEX FABPOUT1 FABPPCTL FABPPILE FABPPMAP
  FABPPSDA FABPPSIX FABPRDEF FABPRORG FABPSCMP FABPSCTL FABPSDA0
  FABPSEND FABPSHI0 FABPSIX0 FABPSNAP FABPSSUP FABPSTAP FABPSTE0
  FABPSUMM FABPTGEN FABPUCB0 FABPUCDD FABPUCMP FABPUDBR FABPUDB1
  FABPUDCT FABPUDET FABPUDSR FABPUDTB FABPUGET FABPUHDR FABPUHTC
  FABPUMAI FABPUMAP FABPUPHR FABPURND FABPURTO FABPUSPM FABPVCB
  FABPXCTL FABPXPHR FABPXRCK
  

Fix information

• Fixed component name

  IMS POINTER CHE

• Fixed component ID

  5655E0900

Applicable component levels

• R310 PSY UK76118

     UP12/02/14 P F202

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.