PK77143: WHEN STARTING A NEW PARTITION WITH A COLD START A DFHRU2803 OCCURS WHEN DFHRUP IS CALLED FOR RECOVERY PROCESSING.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• During a cold start of CICS, a DFHRU2803 occurs.  The CICS
  trace shows DFHRCRP calling DFHRUP.  A VOLERR return code is
  returned to DFHRUP when it tries to access the journal for
  recovery purposes.  This percolates to the DFHRU2803 message
  and the partion terminates.
    The local and global catalogs have been correctly initialized.
  The restart data set has also been correctly initialized, yet
  the cold startup changes to a warm / emeregency retstart when
  DFHRCRP checks the DLI start up indicators.  The indicators are
  set up in DFHSIE1 earlier in the initialization process.  At
  label SIPOFDSB in DFHSIE1 a check is made for the DLI suffix.
  If the suffix starts with "N", NO is assumed and the DLI
  restart setup is skipped leaving the SIT DLI startup parm in
  an odd state.  The DLI suffix is "NP" and when control reaches
  DFHRCRP, it calls DFHRUP because a cold start for DLI is not
  indicated.
    DFHSIE1 needs to check both characters of the DLI prefix to
  confirm that "NO" is specified.
  
  Additional Symptom(s) Search Keyword(s):
  KIXREVJXD
  

Local fix

• Specify DLI=NO in the SIT or generate a new DLZNUCxx with a
  suffix that starts with any letter other than "N" and specify
  that new suffix on the DLI= parameter in the SIT.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: During a cold start of CICS, a          *
  *                      DFHRU2803 may occur when the DLI        *
  *                      SIT parameter starts with an N.         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A cold start of CICS should not call DFHRUP. However, the
  customer experienced a DFHRU2803 error, as a VOLERR had been
  returned to DFHRUP when it tried to access the CICS journal for
  recovery purposes.  This percolated to the DFHRU2803 message
  and the partition terminated.
    The reason DFHRUP was called in error was because DFHRCRP
  failed to check the DLI start-up indicators correctly. These
  are set up in DFHSIE1 earlier in the initialization process.
  If the suffix starts with "N", NO is assumed and the DLI
  restart setup is skipped, leaving the SIT DLI startup parm in
  an odd state. In the customer's case, their DLI suffix was "NP".
  This was misinterpreted as meaning NO. When control reached
  DFHRCRP, it called DFHRUP because a cold start for DLI was not
  indicated.
  KEYWORDS: RUP RU2803 2803 MSGDFHRU2803
  

Problem conclusion

• DFHSIE1 has been changed to correctly test both bytes of
  SITDL1 for a value of NO, rather than just the first byte
  for a value of N.
  

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:

Modules/Macros

•    DFHSIE1
  

Fix information

• Fixed component name

  CICSTS FOR VSE

• Fixed component ID

  564805400

Applicable component levels

• RB0P PSY UK43153

     UP09/01/21 P E421

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.