PK38508: WHEN USING FORMATTIME DATESTRING THE TIME RETURNED SHOULD BE GMT BUT IT IS RETURNING LOCAL TIME.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Using ASKTIME, then FORMATTIME using DATESTRING does not return
  the GMT but the local time, GMT should be returned.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All.                                         *
  ****************************************************************
  * PROBLEM DESCRIPTION: EXEC CICS FORMATTIME command with       *
  *                      DATESTRING specified returns a          *
  *                      formatted local time instead of a       *
  *                      GMT time.                               *
  *                      A similar problem occurs with EXEC      *
  *                      CICS CONVERTTIME.                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  An EXEC CICS ASKTIME ABSTIME command is issued followed by an
  EXEC CICS FORMATTIME ABSTIME DATESTRING command. The date and
  time returned in DATESTRING is LOCAL time and should be GMT in
  the format RFC1123.
  This is because no routine exists to convert ABSTIME, which is
  always represented as local time, to GMT for EXEC CICS
  FORMATTIME commands.
  A similar problem exists for EXEC CICS CONVERTTIME.
  
  Following is an example of the output to expect from EXEC CICS
  FORMATTIME DATESTRING command both before and after the fix has
  been applied. ABSTIME used is local zone +1 hour ahead of GMT.
  
  Without Fix:
  
  EXEC CICS FORMATTIME
   ABSTIME (3391231461300)
   TIME ('084421..')
   DATESTRING ('Tue, 19 Jun 2007 08:44:21 GMT')
  
  With Fix:
  
  EXEC CICS FORMATTIME
   ABSTIME (3391231461300)
   TIME ('084421..')
   DATESTRING ('Tue, 19 Jun 2007 07:44:21 GMT')
  
  Additional Keywords: TIME_ZONE CVTLDTO
  

Problem conclusion

• DFHTIMF has been modified to convert local abstime value to
  the correct GMT value.
  
  The CICS Transaction Server for z/OS, Application Programming
  Reference manual, Version 3 Release 1 ( SC34-6434-04 ) will be
  updated as follows :
  
  In section 1.47, CONVERTTIME add the following to the
  description for DATESTRING.
  
  If the data-area specified is RFC1123 format, which is always
  at GMT, the date and time will be converted to local time.
  
  In section 1.87, FORMATTIME add the following to the description
  for option ABSTIME.
  
  It is expected that ASKTIME ABSTIME will be run before
  FORMATTIME ABSTIME. If ABSTIME is from any other source,
  the output from FORMATTIME may be incorrect.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• ž**** PE07/12/19 FIX IN ERROR. SEE APAR PK54145  FOR DESCRIPTION
  ž**** PE08/05/16 FIX IN ERROR. SEE APAR PK64527  FOR DESCRIPTION
  

APAR Information

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

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

  UK26483 PK48745

Modules/Macros

•    DESTIMF  DFHTIMF
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK26483

     UP07/07/03 P F707

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.