PM06006: DFHTS1301 WRITE ERROR DETECTED BY TEMPORARY STORAGE. RPL FEEDBACK AREA IS X'080040'.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are receiving the following message:
  ----------------------------------------------------------------
  DFHTS1301 WRITE Error detected by temporary storage. RPL
  feedback area is X'080040'.
  ----------------------------------------------------------------
     You have set up your auxiliary temporary storage to use 255
  strings with a TS= SIT parm something like this: TS=(,600,255)
     In the 'TS=1' section of the DFHTS1301 dump, the Auxiliary
  statistics show this about strings:
  ----------------------------------------------------------------
    Number of strings:                            255
  * Peak number of strings in use:                255
  ----------------------------------------------------------------
     VSAM allows a maximum of 255 strings.  And because the TS=
  SIT parm requests 255 strings, CICS builds 255 VCAs and 255
  VSWAs to be able to handle 255 concurrent tasks all using
  Aux Temp Storage at the same time.  But CICS itself uses and
  keeps one of the VSAM strings when it reads the DFHTEMP control
  record during initialization.  This use of a VSAM string is
  outside of the normal application process.   So even though one
  of the VSAM strings is used up, there are still 255 VCAs and
  VSWAs available for application use.  If then there are 255
  tasks all accessing Aux Temp Storage queues at the same time,
  the 255th one will get the error as that asks VSAM for a 256th
  string.
  

Local fix

• Use the TS= SIT parm to request only 254 strings, like this:
   TS=(,600,254)
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: An attempt to write to Temporary        *
  *                      Storage abended ATSU, with message      *
  *                      DFHTS1301.                              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  During initialisation CICS checks the control record of the
  Temporary Storage dataset. This uses one of the VSAM strings
  available for the dataset, but this string is never released as
  the update bit is specified on the RPL. This leads to a
  situation where the number of strings available is out of step
  with the number of free VCAs. VSAM dynamic string addition means
  that this is not usually a problem, as it will add more strings
  as needed up to a maximum of 255.
  The problem comes about when there are 255 VCAs. When CICS
  attempts to write to the Temporary Storage dataset using the
  255th VCA, there will not be any available strings. This
  leads to the 08 40 I/O error from VSAM, which results in an ATSU
  abend in CICS. Message DFHTS1301 will be issued to the CICS log:
   DFHTS1301 WRITE Error detected by temporary storage. RPL
   feedback area is X'080040'.
  
  Note that if the problem occurred for a READ request, rather
  than for a WRITE (as shown above) then the message appears as:
   DFHTS1301 READ Error detected by temporary storage. RPL
   feedback area is X'080040'.
  This leads to an abend ATSD in CICS.
  
  Additional Keywords: abendATSU abendATSD msgDFHTS1301
  Additional Keywords: TS1301 1301
  

Problem conclusion

• DFHTSDM was amended to release the VSAM string used to check
  the control record during CICS initialisation. This ensures that
  the number of VCAs does not exceed the number of strings
  available, thereby avoiding the I/O error.
  

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:

  PM08528 UK55031

Modules/Macros

•    DESTSDM  DFHTSDM
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R500 PSY UK55031

     UP10/03/12 P F003

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.