home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / CDOR0811.ZIP / DOCS.ZIP / SYSOP8.DOC < prev    next >
Encoding:
Text File  |  1993-08-09  |  8.8 KB  |  202 lines
  1. SYSOP8 - The Personal/FMS/FFS Online File Maintenance Mod for RBBS-PC 17.4
  2.  
  3.          Copyright (c) 1993 by Daniel T. Drinnon  All Rights Reserved
  4.  
  5. |Recent Changes marked "|"
  6.  
  7. NOTE: This Feature is designed for the CDor Mods.  It will not work on
  8.       Stock RBBS-PC v17.4 or any other major mods to RBBS-PC with out
  9.       careful attention to system integration!
  10.  
  11. Introduction:
  12. -------------
  13. RBBS-PC, as distributed, lacks any internal File System maintenance for the 
  14. Sysop.  If a Sysop wants to Add, Delete, Edit, Find or Move a file in the RBBS 
  15. File System, the only way to do it is to externally manipulate the Files 
  16. involved to make the desired changes.  In other words, to Add an upload, the 
  17. sysop must copy the upload file to the upload subdirectory and then run RBBS 
  18. locally and "upload the file".  To Delete an upload, the Sysop must manually 
  19. delete the file and then edit the files listing.  You probably get the picture.  
  20. It's an incovienence!  Life could be much better!  The SYSOP8 mod will let you 
  21. do ALL of the previously mentioned features, while On-Line!  The integration of 
  22. this mod is very intense.  It takes into consideration ALL possibilites and ways 
  23. that your RBBS is set up and how to handle the setup accordingly.  If you use 
  24. Warren Muldrow's RFM utility, SYSOP8 will know.  If the file(s) you are going to 
  25. work with are on a subboard while you are "in" your "MAIN" files section, fine, 
  26. SYSOP8 will know what to do.  SYSOP8 has the capability of "CROSS-POSTING" files
  27. ANYWHERE on your BBS.  For the truely paranoid, all actions within the SYSOP8
  28. are recorded in the CALLERS log.
  29.  
  30. Setting Up:
  31. -----------
  32. Setting up is EASY!  I wrote the SYSOP8 mod for the CDor mods, and all you
  33. have to do is run it!  If you use the FFS (FIDX/LIDX), then you must create an
  34. "FIDX" list file or a SYSOP8.CFG file.  The SYSOP8 looks for the SYSOP8.CFG
  35. file FIRST, and if it can't find it, then it will look for the FIDX.LST file.
  36. In your RBBS "DIR" subdirectory (where all your DIR files
  37. are), create the FIDX and/or SYSOP8.CFG list file(s).  The FIDX version of
  38. this file name MUST be called whatever you named your FIDX file in CONFIG #267
  39. plus ".LST".  For example, if your CONFIG #267 says "FIDX.DEF", then you need
  40. to make a "FIDX.LST" file.
  41.  
  42. The format of the FIDX.LST or SYSOP8.CFG file is as follows:
  43.  
  44. FIDXNAME,LIDXNAME,MASTER DIR NAME,DESCRIPTION LENGTH
  45.  
  46. FIDXNAME = CONFIG #267
  47. LIDXNAME = CONFIG #268
  48. MASTER DIR NAME = CONFIG #214 + CONFIG #209
  49. DESCRIPTION LENGTH = CONFIG #219
  50.  
  51. In RBBS, this could translate to
  52.  
  53. C:DIR\FIDX.DEF,C:DIR\LIDX.DEF,C:DIR\MASTER.DIR,43
  54.  
  55. If you want a SUBBOARD's file system accessable from your MAIN board, simple
  56. continue your "FIDX.LST" file with it's info:
  57.  
  58. C:DIR\FIDX.DEF,C:DIR\LIDX.DEF,C:DIR\MASTER.DIR,43
  59. C:DIR\ADUFIDX.DEF,C:DIR\ADULIDX.DEF,C:DIR\ADULT.DIR,46
  60.  
  61.  
  62. Read this!
  63.  
  64. The ONLY difference between the SYSOP8.CFG file and the FIDX.LST file is the
  65. FIDX.LST file is also used by other mods within RBBS and you may not want to
  66. have ALL your download areas and 'master.dir' names in your FIDX.LST file,
  67. for example, you probably don't want to have your ADULT and MAIN files in
  68. the FIDX.LST file.  The SYSOP8.CFG file, however, is only used with the SYSOP8
  69. MOD, which should only be used by you, the sysop.  Needless to say, the
  70. usage of the FIDX.LST file in the SYSOP8 mod will probably go away real soon
  71. and the SYSOP8.CFG file will be the ONLY configuration file used for the
  72. SYSOP8 mod.
  73.  
  74. After you have created your "FIDX.LST" and/or SYSOP8.CFG file, you are ready
  75. to try it out.
  76.  
  77. OPERATION:
  78. ----------
  79. The SYSOP8 functions are activated by pressing "8" at the command prompt in
  80. RBBS.  This should be a SYSOP ONLY Feature.
  81.  
  82.        MAKE SURE YOU HAVE SET THE SECURITY LEVEL OF "8" IN CONFIG!
  83.  
  84. The SYSOP8 functions allow full manipulation of ANY FILE on your computer!
  85.  
  86. Now that you've been warned, let's go on.
  87.  
  88. ADD a File -
  89. ------------
  90.   This feature looks just like the local upload feature in stock RBBS, with
  91.   the exception of you are prompted for the filename of the file you want to
  92.   upload.  You can enter the full path and filename of any file you want to
  93.   upload.  There is NO SECURITY CHECKING for this feature!  Step by Step, here
  94.   is what happens.
  95.  
  96. A)dd, D)elete, E)dit, F)ind, M)ove, H)elp, [Q]uit  A
  97.  
  98. ADD an FMS Entry
  99. Enter SOURCE Path/Filename of new file to ADD!  B:JUNK.ZIP
  100.  
  101. Enter TARGET filename: [JUNK.ZIP]  NEW.ZIP
  102.  
  103. Upload to [A]ll, S)ysop, or Partial Name  A
  104.  
  105. ADD B:JUNK.ZIP to C:\RBBS\UPLOAD\ (Y)es,[N],A)bort)  N
  106.  
  107. ADD B:JUNK.ZIP to C:\RBBS\DOWNLOAD\ (Y)es,[N],A)bort)  Y
  108.  
  109. Copying B:JUNK.ZIP as NEW.ZIP to C:\RBBS\DOWNLOAD\
  110.  
  111. (this part is the same as a local upload)
  112.  
  113. Rebuilding C:DIR\FIDX.DEF
  114. Re-Indexing C:DIR\FIDXT.DEF
  115.  
  116.  
  117. And presto, the file on your Floppy drive is now in your RBBS file system!
  118. Go ahead and give it a try now!  If you have the FIDX.LST file configured
  119. properly, SYSOP8 will also check for SubBoard file systems and give you the
  120. oppourtunity to add the file to a subboard from whereever you might be at the
  121. time.
  122.  
  123.  
  124. DELETE a File -
  125. ---------------
  126.  This feature is great for getting rid of the uploaded files that you don't
  127.  want on your system, like PCBORED demo, WildCat Test Drive, etc.
  128.  Simply type in the FILENAME ONLY (no path) of the file you want to delete.
  129.  SYSOP8 looks in the Personal Files Subdirectory first, and then in the
  130.  subdirectories listed in CONFIG #208, and finally in the subdirectories listed
  131.  in the LIDX.DEF file.  It doesn't look in the M! macro's if you have them.
  132.  If SYSOP8 finds the file you want to delete, it will ask if that file found is
  133.  the one you really want to delete.  When and if you do select to delete the
  134.  found file, SYSOP8 will take care of removing the file off your HD and out of
  135.  your files list and the FIDX.DEF if need be.  If you find that you have an
  136.  entry in your files list, but the file itself cannot be found, you can still
  137.  have SYSOP8 remove the entry from your file list and rebuild the FIDX.DEF.
  138.  
  139.  
  140. EDIT a File -
  141. -------------
  142.  (This feature is not yet incorporated)
  143.  
  144. FIND a File -
  145. -------------
  146.  This feature is very simple.  It will look all through you MAIN and subboard
  147.  file systems for a filename you enter and if it finds it, tell you where the
  148.  file is located.  Once again, do not enter the path with the name of the file
  149.  to find!  Let the SYSOP8 mod do that part.
  150.  
  151. MOVE a File -
  152. -------------
  153.  MOVING a file will prompt you for the filename (no path, please) to move and
  154.  then prompt you where you want to move the file to, sort of like the ADD a
  155.  file feature.  After the file is moved, you are also asked if you would like
  156.  to EDIT the file you moved.
  157.  
  158. Quit -
  159. ------
  160.  Exits the SYSOP8 commands.
  161.  
  162. OPERATIONAL NOTES:
  163. ------------------
  164. This mod involved a lot of thinking and what I like to call "What IF" handling.
  165. There are a LOT of possible set ups in the RBBS file system, and for best
  166. results, here are my strong and tested suggestions that you follow before
  167. using this mod:
  168.  
  169.   1). Use an FMS system!  An FMS system has "backwards" entries in your
  170.       MASTER files list.  If you have a TOP DOWN FMS system, then DO NOT use
  171.       the DELETE an FMS Entry if the entry to delete has an extended
  172.       description!  Future revisions will handle FMS listings in any direction,
  173.       but for now, only "backwards" FMS list are properly manipulated.
  174.  
  175.   2). Use the FIDX/LIDX FFS system!  You can either use the MAKEFIDX utility
  176.       which is included with stock RBBS in the RBBS-UTL file or (highly
  177.       reccommended) Warren Muldrow's RFM utility (RFM-120.ZIP on most BBS's).
  178.  
  179.   3). Do NOT delete an entry on a multi-line system when someone is browsing
  180.       through your file lists on another node!
  181.  
  182.   4). It is reccommended that you do not perform ANY SYSOP8 features while
  183.       someone else is using the file system on another node.  Although all
  184.       files are opened as "SHARED", there are times when the files list or
  185.       FIDX/FIDXT files are rebuilt and then after the original files are
  186.       deleted, the new files are renamed to their perspective names.  This
  187.       only occures during a DELETION.  If you do this while a caller on
  188.       another node is browsing through your files list, more than likely,
  189.       RBBS will panic and immediatly EXIT, leaving your caller in limbo.
  190.       Future revisions may provide for multi-line awareness.
  191.  
  192. | 5). When DELETING a file, CHAINED FMS's are not supported.  You can
  193. |     physically remove a file from your private, upload or download areas,
  194. |     however, the file will only be removed from a listing if it is in
  195. |     the PRIV.DEF or MAIN FMS directory file.
  196.  
  197. DISCLAIMER
  198. ----------
  199. The SYSOP8 features work great on my computer, and should on your's too,
  200. especially if you read this doc.  If something goes wrong, it's your fault!
  201. I am not responsible for any loss, misuse, use of this modification.
  202.