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

Fix Pack 7.1.0.6 for WebSphere MQ V7.1
8.5.5.6: WebSphere Application Server V8.5.5 Fix Pack 6
8.5.5.7: WebSphere Application Server V8.5.5 Fix Pack 7
8.5.5.8: WebSphere Application Server V8.5.5 Fix Pack 8
8.5.5.9: WebSphere Application Server V8.5.5 Fix Pack 9
8.5.5.10: WebSphere Application Server V8.5.5 Fix Pack 10
8.5.5.11: WebSphere Application Server V8.5.5 Fix Pack 11
8.5.5.12: WebSphere Application Server V8.5.5 Fix Pack 12
8.5.5.13: WebSphere Application Server V8.5.5 Fix Pack 13
8.5.5.14: WebSphere Application Server V8.5.5 Fix Pack 14
8.5.5.15: WebSphere Application Server V8.5.5 Fix Pack 15
8.5.5.17: WebSphere Application Server V8.5.5 Fix Pack 17
8.5.5.20: WebSphere Application Server V8.5.5.20
8.5.5.18: WebSphere Application Server V8.5.5 Fix Pack 18
8.5.5.19: WebSphere Application Server V8.5.5 Fix Pack 19
8.5.5.16: WebSphere Application Server V8.5.5 Fix Pack 16
8.5.5.21: WebSphere Application Server V8.5.5.21

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 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