IBM Support

PM87972: WEBSPHERE MQ V701, ABN=5C6-00D40025,U=****CHIN,C=R3600.701.MMC -CSQMHDRS,M=CSQGFRCV,LOC=CSQILPLM.CSQMHDRS+00003146

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • The 5C6-00D40025 abend issued by CSQMHDRS. The problem occurs
    when an MQGET is issued for a shared queue message which is
    larger than 511K (and therefore stored in multiple BLOBs in
    DB2) and which has an RFH2 which is larger than 511K (i.e. does
    not fit in the first BLOB).
    
    Abend 5C6-00E7014F can also be found after the 5C6-00D40025,
    ABN=5C6-00E7014F,C=R3600.701.CHIN,LOC=CSQXADPM.CSQXADPM +04D24
    
    
    
    Additional Symptom(s) Search Keyword(s): 5C6 00D40025 00E7014F
    CSQMHDRS CSQXADPM
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of WebSphere MQ for z/OS Version 7 *
    *                 Release 0 Modification 1 and Release 1       *
    *                 Modification 0.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Abend 5C6-00D40025,                     *
    *                      CSQM_ABEND_MMC_ERROR is issued by       *
    *                      CSQMHDRS when getting a message that    *
    *                      contains headers greater then 511K      *
    *                      in length from a shared queue that      *
    *                      offloads to DB2.                        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    When getting a message CSQMHDRS is called to process any
    headers in the message and parse any message properties found
    in the headers.
    If the message was stored on a shared queue, and offloaded to
    DB2, only the first 511K of the message is available to
    CSQMHDRS, and if the headers are longer than this parsing
    cannot continue and the reported abend is issued.
    

Problem conclusion

  • The limit of 511K of headers in a message put to shared queues
    that offload to DB2 is a permanent restriction.
    
    Validation is added to MQPUT processing to validate that the
    headers are no larger than 511K when putting to a shared queue
    at v701, or a shared queue with OFFLOAD(DB2) at v710.
    MQPUT will fail with MQRC_PROPERTIES_TOO_BIG (MQRC 2478) if a
    message with headers larger than this is put to such queues.
    
    At v710 messages containing >511K of headers are supported when
    put to shared queues with OFFLOAD(SMDS).
    
    The product infocenter is updated as follows:
    
    Explanation of return code 2478 in V701 must be changed to read
    as follows.
    http://publib.boulder.ibm.com/infocenter/wmqv7/v7r0/topic/com.ib
    m.mq.doc/fm20390_.htm
    
    Explanation
    An MQPUT or MQPUT1 call was issued to put a message on a queue,
    but the properties of the message were too large. The length of
    the properties cannot exceed the value of the
    MaxPropertiesLength queue manager attribute.
    This return code will also be issued if a message with headers
    greater than 511K is put to a shared queue.
    
    
    
    Explanation of return code 2478 in V710 must be changed to read
    as follows. Also programmer response needs updating.
    http://publib.boulder.ibm.com/infocenter/wmqv7/v7r1/topic/com.ib
    m.mq.doc/fm20390_.htm
    
    Explanation
    An MQPUT or MQPUT1 call was issued to put a message on a queue,
    but the properties of the message were too large. The length of
    the properties cannot exceed the value of the
    MaxPropertiesLength queue manager attribute.
    This return code will also be issued if a message with headers
    greater than 511K is put to a shared queue using OFFLOAD(DB2)
    
    Programmer Response
    Consider one of the following actions:
    Reduce the number or the size of the properties associated with
    the message. This could include moving some of the properties
    into application data.
    Increase the value of the MaxPropertiesLength queue manager
    attribute.
    If the message has a header greater than 511K and was written
    to a shared queue, consider using shared message data sets
    (SMDS) instead of DB2 as a means of offloading the data.
    010Y
    100Y
    CSQEMPUT
    CSQIMPUS
    CSQMCHKM
    CSQMPOM
    CSQMPRPF
    

Temporary fix

Comments

APAR Information

  • APAR number

    PM87972

  • Reported component name

    WMQ Z/OS V7

  • Reported component ID

    5655R3600

  • Reported release

    010

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2013-04-26

  • Closed date

    2013-09-30

  • Last modified date

    2013-11-04

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

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

    UK98052 UK98053

Modules/Macros

  • CSQEMPUT CSQIMPUS CSQMCHKM CSQMPOM  CSQMPRPF
    

Fix information

  • Fixed component name

    WMQ Z/OS V7

  • Fixed component ID

    5655R3600

Applicable component levels

  • R010 PSY UK98052

       UP13/10/16 P F310

  • R100 PSY UK98053

       UP13/10/16 P F310

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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
04 November 2013