PI41217: DFHRMUTL AUTOCOLD START OVERRIDE DFHAM4874 FOR SOME ENQMODEL RECOVERED FROM CATALOG.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You replace an RDO group containing ENQMODEL definitions with a
  new group and shutdown CICS normal.  DFHRMUTL is run and
  confirms next start will be WARM and all UOW counts are zero.
  
  You next run DFHRMUTL and specify SET_AUTO_START=AUTOCOLD on
  SYSIN to request a COLD start at next CICS restart.
  
  CICS RM domain recognizes the cold start override and issues
  messages:
  
  DFHRM0140 applid Recovery manager autostart override found with
  value: 'AUTOCOLD'.
  DFHRM0149I applid Recovery manager autostart override record
  will be deleted.
  DFHPA1934I applid START TYPE CHANGED TO COLD
  
  CICS begins installing group lists as indicated by message
  DFHSI1511I and when the ENQMODEL definitions begin to install,
  several DFHAM4874 messages are issued stating the ENQMODEL
  already exists.
  
  When DFHNQDM calls DFHPAGP for the start type in refstep
  restore_nqrn_directory PAGP returns pagp_warm as it still knows
  the startup to be AUTO.  It then calls DFHDMDM to wait for phase
  dmph_global_catalog_available .  Since the global catalog is now
  available, DFHNQRN will restore the ENQMODELs.  DFHNQDM should
  first call DFHDMDM for wait phase DMPH_RM_STARTUP_TYPE_KNOWN and
  then call DFHPAGP for INQUIRE_START.  This way if the auto
  start has been overridden (as in this case to AUTOCOLD), the NQ
  domain can purge the catalog entries and perform a valid cold
  start.
  
  
  Additional Symptom(s) Search Keyword(s): KIXREVWJB DFHPAGP
  FORCE_START COLD
  

Local fix

• Disable and Discard all ENQMODEL definitions to remove them
  from the catalog.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: Message DFHAM4874 issued on a cold      *
  *                      restart.                                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  An RDO group for CICS Interdependency Analyser for z/OS was
  installed. This included ENQMODELs. The user removed CIA51 from
  the GRPLIST and replaced it with CIA52 (the CICS IA definitions
  for use with CICS TS 5.2). They then shutdown CICS normally, and
  the definitions were written to the catalog. The customer then
  used DFHRMUTL to set the next AUTO start type to AUTOCOLD.
  The subsequent cold start received a number of DFHAM4874
  messages for the ENQMODELs. This is because of a timing race
  during startup. The DM task for DFHNQDM calls DFHPAGP to
  inquire on the startup type. At this time DFHPAGP still knows
  the startup is AUTO, as CICS recovery has yet to process the
  AUTOCOLD record. DFHNQDM then phase waits for the catalog
  to become available. Since it believes the startup is AUTO,
  DFHNQRN will restore the ENQMODELs, rather than purge the
  entries from the catalog as it should do for a cold start.
  KEYWORDs: msgdfham4874 am4874 4874
  

Problem conclusion

• DFHNQDM has been changed to wait for phase
  DMPH_RM_STARTUP_TYPE_KNOWN before calling DFHPAGP to inquire on
  the startup type. This ensures it knows the startup is cold, and
  so calls DFHNQRN to purge the old entries from the catalog
  rather, than recover them and generate a DFHAM4874 message when
  they are also rebuilt from the CSD.
    The CICS TS for z/OS V5.2 Trace Entries manual (SC34-7295-00)
  will be updated as follows. A new entry will be added to the
  list of NQDM EXC trace entries in chapter 11, page 529, after
  NQ 010F:
  'NQ 0110   NQDM   Exc   Failure waiting for CICS startup type
   1  DMDM parameter list'
  

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:

  UI28784

Modules/Macros

• DFHNQDM  DFHNQDUF DFHNQED  DFHNQIB  DFHNQIE  DFHNQNQ  DFHNQNT
  DFHNQRN  DFHNQST  DFHNQTRI DFHSUTRI
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R900 PSY UI28784

     UP15/07/02 P F507

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.