USA.DOC

8.9 KB 69cfb74bc5c24fc5…
 ████████████████████████████████████████████████████████████████████████████
 ██▌╔════════════════════════════════════════════════════════════════════╗▐██░░
 ██▌║                                                                    ║▐██░░
 ██▌║             █ █     * *      ▄ █ █ *        ▄ █ █ *                ║▐██░░
 ██▌║             █ █     * *    █ █     * *    █ █     * *              ║▐██░░
 ██▌║             █ █     * *    █ █            █ █     * *              ║▐██░░
 ██▌║             █ █     █ █      ▀ █ █ ▄      █ █ █ █ █ █              ║▐██░░
 ██▌║             █ █     █ █            █ █    █ █     █ █              ║▐██░░
 ██▌║             █ █     █ █    █ ▄     █ █    █ █     █ █              ║▐██░░
 ██▌║               ▀ █ █ ▀        ▀ █ █ ▀      █ █     █ █              ║▐██░░
 ██▌║                                                                    ║▐██░░
 ██▌╟────────■ USERS.BBS Statistics Analyzer 1.00 ∙ 01-Mar-90 ■──────────╢▐██░░
 ██▌║                   for RemoteAccess and QuickBBS                    ║▐██░░
 ██▌║  Copyright (C) 1989-1990 Gerard van der Land. All rights reserved. ║▐██░░
 ██▌║                                                                    ║▐██░░
 ██▌╚════════════════════════════════════════════════════════════════════╝▐██░░
 ████████████████████████████████████████████████████████████████████████████░░
   ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░

                                 WHAT IS USA?
                                ■────────────■

      USA (I know, the name doesn't make any sense, but it sounds nice) is a
professional User Statistics generator, just like QuickBest by Ronen Magid, but
it is a lot BETTER, SMALLER, FASTER and can do MORE! USA can be used for both
RemoteAccess and QuickBBS, gives more information, is more more than three
times faster and more than five times smaller than QBEST.EXE.

      USA started it's way in august of 1989 as an exact clone of STATICS by
John Huls (2:512/123), which I wrote because STATICS reported specific flag-
settings for Turbo Data Net (TDN) nodes and I wanted to use the flag-settings
used by the BBS of which is was a co-sysop at that time. By lack of time I
didn't enhance it for a long time. Meanwhile, Ronen Magid had released
QuickBest 3.00 which looked remarkably better than QuickBest 2.22 (windows with
a blue background color and shadow!), but had the disadvantage of having many
bugs (even more than in 2.22) and being VERY SLOW. I decided to turn USA in to
a replacement for QuickBest, with as extras: more speed, less bugs and fully
configurable flag and level reports. Recently, when RemoteAccess was released,
I decided to support RA as USA's default.

      There are however some differences: Unlike QuickBest, I don't add info
from deleted users or zero-fields (ie. 0 Kb downloaded) in the reports and USA
gives more information: a Security report and a Flag report. USA does and will
NOT support a Best downloaded files listing, because I don't think that's a job
for a User Statistics generator. Note that the amount of Kb's Uploaded to and
Downloaded from your BBS will be less than in reality, since you lose info when
you delete users and pack the USERS.BBS file.

      USA was originally written using Microsoft QuickBASIC 4.50, but I
recently converted it to Turbo C 2.00. To protect the program from evil forces
and to save disk space on your hard disk (isn't that nice?), the EXE file was
compressed with LZEXE v0.90 by Fabrice Bellard.

                 DISCLAIMER, LICENSE AND OTHER IMPORTANT STUFF
                ■─────────────────────────────────────────────■

      The following points must be considered, understood and agreed upon
BEFORE you use USA 1.00:

■ USA is ShareWare, and not FreeWare or Public Domain!

■ This documentation and the accompanying program is copyrighted material by
  Gerard van der Land.

■ Although care has been taken to write and test a program that does what this
  documentation states, the program is provided as it is, without warranty or
  guarantee of any kind, either expressed or implied, as to the quality or
  performance of this program, except that it will occupy disk space.

■ The author will not be held liable to you or anyone for any direct, indirect,
  incidental or consequential damages, including any lost profits, lost savings
  which may result from the use or inability to use this program.
  Your use of the program constitutes your agreement to this disclaimer and
  your release of the author from any form of liability or litigation.

■ I grant you a limited license to use USA 1.00 and encourage you to copy and
  distribute it in an unmodified way as much as you want, as long as you still
  abide to the conditions mentioned here and no money or other compensation is
  asked or accepted.

                         INSTALLATION & CONFIGURATION
                        ■────────────────────────────■

■ Put USA.EXE somewhere on your hard disk.
■ Enter your info and wishes in the control file USA.CTL. You won't have much
  trouble with this. Make sure that USA can find that file in the current
  directory when it is started or specify the name of a control file on the
  command line.
■ Put USA in your batch file to run it in your daily event or after each user.

      USA will create the reports in your text files path (which is obtained
from the CONFIG file). USA will put a Ctrl-E (to cancel the page pausing
prompt) and Screen Clearing Codes in the beginning of the file and a "Press
[Return] to continue:" prompt at the bottom of each page.

                                HISTORY/FUTURE:
                               ■───────────────■

      Until now I spent hours thinking, writing, converting, debugging and
documenting USA, and I will keep on doing that. USA is a little bit crippled:
if you don't register, it will display not more than 9 entries per survey. If
you use this program for a period of time and you decide you like it, you can
get a registration key by sending $5 - $10 (or an equivalent amount in any
freely convertible currency), the EXACT TEXT you want after the "BBSName"
keyword and which version you are currenly using, along with any questions,
comments, suggestions and bug-reports, and of course your (net) mail address,
to:

        Gerard van der Land
        Cannenburg 23
        3772 BH Barneveld
        The Netherlands

      Or transfer it to Postbank giro-account 5.245.162 in The Netherlands.
Then I'll make sure you receive your key as soon as possible. Registered users
who wish to change their "BBSName" will have to pay me $1.

Thank you!

Gerard van der Land,
Co-Sysop HAMLOT Services Board (2:283/400.5),
+31-53-762120, 2400 baud

┌───────────┬──────┬─────────────────────────────────────────────────────┐
│ 01-Mar-90 │ 1.00 │ First release of USERS.BBS Statistics Analyzer      │░░
├───────────┼──────┼─────────────────────────────────────────────────────┤░░
│ ??-???-?? │ ?.?? │ ■ USA can now produce some Statistics Graphics too  │░░
│   Under   │ │ ││ │ ■ The colors of the ANSI files are now configurable │░░
│  Reserve  │ │ ││ │ ■ Maybe you have a suggestion? Drop me a message!   │░░
└───────────┴─│─││─┴─────────────────────────────────────────────────────┘░░
  ░░░░░░░░░░░░│░││░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
              │ ││
              │ │╘═> bug fix version (very unlikely unless bugs are serious)
              │ ╘══> minor changes   (format of at least one file has changed)
              ╘════> major changes   (really big changes/additions)


                 OFFICIAL USA 1.00 BETA & DISTRIBUTION SITES:
┌───────────┬──────────────────┬────────────────────────┬─────────────────┐
│ Node      │ Sysop            │ BBS Name               │ Phone (+31-)    │░░
╞═══════════╪══════════════════╪════════════════════════╪═════════════════╡░░
│ 2:512/1   │ Peter Janssens   │ Easy Board             │ 4780-87989  V32 │░░
│ 2:512/18  │ Mark Reijerkerk  │ NEBB                   │ 3494-60638  HST │░░
│ 2:512/100 │ Reinier de Groot │ RemoteAccess Europe    │ 1749-48422  HST │░░
│ 2:512/123 │ John Huls        │ Deep Space Systems     │ 40-450466       │░░
│ 2:282/220 │ Gerard Sittrop   │ RemoteAccess The Arena │ 5109-4458       │░░
│ 2:283/400 │ Eric Lotgerink   │ HAMLOT Services Board  │ 53-762120       │░░
│ 2:286/520 │ Perry de Ronde   │ The Professionals BBS  │ 1620-26466      │░░
└───────────┴──────────────────┴────────────────────────┴─────────────────┘░░
  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░

      You can always request the latest version here, using alias "USA".
I would like to thank my beta testers/support nodes for their help with this
and many other projects. I couldn't have done it without them! Also thanks to
Joep Vullinghs at Bullet BBS (+31-80-601581) and Adrie van Lith.






■──────────────────────────■ End Of Documentation ■───────────────────────────■