PK81266: FPA CAN HANG WHEN DOING PROCESSING WITH A LARGE NUMBER OF TASKS

APAR status

• Closed as program error.

Error description

• Fast Path Analyze can hang in HFPRSRB0 near x'5B0' when
  processing is taking place using more than approximately
  100 tasks.  The wait is due to a logic problem in message
  buffer handling.
  

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. FPA hangs when processing is taking  *
  *                         place using more than 100 tasks.     *
  *                      2. FPA can hang when processing is      *
  *                         taking place using more than         *
  *                         approximately 100 tasks.             *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR includes the following two problems:
  1. FPA (Fast Path Advanced Tool) task termination process gets a
     message buffer. But FPA does not free the message buffer.
     In addition, FPA prepares only 100 message buffers
     constantly.
     Therefore, FPA hangs when processing is taking place using
     more than 100 tasks.
  2. FPA can hang when processing is taking place using more than
     approximately 100 tasks, because FPA prepares only 100
     message buffers constantly.
  

Problem conclusion

• This APAR solves the following two problems:
  1. FPA task termination process has been modified to do not get
     a message buffer.
  2. FPA has been modified to obtain the message buffers depending
     on task count.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS High Performance Fast Path Utilities for z/OS User's
  Guide Version 3 Release 2 (SC18-9869-04).
  
  Chapter 48. Messages and codes of IMS HPFPU
  
  HFPM messages
  
  The following message should be added as follows:
  ----------------------------------------------------------------
  HFPM0003E STORAGE OBTAIN FAILURE FOR MAIN PROCESS.
            - MESSAGE BUFFER POOL
  
  Explanation: GETMAIN to obtain space for internal blocks failed.
  System action: The return code is set to 8 and processing
  continues.
  Programmer response: If the region size that is specified is too
  small, increase the REGION size in the JOB statement in the JCL,
  and rerun the utility.
  320Y
  HFPMCCC0
  HFPWMSG0
  HFPWMTM0
  HFPWPRC0
  

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:

  UK44467

Modules/Macros

•    HFPMCCC0 HFPWMSG0 HFPWMTM0 HFPWPRC0
  

Fix information

• Fixed component name

  IMS HP FP UTILI

• Fixed component ID

  5655K9400

Applicable component levels

• R320 PSY UK44467

     UP09/03/04 P F903