PH52634: DFHRM0400 - A UNIT OF WORK WAS INCOMPLETELY RECONSTRUCTED FROM THE SYSTEM LOG.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• CICS was cancelled by automation software and on the
  subsequent restart the following error was encountered :
  
  DFHRM0400 - A unit of work was incompletely reconstructed
              from the system log.
  
  The log showed the following prior the restart of CICS :
  
  DFHRM0205 An activity keypoint has been successfully taken.
  DFHLG0743 Tail of log stream <hlq>.DFHLOG deleted at block
              id X'00000164AB0E8FA7'.
  
  The DFHRM0400 was then seen on the restart, CICS terminated
  with a dump.
  
  The error was as a result of an EXIS record containing
  nulls for backward pointer and offset. EXIS records log
  the existence of units of work that CICS is interested
  in. The backward pointer and offset within the EXIS log
  record should point at what was the UOW log chain's previous
  head's blockid and offset within the block.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICS users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: CICS is cancelled then COLD started.    *
  *                      Message 'DFHRM0400 - A unit of work was *
  *                      incompletely reconstructed from the     *
  *                      system log' is output and CICS          *
  *                      terminates with a dump.                 *
  ****************************************************************
  A CICS task needed to make a log entry so log manager creates a
  log chain buffer to hold the information. Before this entry got
  completed and written out to DFHLOG, a keypoint occurred.
  
  The keypoint task CSKP noted the inflight unit of work (UOW)
  so wrote an EXIS record to the log from the data available in
  the log manager buffer.
  
  However, as creation of this log entry did not complete, the
  backwards chain pointer to the UOW's log chain was at its
  initialised value of nulls in offsets  x'24' and x'30'.
  
  So although there is a log chain buffer for a UOW, this does
  not guarantee the UOW has logged anything yet.
  

Problem conclusion

• DFHRMUW, DFHRMUW1 & DFHRMUW4 have been changed to set a new bit
  after a log write is successful and to test for it in the EXIS
  logging path.
  

Temporary fix

Comments

APAR Information

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

  PH52602

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

  UI94928

Modules/Macros

• DFHR2TRI DFHRMCD  DFHRMCD1 DFHRMCD2 DFHRMCI2 DFHRMCI3 DFHRMCI4
  DFHRMDM  DFHRMDU0 DFHRMDU2 DFHRMDU3 DFHRMDU4 DFHRMDU5 DFHRML1D
  DFHRMLK1 DFHRMLK2 DFHRMLK3 DFHRMLK4 DFHRMLK5 DFHRMLKQ DFHRMLN
  DFHRMLSD DFHRMLSF DFHRMLSO DFHRMLSP DFHRMLSS DFHRMLSU DFHRMNM
  DFHRMNM1 DFHRMNS1 DFHRMNS2 DFHRMOT  DFHRMR1D DFHRMR1E DFHRMR1K
  DFHRMR1S DFHRMRO  DFHRMRO1 DFHRMRO2 DFHRMRO3 DFHRMRO4 DFHRMROO
  DFHRMROS DFHRMROU DFHRMROV DFHRMRS  DFHRMSL5 DFHRMST  DFHRMST1
  DFHRMTRI DFHRMU1C DFHRMU1D DFHRMU1E DFHRMU1F DFHRMU1G DFHRMU1J
  DFHRMU1K DFHRMU1L DFHRMU1N DFHRMU1Q DFHRMU1R DFHRMU1S DFHRMU1U
  DFHRMU1V DFHRMU1W DFHRMUC  DFHRMUO  DFHRMUW  DFHRMUW0 DFHRMUW1
  DFHRMUW2 DFHRMUW3 DFHRMUWB DFHRMUWE DFHRMUWF DFHRMUWH DFHRMUWJ
  DFHRMUWL DFHRMUWN DFHRMUWP DFHRMUWQ DFHRMUWS DFHRMUWU DFHRMUWV
  DFHRMUWW
  

Fix information

• Fixed component name

  CICS TS Z/OS V6

• Fixed component ID

  5655YA100

Applicable component levels

• R400 PSY UI94928

     UP23/12/15 I 1000

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.