PK06664: CICS CLOCK STUCK AT MIDNIGHT AND INTERVAL CONTROL STOPS WORKING.OCCURS WHEN CEMT PERFORM RESET IS NOT DONE FOLLOWING TIME CHANGE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When the local time offset is changed (as is frequently done
  for a summertime 'spring forward' or wintertime 'fall back' time
  change), an EXEC CICS or CEMT PERFORM RESET is necessary to make
  CICS aware of the change in the local time offset.  If no
  PERFORM RESET is done, then Interval Control STARTs that specify
  an explicit time will expire at the wrong time.  (They will
  expire at the old local time.)  And CICS-generated time stamps
  in messages and CEMT displays and EIBTIME will also reflect the
  old local time.  These are normal and expected consequences of
  not doing the PERFORM RESET .
      But in the case where the local time is moved back an hour
  (i.e. the local time offset from GMT goes from say -5 to -6 or
  from +3 to +2), interval control will stop working for EXEC CICS
  START and DELAY commands that specify an INTERVAL.  This will
  happen at the 1st new local midnight following the change in
  local time offset.  For the next 23 hours, CSATODP will be stuck
  at 2400000F and Interval Control commands will not work.  (At
  any time, however, a PERFORM RESET command will make everything
  work again.)
     The same problem also happens on a summertime 'spring
  forward' change.  But the problem only happens for the 1 hour
  prior to new local midnight (starting with the 2nd new local
  midnight after the time change.)
  

Local fix

• Do a CEMT PERFORM RESET
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: The CICS time-of-day becomes frozen and *
  *                      Interval Control stops working if       *
  *                      PERFORM RESET is not issued after       *
  *                      setting clocks forward or back to       *
  *                      adjust for Summer or Winter time.       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  DFHAPTIM runs at each CICS midnight to reset the CICS clock.
  However, this does not synchronize the CICS time-of-day with
  the system time-of-day if the system time-of-day has been set
  forward or back to adjust for Summer or Winter time.
  
  In this case, at the next CICS midnight, DFHAPTIM will reset
  the CICS clock to the system time-of-day instead of midnight.
  At the next midnight the CICS time-of-day will become frozen and
  Interval Control will stop working unless PERFORM RESET has been
  issued.
  
  Additional keywords: IC START DELAY RESETTIME DAYLIGHT DAYLITE
                       SAVING ZONE TIMEZONE
  

Problem conclusion

• A new system initialization parameter, AUTORESETTIME, has been
  added.  When AUTORESETTIME is NO (the default), if, at the next
  local midnight, the CICS time-of-day differs from the system
  time-of-day by more than 30 minutes CICS will issue message
  DFHAP1500 (MSGDFHAP1500) to indicate that a CEMT PERFORM RESET
  or EXEC CICS PERFORM RESETTIME is needed to synchronize the CICS
  time-of-day with the system time-of-day.  When AUTORESETTIME is
  YES, if, at the next local midnight, the CICS time-of-day
  differs from the system time-of-day by more than 30 minutes
  CICS will issue a PERFORM RESET to synchronize the CICS
  time-of-day with the system time-of-day.
  
  The CICS Transaction Server for z/OS Version 3 Release 1 CICS
  Data Areas manual, LY33-6107-00, will be updated as follows:
  
  Add CSAICMNR to the DFHCSAPS control block (CSA Common system
  area generator) at offset (5B) as follows:
  
   (5B) BITSTRING   1    CSAICIND       INTERVAL CONTROL INDICATOR
         ...1  ....       CSAICMNR      AUTORESETTIME INDICATOR
  
  Add SITICMNR and SITICMNR_X to the DFHSITPS control block (SIT
  System initialisation table) at offsets (513) and (556) as
  follows:
  
  (513) BITSTRING   1    SITMISC        Miscellaneous bits
         .1..  ....       SITICMNR      AUTORESETTIME specified
  
  (556) BITSTRING   1    *
         ....  ...1       SITICMNR_X    AUTORESETTIME overd code
  
  The CICS Transaction Server for z/OS Version 3 Release 1 CICS
  System Definition Guide, SC34-6428-00, will be updated as
  follows:
  
  Add the following parameter to section "Specifying DFHSIT macro
  parameters" in chapter "Specifying CICS system initialization
  parameters":
  
   ,AUTORESETTIME={NO|YES}
                   --
  Add the following parameter description to section "The system
  initialization parameter descriptions" in chapter "Specifying
  CICS system initialization parameters":
  
  AUTORESETTIME={NO|YES}
                 --
     specifies the action CICS should take if, at the next local
     midnight, the CICS time-of-day differs from the system
     time-of-day by more than 30 minutes (for example, after
     setting clocks forward or back to adjust for Summer and
     Winter time)
     NO   if, at the next local midnight, the CICS time-of-day
     --   differs from the system time-of-day by more than 30
          minutes CICS will issue message DFHAP1500 to indicate
          that a CEMT PERFORM RESET is needed to synchronize the
          CICS time-of-day with the system time-of-day.
     YES  if, at the next local midnight, the CICS time-of-day
          differs from the system time-of-day by more than 30
          minutes CICS will issue a PERFORM RESET to synchronize
          the CICS time-of-day with the system time-of-day.
  
  Add the following parameter to section "The default system
  initialization table" in chapter "Specifying CICS system
  initialization parameters":
  
  AUTORESETTIME=NO,         Time-of-day synchronization          *
  
  The CICS Transaction Server for z/OS Version 3 Release 1 CICS
  Messages and Codes manual, GC34-6442-00, will be updated as
  follows:
  
  Add message DFHAP1500 as follows:
  
  DFHAP1500 applid The CICS time-of-day is no longer synchronized
            with the system time-of-day.
  
  Explanation: The CICS time-of-day differs from the system
  time-of-day by more than 30 minutes.
  
  System Action: CICS continues.  However, as SIT parameter
  AUTORESETTIME is set to NO, a CEMT PERFORM RESET is needed
  to synchronize the CICS time-of-day with the system time-of-day.
  
  User Response: Use the CEMT PERFORM RESET (or EXEC CICS PERFORM
  RESETTIME) command to ensure that CICS immediately
  resynchronizes its local time  with that of the MVS TOD clock.
  This will ensure that the correct local time is used by all
  CICS functions, including the API.
  
  Destination: Console
  
  Modules: DFHAPTIM
  
  XMEOUT Parameters: applid
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

  PQ97470

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

  UK06715

Modules/Macros

•    DFHAPTIM DFHCSAD  DFHCSAPS DFHMEAPC DFHMEAPE
  DFHMEAPK DFHPASY  DFHSIA1  DFHSIT   DFHSIT$$ DFHSITPS DFHSIT6$
  DFH06664 MFHMEAPE
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK06715

     UP05/09/05 P F509

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.