home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / znode3 / uploads / tclock.lbr / TCLOCK.DZC / TCLOCK.DOC
Encoding:
Text File  |  1993-06-07  |  2.3 KB  |  49 lines

  1. TCLOCK reads the system clock and sets the internal clock
  2. in a WYSE-60 terminal. The correct time is then displayed
  3. on the terminals status line. The program reads standard
  4. Real Time Clocks (CP/M+, ZDOS, and DateStamper) and provides
  5. for a user implemented non-standard RTC interface. An example
  6. of a user clock interface is included.
  7.  
  8. In addition to setting the terminal clock, the program also
  9. prints the Date and Time on the screen. You may wish to delete
  10. or modify this feature. Deletion is simply a matter of commenting
  11. out two lines near the end of the code in TCLOCK.Z80.
  12.  
  13. The code that sends the command to set the terminal clock is at
  14. the very end of the source. This function occupies the terminal
  15. for a significant time compared to normal baud rates, during 
  16. which the terminal is not accepting data for display. For that
  17. reason, there should be no programed output to the terminal
  18. following the time set function unless an appropriate delay is
  19. included. 50 to 100 milliseconds delay is probably adequate.
  20.  
  21. Other terminals may also have an internal clock which can be set.
  22. Such functions usually involve an ESCape sequence similar to the
  23. one at the label setterm: in TCLOCK. Just change the data at
  24. that label to adapt the time function to another terminal.
  25.  
  26. TCLOCK is written with a 'boilerplate' ZCPR3x header which includes
  27. provision for Type 3/4 implementation and for Configuration data.
  28. Don't look for configuration data; there is none.
  29.  
  30. The source for TCLOCK is in three modules:
  31.     TCLOCK.Z80 is the main module
  32.     GTOSD.Z80 contains the standard RTC functions
  33.     BIOCLK.Z80 contains a user-written RTC read routine.
  34.  
  35. To produce TCLOCK.COM, assemble the three modules to .REL files
  36. using ZMAC, or an SLR assembler, or M80. Do NOT change the names
  37. of the GTOSD and BIOCLK modules without also changing the same
  38. names in the .INCLUDE statements in TCLOCK.Z80.
  39.  
  40. The TCLOCK.COM file is produced by linking the three .REL files
  41. as follows:
  42.  
  43.     LINK TCLOCK
  44.  
  45. where LINK may be ZML or one of the SLR or Microsoft linkers.
  46. Note that Z3LIB and SYSLIB must be present. No link list beyond
  47. that shown is needed because all required link modules are
  48. specified in the .INCLUDE statements at the beginning of TCLOCK.
  49.