PK09584: DFHDD0001 ABEND 0C4/AKEA HAS OCCURRED AT OFFSET X'0566' IN MODULE DFHDDBR. CEMT INQUIRE PIPELINE ISSUED.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• An abend S0C4/AKEA in DFHDDBR reported by message DFHDD0001 may
  occur due to a corrupt AVL tree header for the PIPL directory in
  the Directory Domain. The problem occurs when a browse function
  against the PIPL directory is attempted.  This happens if CEMT
  INQUIRE PIPELINE(*) is entered.
  Formatting out the Directory Domain using IPCS, you will find
  xml statements from the pipeline configuration file overlaying
  the AVL header for the PIPL directory.
  .
  The problem occurs if an empty <handler_parameter_list> element
  is specified by coding the following:
  .
  <handler_parameter_list>
  </handler_parameter_list>
  .
  While this is correct, CICS was expecting an empty list to be
  indicated as follows:
  .
  <handler_parameter_list/>
  .
  Having it coded with both tags causes DFHPIPL to assume that
  there is a parameter list to process and store in a PISNEDA
  area. It tries to determine the length of the parameter list
  but, because there isn't one, the length ends up negative.  A
  GETMAIN is then issued for this negative length of storage which
  gets a zero length piece of storage at the end of a page owned
  by PI and immediately before a page owned by DD (which has the
  AVL header for the PIPL directory).  DFHPIPL then copies data
  into this area (using the 1 byte negative length as a positive
  value).  This overwrites the AVL header for the PIPL directory
  and leads to the errors when trying to browse or discard
  pipelines.
  .
  Local Fix:  Code your empty list as follows:
     <handler_parameter_list/>
  .
  Additional Symptoms: MSGDFHDD0001 DD0001 S0C4 ABENDS0C4 ABEND0C4
  ABENDAKEA CEMT INQUIRE INQ PIPE PIPELINE 5697M1500 5697M15 R400
  R640 400 640
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: MsgDFHDD0001 An abend (code 0C4/AKEA)   *
  *                      has occurred at offset X'0566' in       *
  *                      module DFHDDBR.                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  When installing a pipeline definition using CEDA, program
  DFHPIPL scans the pipeline configuration file (an HFS file
  named in the definition) to find the <handler> elements
  within the file. Having found a <handler> element, DFHPIPL
  looks for a <handler_parameter_list> element within it and
  then for a matching </handler_parameter_list>. If it finds
  both of these elements it assumes that parameters are
  present between the two elements and attempts to calculate the
  length of these. It does this by finding the address of the
  '<' at the beginning of the parameters, then subtracting
  this from the address of the '>' at the end.
  However it is valid to have no parameters between the elements.
  In that case DFHPIPL finds the '>' in '<handler_parameter_list>
  and incorrectly treats this as the end of the parameters.
  It also finds the '<' in '</handler_parameter_list>' and
  incorrectly treats this as the beginning of the parameters.
  This means that the beginning address is after the end
  address, resulting in a negative number for the length.
  This negative number is then used on an MVC instruction
  resulting in an overlay.
  This resulted in the reported message DFHDD0001 and an abend
  AEXZ when using CEMT INQUIRE PIPELINE, but other unpredictable
  results could occur.
  Additional keyword: abendAEXZ PISNEDA configfile S0C4
  abendS0C4 abend0C4 DFHPI0001 msgDFHPI0001
  

Problem conclusion

• DFHPIPL routine populate_service_node_element has been altered
  to only getmain PISNEDA storage, and move data into it, if the
  length of the parameters in the handler_parameter_list is
  greater than 0.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK09132

Modules/Macros

•    DESPIPL  DFHPIPL
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK09132

     UP05/11/18 P F511

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.