PH71183: DOCUMENT TEMPLATE FROM TDQ IS EMPTY AFTER REFRESH OR NEWCOPY

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When an SOS condition occurs, CICS may free some of the document
  templates within its cache. The doctemplate is then tagged for a
  refresh which occurs on its next use. When CICS attempts to
  refresh a doctemplate from a Transient Data Queue (TDQ), it
  issues READQ TD calls to read the information from the TDQ.
  However, if the TDQ has not been closed and reopened, then this
  subsequent read fails to read any data from the TDQ as you can
  only read from TDQs once as they are a destructive read. (You
  can reset a queue's read cursor by closing and reopeing it.)
  The doctemplate may then result in zero size if a NEWCOPY is
  issued against it before the TDQ has been closed and reopened.
  
  Additional symptoms: KIXREVSCB
  READ_TRANSIENT_DATA QZERO TDQUEUE DOCTEMPLATE
  

Local fix

• Close and reopen the associated TDQ, then issue a NEWCOPY for
  the doctemplate.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: DOCTEMPLATEs residing in a TDQ result   *
  *                      in a zero length after a CICS SOS       *
  *                      condition occurs.                       *
  ****************************************************************
  When CICS goes short on storage (SOS), CICS may free some of
  the document templates within its cache and so any DOCTEMPLATEs
  defined as using a transient data queue (TDQUEUE) may have their
  cache cleared. When this DOCTEMPLATE is then attempted to be
  used after this SOS condition, CICS identifies it has been
  cleared from the cache and attempts to read the TDQUEUE again.
  
  The TDQUEUE was not closed/reopened and so this attempt to
  re-cache the TDQUEUE then results in CICS receiving no data and
  QZERO returned from transient data. TDQUEUEs can only be read
  once due to their logically destructive reads.
  

Problem conclusion

• Document handler module DFHDHEI has been updated to close and
  reopen the TDQUEUE before attempting to read it, after its
  cache of templates had been released due to CICS having
  previously been short on storage.
  

Temporary fix

Comments

APAR Information

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

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

  UO08859 UO08860 UO08861

Modules/Macros

• DFHDHEI
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R400 PSY UO08861

     UP26/08/06 I 1000

• R500 PSY UO08860

     UP26/08/06 I 1000

• R600 PSY UO08859

     UP26/08/07 I 1000

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.