home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / UTRAK111.ZIP / USERTRAK.UC2 / USERTRAK.DOC < prev    next >
Text File  |  1994-12-19  |  19KB  |  483 lines
  1.  
  2.                           ──────────────────────
  3.                              UserTrak   v1.11
  4.                           ──────────────────────
  5.  
  6.                   Copyright (c) 1993,1994, John Hasemeier
  7.                             All Rights Reserved
  8.  
  9.   ╔════════════════════════════════════════════════════════════════════╗
  10.   ║                         TABLE OF CONTENTS                          ║
  11.   ╚════════════════════════════════════════════════════════════════════╝
  12.  
  13.          1 . . . . . . . . . . . . . . Program Information
  14.          2 . . . . . . . . . . . . . . Requirements
  15.          3 . . . . . . . . . . . . . . Limited Warranty
  16.          4 . . . . . . . . . . . . . . Distribution Requirements
  17.          5 . . . . . . . . . . . . . . Evaluation License
  18.          6 . . . . . . . . . . . . . . Registered License
  19.          7 . . . . . . . . . . . . . . Installation Instructions
  20.          8 . . . . . . . . . . . . . . Operational Notes
  21.          9 . . . . . . . . . . . . . . Revisions & Bug Report
  22.         10 . . . . . . . . . . . . . . Technical Support
  23.         11 . . . . . . . . . . . . . . Registration Information
  24.  
  25.  
  26.   ┌────────────────────────────────────────────────────────────────────┐
  27.   │ 1.                       PROGRAM INFORMATION                       │
  28.   └────────────────────────────────────────────────────────────────────┘
  29.  
  30.    UserTrak has a number of features which make it a useful tool for the
  31.    TBBS/TDBS sysop in addition to additional features your callers will
  32.    enjoy.
  33.  
  34.     ■ Detailed user listing supporting ANSI and non-ANSI callers
  35.     ■ User listing formatted for both 80 and narrow width screens
  36.     ■ Four categories of TOP-10 listings
  37.     ■ Dynamic internal buffering to lessen the load on TBBS when needed
  38.     ■ Detailed Sysop/SigOp userlog listing showing user flags & report
  39.     ■ Functionality of some programs without taking down TBBS
  40.     ■ No forced use of the DAYFILE log for TOP-10 functionality
  41.  
  42.    As distributed you are given a 30 days license to evaluate the program.
  43.    This allows un-crippled use, with the exception of a 'nag' line after the
  44.    TOP-10 files generation and the day counter at the end of the userlog
  45.    listing.
  46.  
  47.  
  48.   ┌────────────────────────────────────────────────────────────────────┐
  49.   │ 2.                          REQUIREMENTS                           │
  50.   └────────────────────────────────────────────────────────────────────┘
  51.  
  52.    HOST BBS: TBBS 2.2
  53.              TDBS 1.2
  54.  
  55.  
  56.   ┌────────────────────────────────────────────────────────────────────┐
  57.   │ 3.                        LIMITED WARRANTY                         │
  58.   └────────────────────────────────────────────────────────────────────┘
  59.  
  60.    USERTRAK is provided "AS IS". It is up to you to determine the usefulness
  61.    of the package. John Hasemeier does not warrant that the operation of
  62.    this software will meet your requirements or that the operation of this
  63.    software will be uninterrupted or error-free. The entire risk as to the
  64.    quality and performance of the software is with you. Should the software
  65.    provided be defective, you assume the entire cost of all necessary repair,
  66.    servicing or correction (not John Hasemeier).
  67.  
  68.    In no event will John Hasemeier be liable to you for any damages,
  69.    including any lost profits, lost savings or other incidental or
  70.    consequential damages arising out of the use or inability to use the
  71.    software even if John Hasemeier or his authorized representative has
  72.    been advised of the possibility of such damages, or for any claim by
  73.    any other party.
  74.  
  75.    In no event will John Hasemeier's liability, for any damages to you
  76.    or any other person, ever exceed suggested list price or actual price
  77.    paid, whichever is the lower, for the license to use the software,
  78.    regardless of the form of the claim.
  79.  
  80.  
  81.   ┌────────────────────────────────────────────────────────────────────┐
  82.   │ 4.                      DISTRIBUTION REQUIREMENTS                  │
  83.   └────────────────────────────────────────────────────────────────────┘
  84.  
  85.    This section lists permissions and restrictions for distributing the
  86.    EVALUATION version of USERTRAK. The REGISTERED versions of USERTRAK are
  87.    licensed to an individual or organization and may not be passed on,
  88.    distributed, or made available to any third party under any circumstances.
  89.  
  90.       All permissions below are granted with the understanding that:
  91.  
  92.       -  WE MAY WITHDRAW YOUR PERMISSION at any time for any reason,
  93.       -  YOU DO NOT MISREPRESENT USERTRAK as free or public domain software
  94.       -  YOU DO NOT CHEAT our mutual customers into thinking they're paying
  95.          you for the right to use USERTRAK.
  96.  
  97.    All INDIVIDUALS which are not affiliated with a TBBS/TDBS sales, service
  98.    or distribution entity are permitted to give copies of the EVALUATION
  99.    package to anyone you wish as long as no fee is charged and the license
  100.    and distribution rights and restrictions in this document are not violated.
  101.    
  102.    ALL OTHERS, including anyone interested in bundling ANY versions of
  103.    of USERTRAK with hardware, software, or services must obtain our
  104.    permission and a written license before distributing the software.
  105.    
  106.    IF YOU WRITE ABOUT USERTRAK, please send me a copy of any reviews,
  107.    articles, catalog descriptions, or other information you print or
  108.    distribute.
  109.  
  110.    USERTRAK must be distributed with no alterations to the contents of the
  111.    distribution OUTER or INNER archive. The content file names and archive
  112.    names are not to changed.
  113.  
  114.    The only exceptions being you may change the OUTER archive with one of
  115.    your choice and you may also add your BBS advertisement file or archive
  116.    banner to the OUTER packaging. Nothing is permitted to be added to the
  117.    inner archive.
  118.  
  119.    Distribution format is as follows:
  120.  
  121.  UTRAKnnn.ARJ <-- OUTER ARCHIVE (nnn = UserTrak version number)
  122.     |
  123.     |
  124.     |   FILE_ID.DIZ    <-- Author's program description for BBSes
  125.     |   README.1ST     <-- Preliminary instructions/information
  126.     |   UE.EXE         <-- Extraction Tool (Copyright 1994, AIP-NL)
  127.     |__ USERTRAK.UC2   <-- INNER ARCHIVE (author sealed package)
  128.             |
  129.             |
  130.             |   TRAKL.TXT     <-- Sample Type 2 'Menu' for TOP 10 Files
  131.             |   USERTRAK.TPG  <-- UserTrak Program
  132.             |__ USERTRAK.DOC  <-- UserTrak System Operator Manual
  133.  
  134.  
  135.   ┌────────────────────────────────────────────────────────────────────┐
  136.   │ 5.                       EVALUATION LICENSE                        │
  137.   └────────────────────────────────────────────────────────────────────┘
  138.  
  139.    The USERTRAK package contains no public domain software.
  140.  
  141.    UE.EXE is Copyright 1994 by AIP-NL
  142.  
  143.    The files comprising the USERTRAK utility software is protected by the
  144.    United States copyright laws. You may not disassemble, alter, reverse
  145.    engineer the programs or parts of the package in any way.
  146.  
  147.    Distribution terms and conditions (section 4) remain in force and any
  148.    violations of them terminate this license immediately.
  149.  
  150.    You are given a 30 day evaluation license to evaluate USERTRAK after
  151.    which this license terminates.
  152.    
  153.    If you intend to maintain a working copy of the software beyond 30 days
  154.    you are required to make a registration payment to John Hasemeier.
  155.  
  156.    Continued use of USERTRAK beyond 30 days without payment violates this
  157.    license and results in automatic termination of this license.
  158.  
  159.    Upon termination of this license you are required to remove any working
  160.    copies of USERTRAK and all associated files.
  161.  
  162.    By installing or using this software, you acknowledge that you have
  163.    read this agreement, understand it, and agree to be bound by its
  164.    terms and conditions.  You also agree that this is the complete and
  165.    exclusive statement of the agreement between us, which supersedes any
  166.    proposal or prior agreement, oral or written, and any other
  167.    communications between us relating to the subject matter of this
  168.    agreement.
  169.  
  170.    All rights not expressly granted here are reserved by John Hasemeier.
  171.  
  172.  
  173.   ┌────────────────────────────────────────────────────────────────────┐
  174.   │ 6.                      REGISTERED LICENSE                         │
  175.   └────────────────────────────────────────────────────────────────────┘
  176.  
  177.    The USERTRAK package contains no public domain software.
  178.  
  179.    UE.EXE is Copyright 1994 by AIP-NL
  180.  
  181.    The files comprising the USERTRAK utility software is protected by the
  182.    United States copyright laws.
  183.  
  184.    This agreement go into force upon registering USERTRAK and applies
  185.    ONLY to registered license owners. This license is non-transferable
  186.    except as contained in this agreement.
  187.    
  188.    You are authorized to make reasonable backup copies of the registered
  189.    working copy of USERTRAK as part of your normal BBS backup plan.
  190.  
  191.    You are responsible for securing your investment in this software by
  192.    protecting your registered copies and data files. Careless or frivolous
  193.    handling may be construed as violation to this agreement. NONE of the
  194.    registered product is to be distributed except as contained in this
  195.    agreement.
  196.  
  197.    USERTRAK program files are licensed for operation on one CPU at a time.
  198.  
  199.    You may not use, copy, rent, lease, sell, modify, decompile, disassemble,
  200.    otherwise reverse engineer, or transfer the licensed program, or any
  201.    subset of the licensed program, except as provided for in this agreement.
  202.    Any such unauthorized use shall result in immediate and automatic
  203.    termination of this license.
  204.  
  205.    Upon termination of this license you are required to remove any working
  206.    copies of USERTRAK and all associated files.
  207.  
  208.    By installing or using this software, you acknowledge that you have
  209.    read this agreement, understand it, and agree to be bound by its
  210.    terms and conditions.  You also agree that this is the complete and
  211.    exclusive statement of the agreement between us, which supersedes any
  212.    proposal or prior agreement, oral or written, and any other
  213.    communications between us relating to the subject matter of this
  214.    agreement.
  215.  
  216.    All rights not expressly granted here are reserved by John Hasemeier.
  217.  
  218.  
  219.  
  220.   ┌────────────────────────────────────────────────────────────────────┐
  221.   │ 7.                    USERTRAK INSTALLATION                        │
  222.   └────────────────────────────────────────────────────────────────────┘
  223.  
  224.    Installation instructions here assume you have already un-archived
  225.    and placed the game files in a suitable sub-directory.
  226.  
  227.    1. Create a menu item for the userlog listing mode.
  228.  
  229.       EG:  Entry:
  230.            <U>serlog Listing
  231.            Key = U
  232.            Type = 200
  233.            Opt Data = C:\USERTRAK\USERTRAK
  234.  
  235.  
  236.    2. Create a ghost task in CEDIT for the TOP-10 mode.
  237.  
  238.       EG:  
  239.  
  240.  Event 1, Occurs on Line 254 at 23:59 on Sun, Mon, Tue, Wed, Thr, Fri, Sat
  241.           Type = 200  Opt Data = C:\USERTRAK\USERTRAK /Q && S
  242.            
  243.  
  244.    3. Create a menu item for the listing TOP-10 files.
  245.  
  246.       EG:  Entry:
  247.            <T>OP-10
  248.            Key = T
  249.            Type = 2
  250.            Opt Data = C:\USERTRAK\TRAK
  251.  
  252.  
  253.     Note: the output files from the TOP-10 mode are named so that a type
  254.           2 command will work nice. You would simply need to manually create
  255.           a 'menu' text file named "TRAKL.TXT" and place it in the USERTRAK
  256.           directory.
  257.  
  258.           EG:   TRAKL.TXT
  259.  
  260.                 <1>Top 10 Calls to BBS
  261.                 <2>Top 10 Time Online
  262.                 <3>Top 10 Uploaders
  263.                 <4>Top 10 Downloaders
  264.  
  265.  
  266.    4. Configure USERTRAK by running it
  267.  
  268.       On first run, the sysop (priv=255) will need to tell USERTRAK where
  269.       the userlog.bbs file is located and what priv. level to show the user
  270.       flags to.  Very straight forward.  If you want flags to be show along
  271.       with the summary line at the end of the listing to anyone enter 0, 
  272.       otherwise enter whatever your system dictates.
  273.  
  274.  
  275.   ┌────────────────────────────────────────────────────────────────────┐
  276.   │ 8.                          OPERATION NOTES                        │
  277.   └────────────────────────────────────────────────────────────────────┘
  278.  
  279.    userlog listing
  280.    ---------------
  281.  
  282.    The flags shown to the sysop or anyone meeting the minimum priv. level
  283.    USERTRAK was configured with are as follows:
  284.  
  285.          F = full (non A3 bump)
  286.  
  287.          R = reviewed
  288.  
  289.          U = unreviewed
  290.  
  291.          P = protected
  292.  
  293.          D = marked for deletion
  294.  
  295.          I = invisible
  296.  
  297.    In the userlog listing they will follow the name listed.
  298.  
  299.       EG: JOHN HASEMEIER (FRPI)          : SARASOTA, FL ...
  300.  
  301.  
  302.    Anyone without the minimum priv. level will see all users EXCEPT those
  303.    which are flagged for deletion and those flagged invisible.
  304.  
  305.    Additionally these callers will not see the summary report.
  306.  
  307.  
  308.   ╔════════════════════════════════════════════════════════════════════╗
  309.   ║ 9.                     REVISIONS & BUG REPORT                      ║
  310.   ╚════════════════════════════════════════════════════════════════════╝
  311.  
  312.    Revision 1.11
  313.  
  314.         Problem with hour display in top-10 listing #2 fixed
  315.         Delays added to top-10 mode to spread out impact
  316.  
  317.    Revision 1.10
  318.  
  319.         Embarrasment update, version 1.09 had broken error trapping
  320.  
  321.    Revision 1.09
  322.  
  323.     First public release of usertrak.
  324.     Complete ANSI implementation, minor adjustments to cosmetics break
  325.     testing of various situations, addition of some conditional flow.
  326.  
  327.    Revision 1.08
  328.  
  329.     Rewrite various procedures to become dual use procedures, minor ANSI
  330.     support added for top-10
  331.  
  332.    Revision 1.07
  333.  
  334.     Implementation of license key usage in usertrak, optimized error
  335.     handling routines, cleaned up public var use.
  336.  
  337.    Revision 1.06
  338.  
  339.     License key design, addition of program routines to simply know if
  340.     when, why, what to do with license key. Design of separate license
  341.     key generation program mostly.
  342.  
  343.    Revision 1.05
  344.  
  345.     Implemented code to provide evauleation period cop and added nag
  346.     comment on TOP-10 generation mode.
  347.  
  348.    Revision 1.04
  349.     
  350.     Designed methods to have program adjust internal buffer and read
  351.     sizes for both modes.
  352.  
  353.    Revision 1.03
  354.  
  355.     Refined TOP-10 generation at this point all output is formatted with
  356.     no consideration to ANSI or color.
  357.  
  358.    Revision 1.02
  359.  
  360.     Added foundation for dual mode operation and TOP-10 list generation
  361.  
  362.    Revision 1.01
  363.  
  364.     Additions of priv requirements for seeing deleted users and formatted
  365.     display of the information. Addition of Sysop viewing of user's flags
  366.     and optimizing of flag extractions.
  367.  
  368.    Revision 1.00
  369.  
  370.     This marked a major rehash of methods and the extraction of the
  371.     invisible flag so invisible users would not be listed, total display
  372.     fields: name, location, calls, time on, last call.  Simple formatting
  373.     and page pause. Priv requirements for seeing invisible users. Basicly
  374.     a finished userlog lister which I fielded on the BBS for the next few
  375.     days before more testing.
  376.  
  377.    Revision 0.01
  378.     
  379.     Added some detail information (location) with simple delimters
  380.     in between.
  381.  
  382.    Revision 0.00
  383.  
  384.     This revision was my first dabble into parsing out information
  385.     from the userlog.bbs file. Nothing fancy but names spewing onto
  386.     the screen without pause.
  387.  
  388.  
  389.   ╔════════════════════════════════════════════════════════════════════╗
  390.   ║ 10.                      TECHNICAL SUPPORT                         ║
  391.   ╚════════════════════════════════════════════════════════════════════╝
  392.  
  393.    I've written this program to be as bug-free as possible. (don't we all)
  394.    However, there are most likely some bugs which have not shown up.
  395.    Should any bugs be discovered, they should be reported to me as soon as
  396.    possible.  You may send bug reports any way you like yet I will be
  397.    limiting return responses and bug fixes to my BBS in most cases.
  398.  
  399.  
  400.                         John Hasemeier
  401.  
  402.                         USPS : 4411 Bee Ridge Road, #271
  403.                                Sarasota, Florida 34233
  404.  
  405.                         VOICE: 813-924-2251
  406.                         BBS  : 813-923-8730
  407.  
  408.                         Fidonet Address -- 1:137/130
  409.                         Internet Address - tiger@packet.net
  410.  
  411.  
  412.   ╔════════════════════════════════════════════════════════════════════╗
  413.   ║ 11.                      REGISTRATION                              ║
  414.   ╚════════════════════════════════════════════════════════════════════╝
  415.  
  416.    Single CPU licenses are sold for a price of $19.00 US dollars.
  417.  
  418.                        Registration Benefits
  419.  
  420.    ■ FREE technical support             ■ Opportunity to beta new stuff
  421.    ■ Helps create more quality stuff    ■ Discount MAJOR upgrades
  422.    ■ FREE bug fixes & minor revisions   ■ You will be glad you did!
  423.  
  424.  
  425.    To register fill in the following form(s) and send along with payment to
  426.    the address shown in section 10 (technical support).
  427.  
  428.                       ----------------------------------
  429.  --------------------[ USERTRAK Order/Registration form ]--------------------
  430.                       ----------------------------------
  431.  
  432.  DATE . . . . . :
  433.  
  434.  NAME . . . . . :
  435.  
  436.  COMPANY  . . . :
  437.  
  438.  MAILING ADDRESS:
  439.  
  440.  
  441.  
  442.  
  443.  VOICE PHONE(s) :
  444.  
  445.  BBS PHONE(s) . :
  446.  
  447.  BBS NAME . . . :
  448.  
  449.  EMAIL ADDRESSES:
  450.  
  451.  
  452.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  453.  
  454.  
  455.  REGISTRATION FEE       :                                     $19.00
  456.  
  457.  SHIPPING & HANDLING FEE: (from below)                        $____________
  458.  
  459.      ■ Pickup at PLANET 3      :  FREE
  460.  
  461.                                    USA      INT'L
  462.                                   ~~~~~     ~~~~~
  463.      ■ Drop off at YOUR BBS    :  $1.00     $4.00
  464.      ■ Postal Service (on disk):  $2.00     $3.00
  465.      ■ C.O.D. (cash)           :  $3.00      N/A?
  466.  
  467.  
  468.  DISK SIZE/TYPE: ________________                     TOTAL:  $____________
  469.  
  470.  
  471.  Payment must be made with some sort of bank depositable thing, IN US DOLLARS.
  472.  I'll work with you anyway that you want on this, I simply don't have a way to
  473.  process charge cards (the decline of modern civilization) at this time.
  474.  
  475.  All registrations will remain pending until the funds are in my account at
  476.  which time I will final process the order.  Anyone in a real RUSH can do a
  477.  western union transfer, it's pretty cheap and delivers cash in minutes.
  478.  
  479.  Prices are subject to change without any prior notice, yet any in-transit or
  480.  pending orders will commit to the customer understood price.
  481.  
  482.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  483.