home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / rbbs_pc / calllog.arc / CALLLOG.DOC < prev    next >
Text File  |  1989-03-20  |  3KB  |  47 lines
  1. CALLLOG.EXE Release 1.00    20 March 1989
  2.  
  3.     This document describes the RBBS utility program I call CALLLOG.EXE .
  4. The purpose of the utility is to remove old log data from the callers log
  5. kept by RBBS.  This version will work with versions 16.1A and 17.1C.  I
  6. believe other versions back thru 14 should work but, have not tested them.
  7. The program will work with either regular or extended logging.  In fact, as
  8. long as the callers log file remains defined as 64 bytes long and the date
  9. the caller logged on remains in the same relative place (i.e. same number or
  10. space filled gaps previous to the date in the record) the program will 
  11. continue to work with new versions of RBBS.
  12.  
  13. The utility is used as follows:
  14.  
  15.       CALLLOG <filename> #
  16.  
  17.     Where the filename is the name of the callers log file.  Typically, this
  18. is called "CALLERS" by default.  A second file, called WORKFILE.$$$ is used
  19. as a temporary file by the program.  The only time this file would ever
  20. appear in your directory listing is if the program aborted.  I contemplated
  21. allowing full/path directory support for the filename, but because of the
  22. inability of DOS to allow a rename across directories, I had to trap out
  23. the paths and directories.  This means that the program can reside in the
  24. path on your machine, but the current directory must contain your callers log
  25. file when the program runs.
  26.  
  27.     The pound sign indicates the entry of a number.  This number is the number
  28. of days (not counting today) that will be kept in the new log.  The day that
  29. the program calculates from is the system date.  The program has provision for
  30. handling up to 365 days, though I only recommend a 7 or fewer day period if
  31. your board is at all busy.  The calender routines should handle everything up
  32. to the year 2100 with no problem.  Leap days after that are your problem.  The
  33. program disallows 0 for the number of days to keep.  If you want to use zero,
  34. then just erase the callers log file, rather then use this utility.
  35.  
  36.     The date and time run is added to the end of your log file, along with the 
  37. number of days kept.  It also writes my copyright notice there (didn't think
  38. it was completely free did you?).  The program can be placed in your event
  39. file ( RBBSTIM1.BAT ) to be run each night, thus also logging when your
  40. event file actually runs each night.
  41.  
  42.     Any problems may be reported to me via my board at (407) 677-8499 which
  43. is called Known Space.  300/1200 7E1/8N1  24hrs.
  44.  
  45.                                                        James J. Eager
  46.                                                        Orlando, FL
  47.