PI20943: DFHSM0002 CODE X'0317' FREEMAIN_LENGTH_OVERLAYS_NEXT_SCF REMARK(XMATCTXT)

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are receiving DFHSM0002 code X'0317' when a CICS
  Application on one system has made a remote DL/I request.
  This has caused a CSM5 mirror transaction to be attached
  in the remote (DL/I owning) system. Application Context
  Data appears to have flown over to the remote system. We
  GETMAINED some storage to hold that and pass it to CSM5.
  .
  The trace shows the following exception trace entry when
  tran ID CSM5 is doing FREEMAIN,
  QR    SM 0317 SMGF  *EXC* Freemain_length_overlays_next_SCF
                            FUNCTION(FREEMAIN)
                            SUBPOOL_TOKEN(22C8474C , 0000000A)
                            ADDRESS(22D07C10)
                            FREE_LENGTH(DC)
                            REMARK(XMATCTXT)
  .
  Furthermore, found the issue is
  DFHZATT thinks it has found some incoming Application
  Context Data, even though it is beyond the real length of
  the data. It is doing a GETMAIN based on the length included
  with this data, and passing the area to CSM5. Later, CSM5
  attempts to freemain this based on the real length of
  Application Context data. The lengths on the GETMAIN and
  FREEMAIN do not match that leads to this error.
  .
  Additional Symptom(s) Search Keyword(s): KIXREVRJS
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS Users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Message "DFHSM0002  A severe error      *
  *                      (code X'0317') has occurred in module   *
  *                      DFHSMGF." is issued after application   *
  *                      context data is incorrectly passed      *
  *                      on a task attach.                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  MsgDFHSM0002 is issued at task end when DFHXMAT freemains an
  area that was getmained to hold Application Context Data (ACD).
  The ACD should be a fixed length, however the length that was
  getmained when the task was attached does not match the
  length on the freemain.
  DFHZATT is at fault for passing a bad length to transaction
  manager on the attach request.
  DFHZATT parses the request in a TIOA owned by an MRO session.
  Code in DFHZATT looks for an FMH43 and starts looking for
  a X'95' value in field FMHCARGN which signifies the presence
  of ACD data in the TIOA. However, the code fails to
  test if it has reached the end of the request before checking
  for a X'95' value.
  It encounters a X'95' which is part of residual data from a
  previous request processed using the same TIOA.
  DFHZATT references this residual data as CONTEXT_DATA when it
  issues the DFHXMAT ATTACH for transaction CSM5, but there
  is no CONTEXT_DATA in this case and the length passed to
  transaction manager is incorrect.
  

Problem conclusion

• DFHZATT has been changed to ensure that Application Context
  Data fits within the request held in the TIOA before passing
  this as CONTEXT_DATA to transaction manager.
  

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:

  PI22642 UI19970

Modules/Macros

• DFHZATT
  

Fix information

• Fixed component name

  CICS TS Z/OS V5

• Fixed component ID

  5655Y0400

Applicable component levels

• R800 PSY UI19970

     UP14/07/30 P F407

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.