IBM Support

PK68814: EXEC CICS LINK PROGRAM DFHMIRS CAUSES LOOP AND EVENTUAL SHORT ON STORAGE CONDITION - DFHSM0133 DUE TO MANY DFHXFPC-COMM AREAS

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • An EXCI batch user application coded the following command
    specifying a CICS program, rather than one of their own.
    EXEC CICS LINK PROGRAM('DFHMIRS')
    This caused the mirror transaction to loop, repetitively calling
    itself.  This in turn caused CICS to go short on storage due
    to all the areas getmained to handle these links.. like
    kernel stacks and PLCB control blocks.  The region eventually
    hung and had to be recycled.
    Additional keywords:
    KIXREVRJL
    DFHSM0133 MSDFHSM0133 ABENDAKEG AKEG DFHAP0001 MSDFHAP0001
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All                                          *
    ****************************************************************
    * PROBLEM DESCRIPTION: DFHSM0133 issued when CICS goes short   *
    *                      on storage.                             *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    The CICS mirror program DFHMIRS fails to check that it has
    received a request to execute an EXEC CICS LINK PROGRAM command
    that specifies DFHMIRS itself as the linked to program. A user
    of the CICS External Interface EXCI can incorrectly specify
    DFHMIRS as the name of the EXCI server program. For example the
    sample EXCI client program DFH$AXCC can be changed to specify a
    target server program name of DFHMIRS instead of DFH$AXCS.
    When the EXCI batch job is run to execute the EXCI client
    program and to link to the EXCI server program in the CICS
    server region, the client program loops repeatedly calling
    DFHMIRS. This can lead to the short on storage condition, and
    other failures such as AKEG transaction abends. The CICS region
    can become unresponsive so that it has to be terminated and
    restarted. The CICS mirror program has an alias of DFHMIRR so
    that the same failure can occur if this name is specified as
    target server program name.
    Additional keywords:
    msgDFHSM0133 SM0133 0133 abendAKEG
    

Problem conclusion

  • The mirror program DFHMIRS is changed
    to perform additional checks
    when it receives a request to execute
    an EXEC CICS LINK PROGRAM command.
    If the name of the program to be linked to
    is DFHMIRS or DFHMIRR, instead of executing
    the command the mirror program performs
    a transaction abend with abend code AITM.
    
    -------------------------------------------------
    The CICS Transaction Server for z/OS CICS Messages and Codes
    Version 3 Release 1 (manual GC34-6442-04) is to be updated to
    the following new abend code:
    
    AITM
    
    Explanation:  A command has been received by the mirror program
    to call itself.
    
    System action:  The task is abnormally terminated with a CICS
    transaction dump.
    
    User response:  Correct the API command in the client system
    program so that is does not request an EXEC CICS LINK PROGRAM
    to be executed that specifies the name of the mirror program.
    
    Module:  DFHMIRS
    
    -------------------------------------------------
    The CICS Transaction Server for z/OS CICS Messages and Codes
    Version 3 Release 2 (manual GC34-6827-01) is to be updated to
    the following new abend code:
    
    AITM
    
    Explanation:  A command has been received by the mirror program
    to call itself.
    
    System action:  The task is abnormally terminated with a CICS
    transaction dump.
    
    User response:  Correct the API command in the client system
    program so that is does not request an EXEC CICS LINK PROGRAM
    to be executed that specifies the name of the mirror program.
    
    Module:  DFHMIRS
    

Temporary fix

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

Comments

APAR Information

  • APAR number

    PK68814

  • 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

    2008-07-10

  • Closed date

    2008-08-28

  • Last modified date

    2008-09-02

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

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

    UK39364 UK39365

Modules/Macros

  •    CHAPT024 DFHMIRS
    

Publications Referenced
GC34644204GC34682701   

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R400 PSY UK39364

       UP08/08/30 P F808

  • R500 PSY UK39365

       UP08/08/30 P F808

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:
02 September 2008