home *** CD-ROM | disk | FTP | other *** search
/ TopWare Tools / TOOLS.iso / tools / top1468 / timez.doc < prev    next >
Encoding:
Text File  |  1994-01-05  |  44.7 KB  |  826 lines

  1. TIMEZ - A PROGRAM TO TRACK WORLD TIME
  2.  
  3.  
  4. 1.  What is TimeZ?/Requirements/Setup
  5. 2.  Main Screen
  6. 3.  Entering New Time Zones
  7. 4.  Showing a Time Zone
  8. 5.  Editing a Time Zone
  9. 6.  Listing all Time Zones
  10. 7.  Printing all Time Zones
  11. 8.  The Master Clock
  12. 9.  Setting your Clock
  13. 10. The Exchange Rate Calculator
  14. 11. The idxreb utility 
  15. 12. Registration Information 
  16. 13. Program Updates 
  17.  
  18. 1. What is TimeZ?
  19.  
  20.  TimeZ is a program for use by people who NEED to know what time it is
  21. elsewhere in the world.  By entering the proper data into TimeZ, you can
  22. see the current time in any of up to 54 places at once, and an infinite 
  23. number of places in total.
  24.  
  25.  By entering the correct data about a place, specifically about whether 
  26. Daylight Savings is observed there, and if so, when, TimeZ will adjust for 
  27. Daylight Savings in your time zone and those of the other places.  Changes 
  28. in a place's DST status is constantly checked, so updates are immediate.
  29.  
  30.  For people who do not necessarily require that they know the time in many 
  31. places, TimeZ can still be of interest.  During any military operation, 
  32. like Desert Storm or Restore Hope, did you ever wonder the time in the 
  33. place where the troops were?  To find out, just add Iraq or Somalia to 
  34. the Master Clock.
  35.  
  36.  Version 1.3 of TimeZ adds data fields for other information about a place:
  37. Its currency and exchange rate (US dollars), national languages, and type
  38. of government.  These additions can aid the world traveller, and can be a
  39. useful educational tool.
  40.  
  41.  Included with TimeZ is a data file with its companion index files.  In 
  42. these files are over 250 entries to get you started.  Or you can start 
  43. from scratch, whichever works best for you.
  44.  
  45.  I have tried to make TimeZ simple to use.  It does not use any graphics - 
  46. just text for a straight forward readout of the current time.  No three-
  47. letter abbreviations or ANSI-character maps of the world.  I hope you 
  48. find TimeZ enjoyable.
  49.  
  50. Requirements
  51.  
  52.  The requirements of TimeZ are rather simple.  An IBM PC compatible with 
  53. at least 128K RAM, a color monitor (CGA or better), and a disk of some 
  54. sort (hard or floppy) to store the data on.  The size of the data file 
  55. depends on how many entries you make, but even with hundreds of entries, 
  56. TimeZ would still run off of a 360K floppy.  The DOS/Windows utility 
  57. SmartDrv or some other disk cache utility is suggested for best performance.
  58.  
  59.  TimeZ uses four files.  The TimeZ executable (TimeZ.EXE), the data file
  60. (TZ.DAT), a names index file (TZ.IDX), and a sounds-like index (TZSZ.IDX).
  61.  
  62. Setup
  63.  
  64.  Before using TimeZ, you should set the DOS environment variable TZ.  If 
  65. you do not set TZ, DOS will assume that you are in the Pacific Standard 
  66. Time time zone.  Here's what you need to do to set your TZ variable:
  67.  
  68.  Determine your time zone name.  For example, the U.S. has six main time 
  69. zones: Eastern, Central, Mountain, Pacific, Alaska-Hawaii, and Bering.  
  70. Canada uses these and three others: Newfoundland, Atlantic, and Yukon, 
  71. with Yukon being the same as Pacific.  Next, determine if you observe 
  72. Daylight Savings Time in your area.  Most of the U.S. and Canada does, with 
  73. Arizona, Hawaii, and parts of Indiana being notable exceptions.
  74.  
  75.  Next, determine how far ahead of Greenwich Mean Time your location is.
  76. Greenwich, England, and the Prime Meridian which passes through Greenwich, 
  77. is the starting point for all world time.  Most atlases or almanacs will 
  78. help you determine this.  For example, the Eastern time zone is five hours 
  79. ahead of Greenwich.
  80.  
  81.  Lastly, make up a string of characters to represent your time zone.  The 
  82. string must be at least four characters long.  The first three characters 
  83. represent the time zone.  The next characters determine the time difference 
  84. in hours from Greenwich.  The last three characters are used only if 
  85. Daylight Savings is observed where you are.  Here are examples of the TZ 
  86. string:
  87.  
  88. NST3.5NDT   Newfoundland
  89. AST4ADT     Canadian Maritimes
  90. EST5EDT     Eastern Time Zone
  91. EST5        Parts of Indiana
  92. CST6CDT     Central Time Zone
  93. MST7MDT     Mountain Time Zone
  94. MST7        Arizona
  95. PST8PDT     Pacific Time Zone
  96. YST8        Parts of the Yukon
  97. HDT9HST     Alaska-Hawaii Time Zone
  98. HDT9        Hawaii
  99. BDT10BST    The Aleutians
  100.  
  101.  Finally, set the TZ variable equal to your time zone string.  Use the DOS 
  102. Set command to do this.  For example:
  103.  
  104. C:\> set TZ=EST5EDT <ENTER>
  105.  
  106.  For best results, the following line should be set in your AUTOEXEC.BAT 
  107. file:
  108.  
  109. set TZ=EST5EDT
  110.  
  111.  Consult your DOS manual for details about the AUTOEXEC.BAT file.
  112.  
  113.  
  114. 2.  Main Screen
  115.  
  116.  Assuming a data file already exists and is in the same directory as the 
  117. TimeZ program, when starting TimeZ, your screen will look like this:
  118.  
  119.  +---------------------------+ TimeZ Version 1.3 +----------------------------+
  120.  |                                                                            |
  121.  |                                                                            |
  122.  |                                                                            |
  123.  |                        1. Add New Place Entry                              |
  124.  |                        2. Scan Place Entries                               |
  125.  |                        3. Edit Existing Place Entry                        |
  126.  |                        4. List Place Entries                               |
  127.  |                        5. Print Place Entries                              |
  128.  |                        6. Master Clock                                     |
  129.  |                        7. Set Local Date/Time                              |
  130.  |                        8. Quit                                             |
  131.  |                                                                            |
  132.  |                        Enter your choice:                                  |
  133.  |                                                                            |
  134.  |                        F2=Toggle 12/24 hour time                           |
  135.  |                                                                            |
  136.  |                                                                            |
  137.  |                                                                            |
  138.  |                                                                            |
  139.  |                      Current local time: 00:00:00                          |
  140.  |                      Current GMT time..: 00:00:00                          |
  141.  |                                                                            |
  142.  |                Copyright (c) 1994, Steve Mount Software                    |
  143.  +----------------------------------------------------------------------------+
  144.  
  145.  This screen shows the version number at the top, the main menu, a prompt
  146. explaining how to toggle the use of 12-hour time keeping or 24-hour time 
  147. keeping, and a display of the current local and Greenwich Mean Time (GMT).  The 
  148. time displays are real-time and kept up to date as the program awaits input.
  149.  
  150.  If you started TimeZ and there was no data file in the same directory, you 
  151. will see a box like this overlaid on the main menu screen:
  152.  
  153. +---------------------------------------------------------------------+
  154. | TimeZ Directory:                                                    |
  155. +---------------------------------------------------------------------+
  156.  
  157.  In this box, you should type the name of the directory that the TimeZ data is 
  158. in.  If the TimeZ data files do not already exist (for example, you are 
  159. creating a new database), then the name of the directory the files should be 
  160. created in should be typed here.  If no TimeZ data exists in the directory you 
  161. type in, TimeZ will assume you wish to create a new database.  This 
  162. confirmation box will appear:
  163.  
  164. +--------------------------------------+
  165. | Data file does not exist.  Create? Y |
  166. +--------------------------------------+
  167.  
  168.  Note that the default answer is (Y)es.  If you do not wish to create a new 
  169. data file (for example, you mistyped the directory name), then type (N)o and 
  170. press ENTER.  You will be returned to the "TimeZ Directory" box.
  171.  
  172. 3. Entering New Time Zones
  173.  
  174.  TimeZ requires a database of  locations and their time zones to work most
  175. effectively.  Without this database, all TimeZ can do is show you is the
  176. current local and GMT time.  To enter this data, simply press 1 at the main 
  177. menu.  A screen that looks like this will appear:
  178.  
  179.  +----------------------+ Enter New Time Zone Record +------------------------+
  180.  |                                                                            |
  181.  |                                                                            |
  182.  |                                                                            |
  183.  | Place.....:                                                                |
  184.  | Short Name:                                                                |
  185.  | GMT Adjust:                                                                |
  186.  | Daylight Savings Apply? (Y/N).: Y  Starts:              Ends:              |
  187.  | Master Clock Screen (A-Z, 0-9): A                                          |
  188.  |                                                                            |
  189.  | Currency..........:                            Cur/$US:                    |
  190.  | Language(s).......:                                                        |
  191.  | Type of Government:                                                        |
  192.  |                                                                            |
  193.  |                                                                            |
  194.  |                                                                            |
  195.  |       F9=Save and Return to Main Menu   F10=Save and enter another         |
  196.  |                   ESC=Abort entry, Return to Main Menu                     |
  197.  |                                                                            |
  198.  |          Insert DST for:  F1=USA  F2=UK  F3=Europe  F4=Australia           |
  199.  |                                                                            |
  200.  |                                                                            |
  201.  |                                                                            |
  202.  |                                                                            |
  203.  +----------------------------------------------------------------------------+
  204.  
  205.  Each field is explained in turn:
  206.  
  207.  Place:  This field is for the full name of a place.  This place may be a city 
  208. or a country or a state, province, or county.  It is up to you.  Obviously, if 
  209. the place is a large geographic area, the entire area should be encompassed by 
  210. the same time zone and Daylight Savings Time (DST) rules.  The Place name can 
  211. be up to 40 characters long.
  212.  
  213.  Short Name:  The field should contain the short name of the place.  The short
  214. name will be used on the Master Clock to conserve space.  For example, if the 
  215. Place is "Los Angeles, California", the Short Name may be "L.A., CA".  The 
  216. Short Name may be up to 10 characters long.
  217.  
  218.  GMT Adjust:  Input the number of hours that the Place is from GMT.  For 
  219. example, the East Coast of the U.S. is five hours earlier than GMT.  In this 
  220. field, type -5. For another example, France is one hour later than GMT.  You 
  221. may type either 1 or +1 here.  For places with odd GMT offsets, like 
  222. Newfoundland's 3.5 hours earlier, decimal fractions are OK (-3.5, +4.75, etc).  
  223. If you input nothing in this field, 0 will be assumed. Be sure to type the 
  224. offset when the time zone you are entering is not in DST.
  225.  
  226.  Daylight Savings Apply? (Y/N):  A Yes or No question, is DST observed in this
  227. place?
  228.  
  229.  Starts:  If DST does apply, then enter here when it starts.  The format of 
  230. this entry is either:  MMMDD or MMMmDDD.  In both examples, the first three 
  231. characters should be the month DST starts in.  Choose from:  JAN, FEB, MAR, 
  232. APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, or DEC. 
  233.  In the first example (MMMDD), the fourth and fifth characters should be a 
  234. valid date within that month.  For example, if DST always starts on April 1st, 
  235. input APR01.
  236.  In the second example, the fourth character is a modifier.  It can be one of 
  237. the following:  1, 2, 3, 4, 5, F, or L.
  238.  The fifth through seventh characters should be an abbreviation for a day of 
  239. the week.  Use the following:  SUN, MON, TUE, WED, THU, FRI, SAT, or DAY.  
  240. You may use "DAY" with the F and L modifiers only.
  241.  Examples:
  242.  APR1SUN: DST starts on the first Sunday in April
  243.  SEPLMON: DST starts on the last Monday in September
  244.  MAR2TUE: DST starts on the second Tuesday in March
  245.  DEC31:   DST starts on December 31st.  Same as DECLDAY
  246.  
  247.  Ends:  If DST does apply, then enter here when it ends.  Use the same format 
  248. as for "Starts".
  249.  
  250.  Master Clock Screen (A-Z, 0-9):  Fill in any letter A through Z or number 0
  251. through 9.  This indicates the Master Clock screen that this entry will print 
  252. on.  Using Master Clock screens, you can group like entries or places of 
  253. interest together for monitoring.  Note that though you can only have a place 
  254. assigned to one screen at a time, minor variations in the Place string will 
  255. allow a seemingly similar entry to be in each of two screen.  For example, 
  256. "New York City 1" and "New York City 2".
  257.  
  258.  Currency:  Fill in the name of the currency used by this place.  There is 
  259. space for 20 characters.  For example, if the place is Dallas, Texas, you may
  260. wish to type Dollars or US Dollars.
  261.  
  262.  Cur/$US: Type in the number of units of this currency needed to equal one US
  263. dollar.  A decimal point may be used.  For example, the rate for US dollars is
  264. 1.0000.  The rate for Canadian dollars may be 1.3285.  Six positions are
  265. provided for the rate.  The smallest possible value is .00001 and the highest
  266. is 999999.  This field must be filled in to use the Exchange Rate Calculator
  267. later in the program.
  268.  
  269.  Languages:  Type in the most common languages for this place.  For example,
  270. for France, the language would be French.  25 characters are provided for this
  271. data.
  272.  
  273.  Type of Government:  Type in the type of government for this place.  Some 
  274. examples may be "State of USA", "Communist", and "Monarchy".  20 characters are
  275. provided for this data.
  276.  
  277.  The following keys may be pressed on this screen:
  278.  
  279.  F1 will insert the United States DST start/end strings into the record
  280.  F2 will insert the United Kingdom DST start/end strings into the record
  281.  F3 will insert the European DST start/end strings into the record
  282.  F4 will insert the Australian DST start/end strings into the record
  283.  F9 saves the entry and return to main menu
  284.  F10 saves the entry and gives the user a blank screen to begin a new entry
  285.  ESC aborts the addition of the current entry and returns to the main menu
  286.  ENTER, TAB, Down Arrow moves to the next field
  287.  Shift-TAB, Up Arrow moves to the previous field
  288.  Delete, Backspace, Insert, Home, and End for editing
  289.  
  290.  If you enter a Place that already exists (the Place name exactly matches a 
  291. Place already in the data file), you will be given an error message and a 
  292. chance to edit the entry.
  293.  
  294. 4.  Showing a Time Zone
  295.  
  296.  To display the time zone record for a place already entered, press 2 from the 
  297. main menu.  You will see a screen like this:
  298.  
  299.  +-----------------------| Scan For Time Zone Record |------------------------+
  300.  |                                                                            |
  301.  |                                                                            |
  302.  |                                                                            |
  303.  | Place.....:                                                                |
  304.  | F2=Sounds-like search                                                      |
  305.  |                                                                            |
  306.  |                                                                            |
  307.  |                                                                            |
  308.  |                                                                            |
  309.  |                                                                            |
  310.  |                                                                            |
  311.  |                                                                            |
  312.  |                                                                            |
  313.  |                                                                            |
  314.  |                                                                            |
  315.  |                                                                            |
  316.  |                                                                            |
  317.  |                                                                            |
  318.  |                                                                            |
  319.  |                                                                            |
  320.  |                                                                            |
  321.  |                                                                            |
  322.  |                                                                            |
  323.  +----------------------------------------------------------------------------+
  324.  
  325.         Enter the place to search for in the field.  Press ENTER when done.  If you do not
  326. know the exact spelling of a place, then you may press F2 instead of ENTER to begin the
  327. search.  This will perform a "sounds-like" search instead of a straight string search.  The
  328. sound seach uses English phonemes to store and search the place name.  If using sound
  329. search, beware of this.
  330.  
  331.         An example of the difference:  Assume there are two entries, Starksboro and
  332. Stratton.  By typing "str" and pressing ENTER, you would display Stratton, the first
  333. match alphabetically.  However, press F2 instead of ENTER will display Starksboro, the
  334. first phonetic match (vowels do not count).
  335.  
  336.         Once you have pressed either ENTER or F2, you will see a screen like this:
  337.  
  338.  
  339.  +--------------------------| Scan Place Entries |----------------------------+
  340.  |                                                                            |
  341.  |                                                                            |
  342.  |                                                                            |
  343.  | Place.....: Starksboro, Vermont                                            |
  344.  | Short Name: Starksboro                                                     |
  345.  | GMT Adjust: -5                                                             |
  346.  | Daylight Saving Applies? (Y/N): Y  Starts: APR1SUN      Ends: OCTLSUN      |
  347.  | Master Clock Screen (A-Z, 0-9): D                                          |
  348.  |                                                                            |
  349.  | Currency..........: US Dollar                  Cur/$US: 1.0000             |
  350.  | Language(s).......: English                                                |
  351.  | Type of Government: State of USA                                           |
  352.  |                                                                            |
  353.  |                                                                            |
  354.  |                                                                            |
  355.  |        F8=View Next  F9=View Previous  F10=View Another  ESC=Exit          |
  356.  |                        F5=Exchange Rate Calculator                         |
  357.  |                                                                            |
  358.  |                                                                            |
  359.  |                                                                            |
  360.  |                                                                            |
  361.  |                                                                            |
  362.  |                                                                            |
  363.  +----------------------------------------------------------------------------+
  364.  
  365.  You are prompted with six choices.  You may press F8 to view the next
  366. sequential record, F9 to view the previous record, or F10 to start a new
  367. search. F5 will start the Exchange Rate Calculator.  You may also press ESC at
  368. any time to end the search. Note that in Scan mode you may not change any of
  369. the info in the record.  It is view only. 
  370.  
  371.  
  372. 5.  Editing a Time Zone
  373.  
  374.  To edit a time zone already in the data file, press 3 at the main menu.  You 
  375. will see a screen similar to that shown in Chapter 4.  Enter the name of the 
  376. place you wish to edit in the Place field and press either ENTER or F2.  If 
  377. there is a match, you will see a screen like this:
  378.  
  379.  +-----------------------+ Edit Old Time Zone Record +------------------------+
  380.  |                                                                            |
  381.  |                                                                            |
  382.  |                                                                            |
  383.  | Place.....: Starksboro, Vermont                                            |
  384.  | Short Name: Starksboro                                                     |
  385.  | GMT Adjust: -5                                                             |
  386.  | Daylight Savings Apply? (Y/N).: Y  Starts: APR1SUN      Ends: OCT3SUN      |
  387.  | Master Clock Screen (A-Z, 0-9): D                                          |
  388.  |                                                                            |
  389.  | Currency..........: US Dollar                  Cur/$US: 1.0000             |
  390.  | Language(s).......: English                                                |
  391.  | Type of Government: State of USA                                           |
  392.  |                                                                            |
  393.  |                                                                            |
  394.  |                                                                            |
  395.  |                     F8=Save/Edit Next  F9=Save/Return                      |
  396.  |                  F10=Save/Edit Another  ESC=Abort/Return                   |
  397.  |                                                                            |
  398.  |          Insert DST for:  F1=USA  F2=UK  F3=Europe  F4=Australia           |
  399.  |                        F5=Exchange Rate Calculator                         |
  400.  |                                                                            |
  401.  |                                                                            |
  402.  |                                                                            |
  403.  +----------------------------------------------------------------------------+
  404.  
  405.  This screen works in the same way as the Enter New Time Zone Record screen.
  406. All field descriptions are the same.  The function keys that can be used on 
  407. this screen are:
  408.  
  409.  F1 will insert the United States DST start/end strings into the record
  410.  F2 will insert the United Kingdom DST start/end strings into the record
  411.  F3 will insert the European DST start/end strings into the record
  412.  F4 will insert the Australian DST start/end strings into the record
  413.  F5 will start the Exchange Rate Calculator
  414.  F8 to Save the current entry and then edit the next entry
  415.  F9 to Save the current entry and then return to the main menu
  416.  F10 to Save the current entry and then search for another entry to edit
  417.  ESC to Abort the changes to the current entry and return to the main menu
  418.  ENTER, TAB, Down Arrow moves to the next field
  419.  Shift-TAB, Up Arrow moves to the previous field
  420.  Delete, Backspace, Insert, Home, and End for editing
  421.  
  422. 6.  Listing all Time Zones
  423.  
  424.  By pressing 4 at the main menu, you will see a screen similar to this one:
  425.  
  426.  +-------------------------| List Place Selection |---------------------------+
  427.  |                                                                            |
  428.  |                                                                            |
  429.  |                                                                            |
  430.  |                            1. Time Zone List                               |
  431.  |                            2. Currency List                                |
  432.  |                            3. Language List                                |
  433.  |                            4. Government List                              |
  434.  |                            5. Main Menu                                    |
  435.  |                                                                            |
  436.  |                            Enter your choice:                              |
  437.  |                                                                            |
  438.  |                                                                            |
  439.  |                                                                            |
  440.  |                                                                            |
  441.  |                                                                            |
  442.  |                                                                            |
  443.  |                                                                            |
  444.  |                                                                            |
  445.  |                                                                            |
  446.  |                                                                            |
  447.  |                                                                            |
  448.  |                                                                            |
  449.  |                                                                            |
  450.  +----------------------------------------------------------------------------+
  451.  
  452.  Press one of the numbers 1 through 5.  Pressing 5 will return you to the main
  453. menu.  The other numbers correspond to the four available screen listings.  1
  454. will show you a list of all places along with Time Zone information - GMT
  455. offset, the Daylight Saving flag, and the Master Clock screen.  2 shows all
  456. places with currency and exchange rate info.  3 shows the languages for each
  457. place, and 4 shows the government types for each place.  The following shows
  458. the screen produced by a Type 1 report (other reports have similar formats): 
  459.  
  460.  +--------------------------| List Place Entries +----------------------------+
  461.  |                                                                            |
  462.  | City                                      GMT Offset  DST  Master Screen   |
  463.  | ----------------------------------------  ----------  ---  -------------   |
  464.  | Adelaide, Australia                          +9.5      Y         E         |
  465.  | Afghanistan                                   4.5      N         A         |
  466.  | Alaska                                       -9        Y         A         |
  467.  | Albania                                      +1        Y         A         |
  468.  | Aleutian Islands, Alaska                    -10        Y         A         |
  469.  | Algeria                                      +1        N         A         |
  470.  | Alma-Alta, Kazakstan                         +6        Y         A         |
  471.  | American Samoa                              -11        N         A         |
  472.  | Andorra                                      +1        Y         A         |
  473.  | Angola                                       +1        N         A         |
  474.  | Archangel, Russia                            +4        Y         A         |
  475.  | Argentina                                    -3        N         A         |
  476.  | Arizona                                      -7        N         A         |
  477.  | Armenia                                      +4        Y         A         |
  478.  | Aruba                                        -4        N         A         |
  479.  | Austria                                      +1        Y         A         |
  480.  | Azores                                       -1        Y         A         |
  481.  | Bahamas                                      -5        Y         A         |
  482.  |                                                                            |
  483.  |              Press ESC to quit, any other key to continue...               |
  484.  +----------------------------------------------------------------------------+
  485.  
  486.  To get more detail about a Place, use the Scan Place Entries option (Chapter
  487. 2). 
  488.  
  489.  As you search through the data file, one screen of data at a time will 
  490. display.  Press any key between data screens to proceed, or ESC at any time to 
  491. return to the main menu.  On the final List screen, any key will return you to 
  492. the list place selection screen.
  493.  
  494. 7. Printing all Time Zones
  495.  
  496.  Pressing 5 at the main menu will bring you to this screen:
  497.  
  498.  +-----------------------------+ Print Entries +------------------------------+
  499.  |                                                                            |
  500.  |                                                                            |
  501.  |                                                                            |
  502.  |                                                                            |
  503.  |                                                                            |
  504.  |                                                                            |
  505.  |                                                                            |
  506.  |                                                                            |
  507.  |                       About to print TimeZ entries.                        |
  508.  |                                                                            |
  509.  |                 Press F1 for Short List, F2 for Long List                  |
  510.  |                        Press ESC to abort printing                         |
  511.  |                                                                            |
  512.  |                                                                            |
  513.  |                                                                            |
  514.  |                                                                            |
  515.  |                                                                            |
  516.  |                                                                            |
  517.  |                                                                            |
  518.  |                                                                            |
  519.  |                                                                            |
  520.  |                                                                            |
  521.  |                                                                            |
  522.  +----------------------------------------------------------------------------+
  523.  
  524.  Printing your entries is fairly simple.  The report will always go to LPT1.  
  525. DOS's Mode command can be used to change the actual i/o port of the LPT1 printer, 
  526. if need be.  There are two types of listing.  The first, the Short List, is 
  527. accessed by hitting F1 on this screen.  The short list has one line of 
  528. information for each place.  It will show the Place Name, Place Short Name, Place 
  529. GMT Offset, and Master Clock Screen.  Pressing F2 will print the Long List.  This 
  530. list includes all of the above, plus DST Flag, Start and End of DST, and the 
  531. Sound Meta for each Place.  You may press ESC here to abort the print process.
  532.  
  533.  After you press F1 or F2, you will be prompted one last time before the actual
  534. printing.  The Short/Long list prompt will be replaced with:
  535.  
  536. Press F1 for normal print, F2 to print CR/LF
  537.  
  538. Press F1 for normal printing (for example, Epson-compatible dot matrix printers) 
  539. or F2 if CR/LF must be sent at the end of each line (for example, LaserJet and 
  540. DeskJet printers).  Experiment if you are not sure which to use.  You may again 
  541. press ESC on this screen if you decide not to print.
  542.  
  543.  While the printing is happening, a short message will flash on the screen:
  544.  
  545. Printing.  Press ESC to abort...
  546.  
  547.  Pressing ESC will stop the print job.  However, your printer probably has a 
  548. print buffer - if this is the case, then the job will not stop printing until 
  549. the printer's buffer is empty.
  550.  
  551.  The output of the report will be similar to this:
  552.  
  553.  +----------------------------------------------------------------------------+
  554.  | TimeZ Entries Listing - Page 1                                             |
  555.  |                                                                            |
  556.  | Place                                     Short Name  GMT      Scn         |
  557.  | ----------------------------------------  ----------  -------  ---         |
  558.  | DST  Start    End      Sound Meta                                          |
  559.  | ---  -------  -------  ----------                                          |
  560.  |                                                                            |
  561.  | Adelaide, Australia                       Adelaide    +9.5      E          |
  562.  |  Y   OCTLMON  MAR3SUN  ADLDSTRL                                            |
  563.  |                                                                            |
  564.  | Afghanistan                               Afghanistn  4.5       A          |
  565.  |  N                     AFNSTN                                              |
  566.  |                                                                            |
  567.  | .                                                                          |
  568.  | .                                                                          |
  569.  | .                                                                          |
  570.  |                                                                            |
  571.  | 266 entries printed                                                        |
  572.  +----------------------------------------------------------------------------+
  573.  
  574.  
  575.  As mentioned, the Short List will not include the line that begins with "DST".
  576. Using the default program data file, the Short List will be about six pages.  
  577. The Long List will be about 16 pages.
  578.  
  579.  When the job is complete, you will be returned to the main menu.  If TimeZ
  580. detects an error on your printer while it is printing, you will see an 
  581. appropriate error message.
  582.  
  583. 8. Master Clock
  584.  
  585.  Pressing 6 at the main menu will bring you to the Master Clock.  This is where 
  586. you see the fruits of your labor, as it were.  The Master Clock shows you the 
  587. first 57 entries in each of up to 36 screen groups (see Chapter 3 for details 
  588. about Master Clock screens).  The Master Clock looks like this:
  589.  
  590.  +-----------------------------| Master Clock |-------------------------------+
  591.  | In Standard Time             08:09:12AM Sat            In Daylight Saving  |
  592.  |                                                                            |
  593.  | Afghanistn  05:39PM Sat  Baku Azerb  05:09PM Sat  Burma       07:39PM Sat  |
  594.  | Alaska      04:09AM Sat  Bangladesh  07:09PM Sat  Burundi     03:09PM Sat  |
  595.  | Albania     02:09PM Sat  Barbados    09:09AM Sat  Calgary     06:09AM Sat  |
  596.  | Aleutians   03:09AM Sat  Belgium     02:09PM Sat  Cameroon    02:09PM Sat  |
  597.  | Algeria     02:09PM Sat  Belize      07:09AM Sat  Canary Is   01:09PM Sat  |
  598.  | Alma-Alta   07:09PM Sat  Benin       02:09PM Sat  Cape Verde  12:09PM Sat  |
  599.  | Am Samoa    02:09AM Sat  Bermuda     09:09AM Sat  Cayman Is   08:09AM Sat  |
  600.  | Andorra     02:09PM Sat  Bhutan      07:09PM Sat  C.A.R.      02:09PM Sat  |
  601.  | Angola      02:09PM Sat  Boa Vista   10:09AM Sat  Chad        02:09PM Sat  |
  602.  | Archangel   05:09PM Sat  Boise, ID   06:09AM Sat  Chicago     07:09AM Sat  |
  603.  | Argentina   10:09AM Sat  Bolivia     09:09AM Sat  Chile       08:09AM Sat  |
  604.  | Arizona     06:09AM Sat  Bosnia-Her  02:09PM Sat  Xmas Is     03:09AM Sat  |
  605.  | Armenia     05:09PM Sat  Boston      08:09AM Sat  Cocos Is    07:39PM Sat  |
  606.  | Aruba       09:09AM Sat  Botswana    03:09PM Sat  Colombia    08:09AM Sat  |
  607.  | Austria     02:09PM Sat  Brasilia    11:09AM Sat  Comoros     04:09PM Sat  |
  608.  | Azores      12:09PM Sat  B Virgin    09:09AM Sat  Congo       02:09PM Sat  |
  609.  | Bahamas     08:09AM Sat  BrokenHill  11:39PM Sat  Cook Is     04:09AM Sat  |
  610.  | Bahrain     04:09PM Sat  Bulgaria    03:09PM Sat  Costa Rica  07:09AM Sat  |
  611.  | Baja        06:09AM Sat  Burkina Fa  01:09PM Sat  Cote d'Iv   01:09PM Sat  |
  612.  |                                                                            |
  613.  |            Showing screen A.  Press ESC to exit, or Screen key             |
  614.  +----------------------------------------------------------------------------+
  615.  
  616.  The layout is pretty straight forward.  There are three columns of 19 places 
  617. each.  Entries are filled in top to bottom, left to right (as you can see from 
  618. the alphabetical order).  Each place has the place's Short Name, current time 
  619. in hours and minutes, and the current day for this place.  The time will be in 
  620. 12-hour or 24-hour display mode depending upon the toggle done at the main 
  621. menu.  Note that entries may not be in alphabetical order as they are retrieved
  622. in Place Name order, and Place Name can differ from Short Name.
  623.  
  624.  Press any key A-Z or 0-9 to see that Master Clock screen.  The "A" screen is 
  625. the default.
  626.  
  627.  Although you cannot see it here, all places are displayed in white, except 
  628. those that are currently in DST.  Those places are shown in grey.
  629.  
  630.  You will see the notation "*OVERFLOW*" if you have assigned more than 57
  631. places to any one Master Clock screen.
  632.  
  633.  The top of the screen shows the current local time.  Since seconds are the same
  634. across the board, seconds are shown only for the local time.  Also at the top of 
  635. the screen is a key, showing the "In Standard Time" in white, the "In Daylight 
  636. Savings" in grey.
  637.  
  638.  When you are finished looking at the Master Clock, press the ESC key to 
  639. return to the main menu.
  640.  
  641. 10. Exchange Rate Calculator
  642.  
  643.  In various places throughout the program (notably the Scan and Edit screens),
  644. the Exchange Rate Calculator will be available.  When you press the key
  645. corresponding to the Calculator, the following box will appear:
  646.  
  647. +---------| Exchange Rate Calculator |---------+
  648. |    Amount to convert:                        |
  649. |                                              |
  650. |  F1=$ to Foreign  F2=Foreign to $  ESC=Exit  |
  651. +----------------------------------------------+
  652.  
  653.  You are prompted for an amount to convert.  You are given six spaces to type
  654. in an amount.  Decimal points may be used.  The F1 and F2 keys will convert the
  655. amount for you.
  656.  
  657.  If the amount you typed in was in US dollars, and you wish to know how much
  658. that amount is in the foreign currency (let's say French Francs).  Press F1. 
  659. The number of francs that much US currency is equal to will be displayed. 
  660. Conversely, if the number you typed is the number of francs you have, pressing
  661. F2 will show you the equivalent number of US dollars.  (The following examples
  662. are based on an exchange rate of 5.8940): 
  663.  
  664. F1 Example: 
  665.  
  666. +---------| Exchange Rate Calculator |---------+
  667. |    Amount to convert: 100                    |
  668. |            $100.00 = 589.40 Franc            |
  669. |  F1=$ to Foreign  F2=Foreign to $  ESC=Exit  |
  670. +----------------------------------------------+
  671.  
  672. F2 Example:
  673.  
  674. +---------| Exchange Rate Calculator |---------+
  675. |    Amount to convert: 100                    |
  676. |             100.00 Franc = $16.97            |
  677. |  F1=$ to Foreign  F2=Foreign to $  ESC=Exit  |
  678. +----------------------------------------------+
  679.  
  680.  Note the following:  The exchange rates included with TimeZ's sample data set
  681. are current as of January 3, 1994.  A few of the rates are not filled in (such
  682. as for Croatia).  The reasons for this may be that the currency's value is in
  683. too much of a state of flux at this time, or that the currency is not traded
  684. on the open market.  Also, even stable currencies fluctuate constantly relative
  685. to one another.  Frequent updates may be needed. 
  686.  
  687.  Note also that the rates given are international trading rates, which will
  688. differ slightly from official rates of various countries.  Mexico, for
  689. example, will not allow you to import pesos - you may only exchange dollars for
  690. pesos for use in Mexico in Mexico.  The trading rate is about 3.25 pesos per
  691. dollar.  The Mexican rate is something closer to 2.5 pesos/dollar.
  692.  
  693.  A final note:  The rate of, for example, francs to dollars and dollars to
  694. francs is assumed to be the same (inversely proportional).  This is not
  695. usually the case, however.  What this means is that a bank will sell you more
  696. francs for a dollar than it will sell a dollar for francs (you might get 5
  697. francs for one dollar, but have to pay 6 francs to get a dollar).  The
  698. Exchange Rate Calculator should be used for rough estimates only.
  699.  
  700.  Press ESC when you are done with the Calculator.
  701.  
  702. 11. The idxreb utility
  703.  
  704.  Should your index files ever be damaged, you can use the idxreb utility 
  705. included with TimeZ to rebuild them.  To do so, type:
  706.  
  707. C:\> idxreb <ENTER>
  708.  
  709.  If the dat and idx files are not in the same directory as the idxreb program, 
  710. then you will see:
  711.  
  712. TimeZ Data file not in current path.
  713. Enter path for data file:
  714.  
  715.  Alternately, you may provide the pathname on the command line by typing (for
  716. example):
  717.  
  718. C:\> idxreb \tzdata <ENTER>
  719.  
  720.  Enter the path of the directory the files are in (but not the filenames 
  721. themselves).  If the idx files exist in that directory, too, you will be 
  722. given a chance to change your mind:
  723.  
  724. One or more index files already exist.  Do you wish to
  725. overwrite them? (Y to continue, any other to abort):
  726.  
  727.  If you type Y and ENTER, or if there were no idx files in the directory, 
  728. idxreb will rebuild the index files.  This process should only take a 
  729. few moments.  Next, you will see the following message:
  730.  
  731. Resequence master screens? (Y to continue, any other to skip):
  732.  
  733.  If you type Y and ENTER, the master screen entry for each member of the data
  734. set will be set sequentially, overwriting the entry for master screen as
  735. currently entered. 
  736.  
  737. 12. Registration
  738.  
  739.  TimeZ is shareware, and I retain all copyrights to the program.  If you use 
  740. and like TimeZ, I request that you donate $10 to continue to use it.  If you 
  741. do, and also send a diskette (5.25 or 3.5 Double or High density), I will 
  742. include any new version of TimeZ, and its documentation.  Please enclose an 
  743. extra $1 to cover postage, and be sure to enclose your address.
  744.  
  745.  If you would like to register your copy of TimeZ and would like me to send 
  746. you a diskette with the latest version of TimeZ on it, please send an extra 
  747. $2 to cover postage and diskette costs.  Please specify diskette size and 
  748. density.
  749.  
  750.  Also see PRICE.LST for an invoice and other ordering info.  The latest 
  751. version of TimeZ can be downloaded from the IBMAPP forum on CompuServe or 
  752. from America On-Line.
  753.  
  754.  CompuServe users:  TimeZ may be registered via CompuServe's Shareware
  755. Registration Service (GO SWREG).  Request to register program #609.
  756.  
  757.  
  758. Steve Mount
  759. RR 1 Box 320
  760. Starksboro, VT  05487-9702
  761.  
  762. Contact me on CompuServe.....: 73720,3404
  763.  
  764. Contact me on America On-Line: Mountain
  765.  
  766. Contact me on the Internet...: 73720.3404@cis.com    OR    mountain@aol.com
  767.  
  768. Call for ordering/support....: (802) 453-5273
  769.  
  770.  I have fax capability at the above number for orders, but you must call 
  771. me to have my fax set up before faxing (it is a card and shares the line 
  772. with my answering machine).
  773.  
  774. THE TIMEZ PROGRAM AND THIS MANUAL ARE COPYRIGHTED
  775. DOCUMENTS.  THE OWNER OF THE COPYRIGHT GIVES OTHERS
  776. PERMISSION TO DISTRIBUTE UNALTERED COPIES OF THE PROGRAM AND
  777. DOCUMENTATION TO OTHER INTERESTED PARTIES.  THIS PROGRAM IS
  778. NOT IN THE PUBLIC DOMAIN.  IF YOU USE TIMEZ, PLEASE PAY THE
  779. REGISTRATION FEE.  IT WILL ENSURE CONTINUED GROWTH OF THE
  780. PROGRAM FOR ALL USERS.
  781.  
  782. TIMEZ AND DOCUMENTATION COPYRIGHT (c) 1994 BY STEVE MOUNT 
  783. ALL RIGHTS RESERVED.  
  784.  
  785. 13.  Update Notes
  786.  
  787.  The following is a list of program changes that were a part of each new version:
  788.  
  789.  Version 1.01:
  790.  
  791. - Fixed minor problem in Master Clock.  When switching screens too quickly, portion
  792. of bottom of screen border was being erased.
  793.  
  794.  Version 1.1:
  795.  
  796. - References to "Daylight Savings Time" changed to "Daylight Saving Time"
  797. - Short List added to Print Entries
  798. - Bug that prohibited entry of a MMMDD-type DST indicator (ex: APR01) quashed
  799. - Duplicate "Vancouver, British Columbia" removed from data file
  800. - Replaced seconds display at top of Master Clock screen with display of local 
  801. time/day
  802. - Added ability to change current date/time (Set Local Date/Time)
  803. - Quashed bug that prevented F8  (Save, Edit Next)  from working properly in 
  804. Edit Entry after using F2 (sound search)
  805. - Numerous internal changes
  806.  
  807.  
  808.  Version 1.2:
  809.  
  810. - Changes to internal support functions.  Screen functions changed from BIOS
  811. to DMA usage for speed.
  812. - Addition of F8, F9, F10, and ESC keys in Scan Entries.
  813.  
  814.  
  815.  Version 1.21:
  816.  
  817. - Minor bug caused major problem - DST values where DST started and ended in 
  818. the same year not calculated properly.
  819.  
  820.  
  821.  Version 1.3:
  822.  
  823. - Added Currency, Exchange, Languages, and Government fields.  
  824. - Added Echange Rate Calculator 
  825.  
  826.