A fix is available
APAR status
Closed as program error.
Error description
When a channel is shipped over an IRLINK, large containers will get broken up into small blocks (32K-1). The first and last block may be even in length but all the blocks in the middle are X'7FFF'. If a shipped container contains UTF16 data, it will (by default) get converted into the LOCALCCSID (1141 in this case) when a EXEC CICS GET CONTAINER command is issued. This requires a conversion from 2-bytes / character (UTF16) to 1-byte (1141). As the container has been broken up into blocks, several codepage conversion calls are made to convert each one. If the conversion routine is passed a block of size X'7FFF', it will only be able to convert X'7FFE'. It does this and returns an exception of SOURCE_DATA_INCOMPLETE. DFHPGCR (which is converting the container) detects this and attempts to pre-pend the next block with any unconverted bytes from the previous block. In this scenario we only ever have 1 unconverted byte. This is the first byte of a UTF-16 character. In this scenario this always happens to be X'00'. DFHPGCR is supposed to copy this byte to a local area called INCOMPLETE_DATA. This area is eventually inserted in front of the next block and DFHPGCR will ask DFHCV64 to convert 1 more byte on the next CONVERT_DATA call (X'8000' bytes instead of X'7FFF'). The problem is that DFHPGCR never actually copies the unconverted byte into INCOMPLETE_DATA.
Local fix
N/A
Problem summary
**************************************************************** * USERS AFFECTED: All CICS Users. * **************************************************************** * PROBLEM DESCRIPTION: Possible unconverted bytes when using * * CICS containers over an IRLINK. * **************************************************************** It is possible to have some unconverted bytes when using CICS containers over an IRLINK. This will be seen if the container is larger than 32767 and data conversion takes place. This is because the container data has to be split up into 32767 chunks when being flowed across the network. When joining these chunks together on the receiving side and it is being converted from DBCS some bytes may not be converted.
Problem conclusion
DFHPGCR has been changed to ensure all data is converted.
Temporary fix
Comments
APAR Information
APAR number
PH05533
Reported component name
CICS TS Z/OS V5
Reported component ID
5655Y0400
Reported release
100
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2018-11-20
Closed date
2019-02-28
Last modified date
2019-04-18
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI61567 UI61568 PH11227
Modules/Macros
DFHPGCR DFHXCCR
Fix information
Fixed component name
CICS TS Z/OS V5
Fixed component ID
5655Y0400
Applicable component levels
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.4","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"5.4","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
18 April 2019