A fix is available
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
SC34644306 | SC34682803 |
Fix information
Fixed component name
CICSTS V3 Z/OS
Fixed component ID
5655M1500
Applicable component levels
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