PH06213: ABEND5C6-00C51059 OCCURS WHEN DOING A INQUIRE_QNAMES COMMAND WITH PCF.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• The Queue-Manager fails with an ABEND5C6-00C51059 whenever
  attempting to inquire a large number of queues via PCF in a QSG
  while specifying a CMDSCOPE (MQCACF_COMMAND_SCOPE) such as
  CMDSCOPE(*).
  
  Dump Title: CSQ1,ABN=5C6-00C51059,U=D030788,C=MQ###.###.CFM
          -CSQEWCMQ,M=CSQGFRCV,LOC=CSQELPLM.CSQEWCMQ
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IBM MQ for z/OS Version 9       *
  *                 Release 1 Modification 0.                    *
  ****************************************************************
  * PROBLEM DESCRIPTION: Abend 5C6-00C51059 in CSQEWCMQ and/or   *
  *                      abend 5C6-00E20001 in CSQSVBK occur     *
  *                      when processing a                       *
  *                      MQCMD_INQUIRE_QUEUE_NAMES command       *
  *                      issued with CMDSCOPE, if the number of  *
  *                      matching queues causes the response to  *
  *                      be larger than can be sent via the MQ   *
  *                      group server.                           *
  *                      After the abends occur, the group       *
  *                      command server no longer processes      *
  *                      any subsequent commands.                *
  ****************************************************************
  While building the response to an inquire names command, several
  PCF lists are built containing the names, types and dispositions
  of each match queue and these are added to the response message.
  
  If the command is processed by the group server (i.e. CMDSCOPE
  was used to route the command to qmgrs in the qsg), the response
  must be less than 32K. If the response is larger than this,
  the length fields are used incorrectly resulting in the
  reported abends.
  

Problem conclusion

• Additional validation is added to prevent the reported abends.
  If the response to a command is larger than supported, an
  error response will be returned with Reason Code 3230
  (MQRCCF_COMMAND_LENGTH_ERROR).
  
  
  The IBM MQ knowledge center is updated:
  "3230 (0C9E) (RC3230): MQRCCF_COMMAND_LENGTH_ERROR"
  https://www.ibm.com/support/knowledgecenter/SSFKSJ_9.1.0/
                                com.ibm.mq.tro.doc/q047460_.html
  The following statement is added:
  "This return code is also returned on z/OS if the internal form
  of the response is larger than supported when using CMDSCOPE"
  
  "Inquire Queue Names"
  https://www.ibm.com/support/knowledgecenter/SSFKSJ_9.1.0/
                              com.ibm.mq.ref.adm.doc/q087860_.html
  
  The description of the CommandScope parameter is updated to add:
  "
  When a value other than blank is specified, the maximum
  response size is limited to 32K from each queue manager.
  If the response from a queue manager would be larger than this
  an error response with Reason Code MQRCCF_COMMAND_LENGTH_ERROR
  (3230) is returned by that queue manager.
  "
  

Temporary fix

Comments

APAR Information

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

  PI91809

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

  UI61078

Modules/Macros

• CSQMDRTP
  

Fix information

• Fixed component name

  IBM MQ Z/OS V9

• Fixed component ID

  5655MQ900

Applicable component levels

• R100 PSY UI61078

     UP19/02/28 P F902 ¢

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.