IBM Support

IC88154: WEBSPHERE MQ V7.0 CALL FAILS WITH MQRC_HEADER_ERROR USING IBM I QUEUE MANAGER AND MQDESTINATION.PUT()

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When using the Java API to put a message to a queue on an IBM
    i queue manager by using the MQDestination.put() method, the
    following exception occurs:
    
    com.ibm.mq.MQException: MQJE001: Completion Code '2', Reason
    '2142'.
    at java.lang.Throwable.<init>(Throwable.java:
    at java.lang.Exception.<init>(Exception.java:
    at com.ibm.mq.MQException.<init>(MQException.java:
    at com.ibm.mq.MQDestination.internalMQPUT(MQDestination.java:
    at com.ibm.mq.MQDestination.put(MQDestination.java:
    at com.ibm.mq.MQDestination.put(MQDestination.java:1072)
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users of the v7 WebSphere MQ classes for Java
    client on IBM i.
    
    Platforms affected:
    iSeries
    
    ****************************************************************
    PROBLEM SUMMARY:
    When a WMQ Message is put to a queue manager and that WMQ
    message contains 1 or more properties then an RFH2 header is
    created with the message.
    
    The RFH2 header is created using a CCSID of 1208 regardless of
    the platform but when the WebSphere MQ classes for Java
    attempted
    to send the WMQ Message it set the CCSID of the MQMD to be the
    default for the iSeries platform (37). This was incorrect as the
    MQMD CCSID is used to describe the next header which is the RFH2
    header. The exception is thrown because the IBM i Queue Manager
    was expecting the RFH2 header to be in CCSID 37 as defined in
    the MQMD.
    

Problem conclusion

  • This APAR solves the problem by making sure that the CCSID of
    the MQMD is correctly set to 1208 when an RFH2 header is
    present. The CCSID in the RFH2 header is then set to be the
    CCSID of the message payload or any following header.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
                       v7.0
    Platform           Fix Pack 7.0.1.10
    --------           --------------------
    iSeries            7.0.1.10
    
                       v7.1
    Platform           Fix Pack 7.1.0.3
    --------           --------------------
    iSeries            7.1.0.3
    
    Platform           v7.5
    --------           --------------------
    Multiplatforms     7.5.0.1
    
    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

    IC88154

  • Reported component name

    WMQ WINDOWS V7

  • Reported component ID

    5724H7220

  • Reported release

    701

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2012-11-12

  • Closed date

    2012-11-27

  • Last modified date

    2012-11-27

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

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

Fix information

  • Fixed component name

    WMQ WINDOWS V7

  • Fixed component ID

    5724H7220

Applicable component levels

  • R701 PSY

       UP

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSDEZSF","label":"IBM WebSphere MQ Managed File Transfer for z\/OS"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
31 March 2023