IBM Support

IT27439: Setting MQ client CCSID to 1200 causes connections to fail with 2059 or 2540

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

  • If you set the CCSID to 1200 either in the CHANNELS stanza of
    the mqclient.ini or via the equivalent app.config setting,
    connection to MQ fails with MQRC 2059 (MQRC_Q_MGR_NOT_AVAILABLE)
    or 2540 (MQRC_UNKNOWN_CHANNEL_NAME) and the reason for this is
    not apparent.
    
    The connection failure (2059/2540) is caused by conversion
    failure.
    

Local fix

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    Users who set CCSID to 1200 in CHANNEL stanza of mqclient.ini
    file.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    When CCSID is set to 1200 in CHANNEL stanza of mqclient.ini and
    any C or .Net application is used then connection fails with
    2059(MQRC_QMGR_NOT_AVAILABLE) in .Net application and
    2540(MQRC_UNKNOWN_CHANNEL_NAME) in C application.
    
    The 1200 CCSID is not supported for internal Queue Manager
    communication, since UTF-16 and UTF-32 is not supported.
    

Problem conclusion

  • The MQ client code has been updated so that an error is reported
    if anything other than a valid single byte CCSID is specified in
    the mqclient.ini.
    If anything other than a valid single byte CCSID is used, then
    connection would end with 2539(MQRC_CHANNEL_CONFIG_ERROR).
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v8.0       8.0.0.13
    v9.0 LTS   9.0.0.8
    v9.1 CD    9.1.3
    v9.1 LTS   9.1.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

    IT27439

  • Reported component name

    IBM MQ BASE MP

  • Reported component ID

    5724H7251

  • Reported release

    800

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2018-12-19

  • Closed date

    2019-07-12

  • Last modified date

    2019-07-30

  • 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

    IBM MQ BASE MP

  • Fixed component ID

    5724H7251

Applicable component levels

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYHRD","label":"IBM MQ"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"8.0.0.0","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
30 July 2019