home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / rbbs / btjobs.lzh / BTJOBS.DOC < prev    next >
Text File  |  1989-07-07  |  7KB  |  135 lines
  1.                                 BTJOBS V1.0
  2.                                  07/07/89
  3.  
  4. This short documentation file should be all that is necessary to enable anyone
  5. to get BTJOBS up and running! So far this program is FREEWARE. No registration
  6. is required and no assistance is offered. If I retire soon, I may require a
  7. small registration fee to keep me in booze and Cadillacs. Until then you may
  8. use/do whatever you wish with this program! I was going to CopyWrite a large
  9. portion of the program but found that other major companies have used up most
  10. of the CopyWrite laws. So use at your own risk. No guarantees, warranties,
  11. claims are made other than "it works for me!"
  12.  
  13.                 What is BTJOBS?
  14.  
  15. BTJOBS is a program written in QB4.5 that allows you to enter a Date (in the
  16. format nn) and a Program Name (in the format FILENAME) such as:
  17. 01
  18. THISPRG
  19. and on the 1st day of each month THISPRG will be run. No, this is not a TSR
  20. program! It has to be called. Like in RBBS's Drop to DOS at a given time in
  21. your RBBS1TIM.BAT file. I currently use a program that checks what day of the
  22. week it is and if I list a program to be run on that day, that program does it.
  23. This is all well and good and works fine BUT if I want a program to run just
  24. once a month, it is of little use! Since I wanted a monthly listing of all the
  25. available downloads the first of each month (MASTER45 from Thomas Rollins), I
  26. needed something to work on just one day of each month. Ego, I wrote this 
  27. program. Now at a given date (01 to 28 - or LD meaning LAST DAY) this program
  28. will run the file that is listed in the BTJOBS.LST file. If this sounds like 
  29. something that would be of use to you, then read on......
  30.  
  31.                              How To Set It Up
  32.  
  33. Included in the archive (ZIPIVE?) should be the following files:
  34.  
  35. BTJOBS.EXE - Main Program File
  36. BTJOBS.CFG - Sample Configuration file for BTJOBS.EXE
  37. BTJOBS.LST - Sample List of Files to be run on certain days of the Month
  38. BTJOBS.DOC - This File you are reading
  39.  
  40. The configuration file contains four (4) lines:
  41. InfoLine 1
  42. Drive\Path\ line for location of BTJOBS.LST (can be anywhere that exists!)
  43. Drive\Path\ line for location of File Names or BAT files to be run (same!)
  44. InfoLine 2
  45.  
  46. The InfoLines can contain any information that you want to put into them to
  47. help you remember what is going on in the world. They are *NOT* used by the
  48. program but *MUST* be there! Be sure that both Drive\Path\ lines contain the
  49. trailing "\" (backslash). Here is the sample BTJOBS.CFG file that is included:
  50.  
  51. BTJOBS Drive\Path File - Don't forget the "\" at the end of the lines!
  52. C:\RBBS\JOBS\
  53. C:\RBBS\BATCH\
  54. 2nd Line = Location of BTJOBS.LST - 3rd Line = Program Location 
  55.  
  56. When the program is run, it will look for BTJOBS.LST in C:\RBBS\JOBS and then
  57. *IF* the program is to be run on this date, it will look in C:\RBBS\BATCH for
  58. the program that was specified to be run. *IF* it is *NOT* to be run on the
  59. current date, NO error will be written to the BTJOBS.ERR file. If it WAS to be
  60. run on the current date and it does not exist, a missing 'FILENAME' will be
  61. added to the BTJOBS.ERR file. This file (BTJOBS.ERR) will also have info
  62. written to it if BTJOBS.CFG is missing, incorrect format, etc. This will also
  63. occur if BTJOBS.LST is missing, incorrect format, missing information, etc.
  64. This file can in no way be all encompassing but does provide a guide to a 
  65. problem you may be having! If either file (BTJOBS.CFG/BTJOBS.LST) are missing,
  66. the program ends and returns to the calling .BAT file after writing a message
  67. in the BTJOBS.ERR file. The reasoning behind this is to allow other Batch files
  68. to write files/information prior to the date that BTJOBS is to be run. 
  69.  
  70. Example:
  71. On the 14th of the month you run a program that creates a program or file to be
  72. run on the 15th of the month when another program is called, it acts on the
  73. program/information that was extracted on the 14th. If BTJOBS checked for the
  74. program that was supposed to run on the 15th and it was not there it would
  75. "error" out. But if it does not check out the program until it is time to be
  76. run, then it could be there because it was written on the 14th... follow that?
  77. If not, trust me on it!
  78.  
  79. This file (BTJOBS.CFG) *MUST* be created with your favorite Word Processor that
  80. can do ASCII files! The easiest way is just to enter your information to the
  81. second and third line of the sample configuration file that is included!
  82.  
  83.                             Creating BTJOBS.LST
  84.                             (F1 Key Instructions)
  85.  
  86. This file may be created when BTJOBS.EXE is run by "QUICKLY" hitting the F1
  87. key. Approximately 5 seconds are allowed for you to make this selection. If
  88. the F1 (or F2) key are not pressed, the program continues on to do it's tasks.
  89. By pressing F1, you are allowed to enter ONE (1) Date and FileName to be run.
  90. You may run BTJOBS.EXE numerous times to continue adding dates and files to
  91. the "list" or may just use your favorite word processor again to create the
  92. file with as many entries as you wish. If you do create your own "list", 
  93. remember that the date must contain two digits, ie: 01, 09, 22, 15 etc.
  94. Also the FileName may only contain [UP TO] eight (8) characters! IE: FILENAME,
  95. DOTHIS, XXXXXXXX, XX, XXX, etc. - DO NOT ADD THE extension ONTO THE FILENAME!!!
  96. And be sure it is all in CAPs!
  97. Example/Sample included with the Program:
  98.  
  99. 01
  100. MASTER45
  101. 15
  102. MIDMONTH
  103. LD
  104. LASTDAY
  105.  
  106. This sample file only shows three (3) dates and three (3) files to run but it
  107. could be any length. The date/file does *NOT* have to be in sequence (order).
  108. The first file could be LD and the last one could be 01! The program will still
  109. run on the proper date!
  110.  
  111.                             F2 Key Instructions
  112.  
  113. By pressing F2 within the first 5 seconds of selecting BTJOBS.EXE, you may
  114. view the programs and the dates they are to be run. If the program is to be
  115. run on the current date, it will show it to be 'next' run on the next month
  116. but *WILL* be run before the program terminates! This is NOT as confusing as
  117. it sounds. If you have an entry that you want to run 'today' and have it listed
  118. for running TODAY, it will 'NEXT' be run on this date next month BUT it will be
  119. run today also (before the program terminates). Again, trust me on this!!!
  120.  
  121. So far that is about all the program does and all you need to know about it.
  122. I have tried it on a couple of different machines from 4.77 to 20 Mhz and it
  123. appears to work fine but then who knows? It does *NOT* have a monochrome or 
  124. Herc mode, so if you do not have a color monitor or the ATI Solutions card, 
  125. you may have problems with the displays (actually, you WILL have a lot of 
  126. problems with it!)
  127.  
  128. Suggestions/Bitches/Complaints/Praise(?) may ALL be left as Public messages on:
  129.  
  130.                               *** BIGTOP ***
  131.                           12/24/96 BPS 24 hours
  132.                               (218) 389-6009
  133.  
  134.                           Gary Peterson, Sysop
  135.