home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / HATCH / PBFILE21.ZIP / PBFILES.DOC < prev    next >
Text File  |  1996-01-21  |  32KB  |  613 lines

  1.   PBfiles 2.10 - COPYRIGHT 1994-1996 - TRACY L. BAKER - STARPORT VALHALLA BBS
  2.        PBfiles Configuration 1.00 COPYRIGHT 1995-1996 - TRACY L. BAKER
  3.               }}} SPV is now an *OFFICIAL* WWIV Support Site {{{
  4.             *** All the legal junk is at the end of this file! ***
  5.                           >>> A CEREBRUM RELEASE <<<
  6.  
  7.          (I can be reached at 1@11579.wwivnet until further notice.)
  8.  
  9.  
  10.                           :HOW TO ENTER YOUR REGNO:
  11. There are three ways to get to the place where you can enter the registration
  12. number tht you get from me:
  13.  
  14. (1) The first time you run this program (or are upgrading from an earlier
  15.     version).
  16. (2) Type PBFILES /C at the command line.
  17. (3) Type PBFCFG at the command line.
  18.  
  19. After each of these ways, choose option (A) to enter your regno.
  20.  
  21.  
  22.                                 :REQUIREMENTS:
  23. A 80386 class processor or better is required as of version 2.0
  24.  
  25. At least 110k of free conventional memory, 180k of you use the PBFILES /C
  26. approach to enter the configuration editor (70k if you use the PBFCFG.EXE
  27. file solo).
  28.  
  29. A WWIV BBS with a file section set up.
  30.  
  31.  
  32.                    :GETTING STARTED (THE IMPORTANT STUFF!):
  33. For the first time, simply run this from the command line:
  34.  
  35. PBFILES
  36.  
  37. This *will* process all the directories that you have specified in your
  38. default inclusion file (use the / command once in the configuration editor to
  39. name, and edit that file).
  40.  
  41. PBFILES /2  (if running at the same time your BBS is up)
  42.  
  43.  
  44.                           ««« ONE LAST THING!!! »»»
  45. If you plan on running this WHILE YOUR BBS is up, then it is *STRONGLY*
  46. recommended that your include the /2 switch for file sharing support.  This
  47. will keep you from crashing your BBS by enabling file sharing support.
  48. Setting this option to ON in the configuration editor (PBFILES /C) does the
  49. same thing.  In this case, do not use the /2 switch.
  50.  
  51.  
  52.                  :AN INTRODUCTION TO THIS FINE, FINE PROGRAM:
  53. Welcome to PBfiles!  This is the *most* complete WWIV master file lister to
  54. date.  To get an idea, just read down a little further!
  55.  
  56. I've been running a WWIV BBS (StarPort Valhalla) for over 4 years now.  In
  57. all that time, I've *never* found a master file list making program that did
  58. what I wanted it to do.  Sure, I've found a few, but inevitably this one
  59. wouldn't do what that one would, and so on.  So PBfiles is born.  A master
  60. file lister that does it all!
  61.  
  62. THANKS: Kirk of StarFleet Command for being a damn good ßeta (and mostly
  63.         alpha, too) tester and for all the great ideas!
  64.  
  65.                     : ABOUT THAT FANCY NEW ENTRY SCHEME :
  66. Beginning with version 1.4 of PBstring, and 1.2 of both PBconfig and
  67. PBreplace, I've introduced a new way of entering data.  It will now allow you
  68. to enter data instead of having to enter the new data in its entirety.
  69.  
  70. The keys that are active are: Backspace, Delete, Insert, left and right arrow
  71. keys, Home, Escape, and End.
  72.  
  73. The arrows, Home, End, Backspace, and Delete all work in the fashion that
  74. you're used to.
  75.  
  76. The Insert key toggles insert mode on or off (overstrike).
  77.  
  78. The Escape key clears the data from the field entirely, allowing you to enter
  79. new data.  If you press Escape, then Enter, the data field will be erased.
  80.  
  81.  
  82.              :SPEED TESTS/HOW THIS PROGRAM FARED AGAINST OTHERS:
  83. With this release of version 2.0, I've changed all the internal coding.  I
  84. also don't have those old programs to test against.  However, on my machine,
  85. here are my testing times.
  86.  
  87. I use a 80486DX4-120Mhz machine with a 2x and a 6x CD-ROM.  10ms and 9ms
  88. harddrives (both on a VESA local bus) are also factors.
  89.  
  90. Processing 19,104 files on CD-ROM and harddrives, rated fastest to slowest:
  91.  
  92. PBfiles 2.0 with /Q switch   : 42 seconds
  93. PBfiles 2.0 with /F /Q       : 44 seconds
  94. PBfiles 2.0 with /Q /2       : 43 seconds
  95. WWCFL 2.2                    : 171 seconds
  96. PBfiles 2.0                  : 214 seconds
  97. PBfiles 2.0 with /Q /E /M /V : 424 seconds
  98. FileList v1.0                : 754 seconds
  99. TAM v1.23                    : Did not create a complete listing
  100.  
  101. So as you can see, PBfiles, with the /Q switch, BLOWS anything else away in
  102. terms of speed.  In fact, letting it create FILES.BBS type files in each
  103. directory (with the /Q switch) is still almost 4 times faster than the next
  104. closest competetor!
  105.  
  106.  
  107.          :DETAILED COMMAND LINE SWITCH EXPLANATION & SOME EXAMPLES:
  108. ***>>> Please note that {filename} means that you can use *ANY* filename you
  109.        wish.  You can even use complete, valid, DOS path information, too!
  110.  
  111. The following switches act as toggles (turning the desired option on or off)
  112. in relation to the settings found in PBFILES.INI:
  113.  
  114. /2
  115. /F  [all variations]
  116. /G
  117. /H
  118. /E
  119. /L
  120. /M
  121. /Q
  122. /V
  123. /W  [all variations]
  124. /X
  125. /Z
  126.  
  127. These are marked with [TOG]
  128.  
  129. As of this DOC file writing (version 1.6) PBfiles supports a total of 31
  130. command line switches.  The format for these are:
  131. ──────────────────────────────────────────────────────────────────────────────
  132. [what to call this switch]    {example}
  133. /s{filename}  description
  134.               description
  135. example, if any
  136. ──────────────────────────────────────────────────────────────────────────────
  137. [*dump config file]           {/*}
  138. /*            Print the settings from the PBFILES.CFG file into the log file.
  139. ──────────────────────────────────────────────────────────────────────────────
  140. [ignore CD-ROMs!]             {/!}
  141. /!            Keeps PBfiles from listing CD-ROM directories.
  142. ──────────────────────────────────────────────────────────────────────────────
  143. [+add to existing file]       {/+}
  144. /+            Add file listing information to previously existing file
  145.               listing.  File's "header" info. will not be added.  Total byte,
  146.               number of files, and gold (if applicable) will not be tracked.
  147. ──────────────────────────────────────────────────────────────────────────────
  148. [HELP!?!]                     {/?}
  149. /?            Brings up the online help for this program, much the same as
  150.               what you're reading here.
  151. ──────────────────────────────────────────────────────────────────────────────
  152. [2 or more windows - BBS up]  {/2}
  153. /2            If you have a multi-line BBS, or plan on running this program
  154. [TOG]         at the same time your BBS is up (like in another OS/2, Windows,
  155.               *or* DESQview window), then INCLUDE THIS SWITCH on your command
  156.               line or set it to use by using the configuration editor.  The
  157.               reason why it is there is that it enables file sharing.  File
  158.               sharing slows things down. SHARE *MUST* BE LOADED TO TOGGLE
  159.               THIS ON!
  160. ──────────────────────────────────────────────────────────────────────────────
  161. [do All files]                {/A}
  162. /A            Create PBFILES.INC and process all directories.  Do not use
  163.               this switch in this fashion if you do not want to process all
  164.               directories.
  165. ──────────────────────────────────────────────────────────────────────────────
  166. [do All files, don't run!]    {/A!}
  167. /A!           Create PBFILES.INC and process all directories.  Do not run
  168.               the program.
  169. ──────────────────────────────────────────────────────────────────────────────
  170. [do All files]                {/AC:\WWIV\OTHER.INC}
  171. /A{filename}  Same as /A except that {filename} will be created as the
  172.               inclusion filename.
  173. ──────────────────────────────────────────────────────────────────────────────
  174. [creAte master files list!]   {/A!}
  175. /A!{filename} Create {filename} with all directories and exit program.
  176.               Do not run the program.
  177. ──────────────────────────────────────────────────────────────────────────────
  178. [Configure PBfiles]           {/C}
  179. /C            Execute the PBFILES.INI editor.  In this, you can set the
  180.               default inclusion file name, create inclusion files by pick
  181.               lists, set COM1-COM4, and set the status of other options.
  182.               Typing PBFCFG from the command prompt does the same thing.
  183.               Using the /C switch by itself will not create any listings.
  184. ──────────────────────────────────────────────────────────────────────────────
  185. [limit by DAr]                {/DAP}
  186. /DA{a-p}      Limit output to directories that match the DAR specified.  A
  187.               command line with /DAP would limit the listing to directories
  188.               with a DAR of P.  Can be combined with /DS{#}.  See example
  189.               there.
  190. ──────────────────────────────────────────────────────────────────────────────
  191. [limit by DSl]                {/DS50}
  192. /DS{0-255}    Limit output to directories that are equal to, and greater,
  193.               than the DSL specified.  A command line with /DS50 would allow
  194.               all directories with DSL's of 50 and greater to be processed.
  195.               Can be combined with /DA{a-p} as follows:
  196.  
  197. /DAP /DS50
  198. (This would limit processing to those directories that have DSL's of 50 or
  199.  greater *AND* DAR's of P.)
  200. ──────────────────────────────────────────────────────────────────────────────
  201. [DEBUG information]           {/DEBUG}
  202. /DEBUG       Turns on DEBUG information in the PBSTRING.LOG file.  Takes the
  203.              place of having to have a DEBUG.XXX file in existance in the
  204.              current working directory.
  205. ──────────────────────────────────────────────────────────────────────────────
  206. [Extended descriptions]       {/E}
  207. /E            When this command line switch is used, the files' extended
  208. [TOG]         descriptions (if any) will be toggled.  This will be processed
  209.               in both the master, and FILES.BBS reports (if turned on).  Be
  210.               forewarned, however, that using this switch will slow down the
  211.               process immensely and make the report file sizes grow to very
  212.               large proportions.
  213. ──────────────────────────────────────────────────────────────────────────────
  214. [create Files.bbs type files] {/F}
  215. /F            Create, in each hard drive directory processed, a file listing
  216. [TOG]         file specifically for that directory.  This will *not* attempt
  217.               to write to directories that are marked as CD-ROM in
  218.               //DLBOARDEDIT (or as specified by the /R switch).  Used in this
  219.               way, the filename will the data filename (as read from the
  220.               inclusion file) with a .BBS extension.  So UBSYSOP will be
  221.               UBSYSOP.BBS.
  222. ──────────────────────────────────────────────────────────────────────────────
  223. [create Files.bbs type files] {/FF}
  224. /FF           Same as /F except that FILES.BBS will the the filename used for
  225. [TOG]         all directories processed.  This overrides the default setting.
  226. ──────────────────────────────────────────────────────────────────────────────
  227. [create Files.bbs type files] {/FSTARPORT.BBS}
  228. /F{filename}  Same as /F except that {filename} will the filename used for
  229. [TOG]         all directories processed. This overrides the default setting.
  230. ──────────────────────────────────────────────────────────────────────────────
  231. [Get Gif resolution]          {/G}
  232. /G            Get a GIF file's height, width, and number of colors and
  233. [TOG]         include it in the report files output.  Will also be placed in
  234.               any FILES.BBS file.  WIll not process GIF's that are not
  235.               physically there.
  236. ──────────────────────────────────────────────────────────────────────────────
  237. [strip High ascii]            {/H}
  238. /H            Strip out high and low ASCII characters.  These are characters
  239. [TOG]         that have a ASCII value of greater than 126 and less than 32.
  240.               This option is offered because *sometimes* high ASCII, and even
  241.               more so for low ASCII, characters can cause strange things to
  242.               appear in the listings.  Using this switch can solve most of
  243.               these occurances.  (ASCII codes of 3 {heart} are left
  244.               alone to allow for WWIV color codes.)
  245. ──────────────────────────────────────────────────────────────────────────────
  246. [use Inclusion file]          {/IC:\WWIV\OTHER.INC}
  247. /I{filename}  Same as /I except that {filename} will be used instead of
  248.               PBFILES.INC.
  249. ──────────────────────────────────────────────────────────────────────────────
  250. [Inclusion {datafile} name]  {/I:UBSYSOP}
  251. /I:{datafile} Similar to the other /I switches, but quite different, too.
  252.               When used in this way (note the : in the switch, its important)
  253.               you can specify a single directory, as referenced by its WWIV
  254.               datafile name, to process without the need of making an
  255.               inclusion file beforehand.  Perfect for modding into WWIV for
  256.               instant file lists, by directory, for your users!
  257. ──────────────────────────────────────────────────────────────────────────────
  258. [file list masK]               {/KPBFILE*.*}
  259. /K{file mask} The use of this switch will limit the files listed to only those
  260.               that match the file mask you specify.  DOS wildcards are
  261.               accepted.  Entries like PBFILES* will be treated like
  262.               PBFILES*.*.  Works exceptionally well when used with /I:{dfn}
  263. ──────────────────────────────────────────────────────────────────────────────
  264. [suppress Log file entries]    {/L}
  265. /L            Keep PBfiles from making any log entries to PBFILES.LOG. Log
  266. [TOG]         file information looks like this:
  267.  
  268. [PBfiles v2.00 log file opened: November 01, 1995 at 22:34.38]
  269. DEBUG: Memory left @ start: 472k (FCL) 28k (CL)
  270.  
  271. :) This copy of PBfiles v20ß1 is registered!  Thank you, Papa Bear! :)
  272.  
  273. /E toggle (Include extended descriptions)
  274. /M toggle (Include long form file information)
  275. /V toggle (Include long directory information)
  276. /R switch (specify CD-ROM drives)
  277.    Setting up for 1 manually specified CD-ROM drive.
  278. ***Marking drive E as CD-ROM.
  279.    Opening PBFILES.LST in create mode.
  280.    Number of directories is: 50
  281. ∙∙∙Processing: UBSYSOP
  282.     Number of files: 1
  283. ∙∙∙Processing: TESTTEST
  284.     Number of files: 29
  285. . . . . . . . skipping a few lines . . . . . . .
  286. ∙∙∙Processing: CD01047
  287.     Number of files: 17
  288. ∙∙∙Processing: CD01048
  289.     Number of files: 24
  290.  
  291.  4038 files processed -- 604472k bytes
  292. Total time to run: 0 min., 35 secs.
  293. DEBUG: Memory left @ end: 472k (FCL) 28k (CL)
  294. [Log file closed (finished): November 01, 1995 at 22:35.14]
  295. ──────────────────────────────────────────────────────────────────────────────
  296. [More file information]       {/M}
  297. /M            Give more file information.  Without this switch, the file
  298. [TOG]         information in your output file will look like:
  299.  
  300. 1AD     .ZIP    14k  1AD.UUE-  Stops pings dead in their tracks, emails sender
  301. 93DECMOD.ARJ   552k  December 1993 MOD collection from MOD NET
  302. 93NOVMOD.ARJ    78k  November 1993 MOD collection from MOD NET
  303.  
  304.               With this switch, it looks like this:
  305.  
  306. 1AD     .ZIP    14k  1AD.UUE-  Stops pings dead in their tracks, emails sender
  307.                      Papa Bear #1                     [000 d/l's]  (10/25/94)
  308.  
  309. 93DECMOD.ARJ   552k  December 1993 MOD collection from MOD NET
  310.                      Papa Bear #1                     [021 d/l's]  (02/05/94)
  311.  
  312. 93NOVMOD.ARJ    78k  November 1993 MOD collection from MOD NET
  313.                      Papa Bear #1                     [019 d/l's]  (02/05/94)
  314. ──────────────────────────────────────────────────────────────────────────────
  315. [list New files]              {/N}
  316. /N            This, with no modifier (see next switch) will force PBfiles to
  317.               list only files that are 14 days old, and newer.
  318.               ** NOTE ** If any of the /F switches are used in conjunction
  319.               with this, then *new* FILES.BBS type files will be created in
  320.               those directories that have files that match the /N limiting
  321.               criterion.  Only the new files will be listed!
  322. ──────────────────────────────────────────────────────────────────────────────
  323. [list New files]              {/N7}
  324. /N{days}      Same as /N except that you can change the limiting date. /N7
  325.               would list files 7 days and newer.  /N90 would do 90 days and
  326.               newer.  /N1 would list 1 day old files -- great for creating a
  327.               new uploads bulletin!
  328. ──────────────────────────────────────────────────────────────────────────────
  329. [Output filename]             {/OTHISONE.TXT}
  330. /O{filename}  This should always have a {filename}.  If used without one, it
  331.               will default to PBFILES.LST, which is the same as not using the
  332.               /O switch at all.  Lets you redirect the file listing
  333.               anywhere you'd like.  Accepts full path names.
  334. ──────────────────────────────────────────────────────────────────────────────
  335. [Quiet mode]                  {/Q}
  336. /Q            Turn off screen updating.  This makes the whole process a *LOT*
  337. [TOG]         faster!
  338. ──────────────────────────────────────────────────────────────────────────────
  339. [mark drive as cd-Rom]        {/REFG}
  340. /R{drive(s)}  Allows you to mark any drive as a CD-ROM drive.  While the
  341.               program will automatically process directories marked as CD-ROM
  342.               in //DLBOARDEDIT, some of you have those CD-ROM directories
  343.               marked as HARD DRIVE, for whatever reason.  By using this
  344.               switch, you can specify UP TO 9 drives as CD-ROM, and all
  345.               directories located on that drive will be processed as CD-ROM.
  346.  
  347. /RE      (mark drive E as CD-ROM drive)
  348. /RFGKE   (mark drives E, F, G, and K as CDROM -- order makes no difference)
  349.  
  350. Using this also marks the directories as CD-ROM in the listings, like this:
  351.  
  352.        ──══╡Directory Name: Maps and pictures of geography - 40 files╞══──
  353.                                   ──»CD-ROM«──
  354.  ──────────────────────────────────────────────────────────────────────────────
  355. AFRICA2K.GIF    83k  (512x401x64 ) 64 colors  6 bits                            
  356. AUSTINB3.GIF    97k  (512x400x64 ) 64 colors  6 bits
  357.                             
  358. ──────────────────────────────────────────────────────────────────────────────
  359. [Verbose directory info]      {/V}
  360. /V            This turns on extra directory information.  Without this switch,
  361. [TOG]         the directory info looks like:
  362.  
  363.            ──══╡Directory Name: WWIV 4.23 _MODS_ only - 256 files╞══──
  364.  ──────────────────────────────────────────────────────────────────────────────
  365. 94AUGMOD.ARJ   462k  Complete MOD NET collection for August 1994                
  366. 94OCTMOD.ZIP   329k  Complete OCT 1994 MOD NET collection                       
  367. 94SEPMOD.ZIP   301k   Mods posted on Mod Net September 1994                     
  368.  
  369. And with it, you'll get:
  370.  
  371.            ──══╡Directory Name: WWIV 4.23 _MODS_ only - 256 files╞══──
  372.                     ───«Download Dir.: D:\XFERS\WWIV423O\»───
  373.        ───<SL: 50  AGE: 0  MAXFILES: 499  DAR: -  DATA FILE: WWIV423O>───
  374.  ──────────────────────────────────────────────────────────────────────────────
  375. 94AUGMOD.ARJ   462k  Complete MOD NET collection for August 1994                
  376. 94OCTMOD.ZIP   329k  Complete OCT 1994 MOD NET collection                       
  377. 94SEPMOD.ZIP   301k   Mods posted on Mod Net September 1994                     
  378.  
  379. Please note that if there isn't a DAR, there'll be a -, otherwise the proper
  380. DAR will be displayed.
  381. ──────────────────────────────────────────────────────────────────────────────
  382. [file eXistence]              {/X}
  383. /X            The reason why my program is so fast is that it does not
  384. [TOG]         normally check for the files' actual physical existence on the
  385.               hard drive/CD-ROM.  If you use this switch, the program will
  386.               then look to see if the file is actually there.  If the file is
  387.               supposed to be on CD-ROM (as marked in //DLBOARDEDIT or as
  388.               specified by the /R{drive} switch), then this is effectively
  389.               ignored since checking CD-ROMs for possibly missing files
  390.               (because you have a music CD in there, perhaps, like I do now
  391.               <G>) can crash your system.  Hard drives, however, are treated
  392.               differently. If the file is there. the the file's size is
  393.               displayed, otherwise N/A will be displayed.
  394. ──────────────────────────────────────────────────────────────────────────────
  395. [Wwiv colors]                 {/W}
  396. /W            Enable stock WWIV color codes.  These will be embedded into the
  397. [TOG]         output file(s), both master list and FILES.BBS files.  Don't
  398.               yell at me if you don't like my color scheme, instead, see the
  399.               next switch.
  400. ──────────────────────────────────────────────────────────────────────────────
  401. [Wwiv colors]                 {/WMYGOODCO.LOR}
  402. /W{filename}  Same as above, except that the colors are read in from a data
  403. [TOG]         file that you create.  This data file is only 1 line long, with
  404.               10 characters in that line.  These characters represent your
  405.               colors (and yes, extended colors a-z and more are supported).
  406.               Mine looks like this:
  407.  
  408. em5k913n0p
  409.  
  410.               This is my custom color files, where:  [Only line one is used]
  411.               e - red
  412.               m - light red
  413.               5 - green
  414.               k - light green
  415.               9 - cyan
  416.               1 - light cyan
  417.               3 - magenta
  418.               n - light magenta
  419.               0 - white
  420.               p - light white
  421.  
  422.               Keep in mind that if you don't have extended colors, you can
  423.               still use this to REARRANGE your stock colors.  This overrides
  424.               the default settings.
  425. ──────────────────────────────────────────────────────────────────────────────
  426. [get file's dos siZe]         {/Z}
  427. /Z            This forces the use of the file's DOS (true) file size vice
  428. [TOG]         the file size as reported by WWIV.  Useful for accurately
  429.               reporting those files that have been updated since being
  430.               //UPLOADed to the BBS.  Also forces the true file size to be
  431.               used in determining total byte found in the search.  Can slow
  432.               down the search (especially for files that are located on
  433.               CD-ROM's not in the CD-ROM drive).
  434. ──────────────────────────────────────────────────────────────────────────────
  435.  
  436.  
  437.                      :THAT WONDERFUL CONFIGURATION EDITOR:
  438. With the release of version 2.0 of PBfiles is included version 1.0 of the
  439. PBfiles Configuration editor.  The commands are fairly self-explanitory, and
  440. pressing each one will either toggle an option or allow you to change it
  441. manually.
  442.  
  443.  
  444.                     :ERRORLEVELS AND OTHER BATCH ODDITIES:
  445. I've mentioned before that once this is registered, you can easily sent this
  446. up to automated batch processing.  I do just that. (You can't do it
  447. unregistered because the registration keypress is always something different.)
  448.  
  449. Here is a few example, right out of my nightly event batch file:
  450.  
  451.    pbfiles /iadult.inc /oc:\wwiv\gfiles\adult\adult.lst /m
  452.  
  453. This example creates my specialized adult file listing.  Only adult files
  454. will be in here.  It uses ADULT.INC (via the /I{filename} switch) to choose
  455. the inclusion file.  Output is also rerouted to a more private place.  The
  456. /M switch gives me uploader information and more due to the fact that it is
  457. normally OFF in the config file.
  458.  
  459.    pbfiles /i /oc:\wwiv\gfiles\gf1\valhalla.lst /ff
  460.  
  461. This one does my master listing, minus the adult stuff.  The /I makes use of
  462. PBFILES.INC by default, from which I have removed all the adult dirs, and
  463. placed into ADULT.INC.  Still redirecting the output.  /FF creates FILES.BBS
  464. files in all my hard drive directories.
  465.  
  466.    pbfiles /i /oc:\wwiv\gfiles\gf1\newfiles.lst /n14 /wpbfiles.col
  467.  
  468. Here's a new file listing for the past 14 days using the /N switch.  Also
  469. checking for physical existence and including my WWIV color codes.
  470.  
  471.  
  472. -ERRORLEVELS:  I like errorlevels.  They can tell me a lot when I'm
  473. preforming unattended batch processing.  Here at this programs:
  474.  
  475. 00 - Normal exit - no errors.
  476. 01 - PBFCFG.EXE not present in the current directory.
  477. 02 - COMSPEC enviroment variable not set.
  478. 03 - Could not locate appropriate CHAIN.* file in current directory.
  479. 04 - Error reading CHAIN.* file.
  480. 05 - Error opening or reading CONFIG.DAT (see PBFILES.LOG).
  481. 06 - Pressed the wrong key during unregistered keypress sequence.
  482. 07 - PBFILES.DAT is missing, CREATDAT.EXE unable to make a new one.
  483. 08 - PBFILES.DAT -and- CREATDAT.EXE are both missing.
  484. 09 - Error creating PBFILES.DAT file (see PBFILES.LOG).
  485. 10 - /K switch - filename specified was > 12 characters.
  486. 11 - /DS switch - Security level entered was not between 0 and 255.
  487. 12 - /DA switch - Access restriction was not between A and P.
  488. 13 - /A[!] switch - Could not create inclusion file (see PBFILES.LOG).
  489. 14 - /I: switch - Cuold not open temporary inclusion file for writing.
  490. 15 - /I: switch - Used, with no datafilename specified.
  491. 16 - /I switch - Used, with no filename specified.
  492. 17 - /I{fn} switch - Could not find specified filename.
  493. 18 - /W{fn} switch - Specified filename was not found
  494. 19 - Unable to open PBFILES.INI for reading.
  495. 20 - Error in MAINSCREEN display.
  496. 21 - Error in HELPSCREEN display (1).
  497. 22 - Error in HELPSCREEN display (2).
  498. 23 - DOS v4.0 or later needed for file sharing.
  499. 24 - SHARE.EXE not loaded.
  500. 25 - Error in file sharing implementation (0x01).
  501. 26 - Unknown error in establishing file sharing.
  502. 27 - Modem error -- see PBFILES.LOG
  503. 28 - Could not open listing file.
  504. 29 - Could not find DIRS.DAT
  505. 30 - Error opening DIRS.DAT for reading.
  506. 31 - Could not open inclusion file.
  507. 32 - Could not find inclusion file
  508. 33 - Could not open *.DAT (file information file) for reading.
  509.  
  510.  
  511.                         :KNOWNE BUGS/INCOMPATIBILITIES:
  512. PBfiles will not properly process those directories which have become
  513. corrupted in any manner.  Since I do not really know what defines a repair-
  514. able corrupted transfer data file, nor how to fix them, I cannot work around
  515. this. Tolkien's (now WWIV Software Services') Transfer Area Manager version
  516. 1.23 *can* detect these problems (to an extent) and correct for them.
  517.  
  518. At this time, PBfiles has *no* known bugs.
  519.  
  520.  
  521.                             :DEBUG IN THE MACHINE:
  522. Although the program *will* work with your modem, I am working to make it a
  523. bit better.  As a result, if you are having problems with the modem part of the
  524. program (when using in conjunction with SPV-053x.MOD), then create a simple text
  525. file in your main BBS directory called DEBUG.XXX, it matters not what you put
  526. in this file.  Once this is created, it will log (just as long as you do not
  527. disable the log) all the return values sent from the modem to PBfiles.
  528. With the values, I can better tune this program to work with your modem.
  529.  
  530. I will need a copy of the pertinent log entries, and a short description of
  531. what was going on at the time it happened.  Things like "A user was just
  532. running it" will not cut it. I'll need to know how they were running it: By
  533. single file, conference, or full listing...  And what happened -- did it drop
  534. carrier?
  535.  
  536. DEBUG.XXX will most likely be used to generate other log entries in the
  537. future.
  538.  
  539.                                :FINAL THOUGHTS:
  540. I hope you like it.  I do, a lot.  If you have any suggestions, please E-Mail
  541. me at 1@11579.wwivnet. I can also be reached at SPV_PB@AOL.COM.
  542.  
  543. I'll be updating this program.  Most likely quite a lot.  So get in now while
  544. the registration is cheap!  I'll be adding support for the mouse, GUI, code
  545. on how to run internally from WWIV, etc...
  546.  
  547.  
  548.                                 :LEGAL JUNQUE:
  549. Copyright -
  550. The PBfiles software and its accompanying documentation are protected by
  551. both United States copyright law and international treaty provisions.  You
  552. may make copies of this program, and distribute those copies, provided that
  553. you do not change any part of the PBFILExx.* archive, which include:
  554.  
  555. PBFILES.EXE    [The executable file.]
  556. PBFCFG.EXE     [The external configuration editor.]
  557. PBFILES.DOC    [This documentation file.]
  558. PBFILES.REG    [Registration information/form file.]
  559. PBFILES.DAT    [Archive support file.]
  560. CREATDAT.EXE   [Creates PBFILES.DAT.]
  561. CREATDAT.DOC   [Documentation for CREATDAT.EXE.]
  562. FILE_ID.DIZ    [BBS description file.]
  563. PBFILES.ANN    [My version related announcement file.]
  564. SPV-053*.MOD   [WWIV source code modification for adding internal support.]
  565.  
  566. The copyrights off all other programs belong to the respective copyright
  567. holders for those programs.
  568.  
  569. Warranty -
  570. PBfiles is provided as is, without warranty, either expressed or implied.
  571. The author specifically disclaims all other warranties, expressed or implied,
  572. including, but not limited to, any implied warranty of merchantability or
  573. fitness for a particular purpose.  You're using it, and I'm not responsible.
  574.  
  575. License Agreement -
  576. Users are granted a limited license to use the unregistered version of
  577. PBfiles for an evaluation period not to exceed thirty (30) days. Any other
  578. use of PBfiles, or use past the evaluation period requires registration. Users
  579. may freely copy and distribute PBfiles, provided that no fee is charged, and
  580. that the PBfiles archive contains unmodified copies of the original files as
  581. produced by the author.  No part of PBfiles may be modified, altered,
  582. reverse engineered, or sold without prior written permission from the author.
  583.  
  584. Registration -
  585. Registration allows you to use PBfiles past the 30 day trial period.  It
  586. also removes the 60 second delay.  Plus, it makes you feel better and
  587. encourages further development of this, and other, software by the author.
  588. Registration is $10 (US currency only) or $15 if you want me to send the
  589. program on a 3½" diskette). Fill out the form in PBFILES.REG and send it, and
  590. the $10 (or $15) check or money order to the address in PBFILES.REG.
  591.  
  592.                :THE HALL OF HONOR -- THOSE WHO ARE REGISTERED:
  593. [Admiral] Kirk      - StarFleet Command I and II - 904-448-1655
  594. Swordfish           - FishTank                   - 612-757-0218 / 612-757-2416
  595. Sam                 - Sam's BBS                  - 409-729-1319 / 409-729-1418
  596. Morgul              - The Trading Post [SOUTH]   - 803-731-0690 / 803-750-0669
  597. Admiral Nogura      - Dreadnought                - 904-757-0640
  598. Infinity            - Hard Disk Café             - 612-753-9960
  599. Jack Conti          - The Tackle Box             - 617-356-6873
  600. Shadowmaster        - Shadowlands                - 707-528-7987
  601. Captain EJ          - The Unsinkable RMS Titanic - 708-360-8419
  602. Firestorm           - Nuclear Wasteland          - 504-394-0509
  603. File Not Found      - Clone Builder BBS          - 619-728-0541
  604. Bob Chilcote        - F. A. R. T. S.             - 910-864-8635
  605. Dale Cooper         - The Double R Diner         - 612-474-7350
  606. Stainless Steel Rat - The Final Frontier BBS     - 701-293-9197
  607. Hobbit              - Miller Music BBS           - 607-898-3139
  608. WhiteHeart          - The Highlands BBS          - 904-388-1445
  609. Gravedigger         - Digger's Graveyard         - 903-598-6010
  610. Sly                 - The Litter Box BBS         - 314-397-5225
  611. Lancer              - Asgardian Realm            - 314-291-6762
  612. Sean Settle         - WarLock's Realm            - 919-937-0682
  613.