IBM Support

PK22237: ABEND (CODE 0C4/AKEA) HAS OCCURRED AT OFFSET X'3114'IN MODULE DFHTCRP

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • You are running CICS/TS 2.3 maintenance level RSU0509,
    an S0C4 abend occurred during Terminal Control
    Initialization.
    DFHZC0001 CICST4 An abend (code 0C4/AKEA) has occurred at offset
    X'3114 in module DFHTCRP.
    DFHTC1001 CICST4 Terminal control initialization failed
    (DFHSII1)
    Another SVC dump was captured for code TC1001 as well.
    You have to cancel the region and restart it.
    The trace shows the following,
    00011 QR SM 0D01 SMMF  ENTRY FREEMAIN
                     TCRP_ZXL,3CFF5038,CICS
    DM    CO DS 0005 DSSR  EXIT  SUSPEND/OK
    DM    CO DS 0004 DSSR  ENTRY SUSPEND
                     00490007,NO,LOCK,YES
    00011 QR LM 0003 LMLM  ENTRY UNLOCK
                           3BAEEC48,EXCLUSIVE
    00011 QR DS 0004 DSSR  ENTRY RESUME             00490007
    DM    CO DS 0005 DSSR  EXIT  SUSPEND/OK
    DM    CO LM 0004 LMLM  EXIT  LOCK/OK
    DM    CO SM 0302 SMGF  EXIT  GETMAIN/OK         3CFF5030,58
    DM    CO DD 0201 DDDI  ENTRY ADD_ENTRY          D7D7E3C5 ,
                           3CFF5030,
                           3BDB7EF4,3BE0CF40,NO,PPT,EZACIC02
    DM    CO LM 0003 LMLM  ENTRY LOCK
                           3BC7DD48,EXCLUSIVE
    DM    CO LM 0004 LMLM  EXIT  LOCK/OK
    DM    CO LM 0003 LMLM  ENTRY UNLOCK
                           3BC7DD48,EXCLUSIVE
    DM    CO LM 0004 LMLM  EXIT  UNLOCK/OK
    DM    CO DD 0202 DDDI  EXIT  ADD_ENTRY/OK
    DM    CO LD 0001 LDLD  ENTRY INQUIRE_PROGRAM    EZACIC02
    DM    CO LD 0002 LDLD  EXIT  INQUIRE_PROGRAM/OK
                           3CA5BBB0,REUSABLE,CICS
    DM    CO GC 2010 CCCC  ENTRY GET                3BDB8144 ,
                           00000000 ,
                           00000100,PPTEJVMC,EZACIC02
    DM    CO DS 0004 DSSR  ENTRY WAIT_MVS
                           CCVSAMWT,486564C0,NO,IO
                           ASYNRESP
    00011 QR DS 0005 DSSR  EXIT  RESUME/OK
    00011 QR LM 0004 LMLM  EXIT  UNLOCK/OK
    00011 QR SM 0D02 SMMF  EXIT  FREEMAIN/OK CICS storage at
                           3CFF5038
    00011 QR AP FB0A TCRP  *EXC* RECOVERY_ENTERED
    The cause of the 0C4 is due to the fact that the storage at
    location x'3CFF5038' has been re-used by DFHPGRP which was
    running on the CO TCB.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Abend 0C4 in module DFHTCRP at          *
    *                      offset x'3142' when restarting CICS.    *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    During the restart of CICS the Terminal Control Recovery Program
    (DFHTCRP) re-establishes the Terminal Control Table that was in
    existence in the previous run of CICS.
    While building the tcttes from the Catalog a tracking list
    ("ledger") is maintained until all are restored. When this is
    complete DFHTCRP freemains each ledger entry in turn, however
    the freemain is issued before addressing the next ledger entry.
    
    As this region has been restarted with SUBTSK=1 specified, the
    PPTE entries are being rebuilt at the same time under the CO TCB
    by DFHPGRP.
    This allows for DFHTCRP to freemain the last ledger entry in a
    storage page (85 to a page) on the QR TCB, just as DFHPGRP
    obtains a new storage page for PPTE entries (46 to a page) on
    the CO TCB.
    
    When DFHTCRP attempts to address the next ledger entry it now
    picks up erroneous information from the PPTE entry resulting in
    an 0C4 in DFHTCRP at x'3142'.
    
    The recovery routine in DFHTCRP handles the abend and produces a
    ZC0001 system abend before returning to DFHSII1 which produces a
    second system dump (TC1001).
    
    Additional keywords
    msgDFHZC0001 DFHZC0001 msgDFHTC1001 DFHTC1001 ledger_add_all
    LEDGER_ENT_SUBS LEDGER_ENT_NEXT
    

Problem conclusion

  • DFHTCRP has been amended to save the address of the next ledger
    entry before the Freemain is issued.
    

Temporary fix

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

Comments

APAR Information

  • APAR number

    PK22237

  • Reported component name

    CICSTS 3.1 Z/OS

  • Reported component ID

    5655M1500

  • Reported release

    400

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2006-03-28

  • Closed date

    2006-04-04

  • Last modified date

    2006-05-01

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

    PK19537

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

    UK13221

Modules/Macros

  •    DFHTCRP
    

Fix information

  • Fixed component name

    CICSTS 3.1 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R400 PSY UK13221

       UP06/04/07 P F604

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 May 2006