home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / znode3 / uploads / zdbdat11.lbr / ZDBDAT11.DZC / ZDBDAT11.DOC
Encoding:
Text File  |  1991-06-23  |  3.6 KB  |  88 lines
  1.  
  2.                            ZDBDATE.DOC
  3.                            ===========
  4.                 
  5. This overlay for DBase II began as a combination of learning the 
  6. ins & outs of DBase and the desire to experiment with the ZSDOS 
  7. date routines.  It works with versions 2.41 and 2.43* of DBase II 
  8. only, as the addresses and date routines vary from version to 
  9. version.
  10.  
  11. The inputting of the date on the initial start-up of v2.43* is an 
  12. involved routine of 229 bytes (227 bytes of v2.41) with extensive 
  13. error checking and an additional 106 bytes for the old "30 days 
  14. hath September" rhyme.  If the date is entered later using the 
  15. "SET DATE TO" command there is absolutely no error checking, the 
  16. original routines having been overwritten by part 1 of the DBase 
  17. overlay.  The high date locations (hdate) are also overwritten by 
  18. the overlay and the month in the high date is used to check if 
  19. there is a valid date loaded.
  20.  
  21. This routine uses the Unused space within DBase and will input 
  22. the time from the system clock if ZSDOS and an appropriate clock 
  23. routine are incorporated in the operating system.  If there is no 
  24. clock present, or there is an error reading the clock, the 
  25. routine will indicate there is no clock present and will deposit 
  26. you into the normal DBase date routine.
  27.  
  28. The routine has been tested with both "Off-the-Shelf" copies of 
  29. DBase and copies which have been modified with the "NEWBASE" 
  30. program developed by Gene Head.  If using both NEWBASE and this 
  31. routine, the NEWBASE OVERLAY should be incoroporated first.
  32.  
  33.                           INSTALLATION
  34.                           ------------
  35.  
  36. Hex files have been included in this library for both Ver 2.41 
  37. and Ver 2.43* to enable the user to install the program with the 
  38. minimum fuss.
  39.  
  40. The following command lines will modify DBase using MLOAD:
  41.      MLOAD fname.com=dbase.com,zdbdat##
  42. for loading zdbdate only.
  43.      MLOAD fname.com=dbase.com,newbase,zdbdat##
  44. for loading both newbase & zdbdate.
  45.  
  46. Note: Replace ## with `41' for ver 2.41 & `43' for ver 2.43*
  47.  
  48.                              CAVEATS
  49.                              -------
  50.  
  51. There are three warning in relation to this routine. They are:
  52.  
  53. 1. This routine will only work with Ver 2.41 & 2.43* of DBase II. 
  54. (Support for other versions may be added later).
  55.  
  56. 2. If using Newbase and this routine, Newbase must be loaded 
  57. first.
  58.  
  59. 3. If you modify this routine and re-assemble it, beware as it 
  60. contains two `ORG' statements.  Many linkers will fill the area 
  61. between the `ORG' statements with zeros.  If your assembler 
  62. and/or linker operates this way, the easiest fix is to comment 
  63. out the second `ORG' statement and the following jump statement 
  64. and patching the jump address by hand.  (The .HEX files included 
  65. in this library were created using the SLR180 assembler with the 
  66. /H option.)
  67.  
  68.                              CLOSING
  69.                              -------
  70.  
  71. This routine is not copyrighted and is released to the Z-System 
  72. community with no restrictions on its use as a small attempt to 
  73. thank all for the Z-SYStem and its numerous utilites.
  74.  
  75. Many thanks to Gene Head, the author of NEWBASE.ASM, whose work 
  76. in dissecting the various versions of DBase II provided starting 
  77. points and valuable aid in preparing this routine and to the 
  78. developers of ZSDOS and the Z-SYStem.
  79.  
  80. If anyone wishes to incorporate this program into other versions 
  81. of DBase or has any trouble with this version, the writer will be 
  82. willing to provide help as required.
  83.  
  84. Please leave a message on Jay Sage's Znode (617) 965-7259 or call 
  85. me at (516) 224-5935 voice (evenings & weekends).
  86.  
  87.      Ed McGovern
  88.