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 4 Release 1 Trace Entries manual (SC34-7013-01) will be updated in Chapter 7. Dispatcher domain trace points, in Table 126. 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
PM21006
Reported component name
CICS TS Z/OS V4
Reported component ID
5655S9700
Reported release
600
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2010-08-24
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:
UK60098
Modules/Macros
DESDSMT DFHDSMT DFHDSMTA DFHDSMTM DFHDSMTS DFHDSMTT DFHDSTR
SC34701301 |
Fix information
Fixed component name
CICS TS Z/OS V4
Fixed component ID
5655S9700
Applicable component levels
R600 PSY UK60098
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":"4.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":"4.1","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 October 2010