PH11227: PROBLEM WITH DFHPGCR, WHICH NEVER COPIES THE UNCONVERTED BYTE INTO INCOMPLETE_DATA.

Obtain the fix for this APAR.

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 is sysrouted FROM one or more of the following:

  PH05533

• APAR is sysrouted TO one or more of the following:

  UI63493 UI63494

Modules/Macros

• DFHPGCR
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R000 PSY UI63494

     UP19/06/08 P F906

• R900 PSY UI63493

     UP19/06/08 P F906

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.