home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / TODAYBBS.ZIP / TODAYBBS.DOC < prev    next >
Encoding:
Text File  |  1992-04-23  |  13.3 KB  |  311 lines
  1.                                 TODAYBBS
  2.                             by Michael Conley
  3.  
  4.                           Release 3.05 04/23/92
  5.  
  6.                       Requires BRUN40.EXE in the path
  7.  
  8. Now requires "BDAYPREP.EXE" ... a separate program to read your
  9. BBS user birthday data and prepare it for TODAYBBS.  The BDAYPREP
  10. program is supplied in a separate ZIP file, and is available from 
  11. the same BBS where you downloaded TODAYBBS.  The reason for
  12. separating these programs is that TODAYBBS is becoming a more
  13. independent program, with support being added for a variety of
  14. BBS programs.  BDAYPREP is Wildcat!-specific.
  15.  
  16. This  program determines the current date, then reads data  files 
  17. containing historical facts and produces daily files of interesting 
  18. information about the current date.  It is intended for use in  a 
  19. BBS  system  where the file can be created as a part of  a  daily 
  20. maintenance routine.   When used in conjunction with the BDAYPREP
  21. program, the program will optionally incorporate users' birthdays
  22. into the display files it produces.
  23.  
  24. IMPORTANT:  TODAYBBS requires the use of BRUN40.EXE, which is the
  25. runtime module for QuickBasic.  It's readily available on BBS systems
  26. throughout the country.  If you have trouble locating it, call me.
  27.  
  28. Bruce Goldman is now producing excellent TODAY.nnn data files which
  29. are compatible with TODAYBBS, as well as some other programs such as
  30. NEWDAY/PC.  These files are widely available in ZIP format, with each
  31. file containing two months worth of material.  The current series as of
  32. this document is series 906, with files named:  DAY906-1.ZIP, 
  33. DAY906-2.ZIP, etc through DAY906-6.ZIP.  I have written to Bruce and 
  34. he has agreed to distribute these through the Charlatan's Cabin.
  35. They will be available to ALL callers on the first call... 
  36.  
  37. ==============================================================================
  38. NEW FEATURES/CHANGES:
  39.  
  40. Version 3.05 fixes a bug discovered when the data files became larger
  41. than originally envisioned ...
  42.  
  43. Version 3.04 now determines whether your data files are in ascending
  44. or descending sequence by year.  If they are ascending, such as the
  45. newer files by Bruce Goldman, TODAYBBS will reverse the sequence,
  46. so that the newest data is presented first in each category.  After
  47. several conversations, it was decided this approach is desirable for
  48. online use.  If you'd prefer to have the older dates first, you may
  49. either continue to use version 3.03, or let me know and I'll make it
  50. a configuration switch.
  51.  
  52. Version 3.03 fixes a moderately embarrassing leap year bug!
  53.  
  54. Beginning with version 3.02, TDHEADER.DAT and TDTAIL.DAT header and tag
  55. files can now include color codes for the appropriate bulletin board
  56. software you're running.  They are no longer 'forced' into any particular
  57. color, so if you DON'T include color codes, these files will be whatever
  58. color the previous line was.  Therefore we recommend putting in at least
  59. ONE color code at the start of each file if you use them.
  60.  
  61. Version 3.xx can now be run with various BBS software packages.  If you
  62. wish to include user birthdays, you'll need to run the appropriate extraction
  63. program to build TODAY.BIR in your \TODAY\ directory.  
  64.  
  65. In order for TODAYBBS to report User Birthdays, you'll need BDAYPREP, a 
  66. separate ZIP file which extracts this data from your BBS database and
  67. makes a file compatible with the TODAYBBS format.
  68.  
  69. NOTE ON UPGRADING:
  70.  
  71. If you are already running a version of TODAYBBS prior to 3.00 and are 
  72. converting to the new version, you MUST remove your old configuration file,
  73. because the format has changed.  In its place, a new TODAYBBS.CFG file 
  74. contains all of the control parameters for the program.  A sample is 
  75. included with this ZIP file, and is explained below.
  76.  
  77. ==============================================================================
  78. SETTING UP:
  79.  
  80. The only elements that need to be set up to operate this  program 
  81. are  the  TODAY.LCL file and the TODAYBBS.CFG  file.  
  82.  
  83. You may also add optional "header" and "footer" files to customize
  84. your display.  These will be included before and after the display
  85. of the daily data in the output files.  
  86.  
  87. They are named  "TDHEADER.DAT" and "TDTAIL.DAT" and are plain ASCII.
  88. If they are not found, they will be ignored.  Samples are included
  89. with this ZIP file to give you some ideas.  Incidentally, if Wildcat!
  90. display control characters are included, such as the ^U^N (User Name)
  91. function, they will be correctly displayed with the output file is
  92. viewed by Wildcat!  See your Wildcat! documentation for details on 
  93. using these command sequences in display files.
  94.  
  95. The TODAYBBS.CFG file must be located in the currently logged directory 
  96. whenever TODAYBBS is executed.   The first seven lines of the file define 
  97. the operating parameters,  and the  FORMAT MUST BE FOLLOWED EXACTLY.  
  98. A couple samples of this file are shown below:
  99.  
  100. When editing TODAYBBS.CFG, be sure to use an editor which will NOT include 
  101. any special formatting characters, as some word processing programs may do.
  102.  
  103. C:\TODAY\
  104. Charlatan's Cabin BBS
  105. BDHIRSU
  106. C:\WC30\DISP\HELLO9.BBS
  107. CODE
  108. ;
  109. ;Line 1 is the full drive and path name where the "TODAY.xxx" files are kept.
  110. ;       The trailing BACKSLASH is an essential part of the path name.
  111. ;
  112. ;Line 2 is the name of the BBS as you would like it to appear in the output.
  113. ;
  114. ;Line 3 indicates which categories you would like to include in the output
  115. ;       file.  The categories are defined as follows:
  116. ;
  117. ;          B = birthdays of important public figures.
  118. ;          D = deaths of important public figures.
  119. ;          H = holidays.
  120. ;          I = religious observances.
  121. ;          R = reminders of important annual events.
  122. ;          S = events on this day in history
  123. ;          U = users' birthdays (without the year!) (You'll need to 
  124. ;              run a BDAYPREP program designed for your BBS system.)
  125. ;
  126. ;Line 4 is the full drive and pathname for the program's first output file.  
  127. ;       If used with WILDCAT! we suggest using  C:\CAT\HELLO9.BBS  
  128. ;    (substituting the appropriate path name if different) so that 
  129. ;    the file is displayed automatically at the end of your signon 
  130. ;    sequence.
  131. ;
  132. ;Line 5 should contain the word CODE if you want TODAYBBS to output
  133. ;       Wildcat! version 3.x @-code colors in your .BBS display file.
  134. ;        
  135. ;       If used with WILDCAT! 2.x, line 5 should contain the filename
  136. ;       of your ANSI  .SCR format file.  ANSI codes will automatically
  137. ;       be inserted in the .SCR file and NO color codes will be inserted 
  138. ;       in the .BBS file.  Here's a typical configuration file for Wildcat!
  139. ;       version 2.x:
  140. ;
  141. ;                       C:\TODAY\
  142. ;                       Charlatan's Cabin BBS
  143. ;                       BDHIRSU
  144. ;                       C:\WC\DISPLAY\HELLO9.BBS
  145. ;                       C:\WC\DISPLAY\HELLO9.SCR
  146. ;                       
  147. ;       Note that Wildcat! 3.x can use ONE output file for both MONO and
  148. ;       COLOR (ANSI capable) users.  Automatic color codes in the .BBS file
  149. ;       will be masked for non-color users, and converted for those who have
  150. ;       enabled COLOR in their user profiles.
  151. ;
  152. ;       If you don't want ONLY an ASCII file with NO color codes, place the
  153. ;       word "NONE" on line 5.
  154. ;
  155. ;IMPORTANT:  All lines must be included in the file. Obviously certain
  156. ;          combinations will not utilize all of the lines, but they are
  157. ;         read by the program and tested before the program creates the
  158. ;         output file and must conform to the above specifications even
  159. ;         if not used!  The notes after the last line are not required
  160. ;         and may be deleted, but they will not cause a problem.
  161. ;
  162. ;THIS FILE must reside in the currently logged directory when TODAYBBS is run.
  163. ;
  164. ==============================================================================
  165. THE TODAY.LCL FILE:
  166.  
  167. To customize your display with information of particular interest to your
  168. BBS or immediate area, TODAYBBS will scan for the presence of a file
  169. called "TODAY.LCL" and include appropriate lines from it if it's found.
  170.  
  171. Here's how the data format for all of the files works:
  172.  
  173.  
  174. Column 1:
  175.     The record type, which can be a B for birthdays,
  176.     D for deaths, H for holidays, I for religious events,
  177.     S for special dates in history or R for reminders.
  178.     An asterisk (*) in this column denotes a remark.
  179.  
  180. Cols 2-5:
  181.     Month and day as MMDD with leading zeros.  Zeros
  182.     for the day cause ALL days of the month to match
  183.     when being scanned.  For example 0400 would match
  184.     every day of April.
  185.  
  186. Cols 6-9:
  187.     The full year of the event as four digits.
  188.     May be left blank.  For REMINDERS ONLY, this column
  189.     may contain the ending value of a range of dates, 
  190.     for example:  R10021020 would issue a reminder every
  191.     day between October 2nd and October 20th.  Note that
  192.     the BEGINNING or ENDING dates don't have to be within
  193.     the current month, but if they're NOT, then they must
  194.     be included in all applicable monthly files, since only
  195.     ONE file is read based upon the system date.
  196.  
  197. Column 10:
  198.     A special processing flag.  Values may be:
  199.  
  200.     BLANK for no special processing.
  201.  
  202.     C to continue a message from the previous line.
  203.  
  204.     Note, that you MUST repeat the date fields.
  205.  
  206.     DAY-OF-WEEK DIGIT where 1=Sunday ... 7=Saturday
  207.     This will cause the message to display only if the
  208.     date falls on a certain day of the week.  Look in
  209.     the November file for voting day examples.
  210.  
  211. Cols 11-68
  212.     The message to display for this date. If entry is
  213.     longer, use the 'C' processing flag for proper handling.
  214.     The program will attempt to provide word wrap for
  215.     longer entries, but the algorithm is a simple one
  216.     and may not produce ideal results.
  217.  
  218.                        --EXAMPLES--
  219.  
  220. *mmddyyyy Birthdays
  221. *-------- ------------------------------------------------------------
  222. B09011875 Edgar Rice Burroughs, novelist, Ah-ee-ah-ee-ah!
  223. B09021838 Queen Liliuokalani (last queen of Hawaii).
  224. B09021952 Jimmy Connors, tennis brat
  225.  
  226. *mmddyyyy Deaths
  227. *-------- ------------------------------------------------------------
  228. D01131822 Friday the thirteenth monster dies.
  229.  
  230. *mmddyyyy Holidays
  231. *-------- ------------------------------------------------------------
  232. H0901    2Labor Day, a legal Holiday
  233.  
  234. *mmddyyyy Religious events
  235. *-------- ------------------------------------------------------------
  236. I0922     St. Swithen's Day. (probably not right ... sorry!)
  237.  
  238.  
  239. *mmddyyyy Special events
  240. *-------- ------------------------------------------------------------
  241. S09011939 Germany invades Poland, starts World War II.
  242. S09011952 Sutro Baths purchased by George Whitney.
  243. S09021620 The Mayflower sets sail from Plymouth with
  244. S09021620C102 Pilgrims.
  245.  
  246. *mmddyyyy Reminders
  247. *-------- ------------------------------------------------------------
  248. R04010410 Pay the mortgage!
  249. R0401     Taxes due in two weeks.
  250. R0415     Last day to pay taxes!
  251.  
  252. Because it's a reminder, the first line would be displayed throughout
  253. the indicated range, from 04/01 to 04/10.  This special processing
  254. works ONLY with reminders.
  255.  
  256. ==============================================================================
  257. TESTING:
  258.  
  259. To test the program, simply type TODAYBBS<enter> and the output
  260. file you have named in the TODAYBBS.CFG file will be created or
  261. overwritten if it already exists.
  262.  
  263. You may wish to test various dates.  For convenience, TODAYBBS 
  264. will accept dates from the command line.  Since the year is not
  265. used, enter the date as 4 digits in the form:  MMDD.  Leading
  266. and internal zeros must be used, e.g., TODAYBBS 0307<enter>
  267. will produce a file from the information located for March 7.
  268.  
  269. ==============================================================================
  270. OPERATION:
  271.  
  272. If your BBS has a provision for automatic daily maintenance, such
  273. as the WILDCAT! program by Mustang Software, include the following
  274. line(s) in the maintenance batch file, and schedule it to run as
  275. soon as possible after midnight:
  276.  
  277. CD C:\WC30\DATA
  278. BDAYPREP C:\TODAY\
  279. CD C:\WC30
  280. TODAYBBS      
  281.  
  282. This sequence should be edited to suit your system, of course.  We're
  283. assuming in this example that you're running Wildcat! version 3.0, and 
  284. that your ALLUSERS.DAT file is in a directory named \wc\data.  First,
  285. we change to that directory, and run BDAYPREP.  The command line instructs
  286. BDAYPREP to place its output file (TODAY.BIR) in your C:\TODAY\ directory
  287. along with your other TODAY data files.
  288.  
  289. Next, we change to the directory where TODAYBBS.EXE and TODAYBBS.CFG are
  290. located together.  Run TODAYBBS, and it will read its configuration file 
  291. and follow the instructions you've set up.
  292.  
  293. PROBLEMS, QUESTIONS, SUGGESTIONS:
  294. =================================
  295. TODAYBBS is public domain.  I don't seek or accept any registration fees for 
  296. this or any of my other public domain utility programs, including those for
  297. Wildcat! BBS systems.  If you're interested in making a charitable contribu-
  298. tion to express your appreciation, please read the enclosed file SHARE for
  299. my thoughts on the subject.
  300.  
  301. I welcome suggestions, and will try to help (no guarantees) if there are
  302. problems.  You may contact me at The Charlatan's Cabin BBS  (213) 654-7337, 
  303. or via CompuServe (70250,220).
  304.  
  305. If you're a registered Wildcat! SysOp, please leave me a private comment on
  306. the BBS including your Wildcat! registration number, and I'll upgrade you to
  307. member level.
  308.  
  309. ============================================================================
  310.  
  311.