A fix is available
APAR status
Closed as program error.
Error description
Your CICS region issues message: . DFHNQ0002 A severe error (code X'030B') has occurred in module DFHNQED. . The failing task has issued a SYSPLEX ENQUEUE. The problem occurs in DFHNQED's SYSPLEX_ENQUEUE_WAITER proc due to DFHDSSRM and DFHLMLMM macros using the same area to address their parm lists. . When the SYSPLEX ENQ is not available, there is a loop which suspends the task, resuming every quarter of a second to reissue the MVS ENQ request. The NQ domain lock is released around this request. The problem occurs when we exit the loop for DTIMOUT reasons. DFHNQED attempts to reacquire the NQ lock with a compare and swap instruction, but if that doesn't work, the code issues a DFHLMLMM call to get the lock. But the lock manager call uses the same area in the stack as the DFHDSSRM macro. When the lock manager call returns to DFHNQED, there is now a successful return code in the lock manager parm list. So when DFHNQED checks the DSSR return code, there is no longer a timed-out response but a normal return and we end up in the path for the resumed_and_not_owner_logic_error. . Additional Symptom(s) Search Keyword(s): KIXREVrer Waiter_not_enqueue_owner_after_resume EXECPLEX SYSPLEX_ENQUEUE
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All * **************************************************************** * PROBLEM DESCRIPTION: DFHNQ0002 severe error x'030B' occurred * * in DFHNQED. * **************************************************************** * RECOMMENDATION: * **************************************************************** When a sysplex enq is not available, DFHNQED suspends the task, resuming it every quarter of a second to reissue the MVS ENQ request. The NQ domain lock is released around this request. If the suspended task times out waiting for the enq, DFHNQED attempts to reacquire the NQ domain lock with a direct compare and swap call on the lm_lock_owner field. If this fails, a DFHLMLMM call is made to get the lock. However, DFHNQED shares the same parameter list storage area for both dssr and lmlm calls. This means the dssr_response of purged with a reason of timed out is lost, and replaced by an lmlm_response of normal. This drives the resumed_and_not_owner_logic_error path, and DFHNQ0002 is issued in error. MSGDFHNQ0002 NQ0002 0002 nqed
Problem conclusion
DFHNQED has been changed to separate the paramater lists declarations.
Temporary fix
FIX AVAILABLE BY PTF ONLY
Comments
APAR Information
APAR number
PM56390
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
2012-01-19
Closed date
2012-04-24
Last modified date
2012-05-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK78217 UK78218
Modules/Macros
DESNQNQ DFHNQED
Fix information
Fixed component name
CICS TS Z/OS V4
Fixed component ID
5655S9700
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":"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 May 2012