PH39831: IMPROVE HANDLING OF MQRC_STORAGE_NOT_AVAILABLE CONDITION WHEN ATTEMPTING TO ALLOCATE BUFFER IN ALLY ADDRESS SPACE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• If STORAGE OBTAIN for an AMS buffer allocation fails, some
  callers of this function may not gracefully handle MQRC 2071.
  
  For an MQGET from a shared local queues, this may lead to an
  ABEND 5C6-00C9FEEE. For an MQGET from a shared local queues,
  this may lead to an ABEND 5C6-00D40017.
  

Local fix

• If possible, allocate sufficient region size to the allied
  address space
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
  *                 Release 3 Modification 0.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: When getting a message from an AMS      *
  *                      protected queue a 5C6 abend is thrown   *
  *                      when storage in the application address *
  *                      space is exhausted.                     *
  *                                                              *
  *                      - For private queues the abend is       *
  *                        5C6-00D40017                          *
  *                                                              *
  *                      - For shared queues the abend is        *
  *                        5C6-00C9FEEE                          *
  ****************************************************************
  The return code from a STORAGE OBTAIN that was not able to
  obtain any storage in the application address space was not
  being handled correctly and as a result 5C6 abends were thrown.
  

Problem conclusion

• The return code from the STORAGE OBTAIN that is not able to
  obtain any storage in the application address is now being
  handled correctly and is passed back to the application as
  return code MQRC_STORAGE_NOT_AVAILABLE.
  
  The following page on the V9.3 IBM MQ Documentation:
  
  IBM MQ
   -> Reference
     -> Messages and Reason Codes
       -> API completion and reason codes
         -> API reason codes
           -> 2071 (0817) (RC2071): MQRC_STORAGE_NOT_AVAILABLE
  
  https://www.ibm.com/docs/en/ibm-mq/9.3?topic=codes-2071-0817-rc
  2071-mqrc-storage-not-available
  
  Will have the following text added to the section labeled
  'Programmer response' as a new bullet point with the z/OS tag:
  
  - This return code can be seen as a result of exhausting all
  storage in the application address space.
  

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:

  UI82316

Modules/Macros

• CSQIMGES CSQMGET
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R300 PSY UI82316

     UP22/09/17 P F209

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.