IBM Support

PK96437: HD POINTER CHECKER REPORT AND HISTORY ENHANCEMENT

A fix is available

Obtain the fix for this APAR.

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as new function.

Error description

  • This is a functional enhancement of HD Pointer Checker as
follows:

 - New information is added to "DB Record Distribution
Statistics report" and "Partition Statistics report and
Database Statistics report"

 - When HD Pointer Checker runs in HP Image Copy job, HD
Pointer Checker stores the following values in history records:
     - The number of root segment occurrences which do not
have dependent segment within the same block
     - Average number of dependent segment occurrences which
locate in the same block as root segment occurrence
     - The number of dependent segment occurrences which
locates in the different block from root segment occurrence

This APAR addresses FUTS REQ MR0727042240.

Local fix

  • N/A

Problem summary

  • ****************************************************************
* USERS AFFECTED: Users of IBM IMS High Performance Pointer    *
*                 Checker for z/OS Version 3 Release 1         *
*                 (FMID=HPC2310) who use HD Pointer Checker    *
*                 (HDPC), DB Historical Data Analyzer (DBHDA), *
*                 Export Utility of DBHDA, and the Single-step *
*                 HASH checking option of IMS High Performance *
*                 Image Copy.                                  *
****************************************************************
* PROBLEM DESCRIPTION: This APAR provides the following        *
*                      changes:                                *
*                      1. Adds dependent segments distribution *
*                         and length of variable length (VL)   *
*                         segments to HDPC reports.            *
*                         With this change, FABP1530W message  *
*                         is removed.                          *
*                      2. Supports a new ICEIN keyword DEPDIST *
*                         to print the dependent segments      *
*                         distribution.                        *
*                      3. Sets the dependent segments          *
*                         distribution information in HISTORY  *
*                         record in Single-step HASH checking. *
*                      4. Corrects a DBHDA report error when   *
*                         HISTORY data set is MULTIENT=YES     *
*                         attribute.                           *
****************************************************************
* RECOMMENDATION: Apply the maintenance for this APAR.         *
****************************************************************
1. HDPC reports enhancements.

  1) DB Record Distribution Statistics report
    The reports prints more lines about dependent segments
    distribution as follows:
    - A new line BLOCKS WITHOUT ROOT SEGMENTS IN RAA is added.
    - A new section Summary of Dependent Segments
      Distribution is added.
      This new section has three lines:
      - NUMBER OF DEPENDENTS IN AS SAME BLOCK AS ROOT
      - AVERAGE DEPS IN AS SAME BLOCK AS ROOT PER ROOT
      - NUMBER OF DEPENDENTS IN THE DIFFERENT BLOCK TO ROOT
    And with this change, message FABP1530W is removed from
    DB Record Distribution Statistics report.
    The message showed that some sections are not printed
    in this reports because of control statement specification.
    It is removed because it is not indicating either error or
    warning incident.

  2) Partition Statistics report and Database Statistics report
    SUMMARY OF VL SEGMENT SIZES section prints more information
    about VL segment length :
    - A new mark "<= AVERAGE" is added to point up the average
    - A new line MORE THAN 90 PERCENT OF SEGMENT OCCURRENCES ARE
      INCLUDED IN THE RANGE xxxxxx - xxxxxx is added.

2. A new key word DEPDIST is added to ICEIN control statement
   to print the following three sections in the
   DB Record Distribution Statistics report:

  - Summary of Dependent Segments Distribution
  - Distribution of Dependent Segments in Root Block
  - Distribution of Dependent Segments by Segment Code

  DEPDIST is available in HDPC runs as Single-step HASH checking
  option of IMS High Performance Image Copy (HPIC).
  + Note --------------------------------------------------+
  | To use a DEPDIST keyword, APAR PK97330 must be applied |
  | to HPIC.                                               |
  +--------------------------------------------------------+

