TZDATA - process a time zone definition file.

Syntax:

tzdata file [TZData=procfile]

Options:

file
is either a text file containing definitions for time zones and time zone locales, or a processed time zone definition file. If this argument is omitted, TZDATA uses the default processed time zone definition file:
uw_tools/rfw1.6/aux/tzdata
TZData=procfile
writes a processed version of the definitions to the specified file.

Description:

TZDATA reads a time zone definition file given in either text format or processed (binary) format. If you specify the TZData= option, TZDATA writes a processed version of the file to the specified "procfile". Processed time zone definition files are read by the B library function .TINIT in order to provide time zone information to a program.

TZDATA always writes a text version of the time zone definitions to the standard output. This text version contains no comments except for the first line of output; this first line is a comment giving the number of words of memory the time zone definitions will occupy when loaded into a program.

As an example of how TZDATA can be used, consider

tzdata >deffile
Since there is no input file specified, TZDATA reads the standard processed time zone definition file, and writes a text version of this file to the standard output (deffile). You can then examine and edit these definitions if you wish, by using a text editor on "deffile". When you're done, you can process "deffile" into your own customized time zone definition file with
tzdata deffile tzdata=/myproc >check
This takes the text definitions in "deffile" and creates a processed version in "/myproc". It also writes a text version of the definitions into "check", which you can examine if you like. The first line will be of most interest, since that gives the memory space required to hold the tables you've just processed.

Files Used:

uw_tools/rfw1.6/aux/tzdata

See Also:

expl b tz
for information about time zone definition files.
expl b lib .tinit
 

Copyright © 2000, Thinkage Ltd.