IBM Support

PM20793: NOT ENOUGH DIAGNOSTIC INFORMATION TO DIAGNOSE DFHDS0002 A SEVERE ERROR (CODE X'0198') HAS OCCURRED IN DFHDSMT.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • During shutting down CICS region, msgDFHDS0002 was produced with
    a DS0002 dump.
    .
    DFHDS0002 CICSP A severe error (code X'0198') has occurred in
    module DFHDSMT.                               0198       X'0198'
    .
    Authorised code issued SVC D8 from AFCB, a non-zero dsas_retcode
    was received. This lead to the issue of this message and dump.
    dsas_retcode was not saved before this message was being traced,
    therefore it's difficult to understand what exactly happened.
    .
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All CICS Users.                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: Not enough diagnostic information       *
    *                      to diagnose a DS0002 abend code         *
    *                      X'0198' issued during shutdown.         *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    During CICS shutdown, module DFHDSMT issues a DS0002 abend, code
    X'0198'. Trace shows exception trace point DS 0198
    DSMT_SNAP_FAILURE was issued from within SNAPSHOT_MVSTCBS.
    This indicates that a call to TCBSTATS in module DFHDSAS has
    failed. The return code from this call should have been held in
    field dsas_retcode, but was not copied into storage at any point
    and cannot be seen in the DS0002 dump.
    
    Additional Keywords: DS0198 SERVAID
    

Problem conclusion

  • DFHDSMT has been altered so that the dsas_retcode field will be
    copied into the stack storage area of DFHDSMT. This makes it
    possible to discover the return code from the TCBSTATS call.
    The return code will also be available in the data3 area of
    the DS0198 exception trace entry.
    
    
    
    The CICS Transaction Server for z/OS Version 3 Release 1
    Trace Entries manual (SC34-6443-06) will be updated in
    Chapter 9. Dispatcher domain trace points, in
    Table 125. Dispatcher domain trace points. The entry for
    DS 0198 will be updated to add a new data area:
    3 DSAS return code
    
    The CICS Transaction Server for z/OS Version 3 Release 2
    Trace Entries manual (SC34-6828-03) will be updated in
    Chapter 7. Dispatcher domain trace points, in
    Table 124. Dispatcher domain trace points. The entry for
    DS 0198 will be updated to add a new data area:
    3 DSAS return code
    

Temporary fix

  • FIX AVAILABLE BY PTF ONLY
    

Comments

APAR Information

  • APAR number

    PM20793

  • Reported component name

    CICSTS V3 Z/OS

  • Reported component ID

    5655M1500

  • Reported release

    400

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2010-08-20

  • Closed date

    2010-08-31

  • Last modified date

    2010-10-02

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

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

    PM21006 UK60042 UK60064

Modules/Macros

  •    DESDSMT  DFHDSMT  DFHDSMTA DFHDSMTM DFHDSMTS
    DFHDSMTT DFHDSTR
    

Publications Referenced
SC34644306SC34682803   

Fix information

  • Fixed component name

    CICSTS V3 Z/OS

  • Fixed component ID

    5655M1500

Applicable component levels

  • R400 PSY UK60042

       UP10/09/03 P F009

  • R500 PSY UK60064

       UP10/09/03 P F009

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 October 2010