Fixes are available
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 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
R701 PSY
UP
Document Information
Modified date:
28 April 2022