PK02247: HPFP REORG PROVIDES AN INCORRECT USR WHEN NEWACB IS SPECIFIED AND THE RANDOMIZER SCATTERS SEGMENT RECORDS ACROSS AREAS.

APAR status

• Closed as program error.

Error description

• HPFP Reorganization provides an incorrect USR when NEWACB is
  specified and the randomizer scatters segment records across
  areas in a random fashion.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of High Performance Fast Path      *
  *                 Reorganization Tool Version 2 Release 1.     *
  *                 (FMID: H31A210)                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: HPFP Reorganization provides an         *
  *                      incorrect USR when NEWACB is specified  *
  *                      and the randomizer scatters segment     *
  *                      records across areas in a random        *
  *                      fashion.                                *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  1.When the database records are randomized and unloaded to
    several USR (Unloaded Segment Record) files from one area
    through the UNLOAD process, some unloaded segment records are
    included in to incorrect USR files.
  
  2.When the output area of randomized records is not specified
    with OAREA keyword and the area number is the same with
    original area, the module HFPJQUS0 gets ABEND with 0C4.
  
  3.The UNLOAD process of HPFP Reorganization provides a new
    message when some randomized DB records are not written to
    USR files relative to OAREA keyword.
  
  4.The number of segment records in RELOADED REPORT of HFPRPTS
    be possibly reported below the correct value when segments
    for multiple AREA are written into one USR file by multiple
    tasks at a time.
  

Problem conclusion

• 1.The module HFPJRND0 is modified to queue SR buffer, when the
    segment records are randomized to different areas and unload
    to different USR files which the previous segment records are
    unloaded.
  
  2.The module HFPJRND0 is modified to confirm that the new
    randomized area is specified with OAREA keyword or not.
  
  3.When some of new randomized area is not specified with OAREA
    keyword, following HFPJ0003I message is issued. And the number
    of DB records, that is not written to USR files, is reported
    in HFPRPTS after the report "NUMBER OF DB RECORDS THAT
    RELOADED AREANAME IS CHANGED BY RANDOMIZER."
  
    HFPJ0003I UNLOAD PROCESSING COMPLETED FOR AREA NO: nn,
    AREANAME: areaname WITH THE FOLLOWING CONDITION.
            - SOME RANDOMIZED DB RECORDS ARE NOT WRITTEN TO
    UNLOADED SEGMENT RECORD FILE.
  
  4.ST instruction is changed to CS instruction in case of
    updating the number of segment records of RELOADED REPORT.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS High Performance Fast Path Utilities for z/OS User's
  Guide Volume 1: High Performance Fast Path Reorganization
  Tool Version 2 Release 1 (SC18-7615-00) should be changed as
  follows:
  
  Appendix.B. Sample reports
  
  The following explanation of Figure 35. Unloaded report for
  unload is added.
  ---------------------------------------------------------------
  NUMBER OF DB RECORDS THAT RELOADED AREANAME IS CHANGED BY
  RANDOMIZER
       The number of records that the areaname is changed in
       randomizing process. This text is issued only in the case
       that randomizer is called.
  
       NUMBER OF DB RECORDS ARE NOT WRITTEN TO USR
            The number of records randomized into the new area
            that is not specified with OAREA keyword.
  
  Appendix.E. Messages and Codes
  Messages
  Unload process
  The following message should be changed to the latter.
  ---------------------------------------------------------------
  HFPJ0005W DB RECORD(S) RANDOMIZED TO DIFFERENT AREA FROM INPUT
            AREA NO: nnnn, AREANAME: areaname
  
  Explanation: The input area no. nnnn, area name areaname was
            randomized to be reloaded to another area as a result
            of calling the randomizer excepting for all areas
            specified with OAREA keyword. This message is issued
            only once for each area.
  
  System Action: The return code is set to 4 and processing
            continues.
  
  Programmer Response: If this is not the expected result, check
            the load library that contains the randomizer, correct
            the error, and rerun the job.
  
  The following description need to add after HFPJ0003I
  explanation.
  ---------------------------------------------------------------
  HFPJ0003I UNLOAD PROCESSING COMPLETED FOR AREA NO: nnnn,
            AREANAME: areaname WITH THE FOLLOWING CONDITION.
  
            - SOME RANDOMIZED DB RECORDS ARE NOT WRITTEN TO
  UNLOADED SEGMENT RECORD FILE.
  
  Explanation: The unload process for area number nnnn, area
            areaname has completed, but some of DB records were
            randomized to another area that is not specified with
            OAREA keyword.
  
  System Action: Processing continues.
  
  Programmer Response: None.
  210Y
  HFPJMAN0
  HFPJQUS0
  HFPJRND0
  HFPLINF0
  HFPUSNC0
  HFPWMTJ0
  HFPZACT
  

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:

  UK01900

Modules/Macros

•    HFPJMAN0 HFPJQUS0 HFPJRND0 HFPLINF0 HFPUSNC0
  HFPWMTJ0 HFPZACT
  

Fix information

• Fixed component name

  IMS HP FP UTILI

• Fixed component ID

  5655K9400

Applicable component levels

• R210 PSY UK01900

     UP05/04/06 P F504