IBM Support

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

A fix is available

Subscribe

You can track all active APARs for this component.

 

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 number

    PK77143

  • Reported component name

    CICSTS FOR VSE

  • Reported component ID

    564805400

  • Reported release

    B0P

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2008-12-08

  • Closed date

    2009-01-14

  • Last modified date

    2009-05-14

  • 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.

[{"Business Unit":{"code":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.1.1","Edition":""}]

Document Information

Modified date:
14 May 2009