home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / l / lcnt150u.zip / LOCATER.ZIP / LOCATER.DOC next >
Text File  |  1992-11-27  |  4KB  |  96 lines

  1. =============================================================================
  2. Locater  -  Locate files by FileDate in FILELIST files.
  3.  
  4. Usage:  Locater p# t# $lastuser =filename.ext /fixfbbs.cfg #days Date_STR
  5.  
  6. P#       = COM Port number, Com1 = p1 etc... Uses FOSSIL.
  7. P0       = Local mode, does not use FOSSIL.
  8.  
  9. #days    = Find new files #days old or less. (10 = ten days etc.)
  10.  
  11. Date_STR = DOS style date, mon-day-year. eg. 01-01-92
  12.  
  13. $lastuser      = full path of a LASTUSER.BBS file.  Use T# to
  14.                  override for different Tasks.
  15. =filename.ext  = full path of a filelist to search, otherwise
  16.                  all files listed in FIXFBBS.CFG are searched.
  17. /filename.ext  = full path of a FIXFBBS.CFG type file.
  18.  
  19. Example1:  LOCATER.EXE P%P $C:\MAX\LASTUSER.BBS /C:\MAX\FIXFBBS.CFG =%w
  20.         =  this is the equivalent of a F* in a specific area.
  21.  
  22. Example2:  LOCATER.EXE P%P $C:\MAX\LASTUSER.BBS /C:\MAX\FIXFBBS.CFG
  23.         =  this is the equivalent of a L* in any area.
  24.  
  25. LOCATER will prompt for date information if none on command line.
  26. =============================================================================
  27.  
  28. Locater is an online program that will search
  29. for newfiles in filelists that contain valid
  30. date information of the standard DOS type. Locater
  31. uses the FOSSIL if operated remotely.
  32.  
  33. FILENAME.EXT     1234 01-01-80  [ 1] description
  34.                       ^^^^^^^^
  35.                     Jan 01, 1980  etc....
  36.  
  37. This program, and the 2 .mec files supplied can
  38. be used on a CD-Rom type system that has filesize
  39. and filedate as part of the description. Of course
  40. this program has been designed to compliment both
  41. Fixfbbs and Logcount. It uses (needs) a config
  42. file exactly the same as FIXFBBS.
  43.  
  44. Newfile.Mec is used when somebody enters a "F*" while in an area,
  45. in this case the filelist name is passed as a command line option
  46. and LOCATER does not read the filelists in Fixfbbs.cfg. Only finds
  47. newfiles in the current file area.
  48.  
  49. Locater.Mec is used when somebody enters a "L*' while in an area.
  50. It will then check all filelists in fixfbbs.cfg to find all new
  51. files by date.
  52.  
  53.  
  54. It is very important the the first 4 lines of Fixfbbs.Cfg have
  55. the correct information,  especially if you have avatar colour
  56. codes as part of your download counters. Locater strips out the
  57. avatar codes. If the user has ANSI active then the default Maximus
  58. colours will be added, if the user has Avatar or TTY active then
  59. no ANSI colours will be added. The descriptions should appear exactly
  60. as Maximus would display them, with the descriptions properly
  61. adjusted for any download counter size.
  62.  
  63.  
  64. The .mec files assume that the fixfbbs.cfg and lastus??.bbs
  65. are in the c:\max directory. The LOCATER.MEC file also has
  66. a reference to the normal Locate function help file,
  67. c:\max\hlp\locate. If these names are different or the paths
  68. to them are different then make the appropriate alterations.
  69.  
  70. Compile the .Mec files with MECCA, then edit your Menus.Ctl
  71. and replace the standard Maximus functions with the new
  72. Display_files. The standard Maximus functions do not work
  73. if Maximus has been instructed to "FileDate NONE"!
  74.  
  75. %       Locate                                     Twit "Locate a file"
  76.         Display_file    misc\locater               Twit "Locate a file"
  77. %       File_Titles                                Twit "File Titles"
  78.         Display_file    misc\newfile               Twit "File Titles"
  79.  
  80. A user will be able to look for new files in any and all filelists
  81. configured in the fixfbbs.cfg. Make sure you set appropriate privilege
  82. levels in Menu.Ctl if this causes any security problems. The example
  83. privilege "TWIT" lets everybody use the newfile search.
  84.  
  85. If you omit the $lastuser.bbs option then LOCATER will not be able
  86. to obtain the users' graphic setting or the date of their last call.
  87. ANSI will be active and Locater will not be able to determine the
  88. date of the users' last call. I suggest you include the $lastuse.bbs
  89. parameter when running the program remotely...
  90.  
  91. good luck.
  92.  
  93. (C) Rodney A. Fraser, 1992.
  94.  
  95.  
  96.