PK56145: CONTAINER DATA IS TRUNCATED WHEN LINK RETURNS IF DATA OVER 32K AND DATA CONTAINS A X'07'.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When using Channels and Containers to transfer binary data
  between programs on a CICS LINK, container data is truncated
  when the LINK returns if two conditions are met:
  (1) the data length is greater than 32,678
  (2) the byte at offset 32,669 contains x'07'.
  When the two conditions are met, the data is truncated to
  32,667.
  The client and server regions are connected via MRO.  Neither
  CICS regions receive error messages.  Yet, in the CICS log
  for the client, you will see:
  DFHIR3783 Connected transaction abended with message.
  CICS looks at the 07 as an FMH error from the server.
  This is very similar to APAR PK35533.  While PK35533 corrected
  the FMH parameter in the TOR on the DFHISP's CONVERSE
  instruction because DFHAPCR's EXPORT_ALL had already supplied
  it with the first 32k of data.  This problem is in the AOR
  when the mirror task (DFHMIRS) specifies that CICS is treating
  the 07 as an FMH error from the FMH parameter, eventhough
  DFHAPCR's EXPORT_CHANGED has already supplied it when it
  had returned the first 32k of data.
  Additional Symptoms and Keywords:
  x'07' 07 MSGDFHIR3783
  DFHME0121 The first attempt at formatting message DFHIR3783,
  TD queue CSMT, has failed - Invalid DBCS format
  Customer may receive MSGDFHME0121 for the DFHIR378 message.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Container data truncated on a DPL       *
  *                      request when Channel data contains      *
  *                      x'07' in byte 2 of the final buffer.    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  An application program issues an EXEC CICS LINK request with the
  CHANNEL option to a program in a remote region.
  On returning from the AOR the Channel data exceeds 32k and the
  first buffer is sent by DFHAPCR's EXPORT_CHANGED routine with
  the FMH option. The final portion of the Channel data is
  sent by DFHMIRS, incorrectly with the FMH option again.
  
  When that final part is received in the TOR it contains the FMH
  option and the user data just happens to include a x'07' in
  position 2 of the TIOA. DFHZARQ assumes that this is an ABORT
  request (FMH07) and exits DFHAPCR's IMPORT_CHANGED with an
  Exception/Terminal_Error.
  
  This results in the final part of the Channel data being lost
  and the length of the Channel being truncated to 32667.
  
  Additional keywords
  TCTE_CHAN_SENT_FMH EXPORTED_CHANGED IMPORTED_CHANGED
  

Problem conclusion

• DFHMIRS has been amended for MRO connections to check whether
  DFHAPCR's EXPORT_CHANGED has already sent the FMH data. If it
  has the FMH option will not be included on the DFHTC TYPE=WRITE
  instruction.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK34457 UK34458

Modules/Macros

•    DFHMIRS
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK34457

     UP08/03/15 P F803

• R500 PSY UK34458

     UP08/03/18 P F803

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.