3. Before this APAR, the following three values were not set in
   History record when HDPC runs in the Single-step HASH
   checking option of HPIC.

  By this APAR, the values are set when DEPDIST is specified
  in ICEIN keyword.
  - HITRWODP
      The number of root segment occurrences that do not have
      dependent segment within the same block.
  - HIDPWORT
      The number of dependent segment occurrences that are
      in the different block from the root segment occurrence.
  - HIAVGDPR
      The average number of dependent segment occurrences that
      are in the same block as the root segment occurrence.

  In addition, a new equation is added to the HIRPTF2 field
  of the HISTORY record:
  - HIRDEPD  EQU   X'08'
  It is a flag for showing DEPDIST is specified or not.

  When DBHDA processes the HISTORY records with the above
  values, DBHDA prints the values in the following lines
  of HD Analysis report:
  - ROOTS WITH NO DEPENDENTS IN SAME BLOCK
  - AVG. COUNT OF DEPS IN SAME BLK AS ROOT
  - DEPENDENTS NOT IN SAME BLOCK WITH ROOT

  When Export Utility processes the HISTORY records with the
  above values, Export Utility sets the following values in the
  exported flat records:
  - NO_OF_ROTWODEP
     The number of root segment occurrences that are in the
     same block as the dependent segment occurrences
  - NO_OF_DEPWOROT
     The number of dependent segment occurrences that are
     in different blocks than the root segment block
  - NO_OF_AVDEP
     The average count of dependent segment occurrences in the
     same block

4. When HISTORY data set has MULTIIMSID=YES attribute, DBHDA
   prints HD Analysis report in the data set group number 01
   format even if the data set group number is not 01.
   This APAR corrects this error.

Problem conclusion

  •

Temporary fix

  •

Comments

  • 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)
==============================================================
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
2.0        HD Pointer Checker
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--------------------------------------------------------------
2.2         Operating instruction for the HD Pointer Checker
            processor
2.2.3       Output
--------------------------------------------------------------
Table 16. was modified by "Update 4: June 2009".
And it is modified again by this APAR as follows:

  Report printed in HASH check option in IMS HPIC or IMS
  Parallel Reorganization:
    ICEIN HDPC= keywords and (HOMECHK=) keyword for printing
    report
  Report name:
    DB Record Distribution Statistics
  Description:
    DBDIST *
    HOMECHK=YES *
    CHAINDIST *
|   DEPDIST *
--------------------------------------------------------------
2.2.3.3    STATIPRT data set
2.2.3.3.12 DB Record Distribution Statistics report
--------------------------------------------------------------
The following descriptions are added:

  MAXIMUM ROOTS PER BLOCK
    The maximum number of root segments contained in one Block
    (OSAM DB) or CI (VSAM DB).

| BLOCKS WITHOUT ROOT SEGMENTS IN RAA
|   The number of blocks that do not have root segments in the
|   root addressable area (RAA).

  :

  AVERAGE ROOTS PER SYNONYM CHAINS
    The total number of synonym roots for synonym chains divided
    by the total number of synonym chains. Neither the number of
    roots nor the number of chains whose length is one is
    included.

| Summary of Dependent Segments Distribution: This part shows
| the summary of dependent segments distribution.
|
| NUMBER OF DEPENDENTS IN AS SAME BLOCK AS ROOT
|   The number of dependent segment occurrences that are in the
|   same block as root segment occurrence
|
| AVERAGE DEPS IN AS SAME BLOCK AS ROOT PER ROOT
|   The average number of dependent segment occurrences that are
|   in the same block as root segment occurrence
| NUMBER OF DEPENDENTS IN THE DIFFERENT BLOCK TO ROOT
|   The number of dependent segment occurrences that are locates
|   in the different block from root segment occurrence

The following report items are added to Figure 36.:

  - BLOCKS WITHOUT ROOT SEGMENTS IN RAA
  - SUMMARY OF DEPENDENT SEGMENTS DISTRIBUTION
    - NUMBER OF DEPENDENTS IN AS SAME BLOCK AS ROOT
    - AVERAGE DEPS IN AS SAME BLOCK AS ROOT PER ROOT
    - NUMBER OF DEPENDENTS IN THE DIFFERENT BLOCK TO ROOT
--------------------------------------------------------------
2.2.3.3.15 Partition Statistics report and
           Database Statistics report
--------------------------------------------------------------
The following descriptions are added:

  SIZE RANGE

    :

    Note: In the following cases, however, the size range might
    become less than 20 or the size range might not be fixed.
    - The maximum segment length specified in the SEGM statement
      for the DBD exceeds a certain value.
    - The segment length is distributed within a certain narrow
      range.

| "<= AVERAGE" in the SUMMARY OF VL SEGMENT SIZES marks the
| average length range.
|
| MORE THAN 90 PERCENT OF SEGMENT OCCURRENCES ARE INCLUDED IN
| THE RANGE xxxxxx - xxxxxx.
|   It shows the size range that more than 90% occurrences are
|   belong to.

