PI56626: WMQ MQRC_ADAPTER_STORAGE_SHORTAGE 2127 RETURNED WHEN APPLICATION CODE IS LINKED WITH CSQBRRSI STUB

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Memory leak is observed in Subpool 2 Key 8 for LE HEAP storage
  when an application (using native bindings) executes API calls
  to MQ through the CSQBRRSI stub. In this case the application
  is active for long periods. Change Team finds that, when linked
  with CSQBRSSI, an application issuing MQDISC causes CSQBDSC to
  be invoked which is expected to delete any message handles
  associated with the hConn however this deletion is not taking
  place (Note that linking an application with CSQBRSTB has the
  same unexpected effect).
  .
  Additional keywords:
  SP2 KEY8
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of WebSphere MQ for z/OS Version 8 *
  *                 Release 0 Modification 0.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: MQRC 2127 MQRC_ADAPTER_STORAGE_SHORTAGE *
  *                      returned by MQCRTMH when using RRS      *
  *                      stubs due to message handle storage     *
  *                      remaining allocated.                    *
  *                      Other symptoms include storage shortage *
  *                      in the application address space.       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When an application linked with an RRS stub calls MQCRTMH to
  create message handles associated with a hconn, and subsequently
  calls MQDISC without calling MQDLTMH to explicitly delete the
  message handles, the message handles are not implicitly deleted.
  The message handles (and any associated message properties
  control blocks) remain allocated using storage in the
  application address space until the task that issued MQCONN
  terminates.
  In applications that use long running tasks that repeatedly
  connect and disconnect from the queue manager, this can lead
  to an accumulation of storage for these message handles.
  This can lead to a short of storage condition occurring for the
  application address space, preventing further message handles
  being created, and causing unpredictable results for the
  application.
  

Problem conclusion

• CSQBDSC is changed to correctly delete message handles
  associated with the connection being disconnected when called
  from an application linked with an RRS stub.
  000Y
  CSQBDSC
  

Temporary fix

• *********
  * HIPER *
  *********
  

Comments

APAR Information

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

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

  UI35651

Modules/Macros

• CSQBDSC
  

Fix information

• Fixed component name

  WMQ Z/OS 8

• Fixed component ID

  5655W9700

Applicable component levels

• R000 PSY UI35651

     UP16/04/12 P F604 ¢

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.