home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / TASK.ZIP / TASK.DOC < prev    next >
Text File  |  1992-09-07  |  8KB  |  184 lines
  1. Task Macro - A {COMMO} timed execution facility
  2. Copyright (c) 1992 Joe Hayashi
  3.  
  4.  
  5. -----------------------------------------
  6. INTRODUCTION
  7. -----------------------------------------
  8.  
  9. TASK.MAC is a set of {COMMO} macros that allow you to automatically
  10. execute DOS programs at any time of the day on any day of the week.
  11. With some clever macros, you'll have {COMMO} acting as your electronic
  12. valet, dialing BBSs in the middle of the night to get mail mail, files,
  13. and news.  Any DOS program you can run unattended is ideal for use
  14. with TASK.MAC.  
  15.  
  16. TASK.MAC is not a TSR, it is designed to take over your computer and
  17. work while you are asleep or away.  You must have {COMMO}, a terrific
  18. terminal program written by Fred Brucker, for TASK.MAC to work.
  19.  
  20. To make TASK.MAC work, you need to put the file TASK.MAC and TASK.TXT
  21. in your commo directory.  TASK.TXT is the schedule file that TASK.MAC
  22. reads and acts upon. The structure of TASK.TXT is outlined below.
  23.  
  24. I've have included some other files in this package as well.  The
  25. CIS.MAC macros are some macros I use to automate some of my time on
  26. compuserve.  They are provided so that you can give TASK.MAC something
  27. to do right away.  The SED.ZIP package includes some SED scripts that
  28. make the text files created by CIS.MAC easy to read.
  29.  
  30. -----------------------------------------
  31. TASK.MAC
  32. -----------------------------------------
  33.  
  34. Getting started:
  35.  
  36. Move both TASK.MAC and TASK.TXT into your commo directory.  If you
  37. want an easy way to launch TASK.MAC, you can use the included BYE.BAT
  38. file.  BYE.BAT just launches commo with TASK.MAC loaded and runs the
  39. :start macro.  To use BYE.BAT, put it on your DOS path. 
  40.  
  41. Here is BYE.BAT:
  42.  
  43. @echo off
  44. cd \commo
  45. commo /mtask.mac /:start
  46.  
  47. You may need to change a couple things in TASK.MAC to make sure that
  48. it will work for you.  There are two lines in TASK.MAC that begin
  49. with an exclamation point.  Double check these lines to make sure they
  50. jive with your setup.  You may need to edit BYE.BAT if commo does not
  51. reside in a directory off of your root diretory.
  52.  
  53. The last thing you need to do is to edit the TASK.TXT file to include
  54. the commands you want to run.  You'll notice that there are already a
  55. fair number of commands I've included for you.  All of the CIS.MAC
  56. macros are used as well as some dummy commands.
  57.  
  58. The structure of the TASK.TXT file is pretty simple.  Here are two
  59. sample lines.
  60.  
  61. #time mtwtfss command line     <-- comment line
  62. 06:00 y y y   commo /:apo      <-- task line
  63.  
  64. The first line is a comment line.  All lines that begin a "#" (sharp)
  65. character are ignored.
  66.  
  67. The second line is a task line.  It includes the time of day to
  68. execute the task, the days of the week on which to execute the task,
  69. and the task itself.  
  70.  
  71. I've included the comment line to make the structure of task lines
  72. clearer.  It is unnecessary to include this comment line in your
  73. TASK.TXT file.
  74.  
  75. The first item is the 24 hour time of day to execute this task.  In
  76. this example the execution time is 6am.
  77.  
  78. Next is a series of seven characters, either a "y" or a " " (space)
  79. character.  These seven character tell TASK.MAC on which days to
  80. execute your task.  The character directly below the first "m" on
  81. the comment line tells TASK.MAC whether on not to execute this task
  82. on Monday.  If there is a "y" in this space, it will execute.  If
  83. there is a space " " here, it will not.  This task will be execute
  84. at 6am on Monday, Wednesday, and Friday.
  85.  
  86. The third item, starting in the 15th position on line two is the
  87. full DOS command line to be executed.  In this case the command
  88. "commo /:apo" (start commo and run the :apo macro) will be executed.
  89.  
  90. The last thing you need to remember about the TASK.TXT file is that
  91. the commands need to be sorted in order of execution times.  If your
  92. text editor doesn't sort things, have the DOS sort command do it.
  93. From DOS, type "type task.txt | sort > task.new".  Delete task.txt
  94. and rename task.new to task.txt.
  95.  
  96. -----------------------------------------
  97. CIS.MAC files
  98. -----------------------------------------
  99.  
  100. What do these files do?
  101.  
  102. I've included the CIS.MAC files so that you can actually have
  103. TASK.MAC do something for you in case you haven't any macros of
  104. your own.  The CIS.MAC macros are for users of Compuserve.  If
  105. you aren't a member, these macros won't do diddly.
  106.  
  107. I have included macros to get AP Headlines News, Online Today,
  108. PCWeek and MacWeek newsbriefs, and What's New for both Compuserve
  109. and Ziffnet.  
  110.  
  111. The easiest way to use the CIS.MAC files is to append them to your
  112. COMMO.MAC file.  Type "copy commo.mac + cis.mac" in your commo
  113. directory to accomplish this.
  114.  
  115. To use CIS.MAC you _must_ add an entry to your commo.fon file.  The
  116. name of the entry must be "Auto_cis" and it must include your
  117. Compuserve password and the number you dial to access compuserve. 
  118. I've included a simple file ADD.FON with instructions if you'd rather
  119. not add the number yourself.  You can append this file to your
  120. COMMO.FON file by typing "copy commo.fon + add.fon".  You'll still
  121. must edit the file to include your password and access phone number.
  122.  
  123.  
  124. -----------------------------------------
  125. SED.ZIP
  126. -----------------------------------------
  127.  
  128. The files packed in SED.ZIP are SED scripts used (optionally) by
  129. the CIS.MAC macros files to make the files created by the CIS.MAC
  130. macros more readable.
  131.  
  132. You need to put the *.sed files in your commo home directory.  You
  133. also need to get your hands on a DOS version of SED.  There are two
  134. in the Unix forum on Compuserve in library 13 (go unix, library 13
  135. "DOS under UNIX").  One is called SED.ZIP, the other is called
  136. TC-SED.ZIP.  The TC-SED.ZIP executable has at least one known bug
  137. (the "not" command (!) is broken).  I recommend SED.ZIP it's bigger
  138. and slower but it seems to work more like a Unix version.  The code
  139. comes from the FSF.  As far as I know, both are in the public domain.
  140.  
  141. SED stands for stream editor.  It's a standard Unix tool that carries
  142. out series of editing commands on a text file.  Yes, it can be
  143. difficult to use.  I make no claim of being a SED master;  I'm sure
  144. these files could be improved.  But heck, if they work for me, they
  145. might work for you.
  146.  
  147. If you find that you love SED and want to write your own scrips, I
  148. would check out a book on Unix.  SED works well with commo because
  149. all of the commo support files are plain text.  It's fairly trivial
  150. to write a script that appends BBS listins to your commo.fon file,
  151. eliminating the need for you to add all those curly braces by hand.
  152. There are undoubtedly dozens of other good uses for SED and I am sure
  153. that clever and prudent use of SED might someday save the world. 
  154.  
  155.  
  156. -----------------------------------------
  157. ADMINISTRIVIA
  158. -----------------------------------------
  159.  
  160. 1)  This distribution is Good Deed Ware.  If I've done you a good
  161. deed by writing these macros, then do a good deed for someone else
  162. today.
  163.  
  164. 2)  TASK.MAC and the CIS.MAC macros are Copyrighted to Joe Hayashi
  165. (c) 1992.  You may distribute these files only in an unmodified form.
  166. You may not distribute any of these files as part of a larger software
  167. distribution without my prior written consent.  
  168.  
  169. 3)  I don't guarantee anything about any of these files.  Your use
  170. of these files constitutes an agreement to not to hold me responsible
  171. for any damage your do to your computer system as a result of your
  172. use of these files.
  173.  
  174. 4)  All trademarks used within are registered trademarks of their
  175. respective companies.  
  176.  
  177. 5)  Please send bug reports, comments & questions to:
  178.  
  179.     Joe Hayashi 70754.1164@compuserve.com
  180.  
  181. Thanks for trying TASK.MAC.  Take care.
  182.  
  183. -Joe
  184.