Skip to main content

TPF : Support : Maintenance TPF : Support : Maintenance

Skip to: Abstract | Comments | Solution | Migration | Download

APAR NUMBER:  PJ29957                           
PRODUCT:  TPF4  
FUNCTIONAL AREA:  ISO-C SUPPORT  
SHIPPED IN PUT:  19  
   

ABSTRACT:  
This is a single-source APAR to backfit time zone (TZ) environment  
variable support from the next release back to TPF 4.1.  
   
APAR CONTENTS:  
FEATURE   TYPE                STATUS    NAME                                
Base      Object              Changed   obj/oco/ccint40.o  
Base      Object              Changed   obj/oco/cgmtme40.o  
Base      Object              Changed   obj/oco/cmktme40.o  
Base      Object              New       obj/oco/cotzst40.o  
Base      Object              Changed   obj/oco/csftme40.o  
Base      Object              Changed   obj/oco/csptme40.o  
Base      Object              Changed   obj/oco/cstlcl40.o  
Base      BldScript           Changed   source/rt/base/cisobs.bsc  
   
PREREQUISITE APARS:  To be applied in order listed.  
Base      Object              Changed   obj/oco/ccint40.o  
 PJ25589(09)  PJ21337(12)  PJ27367(14)  
Base      Object              Changed   obj/oco/cgmtme40.o  
 PJ21337(12)  
Base      Object              Changed   obj/oco/cmktme40.o  
 PJ21337(12)  
Base      Object              Changed   obj/oco/csftme40.o  
 PJ21337(12)  
Base      Object              Changed   obj/oco/csptme40.o  
 PJ21337(12)  
Base      Object              Changed   obj/oco/cstlcl40.o  
 PJ21337(12)  PJ27786(15)  
Base      BldScript           Changed   source/rt/base/cisobs.bsc  
 PJ28649(17)  
   

COMMENTS:  
Currently, the TZ environment variable is not supported on TPF 4.1. The  
time zone information is obtained from the LC_TOD category of the  
current locale. The LC_TOD locale category is not supported in the next  
release.  
   

SOLUTION:  
C support library (CISO) is modified to add support for the TZ  
environment variable. If the TZ environment variable is set, the local  
time zone information will be taken from it. If not, LC_TOD continues  
to be supported and used in TPF 4.1. The value of the TZ environment  
variable will specify the locale time zone and time difference/offset  
from GMT (called Universal Reference Time or Greenwich Mean Time).  
Where needed, it also can specify daylight saving time zone name,  
offset, start, and end of daylight saving time, specifying when  
daylight saving time should be in effect. This information can be used  
to map universal reference times to local times. The TZ environment  
variable is set by using the setenv function; for example:   
   
 setenv("TZ", "EST+5EDT,M4.1.0/2,M10.5.0/2",1)   
   
This specifies the Eastern time zone in the United States, which is 5  
hours behind Coordinated Universal Time (UTC), including the daylight  
saving time and the dates when daylight saving time will start (first  
Sunday in April at 2:00 a.m. M4.1.0/2) and end (last Sunday in October  
at 2:00 a.m. M10.5.0/2). If the offset for daylight saving time is  
omitted, it then defaults to 1 hour ahead of standard time (as in the  
previous example). The offset for time zone and daylight saving time  
can be in the form hh[:mm[:ss]]   
   
 setenv("TZ","AFT+04:30",1), setenv("TZ",  
"EST+5EDT01:00,M4.1.0/2,M10.5.0/2",1)   
   
If daylight saving time is not observed in the local time zone, the  
name and offset for the daylight saving time zone is not specified; for  
example:   
   
 setenv("TZ","WEST-1",1)   
   
This specifies the Western European standard time zone, which is 1 hour  
ahead of Coordinated Universal Time (UTC).  
   
   

DEPENDENCIES  
   
SEGMENTS TO BE ASSEMBLED OR COMPILED:  
None.  
   
SEGMENTS TO BE LINK EDITED:  
ciso40.exe (Shipped in Tar File)  
   
COREQS:  
None.  
   

MIGRATION CONSIDERATIONS:  
None.  
   
UPDATED INFORMATION UNITS:  
TPF Application Programming  
   
See your IBM representative if you need additional information.  
   

DOWNLOAD INSTRUCTIONS:  
http://www.ibm.com/software/htp/tpf/pages/maint.htm
   
-- END APAR PJ29957 
       


Download file(s): Login once to access server, leave window open, then click on link(s) below. Source Binary