A fix is available
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 number
PH06213
Reported component name
IBM MQ Z/OS V9
Reported component ID
5655MQ900
Reported release
100
Status
CLOSED PER
PE
NoPE
HIPER
YesHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2018-12-06
Closed date
2019-02-01
Last modified date
2019-03-01
APAR is sysrouted FROM one or more of the following:
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.
[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"100","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]
Document Information
Modified date:
01 March 2019