PK89657: THE EXPORT UTILITY OF DBHDA WRITES A WRONG DSG NUMBER INTO FLAT RECORDS.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When EXPORTABLE=YES and MULTIIMSID=YES are specified for HISTORY
  data set, the Export utility of DBHDA (DB Historical Data
  Analyzer) writes a wrong data set group number into flat records
  that are stored in the FABGEXPF data set.
  

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 the Export Utility of DB       *
  *                 Historical Data Analyzer (DBHDA).            *
  ****************************************************************
  * PROBLEM DESCRIPTION: In this APAR, the following error (1)   *
  *                      is fixed and the new function (2) is    *
  *                      added to Export Utility of DBHDA.       *
  *                                                              *
  *                      (1) Incorrect values in flat records    *
  *                                                              *
  *                        When HISTORY data set with            *
  *                        MULTIIMSID=YES option is used in      *
  *                        Export Utility, Export Utility writes *
  *                        incorrect values in flat records.     *
  *                                                              *
  *                      (2) New format of segment hierarchical  *
  *                          level in flat records               *
  *                                                              *
  *                        Character format is supported in the  *
  *                        field of a segment hierarchical level *
  *                        in flat records.                      *
  *                        This addresses FITS REQ MR0622091232. *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  (1) Incorrect values in flat records
  
    When a HISTORY data set with MULTIIMSID=YES option is used in
    Export Utility, Export Utility writes incorrect values into
    the following fields in flat records.
  
    - DSGID            (Data set Group identifier)
    - DSGIDCHR         (Data set Group identifier in character
                        format)
    - AVDBREC          (Average database record length)
    - NO_OF_ROTNOHOM   (The number of root segment occurrences in
                        blocks other than HOME block)
  
  (2) New format of segment hierarchical level in flat records
  
    Character format is supported in a field of a segment
    hierarchical level in flat records. The field name of a
    segment hierarchical level in flat records is SEGLVL.
  

Problem conclusion

• 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 (SC19240100)
  ==============================================================
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  4.0        DB Histrical Data Analyzer
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  --------------------------------------------------------------
  4.3        Operating instructions for Export Utility
  4.3.3      Input
  4.3.3.3    FABGRECI data set
  4.3.3.3.7  Field names
  --------------------------------------------------------------
  The row of SEGLVL in Table 59. is modified as follows:
  
    Field name: SEGLVL
    Maximum length that can be specified:
  |   C --> 2
      X --> 1
      P --> 0
  

Temporary fix

Comments

APAR Information

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

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

  UK48257

Modules/Macros

•    FABGXCB0 FABGXFLD FABGXXPE
  

Fix information

• Fixed component name

  IMS POINTER CHE

• Fixed component ID

  5655E0900

Applicable component levels

• R310 PSY UK48257

     UP09/07/11 P F907

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.