PK08404: ABEND0C4 IN DFHZCN1 AT OFFSET C42.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Getting message DFHAP0001 An abend (code 0c4/akea) has occurred
  offset X'00000C42' in module DFHZCN1.  While a CCIN INSTALL task
  is waiting for an ENQ to be satisfied and a CCIN UNINSTALL is
  issed freeing storage pointed by TCSE_CCINDATA_PTR.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Abend 0C4 in DFHZCN1 at offset x'C42'.  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A CCIN transaction processing an UNINSTALL request for a CICS
  Client Connection becomes suspended in DFHZCN2 trying to delete
  a Virtual Terminal (\AAG). While suspended and holding the
  Enqueue ('DFHZCN2 xxx') to the connection a new CCIN INSTALL
  request arrives for the same connection.
  
  The INSTALL request freemains and getmains a new CCINPARM
  parameter area (TCSE_CCINDATA_PTR) before it becomes suspended
  on the Enqueue held by the first task.
  
  After 10 seconds the UNINSTALL request gives up trying to delete
  the virtual terminal (\AAG) and releases the enqueue. As this is
  an UNINSTALL request it freemains the storage just acquired by
  the other task and sets TCSE_CCINDATA_PTR to zero.
  
  When the INSTALL request resumes it completes its processing
  before returning to DFHZCN1 to send the response to the client.
  As part of this routine the first four bytes pointed to by
  TCSE_CCINDATA_PTR are used to obtain the Security & Applid from
  the Input Parms, as this value is pointing at low storage a very
  large number (x'078D1000') is used in the calculation resulting
  in a 0C4 abend in DFHZCN1 at offset x'C42'.
  
  Additional keywords
  AP3015 TID_ZCN2_COND_ENQ_FAILED DFHZCN1-
  

Problem conclusion

• DFHZCN1 and DFHZCN2 have been amended to move the Enqueue /
  Dequeue processing of the install/uninstall of a CICS Client
  Connection from DFHZCN2 into DFHZCN1.
  This will enable the getmain and freemain of the parameter area
  (CCINPARM) to be serialized within the enqueue.
  
  The documentation in the following manual has been amended :-
  (1) CICS Transaction Server for z/OS
      CICS Trace Entries
      Version 3 Release 1
      Document Number SC34-6443-00
  
  - Delete trace entry AP 3015
     AP 3015 DFHZCN2 Exc   Cond. enqueue failed  1   None
  - Add new trace entry AP 3042
     AP 3042 DFHZCN1 Exc   Cond. enqueue failed  1   None
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PK06017

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

  UK06194

Modules/Macros

•    DFHZCN1  DFHZCN2  DFHZCTR1 DFHZGDCC DFHZGDCD
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK06194

     UP05/08/16 P F508

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.