home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / znode3 / uploads / clock22.lbr / CLOCK22.DZC / CLOCK22.DOC
Encoding:
Text File  |  1993-03-25  |  3.1 KB  |  71 lines

  1. This program will set or read the MM58167 clock chip which is 
  2. used by the Kenmore clock, the Anapro clock for the H89, the CDR 
  3. Super RAM 89 clock for the Heath H89, and perhaps others.
  4.  
  5. The clock has no year port however the year is usually stored at
  6. the clock base port plus 9. The clock does not 'roll over' the 
  7. year on January 1 and does not recognize leap years. The clock 
  8. does not handle Day Light Savings time(I am not sure any clock 
  9. for 8 bit computers does this). 
  10.  
  11. CLOCK.COM overcomes these deficiencies by using the clock RAM 
  12. to store and retrieve needed information.
  13.  
  14. To use the program you only need to be sure the base port for 
  15. your clock is installed.  The base port may be installed by using 
  16. the included clock22.cfg with ZCNFG. You may also use a file patcher 
  17. to change the value at 10eh to the correct value in the standard CPM 
  18. version(CLOCK22.CZM in this library). The base port for the Kenmore 
  19. clock is E0; Anapro clock = 80; CDR = A0.
  20.  
  21. You may set the default time type to a 24 hour or 12 hour clock
  22. (Military/Civilian) format. The value at 10dh is 0 for the
  23. former; ff for the latter.
  24.  
  25. The next two options are only available if you use ZCNFG or
  26. assemble and link CLOCK22.Z80:
  27.  
  28. 1) If you use ZCPR3, you may set which registers in the Z3MSG area
  29. to use for starting time storage. A total of X bytes is needed.
  30.  
  31. 2) Under ZCPR3, if you use a Heath/Zenith H19 terminal, you may 
  32. choose to display the time data on the 25th line. The Heath or 
  33. ANSI(VT-52) modes are allowed. Any other terminal that supports 
  34. the 25th line may also be used. The enable/disable the 25th line 
  35. information must be entered in the source file or entered via 
  36. ZCNFG(use the option help). The save/return-to current cursor 
  37. position information must also be entered.
  38.  
  39.  
  40. Enter CLOCK ? at the command line to see the options for setting
  41. or reading the clock. The first time you set the clock I suggest
  42. you do 'xx-mon-xx yy:zz Y' to set the date/time and enable the
  43. daylight savings time feature. You must enter a <RETURN> to start 
  44. the clock. The time will be set to yy:zz with the second = 00. 
  45. Using your reference clock hit <RETURN> just as its time changes 
  46. to yy:zz. After that, set the date or time as needed. The DST 
  47. option may be turned on or off whenever you set the time.
  48.  
  49. CLOCK.COM will run ZCPR3 or standard CP/M. If you are using
  50. ZCPR3, you may use the 'S' option to store the current time in 
  51. the Z3 message buffer. Later using the 'E' option you may 
  52. determine the time that had elapsed to the hundredth of a second
  53. since the time was first stored. For example, if you want to know 
  54. how long it takes program 'test' to perform its function, 
  55. 'clock s;test;clock e' will report the elapsed time. This will 
  56. work best if run from a RAM disk or a hard disk. [A caveat--
  57. the TEST program must not use the same Z3 message registers as
  58. CLOCK.COM).
  59.  
  60. Biff Bueffel
  61. 19820 N.W. Metolius Drive
  62. Portland, Oregon 97229-2864
  63.  
  64. (503) 645-7783 (voice)
  65.  
  66. Messages may be left for me on 
  67.  
  68.     1) Al Hawley's BBS (310) 670-9465
  69.  
  70.     2) Jay Sage's BBS (617) 965-7259 (password=DDT)
  71.