IBM Support

IT04039: WEBSPHERE MQ FTE ERROR: BFGIO0189E UNABLE TO CONVERT THE CHARACTER SET 'IBM01141' TO A CODED CHARACTER SET ID

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • WMQ-FTE requests a transfer from file to queue, where the
    destination agent is running on z/OS and using a JVM default
    "file.encoding" value of "IBM01141".
    
    WMQ-FTE requests via the WebSphere MQ Java classes to perform
    character conversation of the file to the "IBM01141" file
    encoding. This fails as this Charset name is not known by the
    WebSphere MQ Java classes - in that they do not contain a
    mapping for this Charset name to a IBM CCSID value (which is
    1141).
    
    WMQ-FTE requests a second transfer, again file to queue, but
    this time specifying that the file should be encoded on the
    queue using the Java Charset encoding value of "IBM-1141". This
    is known by the
    WebSphere MQ Java classes to map to the CCSID value 1141, and so
    this transfer
    succeeds.
    
    As part of the initialisation of this Charset to CCSID map for
    this character encoding, the WebSphere MQ Java classes also
    check to see what the formal Charset name is for the recognised
    Charset,
    which happens to be "IBM01141", and this is dynamically added to
    the map for future use.
    
    
    WMQ-FTE requests a third transfer which matches the first, which
    is a transfer from file to queue, again using the JVM default
    file.encoding value of "IBM01141". However this time, as the
    second transfer added this name to the Charset -> CCSID map
    table, the entry is recognised
    and the transfer succeeds.
    

Local fix

  • n/a
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users of the WebSphere MQ classes for
    Java/JMS at versions:
    
      v7.0
      v7.1
      v7.5
    
    v8.0 is NOT affected by this problem.
    
    The affected users include users of WebSphere MQ FTE/MFT, and
    users of the WebSphere MQ Resource Adapter (WMQ-RA) as used by
    application servers such as the WebSphere Application Server.
    
    
    Platforms affected:
    AIX, HP-UX Itanium, HP-UX PA-RISC, IBM iSeries, Linux on Power,
    Linux on x86, Linux on x86-64, Linux on zSeries, Solaris SPARC,
    Solaris x86-64, Windows, z/OS, MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    The WebSphere MQ classes for Java/JMS include a class which
    function is to provide a mapping between the codepage names as
    used by Java (java.nio.charset.Charset names), and those used by
    WebSphere MQ (Coded Character Set Identifier, or CCSID).
    
    This map is used for example when sending character data which
    is to be encoded in a particular Java Charset name, such as
    "IBM01141", to WebSphere MQ where the data encoding needs to be
    defined in terms of a CCSID number, which is CCSID 1141 for the
    IBM01141 Charset name.
    
    
    This map is generated at product compilation time using the
    available Charset names for the build machine's specific JDK. At
    runtime, more Charset names may be available that were at
    compilation time, from the use of later levels of the JRE or
    from different Java vendors.
    
    The consequence of this is that the map needs updating to
    include new entries over time.
    
    
    The entry which is addressed by this specific APAR is the
    mapping:
    
    CCSID 1141
    Charset name: "IBM01141"
    
    
    This problem was reported by a user of the WebSphere MQ FTE
    7.0.4 product, which when doing a file transfer from file to
    queue makes use of this map class from the WebSphere MQ classes
    for Java/JMS to determine the appropriate CCSID value for the
    desired character encoding. The error message output for this
    failed transfer was:
    
    BFGIO0189E: Unable to convert the character set 'IBM01141' to a
    coded character set ID.
    

Problem conclusion

  • The mapping class used by the WebSphere MQ classes for Java/JMS
    have been updated to include an entry which maps the Charset
    name "IBM01141" to the CCSID value 1141.
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v7.0       7.0.1.13
    v7.1       7.1.0.7
    v7.5       7.5.0.5
    
    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

    IT04039

  • Reported component name

    WMQ WINDOWS V7

  • Reported component ID

    5724H7220

  • Reported release

    701

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2014-09-02

  • Closed date

    2014-10-14

  • Last modified date

    2014-10-14

  • 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

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSFKSJ","label":"WebSphere MQ"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.0.1","Line of Business":{"code":"LOB36","label":"IBM Automation"}}]

Document Information

Modified date:
29 June 2020