home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / FSTAT21.ZIP / FILESTAT.DOC < prev    next >
Encoding:
Text File  |  1993-09-12  |  9.2 KB  |  264 lines
  1.                              FileStat Version 02.10
  2.  
  3.                                Copyright (c) 1993
  4.  
  5.                       By Chris Serino & Dutchess Software
  6.  
  7.                              The Dutchess  CoCo BBS
  8.  
  9.                                  (914) 298-8205
  10.  
  11.                                 FIDONET 1:272/76
  12.  
  13. ┌─────────────────────────────────────────────────────────────────────────────┐
  14. │▒▒▒▒▒▒ LICENSING INFORMATION ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ FileStat 02.10 ▒▒│
  15. └─────────────────────────────────────────────────────────────────────────────┘
  16.  
  17.  
  18.   This program is not freeware.   This is SHAREWARE  which  means  it is user-
  19.   supported software.  If you use this  program for more than 30 days, you are
  20.   required  to register  or remove it from  your system.  The Registration fee
  21.   is a mere $6.00 and is not a lot to ask.
  22.  
  23.   The concept works only with your support.  If you find that you can use this
  24.   program, then a  registration  fee of $6.00 U.S  funds will help  defray the
  25.   development cost and encourage the  authorship of other  programs that might
  26.   be useful to you.  A Registration Form for this purpose is included with the
  27.   distribution archive and is called FILESTAT.REG.
  28.  
  29.   FileStat V 02.10 is Copyrighted (c) 1993 by Chris Serino & Dutchess Software
  30.   and all  rights are reserved.  You may  copy this  program and documentation
  31.   for backup purposes.  You may also copy and share  UNMODIFIED  copies of the
  32.   program  package,  providing  that  the copyright  notice is  reproduced and
  33.   included on all copies.
  34.  
  35.   You may not  sell the product  for a fee and/or distribute the product along
  36.   with  other products  without expressed  prior written  permission from this
  37.   software's author, nor may you  modify or remove  the Copyright  Notice from
  38.   the program or the documentation.
  39.  
  40.   Comments,  suggestions  and  bug  reports are  welcome. If you have any, you
  41.   should  contact:  The Dutchess CoCo BBS  at  (914) 298-8205  300-14000  baud
  42.   or at FidoNet Address (1:272/76).
  43.  
  44. ┌─────────────────────────────────────────────────────────────────────────────┐
  45. │▒▒▒▒▒▒ OVERVIEW ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ FileStat 02.10 ▒▒│
  46. └─────────────────────────────────────────────────────────────────────────────┘
  47.  
  48.  
  49.   FileStat  is  a  Remote Access  file  system totals generator.  It will scan
  50.   selected File Areas and create a list of file-area names, number of files in
  51.   area, number of bytes  in area, and will  list totals  in both  ANSI & ASCII
  52.   format for  users to view.  In addition to creating a file system total file
  53.   it will create another file listing the most popular (downloaded) files.  It
  54.   will  also be  in both  ANSI/ASCII  formatted files.  FileStat Will Now Also
  55.   Create an ANSI/ASCII file that contains user information such as Top Callers
  56.   , Top Downloaders &  Top Uploaders.  FileStat  Requires  Remote  Access  BBS
  57.   Version 02.00 or newer.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.                                     Page -1-
  66.  
  67.  
  68. ┌─────────────────────────────────────────────────────────────────────────────┐
  69. │▒▒▒▒▒▒ UPGRADE INFORMATION ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ FileStat 02.10 ▒▒│
  70. └─────────────────────────────────────────────────────────────────────────────┘
  71.  
  72.   To  upgrade from  Version 02.00  to  Version 02.10  all that is needed is to
  73.   replace  the file:  FILESTAT.EXE and to edit your configuration file and add
  74.   lines  15  thru  34 (Descriptions of what  these lines need are found in the
  75.   installation  portion  of this  documentation) &  include  the  command line
  76.   parameters that you wish from the list found else where in this file.
  77.  
  78.  
  79. ┌─────────────────────────────────────────────────────────────────────────────┐
  80. │▒▒▒▒▒▒ INSTALLATION ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ FileStat 02.10 ▒▒│
  81. └─────────────────────────────────────────────────────────────────────────────┘
  82.  
  83.   Installation  is fairly easy and straight-forward.  The following  steps and
  84.   examples  should  have  you up and running  in a  very short period of time.
  85.  
  86.   1)  Place all files of this archive into a directory.
  87.  
  88.   2)  Edit the example configuration file included in the distribution archive
  89.       to  fit  your  needs.  A  Description  follows as  to the  configuration
  90.       format.
  91.  
  92. EXAMPLE: FileStat.CFG
  93.  
  94. Chris Serino
  95. The Dutchess CoCo BBS
  96. 000000000
  97. c:\ra
  98. c:\ra\txtfiles\filestat.asc
  99. c:\ra\txtfiles\filestat.ans
  100. 10
  101. 0
  102. 6
  103. 11
  104. 16
  105. 12
  106. 13
  107. 17
  108. c:\ra\txtfiles\popular.asc
  109. c:\ra\txtfiles\popular.ans
  110. c:\ra\FExclude.txt
  111. 6
  112. 13
  113. 12
  114. 11
  115. 15
  116. 16
  117. 10
  118. c:\ra\txtfiles\userstat.asc
  119. c:\ra\txtfiles\userstat.ans
  120. c:\ra\exclude.txt
  121. 6
  122. 15
  123. 16
  124. 12
  125. 17
  126. 10
  127. 0
  128.  
  129.  
  130.  
  131.                                     Page -2-
  132.  
  133.  
  134. ____________________________________________________________________________
  135. Lines 1  Thru 3  Are For System Information Configuration
  136.  
  137. Line #1         Sysop Name
  138. Line #2         BBS Name
  139. Line #3         Registration Number (Given When Software Registered)
  140. ____________________________________________________________________________
  141. Lines 4  Thru 14 Are For The File Statistics Configuration
  142.  
  143. Line #4         Full Pathlist to RA System Directory
  144. Line #5         Full Pathlist & Name of ASCII Output File
  145. Line #6         Full Pathlist & Name of ANSI Output File
  146. Line #7         Maximum List Security level for area to add to List
  147. Line #8         Group number of area's to include & List.  0 for All Groups
  148. Line #9         Border Color
  149. Line #10        Area # Color
  150. Line #11        Area Name Color
  151. Line #12        Number of Files Color
  152. Line #13        Number of Bytes Color
  153. Line #14        Total Numbers Line Color
  154. ____________________________________________________________________________
  155. Lines 15 Thru 24 Are For The Most Popular Files Configuration
  156.  
  157. Line #15        Full Pathlist & Name of ASCII Output File
  158. Line #16        Full Pathlist & Name of ANSI Output File
  159. Line #17        Full Pathlist & Name of Exclude File (Blank Line For None)
  160.                 Exclude File Is A Plain Ascii File With A List Of Filenames
  161.                 To Exclude From The Most Popular Output File (Maximum 100)
  162. Line #18        Border Color
  163. Line #19        FileName Color
  164. Line #20        File Size Color
  165. Line #21        Area # Color
  166. Line #22        # Of Times Downloaded Color
  167. Line #23        Uploader Color
  168. Line #24        Number Of Popular Files To Have On List (1 To 50)
  169. ____________________________________________________________________________
  170. Lines 25 Thru 34 Are For The User Statistics Configuration
  171.  
  172. Line #25        Full Pathlist & Name of ASCII Output File
  173. Line #26        Full Pathlist & Name of ANSI Output File
  174. Line #27        Full Pathlist & Name of Exclude File (Blank Line For None)
  175.                 Exclude File Is A Plain Ascii File With A List Of User Names
  176.                 To Exclude From The User Statistics Output File (Maximum 100)
  177. Line #28        Border Color
  178. Line #29        Top Callers Color
  179. Line #30        Top Uploaders Color
  180. Line #31        Top Downloaders Color
  181. Line #32        Numbers Color
  182. Line #33        Number Of User Stats To Have On List (1 To 100)
  183. Line #34        Use Real Names or Handles.  Real Names= 0  Handles= 1
  184.  
  185.  
  186.                 Colors are as follows:
  187.                 Black   =0    -
  188.                 Red     =1      \
  189.                 Green   =2        \
  190.                 Yellow  =3          \   For Bold Colors add 10
  191.                 Blue    =4           /  to numbers at left
  192.                 Magenta =5         /
  193.                 Cyan    =6       /
  194.                 White   =7    _/
  195.  
  196.  
  197.                                     Page -3-
  198.  
  199.  
  200.   3)  To run FileStat just from either your daily event batch file or from the
  201.       DOS command prompt ENTER:  Filestat <Configfile> [Flag] [Flag] [Flag]
  202.  
  203.              < >     : Required Paramater
  204.              [ ]     : Optional Paramater
  205.         <ConfigFile> : Pathlist & FileStat Config File Name
  206.             [Flag]   : Which Stats To Create
  207.                        /F   = Create File Statistics File
  208.                        /P   = Create Popular Files File
  209.                        /U   = Create User Statistics File
  210.  
  211.       If no flags are passed then FileStat will create all three files.
  212.  
  213.         EXAMPLES:
  214.      C:\> filestat filestat.cfg         (Creates ALL Files)
  215.      C:\> filestat filestat.cfg /U      (Creates Only User Statistics)
  216.      C:\> filestat filestat.cfg /F /U   (Creates FileStats & User Stats Only)
  217.      C:\> FileStat C:\RA\DOORS\FILESTAT\FileStat.Cfg
  218.                                         (Same as example #1)
  219.  
  220.  
  221.   4)  Setup menu option's on the bbs using a Type 45 option to allow users to
  222.       view the resulting files.
  223.  
  224.  
  225. ┌─────────────────────────────────────────────────────────────────────────────┐
  226. │▒▒▒▒▒▒ AUTHORS NOTE ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ FileStat 02.10 ▒▒│
  227. └─────────────────────────────────────────────────────────────────────────────┘
  228.  
  229.   Do you have an idea for other programs/utilities for Remote Access but dont
  230.   have the programming skills needed?  If you do let us know and maybe we can
  231.   help make your  idea a reality.  Also if you would like to be a Beta-Tester
  232.   of future Dutchess Software  products drop us a line and we will supply you
  233.   with an application.
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                                     Page -4-
  264.