The new items described above are added to Figure 39.:

  - <=AVERAGE
  - MORE THAN 90 PERCENT OF SEGMENT OCCURRENCES ARE INCLUDED IN
    THE RANGE xxxxxx - xxxxxx.
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
4.0        DB Historical Data Analyzer
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
--------------------------------------------------------------
4.2        Operating instructions for DB  Historical Data
           Analyzer in the MVS batch environment
4.2.4      Output
4.2.4.2    HISTPRT data set
4.2.4.2.5  HD Analysis report
--------------------------------------------------------------
The following descriptions are modified:

    ROOTS WITH NO DEPENDENTS IN SAME BLOCK

      :

      When the data set group is processed by the HASH check
|     function in FABPMAIN, this field shows N/A, because that
      function forces INCORE=NO.
|     When a DEPDIST keyword is not specified in the Single-step
|     HASH checking option of IMS High
|     Performance Image Copy, this field shows N/A.

    AVG. COUNT OF DEPS IN SAME BLK AS ROOT

      :

      When the data set group is processed by the HASH check
|     function in FABPMAIN, this field shows N/A, because that
      function forces INCORE=NO.
|     When a DEPDIST keyword is not specified in the Single-step
|     HASH checking option of IMS High
|     Performance Image Copy, this field shows N/A.

    DEPENDENTS NOT IN SAME BLOCK WITH ROOT

      :

      When the data set group is processed by the HASH check
|     function in FABPMAIN, this field shows N/A, because that
      function forces INCORE=NO.
|     When a DEPDIST keyword is not specified in the Single-step
|     HASH checking option of IMS High
|     Performance Image Copy, this field shows N/A.
--------------------------------------------------------------
4.3        Operating instructions for Export Utility
4.3.3      Input
4.3.3.3    FABGRECI data set
4.3.3.3.7  Field name
--------------------------------------------------------------
Table 54. is modified as flows:

  Field Name:
    NO_OF_ROTWODEP
  Description:
    The number of root segment occurrences that are in the same
    block as the dependent segment occurrences
    If you want to set this field, run HD Pointer Checker with
    the HASH=NO and INCORE=YES options
|   If you want to set this field, specify DEPDIST in the ICEIN
|   statement and run Single-step HASH checking option of IMS
|   High Performance Image Copy

  Field Name:
    NO_OF_DEPWOROT
  Description:
    The number of dependent segment occurrences that are in
    different blocks than the root segment block
    If you want to set this field, run HD Pointer Checker with
    the HASH=NO and INCORE=YES options
|   If you want to set this field, specify DEPDIST in the ICEIN
|   statement and run Single-step HASH checking option of IMS
|   High Performance Image Copy

  Field Name:
    NO_OF_AVDEP
  Description:
    Average count of dependent segment occurrences in the same
    block
    If you want to set this field, run HD Pointer Checker with
    the HASH=NO and INCORE=YES option
|   If you want to set this field, specify DEPDIST in the ICEIN
|   statement and run Single-step HASH checking option of IMS
|   High Performance Image Copy
--------------------------------------------------------------
7.1        Messages and codes
7.1.1      HD Pointer Checker
7.1.1.3    Messages
--------------------------------------------------------------
The following message is deleted:

  FABP1530W DISTRIBUTION OF DEPENDENT SEGMENTS IN ROOT BLOCK AND
  DISTRIBUTION OF DEPENDENT SEGMENTS BY SEGMENT CODE ARE NOT
  AVAILABLE.

APAR Information

  • APAR number

    PK96437

  • Reported component name

    IMS POINTER CHE

  • Reported component ID

    5655E0900

  • Reported release

    310

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2009-09-17

  • Closed date

    2009-10-08

  • Last modified date

    2009-11-04

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

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

    UK50917

Modules/Macros

  •    FABGANAL FABGHIR  FABGRHT  FABPDCT  FABPDDST
FABPHINI FABPHPSD FABPHSDA FABPLINK FABPMSGT FABPPSDA FABPRDEF
FABPSDA0 FABPSMT  FABPUDBR FABPUDTB FABPURTO FABUITCT HPC2310J

Publications Referenced
SC19240100

Fix information

  • Fixed component name

    IMS POINTER CHE

  • Fixed component ID

    5655E0900

Applicable component levels

  • R310 PSY UK50917

       UP09/10/14 P F910

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.

[{"Line of Business":{"code":null,"label":null},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89G","label":"IMS HP Pointer Checker"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1.0"}]

Document Information

Modified date:
03 April 2021

Page Feedback