home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac / fmsffs31.zip / FMSFFS.DOC < prev    next >
Text File  |  1994-08-01  |  31KB  |  686 lines
  1. ===============================================================================
  2.  
  3.   From the RBBS Files of        FMSFFS v3.1 Copyright (c) 1993,1994
  4.   The Cellar Door RBBS          By: Daniel T. Drinnon * All Rights Reserved
  5.   Sysop: Dan Drinnon            ===============================================
  6.   Home of the CDOR Mods!
  7.  
  8. ===============================================================================
  9. Purpose:
  10.  
  11. To maintain RBBS FFS and FMS files.  Supports Stock and CDOR RBBS.  Not
  12. crippled in any way.
  13.  
  14. ===============================================================================
  15. Usage:
  16.  
  17. FMSFFS [ConfigFile]
  18.  
  19.           ConfigFile is optional.  The default ConfigFile name is FMSFFS.CFG in 
  20.           the current directory.
  21.  
  22. ===============================================================================
  23. Included Files:
  24.  
  25. FMSFFS   EXE  -  the program
  26. FMSFFS   286  -  the program for 286 cpu's and up
  27. FMSFFS   DOC  -  this documentation
  28. FMSFFS   CFG  -  sample configuration file
  29. FMSFFS   ASK  -  contribution form
  30. FILE_ID  DIZ  -  description file
  31.  
  32. ===============================================================================
  33. ConfigFile Options:
  34.  
  35. The configuration for FMSFFS can contain the following selections:
  36.  
  37.   -----------------------------------------------------------------------------
  38.   LogFile   [drive:][path][filename]
  39.  
  40.       FMSFFS can log activity to the log file if specified here.
  41.  
  42.         Default: NONE
  43.   -----------------------------------------------------------------------------
  44.   LogLevel  n
  45.  
  46.       LogLevel controls the level of log activity to be recorded to LogFile.  A
  47.       value of 0 only records the Begin, End and Abort events.  A value of 1
  48.       or records the Begin, End, Abort and Duplicate Files found.  A value of
  49.       2 records all activity except Duplicate Files found.  A value of 4
  50.       records ALL activity.
  51.  
  52.         Default: 0
  53.   -----------------------------------------------------------------------------
  54.   WorkDir   [drive:][path]
  55.  
  56.       When FMSFFS is running, it creates and uses up to 4 work files.  You may 
  57.       select to have these files created on a RAMDRIVE for extra speed during 
  58.       processing.  The WorkDir must have room for approximatly 3 copies of your 
  59.       FMSFile and approximatly 2 copies of your NameFile.  If the WorkDir
  60.       cannot be found, the the DEFAULT PATH will be used.  FMSFFS will
  61.       automatically Exclude work files it creates which may also be
  62.       located withing a FileSpec.
  63.  
  64.         Default: DEFAULT PATH
  65.   -----------------------------------------------------------------------------
  66.   UseEMS
  67.   UseXMS
  68.  
  69.       When FMSFFS is running it will SHELL to run the Sorter program and, if 
  70.       enabled, the ZIP, PAK, or ARC Command program to extract FILE_ID.DIZ 
  71.       files.  UseEMS and UseXMS tell FMSFFS to use EMS and/or XMS memory to 
  72.       store the image of FMSFFS.EXE to give back more RAM during a SHELL. If 
  73.       both UseEMS and UseFMS are not enabled, then FMSFFS will write its image 
  74.       to DISK.
  75.  
  76.         Default: EMS and XMS DISABLED
  77.   -----------------------------------------------------------------------------
  78.   NoSwap
  79.  
  80.       NoSwap will disable EMS, XMS and DISK SHELL swapping.  Normally, you will 
  81.       always have enough coventional RAM to run the Sorter and Archive programs, 
  82.       so it is reccomended that this option is enabled.
  83.  
  84.         Default: No EMS, XMS or DISK SHELL SWAPPING
  85.   -----------------------------------------------------------------------------
  86.   Sorter    [drive:][path][filename]
  87.  
  88.       FMSFFS must have an external sort program to sort the FFS and FMS files. 
  89.       This program must be able to do an ALPHABETICAL sort and also most be able 
  90.       to sort on different COLUMNS in a file.
  91.  
  92.         Default: QSORT
  93.   -----------------------------------------------------------------------------
  94.   AlphaSort [...]
  95.  
  96.       This is the command line given to the Sorter to do a basic alphabetical 
  97.       sort on an FFS or FMS file.
  98.  
  99.         Default: NONE
  100.   -----------------------------------------------------------------------------
  101.   DateSort  [...]
  102.  
  103.       This is the command line given to the Sorter to do a DATE sort on an FMS 
  104.       file.
  105.  
  106.         Default: /30:2 /24:5 /-1.
  107.   -----------------------------------------------------------------------------
  108.   NameFile  [drive:][path][filename]
  109.  
  110.       The NameFile is the "FIDX.DEF" RBBS index file.
  111.  
  112.         Default: FIDX.DEF
  113.   -----------------------------------------------------------------------------
  114.   LocationFile [drive:][path][filename]
  115.  
  116.       The LocationFile is the "LIDX.DEF" RBBS list file.
  117.  
  118.         Default: LIDX.DEF
  119.   -----------------------------------------------------------------------------
  120.   TabFile   [drive:][path][filename]
  121.  
  122.       The TabFile is the "FIDXT.DEF" RBBS tab file.  RBBS expects this file to 
  123.       be the same as the NameFile with a "T" before the "." in the name.
  124.  
  125.         Default: FIDXT.DEF
  126.   -----------------------------------------------------------------------------
  127.   WriteMode [REPLACE|APPEND]
  128.  
  129.       WriteMode tells FMSFFS how to handle your existing FFS files.  In
  130.       normal use, you will want FMSFFS to REPLACE the FFS files with the
  131.       new FFS files it builds.  Otherwise, FMSFFS will APPEND FFS information
  132.       to your existing FFS files.
  133.  
  134.         Default: REPLACE
  135.   -----------------------------------------------------------------------------
  136.   MakeRFM
  137.  
  138.       If you use Warren Muldrow's RFM mod then you want to uncomment this 
  139.       option.  The CDOR and MAPLE mods automatically detect an RFM modifed FFS 
  140.       NameFile.  Stock RBBS does not support RFM.
  141.  
  142.         Default: NOT ENABLED
  143.   -----------------------------------------------------------------------------
  144.   CDROMDrive      E
  145.  
  146.       If you are using the RBBS/CDOR CDROM mod then you may want to uncomment 
  147.       this option.   The CDOR mods automatically detect a CDROM modified FFS 
  148.       NameFile.  Up to 255 CDROMDrive's may be specified.  Stock RBBS does not 
  149.       support RFM.  Only use this option for the CDOR9404 and later mods.
  150.  
  151.         Default: NOT ENABLED
  152.   -----------------------------------------------------------------------------
  153.   DirectoryExclude  [drive:][path][filename]
  154.  
  155.       If you use the "/S" FileSpec option and there are specific subdirectories 
  156.       you do not want included in the FileSpec search, then you can exclude them 
  157.       with this option.  The [filename] must match the FileSpec [filename] for 
  158.       FMSFFS to match and exclude.  You may specify up to 255 FileSpecExclude's.  
  159.       A subdirectory may only be excluded if FMSFFS knows to exclude it when
  160.       scanning for subdirectories specifed with the FileSpec option and the /S 
  161.       feature.  Therefore, be sure the DirectoryExclude option is listed BEFORE
  162.       the FileSpec option in your FMSFFS.CFG file.
  163.  
  164.         Default: NONE
  165.   -----------------------------------------------------------------------------
  166.   NeverDelete [drive:][path][filename]
  167.  
  168.       FMSFFS will not delete any files during any RFM operations is you give the 
  169.       FULL path and filename here.  Up to 255 NeverDelete's may be specified 
  170.       here.
  171.  
  172.         Default: NONE
  173.   -----------------------------------------------------------------------------
  174.   FileSpec  [drive:][path][filename] [/S] [path] [days]
  175.  
  176.       The FileSpec tells FMSFFS the location of your BBS files.  Normally, you 
  177.       will want to make the [filename] be "*.*".  When you include a "/S", then 
  178.       FMSFFS will search ALL subdirectories below the FileSpec for matches to 
  179.       the [filename].  If you are using Warren Muldrow's RFM mod and have 
  180.       uncommented the MakeRFM config option, then you can also specify a path 
  181.       and number of days to delete files which have not been downloaded or 
  182.       viewed for the number of days specified. Up to 1000 subdirectories may be
  183.       given to the FileSpec however, FMSFFS will always check for available 
  184.       program memory and print an exclamation mark "!" when you have specified 
  185.       more FileSpec's than FMSFFS can handle.
  186.  
  187.         Default: NONE
  188.   -----------------------------------------------------------------------------
  189.   FileNameExclude  [filename]
  190.  
  191.       If you need to prevent FMSFFS from adding specfic files it finds to your 
  192.       FMSFile, then you must tell FMSFFS the NAME of each file here.  You may 
  193.       specify up to 255 FileNameExclude's.
  194.  
  195.         Default: NONE
  196.   -----------------------------------------------------------------------------
  197.   BulletinFile [drive:][path][filename] [days]
  198.  
  199.       If you are using Warren Muldrow's RFM mod, have MakeRFM uncommented, AND
  200.       specified a path and days for FileSpec, then you can also have FMSFFS
  201.       create a Bulletin File listing files which will be deleted soon.  The
  202.       days paramter tells FMSFFS the cutoff days to list files to be deleted.
  203.       For example, if the FileSpec [days] is 30, the BulletinFile [days] is 20
  204.       and today is the 1st of the month, then all files in the FileSpec
  205.       directory which have NOT been downloaded or viewed will be listed in the
  206.       bulletin starting on the 10th (20 days before they will be deleted).  The
  207.       RBBS naming convention for BulletinFile applies here.  If BulletinFile
  208.       is C:\RBBS\BULLETIN\BOLDIES, the FMSFFS will make OLDIES, OLDIESG,
  209.       OLDIESC and OLDIESR (RIP).  The RIP version of the BulletinFile will also
  210.       use the CDOR SmartText {SO and {SN.  Stock RBBS will just output 2
  211.       spaces for these characters.  If the filename you specify is 8 characters
  212.       long, then FMSFFS will only use the first 7 characters.
  213.  
  214.         Default: NONE
  215.   -----------------------------------------------------------------------------
  216.   DirString  [...]
  217.  
  218.       If you are using RBBS macros in your FMS, then you must identify them here 
  219.       so FMSFFS can properly handle them.  It is beyond the scope of this 
  220.       documentation to explain how to use RBBS macros in you FMS files. Please 
  221.       consult RBBS Documentation and also look at the files contained within 
  222.       RBBS-UTL.ZIP for further information.
  223.  
  224.         Default: NONE
  225.   -----------------------------------------------------------------------------
  226.   FileDir [drive:][path][filename]
  227.  
  228.       FileDir works in conjunction with the DirString option.  If you do use the 
  229.       DirString and FileDir options with RBBS macros, please be sure that the 
  230.       FileDir files are formatted the same as your FMSFile. In otherwords, each 
  231.       line in the FileDir should have the same number of characters as in your 
  232.       FMSFile.
  233.  
  234.         Default: NONE
  235.   -----------------------------------------------------------------------------
  236.   FMSFile [drive:][path][filename]
  237.  
  238.       FMSFile is the name of your RBBS FMS file to process.  FMSFFS will only 
  239.       process your FMSFile(s) listed here if they are specified.  FMSFFS will 
  240.       not follow an \FMS CH() specification, so if you do chain your FMS files, 
  241.       then list each one here.  Up to 255 FMSFile's may be specified.
  242.  
  243.         Default: NONE
  244.   -----------------------------------------------------------------------------
  245.   FMSIndex
  246.  
  247.       If you are using the RBBS/CDOR Times Downloaded mod and you update the 
  248.       Times Downloaded values while callers are online then you may want to 
  249.       uncomment this option.   With this option, FMSFFS will create an FMSFile 
  250.       INDEX with the name of the FMSFile and the filename extension of .IDX. 
  251.       The CDOR mods will look for this file and use it if found which will 
  252.       result in faster updating of the Times Downloaded field.  The FMSFile 
  253.       INDEX is also used with the SYSOP8 mod when deleting FMS entries. Only 
  254.       use this option for the CDOR9404 and later mods.
  255.  
  256.         Default: NO INDEX
  257.   -----------------------------------------------------------------------------
  258.   FMSFormat [...]
  259.  
  260.       FMSFormat tells FMSFFS how to sort the FMSFile. By default, FMSFFS will 
  261.       sort your FMSFile by "backwards" date.  Otherwise, FMSFFS will look for 
  262.       "TOP" and/or "NOSORT" in the FMS Header and honor those settings.
  263.  
  264.         Default: NONE (date format)
  265.   -----------------------------------------------------------------------------
  266.   FMSAlpha  [drive:][path][filename]
  267.  
  268.       FMSFFS will optionally create an alphabetically sorted FMS file for you if 
  269.       you specify a filename here.  There is very little overhead to create an 
  270.       FMSAlpha file because FMSFFS will have a alphabetically sort FMS list 
  271.       during its process which is used internally and can also be used for this 
  272.       option.
  273.  
  274.         Default: NONE
  275.   -----------------------------------------------------------------------------
  276.   FMSAlphaHeader [...]
  277.  
  278.       If you specified an FMSAlpha file, then FMSFFS will insert the 
  279.       FMSAlphaHeader on the FIRST line of the FMSAlpha file.  When RBBS is set 
  280.       up with an FMS system, the FMSAlphaHeader is required to tell RBBS how to 
  281.       handle the list.
  282.  
  283.         Default: \FMS TOP NOSORT
  284.   -----------------------------------------------------------------------------
  285.   FMSDate [...]
  286.  
  287.       FMSDate tells FMSFFS how to date FMS entries.  If FMSDate is set to ".", 
  288.       then FMSFFS will use the physical file date as reported by DOS. FMSDate 
  289.       with no parameters will tell FMSFFS to use the date as listed in the 
  290.       FMSFile UNLESS the physical file date as reported by DOS is NEWER than the 
  291.       FMSFile date.  This keeps your FMSFile updated as BBS files get updated, 
  292.       placing updated BBS files towards the newer part of the FMSFile list.
  293.  
  294.         Default: NONE (use FMSFile date)
  295.   -----------------------------------------------------------------------------
  296.   DateSeparator [.]
  297.  
  298.       DateSeparater is a one character value which you would like FMSFFS to use 
  299.       for date listings in the FMSFile.  If this option is not enabled, then the 
  300.       standard date separator is a dash "-".
  301.  
  302.         Default: -
  303.   -----------------------------------------------------------------------------
  304.   FMSDupePath [...]
  305.  
  306.       If FMSFFS finds any duplicate files, it can move these duplicate files to
  307.       a hold directory you specify here.  FMSFFS will move the duplicate file
  308.       which is on the lower numbered drive.  For example, if a duplicate file
  309.       is found in C:\RBBS\FILES and E:\BBS\RBBS, then the file in C:\RBBS\FILES
  310.       would be moved to the hold directory.  If NO path is specified, then
  311.       FMSFFS will simply DELETE the duplicate file.
  312.  
  313.         Default: NONE (do not move dupes)
  314.   -----------------------------------------------------------------------------
  315.   FMSMissing [...]
  316.  
  317.       FMSMissing is a 9 character (or less) text string to be placed in the File 
  318.       Size field of the FMSFile listing for any FMSFile entry which FMSFFS 
  319.       cannot find in the FileSpec or FileDir specifications.
  320.  
  321.         Default: NONE (delete missing FMS files from the FMSFile)
  322.   -----------------------------------------------------------------------------
  323.   UnKnownDesc  [...]
  324.  
  325.       If FMSFFS finds files NOT listed in FMSFile, then it will automatically 
  326.       add the file to the FMSFile and give it the description you specify here.
  327.       In the event of CHAINED FMSFiles, the unlisted file will be added to the
  328.       FIRST FMSFile listed in the FMSFFS.CFG file.
  329.  
  330.         Default: "<Description Unavailable>"
  331.   -----------------------------------------------------------------------------
  332.   FILEID  [filename]
  333.  
  334.       FMSFFS will search all ZIP, ARC and PAK archived files for FILE_ID.DIZ (or 
  335.       whatever filename you specify here) and import the FILE_ID.DIZ text into 
  336.       the FMSFile description.  The FIRST line in the FILE_ID.DIZ will be used 
  337.       as the MAIN description and any remaining lines in the FILE_ID.DIZ will be 
  338.       placed in the extended description.  It will take longer for FMSFFS to 
  339.       look inside archived files for the FILE_ID.DIZ file, so you should only 
  340.       run FMSFFS with this option ONE TIME.
  341.  
  342.         Default: NONE (do not look)
  343.   -----------------------------------------------------------------------------
  344.   GIF
  345.  
  346.       FMSFFS will add GIF dimensions (ex: (640x480x256)) to all GIF files listed 
  347.       in the FMSFile to the MAIN FMSFile description.  FMSFFS will only extract 
  348.       the GIF dimensions and place them in the FMSFile when the FIRST character 
  349.       of the MAIN FMSFile description does NOT start with "(".  The original 
  350.       description will then be appended to the end of the dimensions.  It will
  351.       take FMSFFS longer to extract this information from each GIF file in your 
  352.       FMS so you should run FMSFFS with this option ONE TIME.
  353.  
  354.         Default: NONE (do not extract)
  355.   -----------------------------------------------------------------------------
  356.   KeepExtended
  357.  
  358.       FMSFFS will not overwrite an existing FMSFile extended description if
  359.       this option is enabled.
  360.  
  361.         Default: OVERWRITE
  362.   -----------------------------------------------------------------------------
  363.   MaxExtendedLines [n]
  364.  
  365.       FMSFFS will limit the number of Extended Description lines by what you
  366.       set here.  The maximum allowable extended lines per filename is 199.
  367.  
  368.         Default: 10
  369.   -----------------------------------------------------------------------------
  370.   CategoryChange  [old] [new]
  371.  
  372.       FMSFFS can change Category Codes in the FMSFile by using this option.
  373.       Both the [old] and [new] paramters must be specified.  The [old] and
  374.       [new] paramters should be the same length as the FMSCatLen.  You can
  375.       specify up to 255 categories to change.  CategoryChange's will be
  376.       processed BEFORE CategoryDirChange's.
  377.  
  378.         Default: NONE
  379.   -----------------------------------------------------------------------------
  380.   CategoryDirChange  [directory] [category]
  381.  
  382.       FMSFFS can change Category Codes in the FMSFile by using this option.
  383.       Both the [directory] and [category] paramters must be specified.  The
  384.       [category] paramters should be the same length as the FMSCatLen.
  385.       You can specify up to 255 categories to change.  CategoryDirChange's
  386.       will be processed AFTER CategoryChange's.
  387.  
  388.         Default: NONE
  389.   -----------------------------------------------------------------------------
  390.   FMSCatCode [...]
  391.  
  392.       FMSFFS will use the category code specified here for the FMS category for 
  393.       any files it finds not listed in FMSFile.  This option must be a 3 
  394.       character string.
  395.  
  396.         Default: 999
  397.   -----------------------------------------------------------------------------
  398.   FMSDescLen  [..]
  399.  
  400.       FMSFFS can CHANGE the description length of your FMSFile descriptions by 
  401.       what you specify here.  There is no upper or lower limit for this option.
  402.  
  403.         Default: 46
  404.   -----------------------------------------------------------------------------
  405.   FMSExtra [..]
  406.  
  407.       FMSFFS can handle 1 extra FMS FIELD in your FMSFile, such as the Times 
  408.       Downloaded information optionally available with the CDOR mods. If any 
  409.       extra information is included in your FMSFile, then its LENGTH must be 
  410.       specified here.  This field must also be located after the FMS description 
  411.       and before the FMS category.  FMSFFS currently uses FMSExtra specfically 
  412.       for the CDOR Times Downloaded mod.
  413.  
  414.         Default: 0
  415.   -----------------------------------------------------------------------------
  416.   FMSCatLen [.]
  417.  
  418.       This is the length of the Category CODE in the FMSFile.  With current 
  419.       versions of RBBS, this length should always be 3.
  420.  
  421.         Default: 3
  422.   -----------------------------------------------------------------------------
  423.   ZIPCommand [filename]
  424.  
  425.       This is the command to unZIP.  It is used in conjunction with the FILEID 
  426.       filename.
  427.  
  428.         Default: PKUNZIP
  429.   -----------------------------------------------------------------------------
  430.   ARCCommand [filename]
  431.  
  432.       This is the command to unARC.  It is used in conjunction with the FILEID 
  433.       filename.
  434.  
  435.         Default: PKXARC
  436.   -----------------------------------------------------------------------------
  437.   PAKCommand [filename]
  438.  
  439.       This is the command to unPAK.  It is used in conjunction with the FILEID 
  440.       filename.
  441.  
  442.         Default: PKUNPAK
  443.  
  444. ===============================================================================
  445. Notes and Pratical Applications:
  446.  
  447.   Speed
  448.  
  449.       FMSFFS has been tideously coded to give the highest throughput during its 
  450.       runtime operation.  There are certain configuration options that will 
  451.       affect the speed of FMSFFS's processing time:
  452.  
  453.          WorkDir -
  454.            Your WorkDir should be a RAMDrive or your fastest Hard Drive.
  455.  
  456.          UseEMS,UseXMS -
  457.            Any time FMSFFS SHELLS to sort files, it will swap itself to
  458.            EMS,XMS or DISK for more memory  unless you turn these options
  459.            off and use the NoSwap option.  Generally, you will not want to
  460.            use EMS, XMS or DISK swapping unless your system does not have
  461.            enough memory to run the ZIP, ARC or PAK commands.  These options
  462.            will most noticably slow FMSFFS down when FILEID is active.
  463.  
  464.          MakeRFM -
  465.            When this option is enabled, FMSFFS must reindex the FIDX file.
  466.            This does not take much time, but does add an extra process to
  467.            the operation.
  468.  
  469.          FileNameExclude, DirectoryExclude -
  470.            If you exclude Filenames or Directories, then FMSFFS must check
  471.            the FileSpec's you told it to look in for matches.  The more
  472.            exclusions, the longer it takes.
  473.  
  474.          CategoryChange, CategoryDirChange -
  475.            When changing categories, FMSFFS must check for matches for every
  476.            file in your FMS.  The more Categories you change, the longer it
  477.            will take.  These 2 options should normally only be used once.
  478.  
  479.          FMSFile -
  480.            When FMSFile is specified, then FMSFFS will process your FMS
  481.            after processing your FFS.  If all you need to do is process
  482.            your FFS files, then comment FMSFile out.  When CHAINING FMS
  483.            files, FMSFFS must reindex each file in your FMSFiles which
  484.            invloves one extra process while FMSFFS runs.
  485.  
  486.          FMSAlpha -
  487.            Creating an FMSAlpha file will slow FMSFFS down slightly.
  488.  
  489.          FMSMissing -
  490.            When you have FMSFFS check your FMSFile for filenames which are
  491.            not on your HD or CD-ROM, then FMSFFS will verify your FMSFile
  492.            against the FIDX files before processing the FMSFile.
  493.  
  494.          FMSDupePath -
  495.            If FMSFFS must copy all duplicate files it finds, then there will
  496.            be some slowdown.  This option should normally be run only once.
  497.  
  498.          FILEID,GIF -
  499.            Needless to say, checking archived files for FILE_ID.DIZ files
  500.            will take a lot more time than a normal run.  You should only
  501.            use these options once on an FMSFile you want to add FILE_ID.DIZ
  502.            descriptions and/or GIF dimensions to.  CD-ROM drives will
  503.            greatly affect FMSFFS's operation depending on the speed of the
  504.            drive.  For every filename in your FMSFile, FMSFFS will open and
  505.            search for FILE_ID.DIZ or extract the GIF dimensions, depending
  506.            on the filename's extension.
  507.  
  508.          KeepExtended -
  509.            This option will stop FMSFFS from looking for FILE_ID.DIZ in
  510.            files listed in your FMS which already have an extended
  511.            description.
  512.  
  513.       In summary, the following options, in descending order, are the
  514.       biggest time hogs with FMSFFS:
  515.  
  516.            FILEID
  517.            UseEMS,UseXMS (with FILEID)
  518.            GIF
  519.            FMSDupePath (when moving duplicates)
  520.            FMSMissing
  521.  
  522.       The other options listed above affect FMSFFS's operation acutely.
  523.  
  524.  
  525.    Daily Operations
  526.  
  527.       There are basically 2 ways to use FMSFFS in a day-to-day basics for
  528.       your BBS.  As a daily event, you can run FMSFFS against all your BBS
  529.       files for regular maintenance.  If you run a front end system such
  530.       as BinkleyTerm or Front Door, sometimes your system may receive
  531.       network files which you process with a "TIC" tosser.  If your "TIC"
  532.       tosser places incoming network files anywhere BUT your default RBBS
  533.       upload subdirectories, then callers will see the new file in your
  534.       FMSFile list, but will not be able to download it because it is not
  535.       in the FFS FIDX.DEF list.  So, you can make part of your "TIC"
  536.       processing also run FMSFFS, but, make FMSFFS use a special
  537.       FMSFFS.CFG file which has the FMSFile line commented out.  This will
  538.       make FMSFFS rebuild the FFS files only and save time by not processing
  539.       large FMSFiles.
  540.  
  541.  
  542.    Periodic Operations
  543.  
  544.       Occasionally, you may want to run FMSFFS with the FILEID and/or GIF
  545.       options enabled to catch missing FILE_ID.DIZ descriptions and GIF
  546.       dimensions in your FMSFile.
  547.  
  548.  
  549.    Making New FMSFiles
  550.  
  551.       FMSFFS does not need an existing FMSFile to run.  If the FMSFile
  552.       is not found, then it assumes you want to make a new one.  When
  553.       this happens, all FMSFile entries will have the UnKnownDesc for
  554.       the description and the current date unless you are using the "."
  555.       for FMSDate.
  556.  
  557.       You may want to make use of the CategoryDirChange to assign categories
  558.       to FMSFile entries based on their subdirectory location.
  559.  
  560.       Because of the way FMSFFS operates, you must have an existing FMSFile
  561.       to use the FILEID and/or GIF options.  Even if these options are
  562.       enabled, they will not be active when FMSFFS is creating a NEW
  563.       FMSFile.  To use these options, run FMSFFS a second time.
  564.  
  565.  
  566.    RFM considerations
  567.  
  568.       When you are using the MakeRFM option, FMSFFS uses your current
  569.       FIDX.DEF file to extract the FIDX.DEF DATE field.  This means
  570.       FMSFFS has to search through your old FIDX.DEF file for matches to
  571.       the creent FIDX.DEF file that FMSFFS creates.  This is normally not
  572.       a problem, but if you were to exclude files from your FMS that were
  573.       previously in your FMS, then FMSFFS has to go through more data
  574.       in the old FIDX.DEF to find a match.  This may slow the process down
  575.       and if it does, you may want to just DELETE your old FIDX.DEF and
  576.       let FMSFFS make a new one.
  577.  
  578.       FMSFFS handles the RFM procedure the same as Warren Muldrow's RFM
  579.       does in respect to the FMSFile specification.  For example, the
  580.       following line:
  581.  
  582.       FileSpec   C:\RBBS\FILES\*.*   C:\RBBS\OLDFILES  180
  583.  
  584.       Means all files in C:\RBBS\FILES will be moved to C:\RBBS\OLDFILES
  585.       after 180 days inwhich any file in this subdirectory was not viewed
  586.       or downloaded.  Needless to say, you do NOT want to use the RFM
  587.       options unless your RBBS can handle it.  Further:
  588.  
  589.       FileSpec   C:\RBBS\FILES\*.*  /S  C:\RBBS\OLDFILES  180
  590.  
  591.       Means files below C:\RBBS\FILES will be moved as well when their time
  592.       has come.
  593.  
  594.  
  595.    Duplicate Names
  596.  
  597.       If FMSFFS comes across duplicate filenames, it will only use the
  598.       first file found for the FFS and FMS files.  The order of the
  599.       first file is determine by the FileSpec.  If FMSDupePath is uncommented,
  600.       then FMSFFS will move the duplicate to a holding area if you
  601.       specify a path, or simply delete the duplicate if there is no path
  602.       specified.
  603.  
  604.  
  605.    ESC
  606.  
  607.       To abort FMSFFS, press ESC!  When you do this, FMSFFS will restore
  608.       as much as possible before finishing.
  609.  
  610.  
  611.    Temp Files
  612.  
  613.       FMSFFS will create, use and delete various work files.  Given your
  614.       NameFile is FIDX.DEF and your FMSFile is MASTER.DIR, the following
  615.       files will be created, used and then deleted in the current directory
  616.       FMSFFS is excuted in or the WorkDir, if specified:
  617.  
  618.          FIDX.WRK
  619.          MASTER.WRK
  620.          MASTER.SRT
  621.          MASTER.EXT
  622.  
  623.  
  624.    Drive Space
  625.  
  626.       FMSFFS will make sure there is enough drive space (WorkDir or otherwise)
  627.       to process its files.  However, since the files created are dynamic the
  628.       the sizes of these files cannot be predicted.  Therefore, if FMSFFS runs
  629.       out of drive space, it will abort and restore the original FFS and FMS
  630.       files.
  631.  
  632.  
  633. ===============================================================================
  634. History:
  635.  
  636. 061993 - * Initial BETA release
  637. 062693 - * Fix for extended descriptions with same dates in a date ordered
  638.            FMS but NOT in alpha order as secondary sort causing problems.
  639.          * Fix for FMSDate "." option
  640. 071093 - * some fixes for creating final master.dir file with no ext. desc.
  641. 073193 - * Beta release of version 2 Beta
  642. 080193 - * fix for alpha.dir header and format output
  643.          * fix for \FMS lines
  644.          * fix for entries in FMS.DIR not online trashing FMS.DIR
  645.          * enabled FMSMissing Option
  646. 080293 - * fix for rfm type fidx file going skewed with unlisted files
  647. 080893 - * fix for invalid DOS filedates when using FMSDate .
  648. 030694 - * Version 2.1 is now from the BASIC version due to problems with
  649.            previous C versions.
  650. 070494 - * Version 3.0 Major Revisions in code!
  651. 070794 - * Added FMSIndex option
  652.            Improved Speed and Fixed Problems with FMSMissing Option
  653.            Added Files/Sec reporting
  654.            Fix for \FMS not being honored when running non-date FMS
  655.            Fix for /S not working with non *.* filespecs
  656.            Added CategoryDirChange
  657.            Added WorkDir and Drive Space checking
  658. 080193 -   Version 3.1
  659.  
  660. ===============================================================================
  661.  
  662. DANIEL T. DRINNON IS NOT RESPONSIBLE TO YOU FOR DAMAGES, INCLUDING BUT NOT 
  663. LIMITED TO, ANY LOST PROFITS, LOST MONIES, OR OTHER SPECIAL, GENERAL, INCIDENTAL 
  664. OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE (INCLUDING 
  665. BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES 
  666. SUSTAINED BY THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER 
  667. PROGRAMS) OR ANY OTHER LOSS EVEN IF YOU HAVE BEEN ADVISED OF THE POSSIBILITY OF 
  668. SUCH DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.
  669.  
  670. ================================================================================
  671. Liscense:
  672.  
  673.            You are authorized to USE this program as long as you would like.
  674.            This program is fully functional as distributed and requires NO 
  675.            registration or intervention for it's execution.  Contributions
  676.            are gladly accepted - see FMSFFS.ASK!
  677.  
  678. ================================================================================
  679.  
  680. Dan Drinnon
  681. The Cellar Door RBBS
  682. 505-784-3187
  683. FidoNet: 1:318/1
  684. RBBSNet: 8:903/2
  685.  
  686.