PM62458: DFHSM0002 SEVERE ERROR (CODE X'0D06') DFHSMMF FREEING ADPTFLDS, DFHICP CALLED DIRECTLY

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are running with CICS TS 4.2, and receive a dump with
  message: DFHSM0002 A severe error (code X'0D06') has occurred
  in module DFHSMMF.
  
  Trace entires show that there is trouble FREEing ADPTFLDS,
  as it is not on an 8-byte boundary.
  
  Further investigation indicates that DFHICP is attempting to
  FREEMAIN storage if ICE_ADAPTER_ADDR is non-zero. This
  setting is for origin data returned by adapters. In this
  case, a check to verify that the non-zero data is valid (in
  DFHEIIC) has not taken place because DFHICP was called
  directly.
  
  The TRACE shows that the invalid FREEMAIN of ADPTFLDS:
  
  SM 0D06 SMMF  *EXC* - Address_not_on_8_byte_boundary -
       FUNCTION(FREEMAIN) REMARK(ADPTFLDS) ADDRESS(00000711)
       STORAGE_CLASS (SHARED_CICS)
  or possibly:
  SM 0D07 SMMF  *EXC* - Address_is_outside_DSA ADPTFLDS
       STORAGE_CLASS (SHARED_CICS)
  
  DFHSM0002
  
  Additional Symptom(s) Search Keyword(s):
  0C4/AKEA AbendS0C4 AbendAKEA
  DFHXMAT at offset 00002086
  process_adapter_data_routine
  XMAT_ADAPTER_FIELDS_P
  EX MVC XMAT_ADAPTER_FIELDS_DATA
  DFHSM0002 CODE X'0D07'
  0D09 TCTTE_address_not_provided
  .
  KIXREVJXD
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: A severe error (X'0D06') occurs in      *
  *                      module DFHSMMF.                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  DFHICP is called directly from DFHMCP1$.  Previous actions of
  BMS have caused the TCA to have data inserted, validly, at the
  location at which the TCAICADP field is declared.  This is used
  by DFHICP and on finding it to be non-zero, DFHICP believes
  there to be adapter data present.  As a consequence this
  residual data is copied into the ICE_ADAPTER_ADDR field and a
  FREEMAIN is performed.  This FREEMAIN fails resulting in
  the severe error.
  Additional keywords: msgDFHSM0002 DFHSM0002 SM0002 x'0D07'
  ADDRESS_NOT_ON_8_BYTE_BOUNDARY ADDRESS_IS_OUTSIDE_DSA
  ADPTFLDS TCZICADP PM55512
  

Problem conclusion

• A new existence bit, TCAICADX, has been added to the TCA to
  indicate if adapter data is present.  This bit is set and unset
  as appropriate by DFHEIIC.  DFHICP has been modified to test
  TCAICADX and if unset branch around the copy of TCAICADP to
  ICE_ADAPTER_ADDR, thus preventing the invalid FREEMAIN.
  
  The CICS Transaction Server for z/OS Version 4 Release 2 Data
  Areas manual (GC34-7163-01) will be updated as follows.
  
  In the TCA Task Control Area section, Table 605; the TCAICHDR
  entry will be modified as follows:
  
  Type: 1... ....
  Name (dim): TCAICHDR or TCAICADX
  Description: DATA RETURNED BY IC GET CONTAINS A USER-BUILT HDR.
  (INTERNAL) or ADAPTER DATA PRESENT
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• ž**** PE12/09/06 FIX IN ERROR. SEE APAR PM67638  FOR DESCRIPTION
  

APAR Information

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

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

  UK79075

Modules/Macros

•    DFHEIIC  DFHIC    DFHICP
  

Fix information

• Fixed component name

  CICS TS Z/OS V4

• Fixed component ID

  5655S9700

Applicable component levels

• R700 PSY UK79075

     UP12/06/01 P F205

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.