home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / USAGE18.ZIP / USAGE.DOC < prev    next >
Text File  |  1992-09-28  |  5KB  |  123 lines
  1.  
  2. USAGE -- Reads one or more Maximus or Binkley logs and generates a usage graph
  3.  
  4. Version 1.8  (9/28/92)
  5.  
  6. Written by Bob Quinlan of Austin, Texas, USA
  7. Sysop of Red October at 512-834-2593 (1:382/111)
  8.  
  9. Copyright 1992 by Bob Quinlan
  10.  
  11. Compatible with Maximus 2.00 and 2.01 and BinkleyTerm 2.55 and 2.56
  12.  
  13.  
  14. This program reads one or more Maximus or Binkley logs and generates a
  15. BBS-format usage graph based on the data.  By default it will read
  16. MAX.LOG in the current directory and write USAGE.BBS.  The following
  17. switches allow you to configure it for your system and preferences:
  18.  
  19.     /Cx=y       Set color number 'x' to Avatar color 'y'.  'x' values
  20.                 mean the following:
  21.                     0 = default color
  22.                     1 = title
  23.                     2 = frame
  24.                     3 = reference text (%)
  25.                     4 = reference lines (%)
  26.                     5 = hour text
  27.                     6 = hour dots (odd hour values)
  28.                     7 = hour lines
  29.                     8 = data bars
  30.                     9 = enter prompt
  31.                 Avatar color codes are given in two-digit hexadecimal.
  32.                 The first digit sets the background color (0-7 only) and
  33.                 the second digit sets the foreground color (0-F).  Each
  34.                 digit corresponds to the following colors:
  35.                     0 = black
  36.                     1 = blue
  37.                     2 = green
  38.                     3 = cyan
  39.                     4 = red
  40.                     5 = magenta
  41.                     6 = brown
  42.                     7 = white
  43.                     8 = grey
  44.                     9 = bright blue
  45.                     A = bright green
  46.                     B = bright cyan
  47.                     C = bright red
  48.                     D = bright magenta
  49.                     E = yellow
  50.                     F = bright white
  51.                 Example: To set the data bars to yellow on blue you
  52.                 would use the switch /C8=1E.
  53.  
  54.     /Lfile      Log file to process.  Note that the /L parameter can be
  55.                 used more than once to specify several logs.  This
  56.                 feature is particularly useful if you have multiple
  57.                 lines with separate logs.
  58.  
  59.     /M          Military time.  Display the hours as 0-23.
  60.  
  61.     /Ttitle     Title for graph.  You may want to supply multiple word
  62.                 values for title.  You can separate the words by spaces
  63.                 or by underscores (which will be replaced by spaces).
  64.                 For example, both of these lines would produce the same
  65.                 results:
  66.                     usage /lmax.log /tRed October Usage
  67.                     usage /lmax.log /tRed_October_Usage
  68.  
  69.     /Ufile      The file to which the usage graph will be written. The
  70.                 .BBS extension is not automatically added.
  71.  
  72.     /V          Verbose diagnostic mode.  Prints out each log entry that
  73.                 triggers a starting or ending time.  Prints the elapsed
  74.                 time between each start/end pair.  Not recommended for
  75.                 normal use.
  76.  
  77. If you use WFC within Maximus feed USAGE the Maximus log.  If you use
  78. Binkley to answer the phone feed it the Binkley log.  You can mix log
  79. types if you have lines with different configurations.
  80.  
  81. As an example, my system has two lines, one running Binkley and the
  82. other running Maximus with WFC.  I start a new log every month and keep
  83. the previous month's around as well.  Here is how I generate my overall
  84. usage graph:
  85.  
  86. usage /lbink01l.old /lbink01.log /lmax02l.old /lmax02.log
  87. /tRed October Overall Usage
  88.  
  89. (That's all one line in my batch file.)
  90.  
  91. I have the Log Mode in Maximus set to Verbose and the LogLevel in
  92. Binkley set to 5.  If you use other settings USAGE may not register all
  93. of your system's activity.
  94.  
  95.  
  96. USAGE returns ERRORLEVEL 0 after a successful run.  ERRORLEVEL 1 is
  97. returned to indicate an error.
  98.  
  99. NOTICE:  You may use, copy, and distribute this program freely as long
  100. as you insure that both the executable and the documentation (.DOC)
  101. files are included in the distribution package.  The source code does
  102. not need to be included.  You may modify this program and document, so
  103. long as reasonable credit is given to the original author if a
  104. substantial portion of the original remains intact.  The author is not
  105. responsible for any losses which may occur either directly or indirectly
  106. as a result of using this program.
  107.  
  108. HISTORY:
  109. Version 1.8   (8/28/92) -- Added the /M switch for military time.
  110. Version 1.7   (8/25/92) -- Added the ability to pass multiple-word
  111.                            parameters using spaces.
  112. Version 1.6   (6/03/92) -- Adjusted graph to start at midnight.
  113. Version 1.5   (5/29/92) -- Improved Binkley support.  Added verbose
  114.                            diagnostic mode.
  115. Version 1.4   (5/27/92) -- Allow custom color selections.
  116. Version 1.3   (5/26/92) -- Removed event and keyboard switches.
  117.                            Added support for Binkley logs.
  118.                            Added log file sharing (again).
  119. Version 1.2   (5/14/92) -- Removed log file sharing due to compiler bug.
  120. Version 1.1   (5/13/92) -- Added log file sharing.
  121. Version 1.0   (4/22/92) -- Original release.  Written in Borland C.
  122.  
  123.