PM09080: AFTER MIGRATING TO CICS TS 3.2 API COMMAND EXEC WEB SEND WILL SEND MORE DATA THAN ORIGINAL HTML DATA LENGTH.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• After migrated to CICS TS 3.2 this transaction EXEC WEB SEND
  will send more data then original HTML data length.
  The problem occurs because the HTML template is over 8K long AND
  contains lines sequence of shiftin/cr/lf/shiftout where one line
  spans another.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: A web page based on a large ( > 8K )    *
  *                      DOCTEMPLATE residing on a PDS           *
  *                      contains garbage at the end of the      *
  *                      screen.                                 *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A large DOCTEMPLATE containing DBCS character sequences of
  SHIFTOUT followed by CRLF ( carriage return and Linefeed )
  followed by SHIFTIN is installed from a PDS. The install process
  allocates an 8K buffer to hold the data read from the PDS.
  DFHDHPR strips out sequences of SHIFTOUT/CR/LF/SHIFTIN as it
  encounters them. Eventually the 8K buffer is filled. DFHDHPR
  continues to read data off the PDS in order to determine what
  length of buffer is needed for this DOCTEMPLATE. However, it is
  no longer able to track sequences of SHIFTOUT/CR/LF/SHIFTIN once
  the buffer overflows. DFHDHPR returns an estimate of the buffer
  space needed to hold the DOCTEMPLATE to its caller ( DFHDHTM ).
  DFHDHTM allocates a larger buffer and calls DFHDHPR a second
  time.
  DFHDHPR now reads the DOCTEMPLATE off the PDS again without
  encountering a buffer overflow. This enables it to strip out
  all the SHIFTOUT/CR/LF/SHIFTIN sequences which exist.
  The data in the buffer is now slightly smaller than the length
  of the buffer. DFHDHPR returns this smaller length to DFHDHTM
  but DFHDHTM ignores this smaller length. The DOCTEMPLATE
  length recorded in dhtl_template_body is larger than the length
  of data in the buffer. The data at the end of the buffer is
  a random sequence of characters.
  These random characters appear on a browser when this
  DOCTEMPLATE is used to generate a document which is sent using
  EXEC CICS WEB SEND.
  

Problem conclusion

• DFHDHTM has been changed to detect if a second call to DFHDHPR
  returns a smaller buffer length than was returned by the first
  call. If a smaller length is returned the data is copied into a
  smaller buffer and dhtl_template_body is set to reflect the
  smaller length.
  

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:

  PM13294 PM14144 UK57064

Modules/Macros

•    DESDHTM  DFHDHTM
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R500 PSY UK57064

     UP10/05/25 P F005

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.