A fix is available
APAR status
Closed as program error.
Error description
Serviceability APAR to help gather timely documentation for the Suspend / Resume Race problem that leaves a task suspended with no hope of being resumed.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All * **************************************************************** * PROBLEM DESCRIPTION: Improvements in the CICS Dispatcher * * resume and suspend diagnostics. * **************************************************************** * RECOMMENDATION: * **************************************************************** During suspend/resume processing a task can become left suspended upon a resource indefinitely, when it had been resumed into a task state of RESUMED_EARLY and should have been made dispatchable. This is a very rare circumstance but when it happens the task remains permanently suspended. This is typically in an LMQUEUE suspend upon the SMLOCK lock. This serviceability apar saves the TASK_STATE at crucial points within this code and attempts to detect the situation and issue a DFHDS0002 and write a new exception trace entry. Keywords: MSGDFHDS0002 *EXC* DSTCB_INVALID_SUSPEND SERVAID
Problem conclusion
The CICS Dispatcher code has been changed to save the TASK_STATE during suspend and resume processing and then issue a DFHDS0002 if appropriate. The CICS Transaction Server for z/OS CICS Trace Entries Version 3 Release 1 SC34-6443-00 will have the following addition to the topic '9.0 Dispatcher domain trace points', at the end of 'Table 122. Dispatcher domain trace points', Point Module Lvl Type Data ID DS DFHDSTCB Exc DSTCB_INVALID_SUSPEND 1 Detecting module 0207 2 Dispatcher task area The CICS Transaction Server for z/OS Supplementary Data Areas Version 3 Release 1 LY33-6108-00 will have the following change to the topic 'DSTSK Dispatcher Domain Task Description', Change, (F4) CHARACTER 16 * Reserved To, (F4) BIT(72) 9 TASK_STATE_SAVE TASK_STATE save (F4) BIT(56) 7 TASK_STATE_DSTCBA DFHDSTCB (F4) BIN(8) 1 TASK_STATE_DSTCB1 DFHDSTCB TASK_STATE1 (F5) BIN(8) 1 TASK_STATE_DSTCB2 DFHDSTCB TASK_STATE2 (F6) BIN(8) 1 TASK_STATE_DSTCB3 DFHDSTCB TASK_STATE3 (F7) BIN(8) 1 TASK_STATE_DSTCB4 DFHDSTCB TASK_STATE4 (F8) BIN(8) 1 TASK_STATE_DSTCB5 DFHDSTCB TASK_STATE5 (F9) BIN(8) 1 TASK_STATE_DSTCB6 DFHDSTCB TASK_STATE6 (FA) BIN(8) 1 TASK_STATE_DSTCB7 DFHDSTCB TASK_STATE7 (FB) BIT(16) 2 TASK_STATE_DSWKT DFHDSWKT (FB) BIN(8) 1 TASK_STATE_DSWKT8 DFHDSWKT TASK_STATE8 (FC) BIN(8) 1 TASK_STATE_DSWKT9 DFHDSWKT TASK_STATE9 (FD) CHARACTER 7 * Reserved Change, (125) CHARACTER 3 * reserved for open TCBs To, (125) CHARACTER 1 * reserved for open TCBs (126) BIT(8) 1 SUSPEND_FOOTPRINT Footprint SUSPEND (126) 1... .... DSTCB_CS_1 DFHDSTCB .1.. .... DSTCB_CS_2 DFHDSTCB ..1. .... DSTCB_CS_3 DFHDSTCB ...1 .... DSTCB_CS_4 DFHDSTCB .... 1... DSTCB_CS_5 DFHDSTCB .... .1.. DSTCB_CS_6 DFHDSTCB .... ..1. DSTCB_CS_7 DFHDSTCB .... ...1 * reserved (127) BIT(8) 1 RESUME_FOOTPRINT Footprint RESUME (127) 1... .... DSWKT_CS_8 DFHDSWKT .1.. .... DSWKT_CS_9 DFHDSWKT ..1. .... DSSR_CS_10 DFHDSSR ...1 1111 * reserved The CICS Transaction Server for z/OS CICS Trace Entries Version 3 Release 2 SC34-6828-00 will have the following addition to the topic '7.0 Dispatcher domain trace points', at the end of 'Table 123. Dispatcher domain trace points', Point Module Lvl Type Data ID DS DFHDSTCB Exc DSTCB_INVALID_SUSPEND 1 Detecting module 0207 2 Dispatcher task area The CICS Transaction Server for z/OS Supplementary Data Areas Version 3 Release 2 GC34-6864-00 will have the following change to the topic 'DSTSK Dispatcher Domain Task Description', Change, (F4) CHARACTER 16 * Reserved To, (F4) BIT(72) 9 TASK_STATE_SAVE TASK_STATE save (F4) BIT(56) 7 TASK_STATE_DSTCBA DFHDSTCB (F4) BIN(8) 1 TASK_STATE_DSTCB1 DFHDSTCB TASK_STATE1 (F5) BIN(8) 1 TASK_STATE_DSTCB2 DFHDSTCB TASK_STATE2 (F6) BIN(8) 1 TASK_STATE_DSTCB3 DFHDSTCB TASK_STATE3 (F7) BIN(8) 1 TASK_STATE_DSTCB4 DFHDSTCB TASK_STATE4 (F8) BIN(8) 1 TASK_STATE_DSTCB5 DFHDSTCB TASK_STATE5 (F9) BIN(8) 1 TASK_STATE_DSTCB6 DFHDSTCB TASK_STATE6 (FA) BIN(8) 1 TASK_STATE_DSTCB7 DFHDSTCB TASK_STATE7 (FB) BIT(16) 2 TASK_STATE_DSWKT DFHDSWKT (FB) BIN(8) 1 TASK_STATE_DSWKT8 DFHDSWKT TASK_STATE8 (FC) BIN(8) 1 TASK_STATE_DSWKT9 DFHDSWKT TASK_STATE9 (FD) CHARACTER 7 * Reserved Change, (125) CHARACTER 3 * reserved for open TCBs To, (125) CHARACTER 1 * reserved for open TCBs (126) BIT(8) 1 SUSPEND_FOOTPRINT Footprint SUSPEND (126) 1... .... DSTCB_CS_1 DFHDSTCB .1.. .... DSTCB_CS_2 DFHDSTCB ..1. .... DSTCB_CS_3 DFHDSTCB ...1 .... DSTCB_CS_4 DFHDSTCB .... 1... DSTCB_CS_5 DFHDSTCB .... .1.. DSTCB_CS_6 DFHDSTCB .... ..1. DSTCB_CS_7 DFHDSTCB .... ...1 * reserved (127) BIT(8) 1 RESUME_FOOTPRINT Footprint RESUME (127) 1... .... DSWKT_CS_8 DFHDSWKT .1.. .... DSWKT_CS_9 DFHDSWKT ..1. .... DSSR_CS_10 DFHDSSR ...1 1111 * reserved
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PK57962
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
2007-12-12
Closed date
2007-12-27
Last modified date
2008-02-02
APAR is sysrouted FROM one or more of the following:
PK56291
APAR is sysrouted TO one or more of the following:
UK32605 UK32606
Modules/Macros
DFHDSSR DFHDSTCB DFHDSTR DFHDSTRI DFHDSTSD DFHDSTSK DFHDSWKT
SC34644300 | SC34682800 | LY33610800 | GC34686400 |
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 February 2008