PI08977: DB SENSOR SUPPORTS DB_AVG_LEN_SYNONYM_CHAIN FOR HDAM AND PHDAM DATABASES

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• DB Sensor is enhanced to collect and print a new sensor element
  DB_AVG_LEN_SYNONYM_CHAIN that is the average length of synonym
  chains.
  This APAR is for enabling the enhancement in Integrated DB
  Sensor.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: IBM IMS High Performance Pointer Checker for *
  *                 z/OS Version 3 Release 1 (FMID=HPC2310)      *
  *                 users who run Full Function Database Sensor  *
  *                 (DB Sensor).                                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: DB Sensor is enhanced to collect and    *
  *                      print a data element                    *
  *                      DB_AVG_LEN_SYNONYM_CHAIN that is the    *
  *                      average length of synonym chains.       *
  *                      This APAR is for enabling the           *
  *                      enhancement in Integrated DB Sensor.    *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR and PI08979 of IMS DB Reorganization Expert enhance
  DB Sensor to support a data element DB_AVG_LEN_SYNONYM_CHAIN
  for HDAM and PHDAM database in the following_run modes:
  
   - Integrated DB Sensor runs in IMS High Performance Image Copy
     with HDPC=Y.
   - Integrated DB Sensor runs in IMS High Performance Pointer
     Checker.
  
  When SENSOR_HOME is specified as yes in the control statement,
  DB_AVG_LEN_SYNONYM_CHAIN is stored in the Sensor Data
  repository of IMS Tools Knowledge Base, and it is printed
  in the Sensor Data Statistics report of DB Sensor.
  
  To use the new function, apply this APAR and PI08979.
  

Problem conclusion

Temporary fix

Comments

• The following modules and macros have been modified.
  
  FABPDCT,FABPARCK,FABPDBS0,FABPHINI,FABPHPSD,FABPHSDA,FABPPSDA,
  FABPSDA0,FABPURND
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  
   Note: The Part and Chapter numbers are those of the PDF file.
   The documentation is modified as follows:
   ===============================================================
   IBM IMS High Performance Pointer Checker for z/OS, V3R1, User's
   Guide Version 3 Release 1 (SC19240101)
   ===============================================================
   > Part 2. HD Pointer Checker utility
   >> Chapter 4. Using the HD Pointer Checker processor
   >>> Input
   >>>> FABPMAIN PROCCTL data set
   >>>> PROC statement
   >>>>> SENSOR_HOME=
   --------------------------------------------------------------
   Specifies whether to collect the data elements that are related
   to root segment distribution and store them in the Sensor Data
   repository of IMS Tools KB. If SENSOR=YES is not specified,
   this keyword is ignored.
  
   YES
   Collects the following data elements and stores them in the
   Sensor Data repository of IMS Tools KB:
    DB_NUM_ROOT_NOHOME
    DB_PCT_NUM_ROOT_NOHOME
  | DB_AVG_LEN_SYNONYM_CHAIN
  
   SENSOR_HOME=YES is the default value.
   Consideration: When you specify SENSOR_HOME=YES, a randomizer
   is called to collect data for these data elements.
   Therefore, when SENSOR_HOME=YES is specified, the CPU time and
   the elapsed time will increase compared to when SENSOR_HOME=NO
   is specified.
  
   NO
   Does not collect the data elements that are related to root
   segment distribution.
   For information about the data elements that are related to
   root segment distribution, see the explanation of this keyword
   in the IMS Solution Packs: Database Sensor User's Guide.
  

APAR Information

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

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

  UI14362

Modules/Macros

• FABPARCK FABPDBS0 FABPHINI FABPHPSD FABPHSDA FABPPSDA FABPSDA0
  FABPURND
  

Fix information

• Fixed component name

  IMS POINTER CHE

• Fixed component ID

  5655E0900

Applicable component levels

• R310 PSY UI14362

     UP14/01/28 P F401

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.