home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / bbs / birthday / read_me.1st < prev    next >
Text File  |  1992-02-15  |  7KB  |  142 lines

  1.  
  2. Read Me file for:
  3.  
  4. Birthday.Scr ver 1.0   02/15/1992                          by Big D
  5.  
  6. Rubber City Atari BBS         300/1200/2400                216/376-0885
  7.  
  8.  
  9. Thanks to:
  10. Outrider for his Audit script file, that gave me the idea for
  11. Birthday.Scr...
  12.  
  13. Chuck Grimsby for his Todays program, that make a reason for Birthday.Scr
  14.  
  15. BBS Express ST and all involved in making it what it is today..........
  16.  
  17.  
  18. Why Birthday.Scr:
  19.  I am sure most of us have run or atleast seen one of the Today programs.
  20. I have always liked them... But I have always wanted to have the users of
  21. my bbs birthdays show in a today program... That was always a lot of work
  22. because of 12 data files, divided up in to each month...
  23.  Then Chuck Grimsby and his Todays.Prg ver 1.95 came to the rescue..
  24. Besides having more options then the other today programs, it can also
  25. read from several differnt files sources, besides the regular monthly data
  26. files.... Soooooo I wrote Birthday.Scr to write to one of those files, all
  27. my users birthdays....... And that is the story of Birthday.Scr
  28.  
  29.  
  30. Now What Does this thing Do:
  31.  
  32.    When you run Birthday.Com, it will ask any user with a level of 1 or
  33. higher to enter there Birthday in MM/DD/YYYY format.. It will save that
  34. data to a file called Birthday.Dat.. Now if you have read the Doc file for
  35. Todays program,if not do so you,  will know that on line 2 of the
  36. Todays.Inf file you can enter an Drive\Path\Alternate file name. Now if
  37. you make that file name Birthday.Dat guess what, when Todays program is
  38. run it will find any user of your BBS with a birthday on the current day
  39. and let the rest of your users know about it along with all the rest
  40. of the data you have for Todays program....
  41.  
  42. Settin Birthday.Scr up:
  43.  
  44.    1- Edit the User-Definable Vars at the top of the script file..
  45.  
  46.    2- Compile the script file.....................................
  47.       **** It must be COMPILED to work, if not it will screw the  
  48.       **** .Dat file.. DO NOT RUN TILL YOU COMPILE IT...  *****   
  49.  
  50.    3- Set up a directory to match what you specified as the path for
  51.       your Data files in the script file...........................
  52.  
  53.    4- Edit or create your own Birthday.Txt file.. Then copy it to  
  54.       your birthday directory......................................
  55.  
  56.    5- Set up one of your scripts early in the log on to call
  57.       Birthday.Com  ex: Welcome.Com................................
  58.  
  59.    6- Run Birthday.Com either though a normal log on or Exec from   
  60.       SysOp shell.. If it can find the Directory it will create the 
  61.       data file you specified in the script. You are ready to go....
  62.  
  63. Notes:
  64.  
  65.      Birthday.Com will egnore Guests. It will catch any user who has not
  66. been logged to the data file or any new user... All users with a level of 
  67. 1 or higher will be checked to see if the current date is their birthday.
  68. If it is the Birthday.Txt file will be sent to them, as well as writting
  69. to your call log that it is their birthday......
  70.      Speaking of the call log. Birthday.Com will also write  the birth
  71. date, their current age, and in parenthesis the age Express thinks they
  72. are to the current user on the log..
  73.  
  74. If you are running Audit.Com:
  75.  
  76.      1- Copy your current BIRTHDAY.DAT and NAME.DAT files to an
  77.         empty directory or blank disk..................................
  78.  
  79.      2- Copy the enclosed CONVERT.PRG to the same directory or disk....
  80.  
  81.      3- Now run the Convert program. It will rename your current .DAT
  82.         files, then create a new BIRTHDAY.DAT file that BIRTHDAY.COM
  83.         and TODAYS.PRG ver 1.95 can use.................................
  84.         DO NOT TRY TO USE this new Birthday.Dat with Audit.Com..........
  85.  
  86.      4- Copy the new BIRTHDAY.DAT back to the directory where you
  87.         orginally had it.. The BIRTHDAY.DAT and the BIRTHDAY.TXT are
  88.         all you really need in the directory..
  89.  
  90.      5- If you like rename BIRTHDAY.COM to AUDIT.COM or what ever name
  91.         you have been using and you are ready to go.....................
  92.  
  93. Just about there:
  94.  
  95.   Now I hope you have read the doc file for Todays program.. If not do so
  96. now... Ok edit the Todays.Inf file so it will call your BIRTHDAY.DAT file
  97. as the Alternate file... Remember this can be the only file or you can
  98. also use the regular file in line one.. The choice is yours..............
  99.   Once you have all the files for Todays ver 1.95 ready all you have to do
  100. is set up you scripts to call Birthday.Com first then read the Text file
  101. create by the Todays program.... Example would be have your Welcome script
  102. call Birthday.Com... Then later have Logstat script show the Todays Txt
  103. file....
  104.    Remember you must run the Todays.Prg at the begining of each new day.
  105. You can do this from your logstat script based on Caller number 1 or from
  106. the endcall script checking the current date....
  107. That should do it.........................................................
  108.  
  109.  
  110. I have enclosed some sample files for you to edit and use or just look
  111. them over to get some ideas on how to set up the whole thing.. Again the
  112. choice is yours.
  113.                        Welcome.Hlp     >Runs Birthday.Com
  114.                        Logstat.Hlp     >Do not run Todays.Prg from both
  115.                        EndCall.Hlp     >Logstat and Encall choose one..
  116.                         Todays.Inf     >Sample shows VT52 and how to set
  117.                                        >[I] option to show users.......
  118.  
  119. If you are interested in formats:
  120.  
  121.  The format for BIRTHDAY.DAT for BIRTHDAY.COM is:
  122.  
  123.               *00000000 ------------------------------
  124.               *  is the egnore symble for Todays program
  125.                00000000 is the place holder for the birth date
  126.                         - are the place holder for the users name.
  127.  
  128.  Once a user logs to this spot it will look like this:
  129.  
  130.               I 4041946 John H. Doe                   
  131.               I will tell Todays program that this is a freinds birthday
  132.                 4041946 Tells Todays program to show it on this date.
  133.                         John H. Doe is the users name, expanded to 30
  134.                                     character to keep the file in line.
  135.  
  136. Thats all there is to it... If you need any help just call Rubber City
  137. Atari BBS 216/376-0885  24 hrs or Voice between 6pm-10pm EST 216/376-7618
  138. ask for Don.
  139.  
  140.  As expected, I can not nor will not be liable for what ever happens if
  141. you run these files... You are on your own... All I can say is it works
  142. for me............