IBM Support

PK11517: DFHUS0002 A SEVERE ERROR (CODE X'0307') HAS OCCURRED IN MODULE DFHUSAD AFTER A TASK WAS PURGED.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • DFHUS0002 A severe error (code X'0307') has occurred in module
    DFHUSAD after a task has been purged.
     A task doing the IEGM transaction gets purged at the time
    it is in a LMQUEUE wait. Then when trying to release the lock it
    gets
    this error:
    LM 0047 LMLM *EXC* - THE TASK REQUESTING A LOCK HAS BEEN
    PURGED.FUNCTION(LOCK) LOCK_TOKEN(02BF9228) MODE(SHARED)
    WAIT(CICS)
    This then triggers a DFHSU0002 x'0307' abend and dump.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Abend US0002 (code x'0307') in          *
    *                      module DFHUSAD when executing           *
    *                      a EXTRACT_SEGMENT call.                 *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    An IUI (Interactive User Interface) transaction IEGM becomes
    suspended in DFHUSAD's EXTRACT_SEGMENT routine waiting for
    shared access to the USADLOCK lock which is currently held
    exclusively by another task performing an ADD_USER_WITH_PASSWORD
    call.
    
    While suspended, the Lostterm exit is driven for the terminal
    and as part of the production of the message DFHZC2410 a
    customized Node Error program (IESCLEAN) issues an EXEC CICS SET
    TERMINAL() FORCEPURGE to abend the task immediately. This
    returns PURGED from the Lock Manager LOCK request and the lock
    is never obtained.
    
    However on exit from the EXTRACT_SEGMENT routine, the code
    incorrectly assumes that the lock will always be obtained and
    therefore issues an UNLOCK request. This will fail and the trace
    entry "US 0307 USAD Unlock-error" is produced followed by an
    US0002 system dump.
    
    Additional keywords
    msgDFHZC2410 msgDFHUS0002 DFHUS0002 0307 DFHEVBBF
    

Problem conclusion

  • DFHUSAD's EXTRACT_SEGMENT routine has been amended to issue the
    UNLOCK request only if the LOCK was successful.
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PK11517

  • 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

    2005-09-07

  • Closed date

    2005-10-26

  • Last modified date

    2005-11-04

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

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

    UK08567

Modules/Macros

  •    DESUSAD  DFHUSAD
    

Fix information

  • Fixed component name

    CICSTS FOR VSE

  • Fixed component ID

    564805400

Applicable component levels

  • RB0P PSY UK08567

       UP05/11/04 I 1000

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:
04 November 2005