PK57928: WHEN USING FPA ITASKCTL=N, FPA DOES A SORT BY DEFAULT EVEN IF SORT IS NOT NEEDED

APAR status

• Closed as new function.

Error description

• When using FPA ITASKCTL=N, FPA does a sort by default even if
  sort is not needed, such as the case when ITASKCTL=1.
  This issue is implemented as a result of FITS requirements
  MR0713072549.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of Fast Path Advanced Tool         *
  *                 Version 3 Release 1. (FMID: H31A310)         *
  ****************************************************************
  * PROBLEM DESCRIPTION: FPA judges whether the sort process for *
  *                      the output file is needed or not.       *
  *                      (FITS requirement MR0713072549)         *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  The UNLOAD and EXTRACT functions judge whether the sort process
  for the unloaded segment record file or the extracted output
  record file is needed or not when SORT=YES is specified.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS High Performance Fast Path Utilities for z/OS User's
  Guide Volume 1:Fast Path Advanced Tool Version 3 Release 1
  (SC18-9869-01) should be added as follows:
  
  Appendix A. Command reference
    SORT
     Format:
      YES
  
        For the UNLOAD command, this keyword is ignored when all
        of the following conditions are met:
         - A single area is unloaded into the file.
         - The SDEP=LOGICAL keyword is not specified in HFPSYSIN.
         - The Unload function is processed in the REORG mode.
  
        For the EXTRACT command, this keyword is ignored when
        both of the following conditions are met:
         - A single area is extracted into the file.
         - The database that is specified in DBD does not have
           an SDEP segment.
  
  Appendix H. Message and Codes
    HFPJ messages
  
  The new message HFPJ0013I is added.
  
  HFPJ0013I
  SORT PROCESS WAS SKIPPED FOR DDNAME: ddname.
  
  Explanation: The sort process was skipped for the unloaded
  segment record file or the extracted output record file that
  was specified in DD statement ddname.
  
  For the UNLOAD command, this message is issued when all of the
  following conditions are met:
   - A single area was unloaded into the file.
   - The SDEP=LOGICAL was not specified in HFPSYSIN.
   - The Unload function was processed in the REORG mode.
  
  For the EXTRACT command, this message is issued when both of
  the following conditions are met:
   - A single area was extracted into the file.
   - The database that was specified in DBD did not have an SDEP
     segment.
  
  System action: Processing continues.
  
  Programmer response: None.
  

APAR Information

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

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

  UK32444

Modules/Macros

•    HFPJOMN0 HFPWMTJ0 HFPZFCT
  

Fix information

• Fixed component name

  IMS HP FP UTILI

• Fixed component ID

  5655K9400

Applicable component levels

• R310 PSY UK32444

     UP07/12/21 P F712