home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / beehive / bbs / disp5.arc / DISP5.DOC next >
Text File  |  1990-09-20  |  6KB  |  86 lines
  1. {-------------------------------------------------------------}
  2. {                                                             }
  3. {            ** DISPATCH Utility for Tabby **                 }
  4. {                                                             }
  5. { Program, source code, and doc files are copyrite  (c)  1989 }
  6. { by  Phil  Hansford.  This  program  is  licensed  for  free }
  7. { distribution  only.  You  may  use  this  program  for  any }
  8. { purpose. If you release a revision to this program, do  not }
  9. { charge for it, and include the source code in your release. }
  10. { ----------------------------------------------------------- }
  11. { Phil Hansford                                               }
  12. { February 2, 1989                                            }
  13. { Mysteria BBS                                                }
  14. { 818-353-8891 (modem)                                        }
  15. { Fidonet 1:102/943                                           }
  16. {                                                             }
  17. {-------------------------------------------------------------}
  18.  
  19. {-------------------------------------------------------------}
  20. { This is a new version  of  a  DISPATCH  program  for  Tabby }
  21. { echomail. In combines DISPATCH  and REVENT functions in one }
  22. { program.                                                    }
  23. {                                                             }
  24. { Like its predecessors,  this  program  is  written in Turbo }
  25. { Pascal, and uses a ROS.CLK clock driver include file. It is }
  26. { also possible to use BYE510 clock inserts as overlays  (see }
  27. { RDCLOCK.LBR to see how this is done).                       }
  28. {                                                             }
  29. { The Dispatch program is executed by the  Tabby  Supervisory }
  30. { program (such as BYE).  It  typically  reads the clock  and }
  31. { saves values to SYSDATE, and SYSTIME files,  then runs  the }
  32. { next event if it is valid.  If there  is  a  NXTEVENT  file }
  33. { which is not yet current,  DISPATCH chains to  BYE.  If  no }
  34. { NXTEVENT file is found,  or if the  window  is  passed,  it }
  35. { creates a new NXTEVENT file first.                          }
  36. {                                                             }
  37. { This version has an added command line  timing  option.  If }
  38. { you use it without a command line (as 'DISPATCH')  it  will }
  39. { operate normally. Or you can add a command line to it which }
  40. { specifies the number of minutes for a loop ( 'DISPATCH  20' }
  41. { for example).  That option may  be  used  to  restrict  the }
  42. { 'KSMAIL -rc' command so as not  to  exceed  the  number  of }
  43. { minutes specified. For example, the batch file --           }
  44. {                                                             }
  45. { KSMAIL -rc                                                  }
  46. { DISPATCH 20                                                 }
  47. {                                                             }
  48. { will run KSMAIL to send outgoing mail. If a line is busy or }
  49. { such and KSMAIL can't send all the mail on  first  try,  it }
  50. { will rename LSTEVENT to NXTEVENT, and dispatch will cause a }
  51. { loop back to execute the batch again if it  is  within  the }
  52. { window.  However, the 20 minute option in the example above }
  53. { above,  will limit this looping back to  no  more  than  20 }
  54. { minutes, even if the remaining window is larger. The option }
  55. { copies SYSTIME information to a temporary DISTIME file, and }
  56. { checks it on subsequent runs. When the alloted time is used }
  57. { up,  it renames  NXTEVENT  to  LSTEVENT,  and  deletes  the }
  58. { DISTIME file.  This option does not run when NXTEVENTis not }
  59. { found.  If there is a DISTIME  file  and  NXTEVENT  is  not }
  60. { found, DISTIME is deleted.  Other command line  options  in }
  61. { this version include -fx to force an event, and -c to  exit }
  62. { to system (normal exit is to BYE).                          }
  63. {                                                             }
  64. { - Gotchas -                                                 }
  65. {                                                             }
  66. { Turbo Pascal is written for the Z80 cpu.  This program will }
  67. { not operate on an 8080 or 8085 cpu.                         }
  68. {                                                             }
  69. { Present versions of  Tabby  can't  handle  garbage  on  the }
  70. { command line at startup.  As a  result,  the  Turbo  Pascal }
  71. { execute command will not work properly.  We must execute  a }
  72. { Tabby program with either  submit  or  the  MCLB  (external }
  73. { multiple command  line  buffer).  Both  are  used  in  this }
  74. { version. The MCLB requires ZCMD, ZCPR, or similar.          }
  75. {                                                             }
  76. { The next event functions utilize a 30 line buffer  for  the }
  77. { batch file.  If you exceed 30 lines in your batch file, the }
  78. { program will report an error and abort to BYE.              }
  79. {                                                             }
  80. { The EVENTS.BBS buffer is presently set up for 7 events, and }
  81. { is unsorted. If you exceed 7 events in the EVENTS.BBS file, }
  82. { or if your events there are out of order,  some  events may }
  83. { be missed,  cause system shut down,  or cause unpredictable }
  84. { results.                                                    }
  85. {-------------------------------------------------------------}
  86.