home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / DEMON / AMSTRAD / ONDATE.ARC / ONDATE.DOC < prev    next >
Text File  |  1994-03-14  |  4KB  |  110 lines
  1. ONDATE.COM                                                J. Elliott, June 1993.
  2. ================================================================================
  3.   ONDATE is a conditional submit utility, similar to ONERL. However, it does not
  4. need the GETERL extension to be loaded.
  5.  
  6.   Its task is to run different programs on different dates, and is therefore
  7. only of use if you set the computer's internal clock correctly. PCW users who
  8. don't have SCA's Mk2 interface will have to put DATE SET in their PROFILE.SUB
  9. files.
  10.  
  11.   The syntax is rather different from normal programs. As ONDATE is meant for
  12. use in .SUB files, most of its input is in lines from the .SUB file rather than
  13. the command itself. Syntax is:
  14.  
  15. ONDATE {/Q}
  16. <dd/mm/yy:command 1
  17. <dd/mm/yy:command 2
  18.   .
  19.   .
  20. <dd/mm/yy:command n
  21. <
  22.  
  23.   It should be pointed out that the < is a Submit marker and if you were typing
  24. an ONDATE sequence at the keyboard you would not type this. Note that the date
  25. is in the form dd/mm/yy, not mm/dd/yy as DATE.COM would have it.
  26.  
  27.   Each of dd, mm and yy MUST have two digits. They can be ambiguous; the form
  28. 15/12/?? will work on 15th December (Anniversary of CP/M +) every year.
  29.   If YY is above 77, it will signify a date of the form 19XX - so 85 means 1985.
  30.   If YY is below 78, it will signify a date of the form 20XX - so 37 means 2037.
  31. Ridiculous dates (eg 45/13/93) will never be used.
  32.  
  33. command is just any CP/M command. In a SUB file, only one command can be run
  34.         by ONDATE like this. If you want to do an involved routine, this command
  35.         should be SUBMIT SUPER2 or something similar, all your routine being in
  36.         the sub-SUB file. The exception to this rule is when ONDATE is the last
  37.         command in a SUB file.
  38.           Since SUBMIT removes any ! marks from a SUB file, if you want !
  39.         marks in an ONERL input you should use | (vertical bar) instead.
  40.  
  41.   End all ONDATE inputs with a < (blank line). This tells ONDATE that there are
  42. no more lines to input.
  43.  
  44. There now follows an example:
  45.   .
  46.   .
  47. ONDATE /Q            -The /Q(uiet) stops the following lines being shown on
  48. <15/12/82:ECHO "%You haven't set the computer's clock"                the screen
  49. <15/12/??:ECHO "%C%P/%M+'s anniversary!"               -run once a year
  50. <01/??/??:ERASE *.BAK|ERASE *.OLD                      -run once a month
  51. <?2/??/??:PIP BACKUPS.ARK=CURRENT.ARK                  -run 3 times a month
  52. <31/12/77:ECHO "%Need new version of %O%N%D%A%T%E..."  -last possible date.
  53. <                                                      -End of input.
  54. NEXTPROG
  55.   .
  56.   .
  57.  
  58. There are a number of things to note from this:
  59.   The numbers above are in order. This may be important with ambiguous lines
  60. (see below).
  61.   If you are in the middle of a SUB file and you try to put in a multiple
  62. command (something like <01/01/01:DIR *.COM|DIR *.SUB ) then the first command
  63. will be executed; the second will be left over until the current SUB file comes
  64. to an end, then executed. This can lead to problems.
  65.   ONDATE can't make program input of its own. You will have to use the sub-SUB
  66. file trick for that. Eg: You can't have:
  67.  
  68. 29/02/87:PIP|<m:=*.com|<m:=*.sub|<
  69.  
  70. Instead, use:
  71.  
  72. 29/02/87:SUBMIT PIP001
  73.  
  74. and let PIP001.SUB read
  75.  
  76. PIP
  77. <m:=*.com
  78. <m:=*.sub
  79. <
  80.  
  81.   If there are two valid "<dd/mm/yy:command" lines in an ONDATE command, the
  82. first is used. This means that the order that lines are in may be important.
  83. For example:
  84.  
  85.   <15/12/82:command1
  86.   <15/12/83:command2
  87.   <15/12/??:command3
  88.  
  89. will execute command1 on 15th December 1982; command2 on 15th December 1983 or
  90. command3 for other 15th Decembers. But:
  91.  
  92.   <15/12/??:command3
  93.   <15/12/82:command1
  94.   <15/12/83:command2
  95.  
  96. will execute command3 for all 15th Decembers.
  97.  
  98.   Type ONDATE /H to be reminded of the syntax.
  99.  
  100.   ONDATE accepts dates up to 31st December (20)77. However, DATE only goes up to
  101. 31st December (19)99. Furthermore, dates in ONDATE are in UK format (dd/mm/yy);
  102. dates in DATE are in US format (mm/dd/yy). To convert DATE to work in UK
  103. format up to 2077, use COMPAT (on this disc) with the file UKDATE.CMP:
  104.  
  105. COMPAT DATE UKDATE
  106.  
  107. and then DATE.COM will accept UK format dates up to 2077.
  108. ________________________________________________________________________________
  109.  
  110.