home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac / sfofp24b.zip / SFOFP.DOC < prev    next >
Text File  |  1994-09-04  |  8KB  |  178 lines
  1.  
  2.  
  3.               ╓────────────────────────────────────────────────╖
  4.               ║       SFOFP v2.4ß Zip/ARJ Old File Purge       ║
  5.               ║        For Updating Spitfire File Areas        ║
  6.               ║       Copyright (C) 1994 by Kevin Cummins      ║
  7.               ╙────────────────────────────────────────────────╜
  8.  
  9. What It Does:
  10. ─────────────
  11. SFOFP is a utility designed to help sysops that need to manage their
  12. growing file bases, by either MOVING or DELETING old files.
  13.  
  14. SFOFP determines the age of the ZIP/ARJ file by 'looking' at the files
  15. INSIDE the archive. It DOES NOT use the external file date of the ZIP or ARJ
  16. file itself as a basis for how old the file is. Instead, the date of the
  17. NEWEST file inside the archive is used to compare against a date the sysop
  18. enters at runtime.
  19.  
  20. If the file is determined to be OLDER than the sysop specified date, then
  21. the file is either moved or deleted, depending on the choice the sysop made
  22. at runtime. If the choice was to MOVE, then a directory called OLDFILES
  23. will be created one level below the default directory and all files to be
  24. moved will be relocated there, along with a copy of the file descriptions.
  25. If the choice was to DELETE, then the file is simply deleted and the
  26. description removed from SFFILES.BBS.
  27.  
  28. SFOFP also writes to a LOG file as it operates. All activities of SFOFP
  29. will be sent to this file as well as the screen for viewing while
  30. executing. SFOFP.LOG will be created or appended in the default directory.
  31.  
  32.  
  33. Considerations:
  34. ───────────────
  35. SFOFP never writes to your present SFFILES.BBS, for those of you who become
  36. apprehensive about having your file listings messed with. Once processing
  37. is complete, your old file is renamed to SFFILES.BAK and the new one takes
  38. it place.
  39.  
  40. As of this writing, I have tested both PKZIP 1.1 and 2.04g with SFOFP. Both
  41. seem to work fine, no matter which version the files were actually zipped
  42. with.
  43.  
  44. As far as speed, this will not be the fastest utility you have ever run,
  45. due the nature of the operations involved. SFOFP itself is plenty fast, but
  46. since it makes calls to PKZIP/ARJ, well.......:)
  47.  
  48. Operation:
  49. ──────────
  50. Execution is very simple. If you place SFOFP somewhere in your dos path,
  51. you can then simply change to the directory you wish to run SFOFP on,
  52. and type >SFOFP
  53.  
  54. It is mandatory that PKZIP.EXE is either in your dos path, or in the
  55. current directory when SFOFP is executed if you choose not to use the /ZIP
  56. parameter on the command line. This parameter was added as an attempted fix
  57. for a few sysops having a problem with PKZIP execution within SFOFP.
  58. Proper use of this parameter is /ZIP=PATH TO PKZIP.EXE.
  59.  
  60.         Example: SFOFP /ZIP=C:\UTILS\PKZIP.EXE
  61.  
  62. The path to ARJ.EXE can be specified in the same manner:
  63.  
  64.         Example: SFOFP /ARJ=C:\UTILS\ARJ.EXE
  65.  
  66. Command line parameters can be in any order, and can be combined with the
  67. /MOVE, /DELETE, /DATE= parameters discussed below for registered users.
  68.  
  69. If you haven't specified a path to PKZIP and/or ARJ on the command line,
  70. SFOFP will search for them in your Dos path, and verify them if found. If
  71. found on the command line, paths will be verified before operation
  72. continues.
  73.  
  74. ARJ is totally optional. SFOFP will work just fine if ARJ doesn't exist
  75. anywhere in your computer. However, PKZIP *must* be found somewhere in your
  76. computer even if your primary compression method is ARJ! SFOFP will simply
  77. halt operation if it cannot find PKZIP!
  78.  
  79. SFOFP will first ask you if you wish to MOVE or DELETE. You will respond by
  80. typing D, M, or Q to Quit.
  81.  
  82. Next, SFOFP will ask you to input the date you wish to use as a comparison
  83. against the newest file in each archived file. Type in the number of the
  84. month, day, and year you wish to use.
  85.  
  86. SFOFP will then process each file listed in SFFILES.BBS in the default
  87. directory. Each ZIP/ARJ that does NOT have a file inside newer than the
  88. date you specified will either be moved or deleted.
  89.  
  90.  
  91. Batch Mode Operation:  (Registered Version Only)
  92. ─────────────────────
  93. Version 1.2+ is capable of running unattended in batch mode. SFOFP will
  94. accept two command line parameters. They are:
  95.  
  96.         /MOVE
  97.         /DELETE
  98.         /DATE=
  99.  
  100. You MUST specify either a /MOVE or /DELETE plus the /DATE= parameter to put
  101. SFOFP into batch mode. SFOFP will not operate in batch mode with only one
  102. of these parameters on the command line, as both are required.
  103.  
  104. Examples:
  105.  
  106.         SFOFP /DELETE /DATE=01/01/90    This would delete all files older
  107.                                         than 01/01/90 in the current
  108.                                         directory, listed in SFFILES.BBS.
  109.  
  110.         SFOFP /MOVE /DATE=01/01/90      This is the same as above, except
  111.                                         the files will be moved instead of
  112.                                         deleted, and their descriptions
  113.                                         saved to an oldfiles listing.
  114.  
  115.         SFOFP /MOVE                     This is invalid as a batch mode
  116.                                         command. SFOFP would revert to
  117.                                         interactive mode.
  118.  
  119.         SFOFP /DATE=01/01/92            Same results as the last example.
  120.  
  121.         SFOFP /MOVE /DATE = 06/07/93    This would be invalid, only because
  122.                                         spaces are not allowed in the
  123.                                         command line parameters.
  124.  
  125.         SFOFP /DELETE /DATE=3/1/90      This is also invalid. The date MUST
  126.                                         contain SIX integers. The preceding
  127.                                         zeros are mandatory.
  128.  
  129. Be sure to follow the examples exactly. Do not include spaces, and make
  130. sure the date is in the format: mm/dd/yy. Be certain to include any
  131. preceding Zeros in days or months less than 10, separated by a slash.
  132.  
  133.  
  134. Suggestions:
  135. ────────────
  136. I would suggest you copy one of your smaller file areas over to a test
  137. directory, and run SFOFP on it. You might feel more secure running this the
  138. first time on a dummy directory. Of course, backing up your file areas
  139. regularly is always a good idea, and you might want to back up now if you
  140. really feel uneasy.
  141.  
  142. If you are having problems executing SFOFP, and are not using the command
  143. line parameter(s) to specify ZIP or ARJ paths, please do so. It seems this
  144. may be necessary on some systems, but not on others. If you still have
  145. problems, please contact the author.
  146.  
  147.  
  148. Registration:
  149. ─────────────
  150. All you need to make this copy registered is a registration key file, which
  151. will also be good for any future version of SFOFP. The Registration fee
  152. is only $5. Unregistered versions of SFOFP have a Shareware notice, and
  153. will only process 10 files per run, in interactive mode. Other than that,
  154. registered and non-registered versions do exactly the same job.
  155.  
  156. Creating your registration file only takes a couple seconds, and can be
  157. ready for download on Crimson Cross, usually within 24 hours after
  158. receiving your registration form.
  159.  
  160. A FORM.REG file is included for your convenience.
  161.  
  162.  
  163. Distribution:
  164. ─────────────
  165. SFOFP is released as Shareware. You are welcome to distribute it freely
  166. in it's unmodified form. You may evaluate for a period of thirty days, and
  167. are then required to register if you continue it's use.
  168.  
  169.  
  170.  
  171. Questions, Suggestion, or Comments can be directed to Kevin Cummins at:
  172.  
  173.     Crimson Cross BBS                     RIME  Network
  174.       618-253-3608                      Node: #1390 CCBBS
  175.  
  176.  
  177.  
  178.