PK74388: ERROR MESSAGE HFPR3045E RECEIVED RUNNING EXTRACT WITH FORMAT=USER

APAR status

• Closed as program error.

Error description

• MSGHFPR3045E received when running an Extract with FORMAT=USER.
  Error message text is:
  HFPR3045E BUFFER POOL RELEASE FAILURE FOR:      TCT: FTT00001
  MODULE: HFPFTSK0
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of High Performance Fast Path      *
  *                 Utilities Fast Path Advanced Tool Version 3  *
  *                 Release 2 (FMID: H31A320).                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: 1.MSGHFPR3045E received when running    *
  *                      the Extract function with FORMAT=USER.  *
  *                      2. MSGHFPM3062E is unclear when the     *
  *                      data set listed within the EXITLIB for  *
  *                      the Unload, the Reload or the Change    *
  *                      function is not APF-authorized.         *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR includes the following two problems:
  1. MSGHFPR3045E received when running the Extract function with
     FORMAT=USER because of a buffer handling error.
  2. MSGHFPM3062E is unclear when the data set listed within the
     EXITLIB for the Unload, the Reload or the Change function is
     not APF-authorized.
  

Problem conclusion

• This APAR solves the following two problems:
  1. MSGHFPR3045E received when running the Extract function with
     FORMAT=USER.
     There is a buffer handling error when SEGREC_PREFIX is
     specified in HFPSYSIN and the prefix length is short.
     The buffer handling process is modified correctly.
  2. MSGHFPM3062E is unclear when the data set listed within the
     EXITLIB for the Unload, the Reload or the Change function is
     not APF-authorized. The new subtext of MSGHFPM3062E is added
     to make it clear.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS High Performance Fast Path Utilities for z/OS User's
  Guide Volume 1: Fast Path Advanced Tool Version 3 Release 2
  (SC18-9869-03).
  
  Chapter2. Past Path Advanced Tool
   JCL control language(JCL)
    DD statements
     Input
  
     EXITLIB DD
      The second sentence should be changed as follows:
  
      This DD statement is used when one of the following
      conditions is met:
      - The EXITRTN keyword is specified for the UNLOAD or the
        RELOAD command.
      - The IEXITRTN or the OEXITRTN keyword is specified for the
        CHANGE command.
  
      The following lines should be added as follows:
  
      All of the data sets that are listed within the EXITLIB
      concatenation must be APF-authorized.
  
     IMSRESLB DD
      The following lines should be added as follows:
  
      All of the data sets that are listed within the IMSRESLB
      concatenation must be APF-authorized.
  
     OLDRESLB DD
      The following lines should be added as follows:
  
      All of the data sets that are listed within the OLDRESLB
      concatenation must be APF-authorized.
  
     NEWRESLB DD
      The following lines should be added as follows:
  
      All of the data sets that are listed within the NEWRESLB
      concatenation must be APF-authorized.
  
  Appendix A. Command reference
    EXITRTN
  
    The following description should be added in the first
    paragraph:
    You may provide an EXITLIB DD statement when this keyword is
    specified. If not, you must specify the library that contains
    the user exit routine in JOBLIB/STEPLIB DD.
  
    The first sentence of "Requirement:" described below should be
    deleted.
  
    You must provide an EXITLIB DD statement when this keyword is
    specified.
  
    IEXITRTN
  
    The following description should be added in the first
    paragraph:
    You may provide an EXITLIB DD statement when this keyword is
    specified. If not, you must specify the library that contains
    the user exit routine in JOBLIB/STEPLIB DD.
  
    The first sentence of "Requirement:" described below should be
    deleted.
  
    You must provide an EXITLIB DD statement when this keyword is
    specified.
  
    OEXITRTN
  
    The following description should be added in the first
    paragraph:
    You may provide an EXITLIB DD statement when this keyword is
    specified. If not, you must specify the library that contains
    the user exit routine in JOBLIB/STEPLIB DD.
    The first sentence of "Requirement:" described below should be
    deleted.
  
    An EXITLIB DD statement must be provided when this keyword is
    specified.
  
  
  Appendix H. Message and Codes
    HFPM messages
  
  The new subtext of message HFPM3061E is added.
  - FROM ddname (REASON: NOT APF-AUTHORIZED)
  
  The new subtext of message HFPM3062E is added.
  - FROM ddname (REASON: NOT APF-AUTHORIZED)
  
  The new subtext of message HFPM3360E is added.
  - FROM ddname (REASON: NOT APF-AUTHORIZED)
  320Y
  HFPFTTI0
  HFPFTTU0
  HFPJINI0
  HFPMAPF0
  HFPMELD0
  HFPMEXL0
  HFPUICS
  HFPUICSD
  HFPUICS0
  HFPUMVT0
  HFPWMTM0
  HFPZFTT
  HFPZMVT
  H31A320J
  

Temporary fix

Comments

• ×**** PE08/12/02 PTF IN ERROR. SEE APAR PK76773  FOR DESCRIPTION
  ×**** PE09/06/25 PTF IN ERROR. SEE APAR PK89910  FOR DESCRIPTION
  

APAR Information

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

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

  UK41566

Modules/Macros

•    HFPFTTI0 HFPFTTU0 HFPJINI0 HFPMAPF0 HFPMELD0
  HFPMEXL0 HFPUICS  HFPUICSD HFPUICS0 HFPUMVT0 HFPWMTM0 HFPZFTT
  HFPZMVT  H31A320J
  

Fix information

• Fixed component name

  IMS HP FP UTILI

• Fixed component ID

  5655K9400

Applicable component levels

• R320 PSY UK41566

     UP08/11/15 P F811