PK00570: HPFP REORG KEYWORD EXISTS WHEREAS AN UNLOADED SEGMENT RECORD DATA SET DOESN'T INCLUDE AN AREA INFORMATION RECORD IN UNLOAD.

APAR status

• Closed as new function.

Error description

• HPFP Reorganization provides a keyword that an unloaded segment
  record data set does not include an area information record
  in Unload process.
  

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 a new      *
  *                      keyword AREA_INFORMATION_RECORD for     *
  *                      UNLOAD command.                         *
  *                      When AREA_INFORMATION_RECORD=NO is      *
  *                      specified, an unloaded segment record   *
  *                      data set does not include an area       *
  *                      information record.                     *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  HPFP Reorganization provides a new keyword AREA_INFORMATION_
  RECORD for UNLOAD command.
  When AREA_INFORMATION_RECORD=NO is specified, an unloaded
  segment record data set does not include an area information
  record.
  

Problem conclusion

Temporary fix

Comments

• HPFP Reorganization has been enhanced to add a new keyword
  AREA_INFORMATION_RECORD for UNLOAD command.
  AIR is an alias of AREA_INFORMATION_RECORD.
  AREA_INFORMATION_RECORD=YES|NO is allowed.
  
  When AREA_INFORMATION_RECORD=YES is specified, an unloaded
  segment record data set includes an area information record.
  When AREA_INFORMATION_RECORD=NO is specified, an unloaded
  segment record data set does not include an area information
  record.
  
  RELOAD can't process the unloaded segment record data set
  created with AREA_INFORMATION_RECORD=NO.
  
  The module HFPCCDT0 has been modified to add a new
  AREA_INFORMATION_RECORD keyword entry to Command Definition
  Table (CDT).
  
  The module HFPCDEF0 has been modified to add a new
  AREA_INFORMATION_RECORD keyword default entry to Default
  Entry Table.
  
  The module HFPJINI0 has been modified to bypass to write
  an area information record when AREA_INFORMATION_RECORD=NO
  is specified.
  
  The module HFPJOMN0 has been modified to bypass to write
  an area information record when AREA_INFORMATION_RECORD=NO
  is specified.
  
  The module HFPLRPT0 has been modified to output the following
  text to "Output file report" in HFPRPTS data set when an area
  information record are not written.
  
   - NO AREA INFORMATION RECORD EXISTS IN THIS USR FILE.
  
  The module HFPLCCT0 has been modified to add the
  AREA_INFORMATION_RECORD keyword specified parameter value
  information to "Processing report" UNLOAD PROCESSING OPTION
  in HFPRPTS data set.
  
  The macro HFPZCCT has been modified to add new field to save a
  value of AREA_INFORMATION_RECORD keyword.
  
  The macro HFPZROB has been modified to define a text which
  is written to "Output file report" in HFPRPTS data set
  by HFPLRPT0.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  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:
  
  Chapter 3. HPFP Reorganization command
    Keywords
  
    New keyword AREA_INFORMATION_RECORD should be added to
    Table 26. HFPSYSIN commands, subcommands, and keywords as
    an UNLOAD command first keyword.
  
  
  +--------+-------+-------+-------------------------------------+
  | UNLOAD |       |AREA_IN|Specifies whether an area information|
  |        |       |FORMATI|record is included in an unloaded    |
  |        |       |ON_RECO|segment record data set or not.      |
  |        |       |RD     |                                     |
  +--------+-------+-------+-------------------------------------+
  
  Chapter 5. Unloading a DEDB
    Input for Unload
     HFPSYSIN data set
      UNLOAD command keywords
  
      New keyword AREA_INFORMATION_RECORD should be added to
      Figure 10. UNLOAD command keywords.
  
       AREA_INFORMATION_RECORD
  
      AREA_INFORMATION_RECORD keyword should be added as follows:
  
      AREA_INFORMATION_RECORD
    An optional keyword that specifies whether an area
    information record is included in an unloaded segment
    record data set or not. AIR is an alias of this keyword.
    For information about coding this parameter,
    see "AREA_INFORMATION_RECORD" in Appendix A. Command
    reference.
  
  Appendix A. Command reference
  
  
      AREA_INFORMATION_RECORD keyword should be added as follows:
  
      AREA_INFORMATION_RECORD
  
  Use this keyword to specify whether an area information
  record is included in an unloaded segment record data set
  or not.
  
         AREA_INFORMATION_RECORD is an optional keyword for the
         UNLOAD command.
         AIR is an alias of AREA_INFORMATION_RECORD.
  
         Related keywords:
             None.
  
         Format:
  
  +------------------------------------------------------+
  | AREA_INFORMATION_RECORD=parameter                    |
  +------------------------------------------------------+
  
  parameter
           parameter can be one of the following values:
  
           YES
             Specify that an area information record is
             included in an unloaded segment record data set.
  
           NO
             Specify that an area information record is not
             included in an unloaded segment record data set.
  
  
         Default:
             AREA_INFORMATION_RECORD=YES
  

APAR Information

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

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

  UK05338

Modules/Macros

•    HFPCCDT0 HFPCDEF0 HFPCKWD  HFPJINI0 HFPJOMN0
  HFPLCCT0 HFPLDBR0 HFPLINF0 HFPLLCT0 HFPLOFT0 HFPLRPT0 HFPLSEG0
  HFPLTOT0 HFPMAIN0 HFPUROB0 HFPUWLD0 HFPZCCT  HFPZROB
  

Fix information

• Fixed component name

  IMS HP FP UTILI

• Fixed component ID

  5655K9400

Applicable component levels

• R210 PSY UK05338

     UP05/07/14 P F507