IBM Support

PK81864: DURING A CICS RESTART, A DFHRM0002 RC0397 MAY OCCUR FOR A CMAM TRANSACTION.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • During a CICS restart, the CMAM transaction may be attached
    to resync with the remote parent region.  It will start the
    perform_unshunt recovery process.  During this time the CSXM
    transaction is running and performing unshunt work for UOWs in
    backout state.  A timing problem may occur where the CMAM task
    may find out that the UOW has already been unshunted and
    recovered by the CSXM transaction, or that the UOW is already in
    some form of recovery.
      This leads to a DFHRM0002 0397 error.
    Additional Keywords: RM0002 X'0397' X'397'
    KIXREVACC
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All.                                         *
    ****************************************************************
    * PROBLEM DESCRIPTION: During a CICS emergency restart, CICS   *
    *                      may abend with message DFHRM0002 for a  *
    *                      severe error in module DFHRMLSU.        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    During a CICS emergency restart, while recovering the UOWs
    from the system log, a race can occur between the CSXM task
    and an attached task.
    
    When a UOW has two RUNT links associated with it, the first link
    to be processed by the CSXM task will lead to a task being
    attached to complete the unshunting process for the UOW. The
    CSXM task will then continue to process the next link. In this
    case it moves on to the second link from the UOW. The CSXM task
    begins to process the second link and sets the recovery in
    progress flag. The task is suspended before completion. While
    CSXM is suspended, the attached task begins. This discovers
    that there is a second link for this UOW, so begins to process
    it. At this point it discovers that recovery is already in
    progress. This leads to a disaster response and subsequent
    msgDFHRM0002 being issued.
    
    Additional Keywords: RM0002 RMLSU 0397 X'0397' SFR CMAM
    

Problem conclusion

  • DFHXMRM1 has been altered so that if recovery_already_in_prog
    is found on the first initiate_recovery call, then the codepath
    is exited straight away and processing continues as normal.
    

Temporary fix

  •             *********
                * HIPER *
                *********
    FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PK81864

  • Reported component name

    CICSTS V3 Z/OS

  • Reported component ID

    5655M1500

  • Reported release

    400

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2009-03-04

  • Closed date

    2009-05-27

  • Last modified date

    2009-07-01

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    UK46940 UK46941 PK88762

Modules/Macros

  •    DESXMRM  DFHXMRM  DFHXMRM1
    

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R400 PSY UK46940

       UP09/06/03 P F906

  • R500 PSY UK46941

       UP09/06/03 P F906

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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"3.1","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
01 July 2009