IZ63971: CLIENT APPLICATION RECEIVES 2009 RETURN CODE WHEN TRYING TO GET LARGE MESSAGE FROM QUEUE: FDC WITH PROBE ID RM496003 OR RM496002

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • WebSphere MQ Client application at version 7.0.1.0 fails to get
    a message from a queue, receiving return code 2009.
    
    The problem occurs when a message is too large to be sent
    without segmenting (i.e. messages larger than about 32000
    bytes). Additional checking in the client code was added for
    WMQ 7.0.1.0 and is causing this problem to be encountered if
    the last segment has a small size (10's of bytes).
    
    When the problem is encountered, the client reports a protocol
    error FDC and closes the channel.
    
    An FDC with PROBE ID RM496003 (or RM496002 for XA client) is
    created. These FDC probes are the key discriminators as to
    whether you have encountered this problem, regardless of
    whether any other symptoms match. If one of these FDCs is
    written then it is extremely likely that you have encountered
    the problem.
    
    Below is part of an example FDC:
    
    | WebSphere MQ First Failure Symptom Report
    |
    | =========================================
    |
    |
    | Operating System  :- AIX 5.3
    | LVLS              :- 7.0.1.0
    |
    | Product Long Name :- WebSphere MQ for AIX
    |
    | Probe Id          :- RM496003
    |
    | Application Name  :- MQM
    |
    | Component         :- reqMakeCall
    |
    | SCCS Info         :- lib/client/amqrcafa.c, 1.220
    |
    | Program Name      :- myget
    
    
    
    | Major Errorcode   :- rrcE_PROTOCOL_ERROR
    |
    | Minor Errorcode   :- OK
    |
    | Probe Type        :- MSGAMQ9504
    |
    | Probe Severity    :- 2
    |
    | Probe Description :- AMQ9504: A protocol error was detected
    for
    channel ''. |
    | FDCSequenceNumber :- 0
    |
    |
    |
    +-------------------------------------------------------------
    
    MQM Function Stack
    MQGET
    MQGET
    reqMakeCall
    xcsFFST
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Customers using WMQ 7.0.1.0 client programs to get messages
    larger than about 32000 bytes are exposed to this problem.
    
    Whether the problem occurs or not depends on the size of the
    message. There will be a small interval of sizes repeating
    every 32768 bytes for which a protocol error will incorrectly
    be reported.
    
    Platforms affected:
    All Distributed (iSeries, all Unix and Windows)
    ****************************************************************
    PROBLEM SUMMARY:
    Additional checking of client received messages was incorrect,
    leading to spurious reports of protocol errors for perfectly
    valid flows.
    

Problem conclusion

  • The additional checking has been corrected.
    
    | MDVREGR 7.0-WS-MQ-Windows-RP0001        |
    | MDVREGR 7.0-WS-MQ-SolarisX64-RP0001     |
    | MDVREGR 7.0-WS-MQ-SolarisSparc64-RP0001 |
    | MDVREGR 7.0-WS-MQ-LinuxX64-RP0001       |
    | MDVREGR 7.0-WS-MQ-LinuxS390X-RP0001     |
    | MDVREGR 7.0-WS-MQ-LinuxPPC64-RP0001     |
    | MDVREGR 7.0-WS-MQ-LinuxIA32-RP0001      |
    | MDVREGR 7.0-WS-MQ-HpuxPaRISC64-RP0001   |
    | MDVREGR 7.0-WS-MQ-HpuxIA64-RP0001       |
    | MDVREGR 7.0-WS-MQ-AixPPC64-RP0001       |
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
                       v7.0
    Platform           Fix Pack 7.0.1.1
    --------           --------------------
    Windows            U200310
    AIX                U827232
    HP-UX (PA-RISC)    U826485
    HP-UX (Itanium)    U826884
    Solaris (SPARC)    U827125
    Solaris (x86-64)   U827374
    iSeries            tbc_p700_0_1_1
    Linux (x86)        U826321
    Linux (x86-64)     U827231
    Linux (zSeries)    U827105
    Linux (Power)      U826779
    
    The latest available maintenance can be obtained from
    'WebSphere MQ Recommended Fixes'
    http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037
    
    If the maintenance level is not yet available, information on
    its planned availability can be found in 'WebSphere MQ
    Planned Maintenance Release Dates'
    http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
    ---------------------------------------------------------------
    

Temporary fix

Comments

APAR Information

  • APAR number

    IZ63971

  • Reported component name

    WMQ AIX V7

  • Reported component ID

    5724H7221

  • Reported release

    701

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2009-10-28

  • Closed date

    2009-11-04

  • Last modified date

    2010-04-08

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

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

    PM00426

Fix information

  • Fixed component name

    WMQ AIX V7

  • Fixed component ID

    5724H7221

Applicable component levels

  • R701 PSY

       UP



Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

WebSphere MQ
APAR / Maintenance

Software version:

7.0.1

Reference #:

IZ63971

Modified date:

2010-04-08

Translate my page

Machine Translation

Content navigation