PH69385: DFHUS0002 CODE X'0311' WITH PURGEACTION(DISCARD) ON TCLASS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A transaction signs on with a user token and attempts to do an
  EXEC CICS START which performs an XMAT attach.  This XMAT attach
  
  fails with a TRANSACTION_DISCARD response due to the
  PURGEACTION(DISCARD) setting on the TCLASS and, during the
  cleanup, incorrectly performs two DELETE_USER calls.  This means
  
  an internal counter value is decremented twice incorrectly and
  can lead to the US0002 x'0311' severe error.
  
  Additional keywords: DFHUS0002 0311 PURGEACTION DISCARD
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Severe Error X'0311' when a TCLASS has  *
  *                      PURGEACTION(DISCARD).                   *
  ****************************************************************
  If a TRANSACTIONS TCLASS has PURGEACTION defined as DISCARD.
  During the processing of a transaction doing an EXEC CICS START
  if the TCLASS LIMIT is hit then DISCARD processing happens.
  This can cause CICS to incorrectly remove the user associated
  with the request twice.  This can lead to a DFHUS0002 with
  severe error code X'0311' due to the user count going negative.
  

Problem conclusion

• CICS has been updated to only remove the user once during
  PURGEACTION DISCARD processing.
  

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:

  UO07645 UO07646

Modules/Macros

• DFHICP
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R500 PSY UO07646

     UP26/05/01 P F604

• R600 PSY UO07645

     UP26/05/01 P F604

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.