PM44490: DFHSM0002 A SEVERE ERROR (CODE X'0A08') HAS OCCURRED IN MODULE DFHSMST

Obtain the fix for this APAR.

APAR status

• Closed as unreproducible in next release.

Error description

• The TI timer task has been started for interval statistics and
  your CICS region receives the following messages and a dump
  for DFHSM0002 (CODE X'0A08').
  .
  DFHMN0101 SMF error - SMF return code X'24'.
  DFHST0103 An SMF error has occurred with return code X'24'.
  DFHSM0002 A severe error (code X'0A08') has occurred in module
  DFHSMST.
  .
  The CICS Internal trace shows trace exceptions :
  TI QR ST 0059 STST  *EXC* SMF_ERROR
  TI QR SM 0A08 SMST  *EXC*
                       Unexpected_return_code_from_UNLOCK_request
                    COLLECT_STATISTICS,C64CF1B5400B6737,YES,YES,NO
  .
  Additional Symptom(s) Search Keyword(s): 5655s9700 600 V410
  KIXREVJXD
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: During DFHSMST COLLECT_STATISTICS, CICS *
  *                      encounters DFHSM0002 A severe error     *
  *                      (code X'0A08') has occurred in module   *
  *                      DFHSMST.                                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  CICS enters the DFHSMST COLLECT_STATISTICS routine, and
  acquires the SMLOCK. During this routine, an SMF error occurs
  during write_buffer_to_smf processing. This error causes
  message DFHST0103 (An SMF error has occurred with return code
  X'xx') to be issued, and a dump taken.
  Taking a dump requires the SMLOCK to be acquired, but this
  task already holds the SMLOCK. The lock manager call returns
  an LMLM_EXCEPTION of LMLM_DUPLICATE_OWNER, but this is not
  tested for. SMGF assumes that it just acquired the SMLOCK, and
  when it finishes it frees the lock. Control passes back to
  DFHSMST. Eventually, this module also issues an unlock for the
  SMLOCK, when it finds it is no longer the owner.
  This leads to CICS issuing message
  DFHSM0002 A severe error (code X'0A08') has occurred in module
  DFHSMST.
  accompanied by exception trace point
  SM 0A08 SMST  *EXC* - Unexpected_return_code_from_UNLOCK_request
  
  Additional Keywords: msgDFHSM0002 SM0002
  

Problem conclusion

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• DFHSMGF has been amended to test the LMLM response codes. The
  smlock_held bit will now only be turned on if the response
  LMLM_OK was returned. The lock will only be freed on exit if
  this bit is on. New trace points have been added to provide
  additional documentation.
  This APAR also includes the functionality added to CICS
  Transaction Server for z/OS Version 4 Release 1 by APAR PM25342.
  
  The CICS Transaction Server for z/OS Version 3 Release 2
  Trace Entries manual (SC34-6828-04) will be updated in
  Chapter 39 Storage manager domain trace points, in table 178
  'Storage manager domain trace points' with three new entries:
  
  
  PointID | Module  | Lvl | Type           | Data
  
  SM 0321 | DFHSMGF | Exc | Lock error     | 1 SMGF parameter list
          |         |     |                | 2 SCA name
          |         |     |                | 3 LMLM parameter list
  
  SM 0322 | DFHSMGF | Exc | Unlock error   | 1 SMGF parameter list
          |         |     |                | 2 SCA name
          |         |     |                | 3 LMLM parameter list
  
  SM 0323 | DFHSMGF | Exc | Duplicate      | 1 SMGF parameter list
          |         |     | owner          | 2 SCA name
          |         |     |                | 3 LMLM parameter list
  

APAR Information

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

  PM19135

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

  UK75929

Modules/Macros

•    DESSMCDU DESSMDC  DESSMGF  DFHSMDCC DFHSMDCD
  DFHSMGF  DFHSMGFA DFHSMGFM DFHSMGFT DFHSMTRI
  

Fix information

• Fixed component name

  CICSTS V3 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R500 PSY UK75929

     UP12/02/17 P F202

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.