PCBCS.DOC

PCBCS - PCBoard Caller Statistics                                  Version 1.36
---------------------------------                                  Jan  3, 1991

  Usage:
  -----

        CS analyzes a PCBoard caller's log file and produces a report
        of system and user activity.  The command line syntax is:

   CS callerfile [outfilename]  [/N] [/V] [/1] [/SU] [/FF] [/C:n] [/T] [/U]
                                [/S:mmddyy] [/E:mmddyy]

        where:
           'callerfile' is the name of a log file. It may be the combination
                        of several actual caller files, but the utilization
                        figures will be inaccurate.

           'outfilename' is the name of a file to receive the report; the
                        default is to display all reports

           /N           specifies to suppress pause at screen end
           /V           specifies to check records for validity against the
                        PCBTEXT file; this is may not be valid for later
                        versions of PCBoard
           /1           includes files in the downloads report for files
                        downloaded only once, otherwise only files downloaded
                        twice or more are reported
           /SU          suppresses the  "User Activity" report
           /S:mmddyy    starting date to process log records
           /E:mmddyy    ending date to process log records
           /FF          specifies that form feeds are generated for
                        each report page
           /C:n         specifies a single node number
           /T           records unprocessed or unknown records in the
                        file called PCBCS.UNK
           /U           write the user statistics report to file called USTATS

  Version history:
  ---------------

  1.13,  9/21/88 - correct missing crlf for heading after users report
                   correct missing aborted dl counts
                   correct missing "Data Base Updated" counts
  1.14, 10/18/88 - correct utilization plot
  1.15, 12/17/88 - improve recording of active (lost) time
  1.20,  1/02/89 - correct change of year problem
  1.21,  1/16/89 - correct problem with more than 8 conferences
  1.22,  4/09/89 - add /C:n parameter
  1.23,  7/18/89 - add /T for tracing unprocessed messages
                 - add elapsed time and 9600 usage to user activity report
                 - correct elapsed time measurements for spanning midnight
                 - remove check for elapsed time exceeding 120 minutes
  1.24, 12/12/89 - add baud rates over 19200
  1.25,  2/06/90 - correction for more than 9 bulletins in a conference
  1.26,  3/18/90 - convert to BC7
  1.27,  3/18/90 - replace CSUB with BC7 functions
  1.28,  4/28/90 - streamine message checking; minor changes for PCBoard 14.5
  1.29,  5/04/90 - add more statistics (reported when /T is used)
  1.30,  5/14/90 - add kludge for PCBoard "change" in CALLER logoff records
  1.31,  6/08/90 - correct multinode report showing non-existant nodes
  1.32,  8/09/90 - correct duplicate download entries
  1.33,  9/23/90 - correct for too many conferences
  1.34,  9/24/90 - account for logoffs through MARKMAIL door
  1.35,  9/24/90 - speed up processing of DL file names
| 1.36,  1/03/91 - add /U command line option, increase limits

  Limitations:
  -----------
        Maximum users per report  2000
        Maximum DL file names     4095
        Maximum DOOR names          20
        Maximum BULLETINS           99
|       Maximum conferences        255
|       Maximum nodes               99

  Notes:
  -----
|       Written by Vernon D. Buerg using MS BASIC Compiler PDS version 7.1
        and some assembler subroutines. For personal use only. May not be sold.

        PCBCS (c) Copyright 1988-1991 Vernon D. Buerg. All rights reserved.