PI96875: DFHEC0002 A SEVERE ERROR (CODE X'3661') HAS OCCURRED IN MODULE DFHECRL

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are receiving the following DFHEC0002 when you overtype
  the Bundle status from from 'Enabling' to 'Enabled',
  DFHEC0002 A severe error (code X'3661') has occurred in module
            DFHECRL
  .
  The trace shows the following INVALID_TOKEN exception trace
  entry,
  AP  3661 ECRL  *EXC* - INVALID_TOKEN - FUNCTION(SET)
                         BUNDLE_TOKEN(17C6DB40 , 00000001)
                         RESOURCE_TOKEN(17ED2BD0 , 00000001)
                         CLIENT_TOKEN(180C7030 , 00000000)
                         STATE(DISABLED)
                         FUNCTION(SET)
                         BUNDLE_NAME(........)
  .
  You did a WARM start for this CICS run.
  .
  Further investigation, found that you have received the
  following DFHRL0119 message prior to this run,
  DFHRL0119 E  The CICS resource lifecycle bundle class failed
  to re-create the BUNDLE resource XXXXXXX because of failed
  consistency checks with the manifest -
   /usr/lpp/<your manifest file path>
  .
  Before that, you had disabled this problem bundle.
  .
  .
  Additional Symptom(s) Search Keyword(s): KIXREVCTC INVALID_TOKEN
  DFHEC0002, EC0002, DFHRL0119, RL0119
  

Local fix

• Restart the CICS region with COLD start.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: When using bundles which contain EP     *
  *                      parts it is possible to suffer a        *
  *                      severe error x'3661' in module DFHECRL. *
  ****************************************************************
  The problem can occur should the bundle in use by the CICS
  region be re-exported to zfs at the same location and the CICS
  region is restarted.
  During the restart CICS finds bundles to recover but this fails
  the consistency checking so CICS does not recover the bundle
  parts. No BUNRLRS records are removed from the GCD.
  The bundle is then discarded, this discard should have driven
  RLPK DISCARD_RESOURCE to delete the GCD records for the bundle
  parts. However as the recovery did not actually recover the
  bundle parts this does not happen. The result after the discard
  is that the GCD still contains the BUNRLRS record.
  The bundle is re-installed adding another BUNRLRS record to the
  GCD.
  When CICS is again restarted it reads the GCD and recovers the
  2 BUNRLRS records even though both are for the same resource.
  The bundle is left in an enabling state.
  
  
  Keywords: EVENTBINDINGS EPADPATER EPADPATERSET
  
  DFHGCD msgDFHEC0002 msgDFHRL0119
  

Problem conclusion

• CICS has been changed to ensure should the recover of the
  catalog records fail consistency checking the catalog record is
  deleted.
  

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:

  UI57910

Modules/Macros

• DFHRLBR  DFHRLDM  DFHRLDUF DFHRLPK1 DFHRLPM  DFHRLRG1 DFHRLRO
  DFHRLRS1 DFHRLST
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R100 PSY UI57910

     UP18/08/17 P F808

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.