IBM Support

IT23169: Pub/sub MQGET returns warning with reason code 2111 MQRC_SOURCE_CCSID_ERROR

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

APAR status

  • Closed as program error.

Error description

  • The subscriber app called MQGET with MQGMO_CONVERT.
    
    The message contained headers with (header).CodedCharSetId =
    MQCCSI_INHERIT.
    
    The MQGET call incorrectly returned the unconverted message to
    the application with warning completion and reason codes
    (CompCode = MQCC_WARNING, Reason = MQRC_SOURCE_CCSID_ERROR).
    
    The correct behaviour is to convert the message.
    
    Also failure data capture (FDC) records might be written with
    details matching these:
    - VP028002 vwb_rf_header vrcE_BAD_CCSID_0
    - VP029002 vwb_rf_header_2 vrcE_BAD_CCSID_0
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Publish/subscribe applications where the message contains
    headers that use MQCCSI_INHERIT.  The problem does not affect
    point-to-point queued MQPUTs/MQGETs.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    The published message contained at least one MQ header in which
    the (header).CodedCharSetId was MQCCSI_INHERIT.
    
    MQCCSI_INHERIT has the value -2, and is not a real coded char
    set identifier.  Instead it is an instruction to the queue
    manager that it should replace the (header).CodedCharSetId with
    the value from the preceding header.
    
    The MQ code was not successfully changing the value to the
    correct coded char set identifier (CCSID), but was leaving the
    value of -2 in that position.
    
    The subscriber called MQGET with MQGMO_CONVERT.  Because the MQ
    code had not changed the value from -2 to a real valid CCSID,
    the MQGET returned the unconverted message to the application
    with warning completion and reason codes (CompCode =
    MQCC_WARNING, Reason = MQRC_SOURCE_CCSID_ERROR).
    

Problem conclusion

  • The MQ code has been corrected to ensure that the occurrences of
    MQCCSI_INHERIT are replaced with the correct CCSID, so avoiding
    the problem reported.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v7.5       7.5.0.9
    v8.0       8.0.0.9
    v9.0 CD    9.0.5
    v9.0 LTS   9.0.0.4
    
    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

    IT23169

  • Reported component name

    WEBSPHERE MQ 7.

  • Reported component ID

    5724H7240

  • Reported release

    750

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-11-15

  • Closed date

    2018-01-09

  • Last modified date

    2018-01-09

  • 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

    WEBSPHERE MQ 7.

  • Fixed component ID

    5724H7240

Applicable component levels



Document information

More support for: WebSphere MQ
APAR / Maintenance

Software version: 7.5

Reference #: IT23169

Modified date: 09 January 2018


Translate this page: