IBM Support

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

A fix is available

Subscribe

You can track all active APARs for this component.

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 0 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.0.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.0.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 number

    PI91809

  • Reported component name

    IBM MQ Z/OS V9

  • Reported component ID

    5655MQ900

  • Reported release

    000

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-12-21

  • Closed date

    2018-07-05

  • Last modified date

    2018-08-22

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

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

    UI57035 PH06213

Modules/Macros

  • CSQMDRTP
    

Fix information

  • Fixed component name

    IBM MQ Z/OS V9

  • Fixed component ID

    5655MQ900

Applicable component levels

  • R000 PSY UI57035

       UP18/07/25 P F807 ¢

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.



Document information

More support for: IBM MQ

Software version: 9.0

Reference #: PI91809

Modified date: 22 August 2018