home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / ucbv0100.zip / UltiCBV.Doc < prev    next >
Text File  |  1995-06-07  |  45KB  |  937 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                UltiCBV
  8.  
  9.  
  10.  
  11.         ┌─────────────────────────────────────────────────────────┐
  12.         │▓▒░                                                   ░▒▓│
  13.         │▓▒░          THE ULTIMATE CALLBACK VERIFIER           ░▒▓│
  14.         │▓▒░                   For AdeptXBBS                   ░▒▓│
  15.         │▓▒░                                                   ░▒▓│
  16.         └─────────────────────────────────────────────────────────┘
  17.  
  18.  
  19.  
  20.  
  21.                            Documenation For
  22.                              UltiCBV v1.0
  23.  
  24.  
  25.  
  26.                     Copyright 1995 John F. Doran
  27.  
  28.                     All Rights Reserved Worldwide.
  29.  
  30.  
  31.  
  32.  
  33.         ┌─────────────────────────────────────────────────────────┐
  34.         │▓▒░               Table Of Contents                   ░▒▓│
  35.         └─────────────────────────────────────────────────────────┘
  36.  
  37.     WARRANTY                                                                 1
  38.  
  39.     ACKNOWLEGEMENTS                                                          1
  40.  
  41.     SHAREWARE DISTRIBUTION                                                   2
  42.  
  43.     DISTRIBUTION FILE CONTENTS                                               2
  44.  
  45.     -> ULTICBV                                                               3
  46.     --> Description                                                          3
  47.     ---> Requirements                                                        4
  48.  
  49.     -> SUPPORT FILES                                                         4
  50.     --> ConfCBV.ERX                                                          4
  51.     ---> UltiCBV.Cfg                                                         4
  52.     ----> UltiCBV.Log                                                        4
  53.     -----> TeleNums.Log                                                      4
  54.  
  55.     -> ASC / ANS / AVT Screens                                               5
  56.     --> CBV_AutoVal*.*                                                       5
  57.     ---> CBV_BadTime.*                                                       5
  58.     ----> CBV_Connect.*                                                      5
  59.     -----> CBV_EMail.*                                                       5
  60.     ------> CBV_Fail.*                                                       5
  61.     -------> CBV_FailBDay.*                                                  5
  62.     --------> CBV_FailPWord.*                                                5
  63.     ---------> CBV_GetPhone.*                                                5
  64.     ----------> CBV_GoAway.*                                                 5
  65.     -----------> CBV_Instructions.*                                          5
  66.     ------------> CBV_Intro.*                                                5
  67.     -------------> CBV_LDLocked.*                                            5
  68.     --------------> CBV_NewTelNo.*                                           5
  69.     ---------------> CBV_No*.*                                               5
  70.     ----------------> CBV_NoTime.*                                           6
  71.     -----------------> CBV_NotValid.*                                        6
  72.     ------------------> CBV_Successful.*                                     6
  73.     -------------------> CBV_UnSucccessful.*                                 6
  74.     --------------------> NewApp.*                                           6
  75.  
  76.     -> ULTICBV INSTALLATION                                                  6
  77.     --> Support Files                                                        6
  78.     ---> AtStart Installation                                                6
  79.  
  80.     -> ULTICBV CONFIGURATION                                                 7
  81.     --> ConfCBV - General Menu                                               7
  82.     ---> ConfCBV - Local/Toll/LD/Intl Area Menus                             8
  83.     ----> Area Codes Configuration                                          10
  84.  
  85.     -> APPENDICES                                                           12
  86.     --> Contacting The Author                                               12
  87.     ---> User Restrictions                                                  12
  88.     ----> Registration                                                      14
  89.     -----> Registration Form                                                15
  90.  
  91.  
  92.                                                                      (Page 1)
  93.         ┌─────────────────────────────────────────────────────────┐
  94.         │▓▒░                    WARRANTY                       ░▒▓│
  95.         └─────────────────────────────────────────────────────────┘
  96.  
  97.  
  98.  
  99.      UltiCBV (The Ultimate CallBack Verifier) has NO WARRANTY.  Use Of
  100.      UltiCBV and any accompanying programs/files is at YOUR OWN RISK.  By
  101.      use of UltiCBV, you agree to hold the author and parties directly or
  102.      indirectly related to the author faultless from the non-use, use, an/or
  103.      misuse of UltiCBV.
  104.  
  105.      UltiCBV And ConfCBV (Configuration Module For UltiCBV) is provided
  106.      'AS-IS' and WITHOUT WARRANTY IMPLIED OR OTHERWISE.
  107.  
  108.  
  109.  
  110.         ┌─────────────────────────────────────────────────────────┐
  111.         │▓▒░                ACKNOWLEDGEMENTS                   ░▒▓│
  112.         └─────────────────────────────────────────────────────────┘
  113.  
  114.  
  115.  
  116.      References not otherwise documented.
  117.  
  118.  
  119.      AdeptXBBS                     Refers To AdeptXBBS Bulleetin Board System
  120.                                    for IBM 32-bit OS/2.
  121.                                    Copyright (c) 1993 - 1995 by AdeptSoft
  122.                                    Portions Copyright (c) 1991 - 1994 M.Kimes
  123.  
  124.  
  125.  
  126.                                                                      (Page 2)
  127.         ┌─────────────────────────────────────────────────────────┐
  128.         │▓▒░            SHAREWARE DISTRIBUTION                 ░▒▓│
  129.         └─────────────────────────────────────────────────────────┘
  130.  
  131.      Shareware is a unique method for the marketing of comptuer software.
  132.      Most of all the products are easily obtained from larger Bulletin Board
  133.      Systems worldwide.  The basis behind the workings of the Shareware
  134.      system is the HONOR system.  This means that the end user is free to
  135.      use the product for a limited trial period to see if it suits their
  136.      needs.  If the user continues to use the product after this trial period
  137.      it is expected of them to register the product with its auther along
  138.      with any stated fees,  this is to reimbuse the author for both the time
  139.      spent in developing the product and to provide incentive to maintain
  140.      and update the product.
  141.  
  142.      You are free to test and use this program,  UltiCBV,  to determin if it
  143.      suits your neds.  If you continue to use this program beyond its thirty
  144.      (30) days trial period,  complete the registration form (REGSITER.NFO)
  145.      and mail it along with the registration fee to the address listed on
  146.      the form.  Upon the receipt of the completed registration form and fees
  147.      you will be kept advised of the status and availability of UltiCBV,
  148.      granted use of the registered version, get timely support when needed,
  149.      and possible use of beta and specialized versions of UltiCBV.
  150.  
  151.         ┌─────────────────────────────────────────────────────────┐
  152.         │▓▒░          DISTRIBUTION FILE CONTENTS               ░▒▓│
  153.         └─────────────────────────────────────────────────────────┘
  154.  
  155.    Naming Convention Of UltiCBV Distribution Archives:
  156.  
  157.    UCBVMMRR.AAA
  158.                     UCBV = UltiCBV
  159.                     MM   = Major Version Number <ie: 01>
  160.                     RR   = Minor Revision Number <ie: 1A>
  161.                     AAA  = Archiver <ie: ZIP>
  162.  
  163.    UltiCBV is distributed as a complete package compressed into one archive
  164.    file.  The archive file of the UNREGISTERED version may be freely
  165.    distributed so long as no charge is required to obtain the pacackage and
  166.    no modifications to the distribution package is made beyond converting
  167.    the archiver format <ie: changing archive from ZIP to ARJ>
  168.  
  169.    DISTRIBUTION OF REGISTERED, ALPHA, OR BETA VERSIONS IS PROHIBITED.
  170.  
  171.    Included in the completed archive for UltiCBV are the following files:
  172.  
  173.    UltiCBV.ERX        - UltiCBV Converted To AdeptXBBS's Enhanced Rexx format.
  174.    ConfCBV.ERX        - Configuration Module For UltiCBV.
  175.    CBV_Screens.Data   - Archive Containing All Of UltiCBV's External Screens.
  176.    UltiCBVCfg.Data    - Archive Containing Other Misc. UltiCBV Cfg Files.
  177.    AreaCodes.CFG      - Sample Configuration File For AreaCodes/Prefixes.
  178.    SysOp.Menu         - Sample SysOp Menu (Inside Of UltiCBVCfg.Data)
  179.    File_ID.DIZ        - Text Describing UltiCBV Distribution Archive.
  180.    UltiCBV.Help       - Help File For UltiCBV And ConfCBV.
  181.    Utility.Data       - Used By InstallCBV.Cmd To Unarchive Data Files.
  182.    UlitCBV.DOC        - Documentation For UltiCBV And ConfCBV.
  183.    Registration.Info  - Registration Info And Form For UltiCBV/ConfCBV.
  184.    History.Text       - Text Describing The Changes And History Of UltiCBV.
  185.    Future.Text        - Planned On Features For Future Releases Of UltiCBV.
  186.  
  187.                                                                      (Page 3)
  188.         ┌─────────────────────────────────────────────────────────┐
  189.         │▓▒░            UltiCBV - Description                  ░▒▓│
  190.         └─────────────────────────────────────────────────────────┘
  191.  
  192.  
  193.    UltiCBV is a Call Back Verification system designed for use with AdeptXBBS
  194.    Bulletin Board Systems.  it is intended to provide an easy way for Adept
  195.    users to self validate themselves without needing direct Systems Operator
  196.    intervention.  UltiCBV also enhances the systems security by recording the
  197.    complete phone numbers used for verification.  It can also be configured
  198.    to lockout troubleseom users,  lockout specific area codes and prefixes,
  199.    and prevent users from gaining multiple accounts.  UltiCBV can also be
  200.    configured to offer Toll, Long Distance and International callers a
  201.    customized access level different from local callers.. or to 'AutoValidate'
  202.    them to save on long distance charges.
  203.  
  204.    UltiCBV uses AdeptXBBS's built in modem handling routines which report the
  205.    speed of the communications port can be used with ANY modem which can be
  206.    used by AdeptXBBS itself.  UltiCBV reads your modem configuration directly
  207.    from AdeptXBBS's configuration (ie: modem init strings and more).  This
  208.    way there is less to configure with UltiCBV and less chances of mishaps
  209.    or mistakes during configuration.  Further.. if you change the configuration
  210.    in AdeptXBBS,  then you automatically update the information for UltiCBV
  211.    as well.
  212.  
  213.    UltiCBV reads AdeptXBBS's Message Base configuration file to help locate
  214.    your Private Email Base,  as well as reading AdeptXBBS's USER GROUP File
  215.    to help you locate 'Validate Users' users groups to Validate or Auto-
  216.    Validate specific callers to.
  217.  
  218.    UltiCBV reads AdeptXBBS's 'Phonecan' file <a trashcan for users telephone
  219.    numbers the SysOp wishes 'LOCKED OUT'>.  This affords for greater security
  220.    and configuration of UltiCBV.
  221.  
  222.    UltiCBV logs all its processes to your AdeptXBBS Sysop Log, SysOp Window
  223.    and to its own specific 'UltiCBV.LOG' log files.  All logging is indepth
  224.    and informative.
  225.  
  226.    UltiCBV uses external screens for MOST of its screen writes.  This offers
  227.    SysOps a great deal of flexibility in adding UltiCBV to their own specific
  228.    AdeptXBBS Setup.  Screens can be modified at the SysOps will.
  229.  
  230.    UltiCBV has seperate configuration levels for Local, Toll, Long Distance
  231.    and International Callers... again... offering a great deal of flexibility
  232.    for SysOps to configure UltiCBV to suit their needs.
  233.  
  234.    UltiCBV automatically checks and cleans users telephone numbers <based upon
  235.    SysOp configuration>.  This helps insure user records contain correct and
  236.    readable information instead of garbage.
  237.  
  238.    ConfCBV is the configuration module needed to set up and configure your
  239.    copy of UltiCBV.  ConfCBV has been written with speed in mind, as well as
  240.    the ability for SysOps to do remote maintenance/configuration of UltiCBV.
  241.  
  242.    UltiCBV was programmed exclusively in OS/2's REXX.  UltiCBV contains well
  243.    over 4000 lines of raw, optimized code.  ConfCMD contains over 4000 lines
  244.    of raw, optimized code as well.
  245.  
  246.  
  247.                                                                      (Page 4)
  248.         ┌─────────────────────────────────────────────────────────┐
  249.         │▓▒░            UltiCBV - Requirements                 ░▒▓│
  250.         └─────────────────────────────────────────────────────────┘
  251.  
  252.    Hardware:  Basically,  you can run UltiCBV on any machine and any modem
  253.    that you can run AdeptXBBS (For OS/2) on.
  254.  
  255.    Software:  UltiCBV requires that you have OS/2 V2.1 or higher installed
  256.    and running as your systems operating system.  Further,  UltiCBV requires
  257.    that you installed OS/2's REXX modules <installed during installation
  258.    procedures or during Selective Install>.  Further,  UltiCBV requires the
  259.    existance of RexxUtil - the extended/enhanced features provided with
  260.    OS/2's basic REXX modules.
  261.  
  262.    UltiCBV needs to be run from a SubDirecty within your Adept main directory
  263.    called "CALLBACK". (ie: C:\Adept\CallBack).  All of UltiCBV's screens
  264.    should be placed in your Adept\TEXT Directory.  UltiCBV.CFG And CONFCBV.ERX
  265.    should be located in your Adept\CallBack directory.
  266.  
  267.         ┌─────────────────────────────────────────────────────────┐
  268.         │▓▒░            UltiCBV - Support Files                ░▒▓│
  269.         └─────────────────────────────────────────────────────────┘
  270.  
  271.    ConfCBV.ERX:  This is the configuration module for UltiCBV.  With this
  272.    program,  you can configure all the needed options/settings and switches
  273.    used by UltiCBV.  ConfCBV can be run locally <From Adept> or remotely to
  274.    allow remote maintenance and configuration of UltiCBV.
  275.  
  276.    UltiCBV.CFG:  This is the data configuration file used by ConfCBV and
  277.    UltiCBV.  Inside this file is stored all your configuration options,
  278.    settings and switches to control UltiCBV callback verification procedures.
  279.    (This file should only be modified by ConfCBV.ERX)
  280.  
  281.    UltiCBV.LOG:  This is a log file created and updated by UltiCBV each and
  282.    everytime a user enters the Callback Verifier.  It's a plain ASCII Text
  283.    file which shows each step during any callback verification attempt.
  284.  
  285.    TeleNums.LOG:  This is a log file created and updated by UltiCBV after each
  286.    successful Validation or AutoValidation of a user.  A users name, handle
  287.    telephone number and other information is recorded in this file.  The file
  288.    is used by UltiCBV to help screen out duplicate accounts based on Telephone
  289.    number.  If a new user entering UltiCBV has the same telephone number as
  290.    a user who was previously verified and validated by UltiCBV... then a
  291.    warning message is sent to the user AND to the SysOp informing them of this
  292.    possible security breach attempt.
  293.  
  294.    AreaCodes.CFG:  This is a Text file listing special areacode information
  295.    such as local, International dialing prefix,  local dialing prefixes, etc)
  296.  
  297.    UltiCBV.Help:  This Is A Text Help File Available to UltiCBV And ConfCBV.
  298.    Whenever You, Or A User Hits The [TAB] Key At An Input Prompt, The Text
  299.    Regarding The Subject They Are Being Prompted For Is Shown.
  300.  
  301.    Phonecan:  This is an AdeptXBBS which contains telephone numbers a SysOp
  302.    wishes to have locked out <for more information on Phonecan... read your
  303.    AdeptXBBS documentation>.
  304.  
  305.    Message_Areas & Groups:  These Are AdeptXBBS Configuration Files Which
  306.    UltiCBV And ConfCBV Will Read To Get Certain Information From.
  307.  
  308.                                                                      (Page 5)
  309.         ┌─────────────────────────────────────────────────────────┐
  310.         │▓▒░            UltiCBV - ANS/ASC/AVT Files            ░▒▓│
  311.         └─────────────────────────────────────────────────────────┘
  312.  
  313.    UltiCBV was written with the SysOp in mind.  I wanted to allow a great
  314.    deal of flexibility in the configuration of UltiCBV so a SysOp can
  315.    almost totally customize UltiCBV to reflect their own personal tastes
  316.    and the theme/look of their systems.  That is why most of UltiCBV's screens
  317.    are external.  In this way a SysOp can modify these screens in any way
  318.    they seem fit to better match them with their own system.
  319.  
  320.    Below is a list of all the ANSI, ASCII and AVATAR screens distributed with
  321.    UltiCBV and their uses.
  322.  
  323.   CBV_AutoValLocal
  324.   CBV_AutoValToll
  325.   CBV_AutoValLD
  326.   CBV_AutoValIntl  --> These are shown to users who fall into the calling
  327.                        region <ie: local> when they are successfully
  328.                        AutoValidated by UltiCBV, before they are sent back to
  329.                        BBS with their new security settings/user group.
  330.  
  331.   CBV_BadTime --> Shown to a user who attempts to be Callback Verified OUTSIDE
  332.                   the SysOp defined time window for their calling region.
  333.  
  334.   CBV_Connect -->  Shown to a user when UltiCBV Connects to their system.
  335.  
  336.   CBV_EMail --> Shown to a user who attempts to be CallBack Verified outside
  337.                 Calling Time Window Prompting To Send EMail To The SysOp.
  338.  
  339.   CBV_Fail --> Shown to a user who fails to complete the CallBack Verification
  340.                procedure (ie: if they quit.. etc)
  341.  
  342.   CBV_FailBDay
  343.   CBV_FailPWord --> Shown to users who failed their Birthdate or Password
  344.                     checks.
  345.  
  346.   CBV_GetPhone --> No longer in use.. replaced with an internal screen.
  347.  
  348.   CBV_GoAway --> Shown to callers who interupt the callback verification
  349.                  process.  UltiCBV will attempt to answer the phone and inform
  350.                  a calling user to callback later when the callback process
  351.                  has completed.
  352.  
  353.   CBV_Instructions --> Instruction screen shown to users before they are
  354.                        disconnected.
  355.  
  356.   CBV_Intro --> Shown to new users entering UltiCBV informing them they are
  357.                 about to be CallBack Verified.
  358.  
  359.   CBV_LDLocked --> Shown to users who's areacode was found to be LOCKED OUT.
  360.  
  361.   CBV_NewTelNo --> Shown to users who choose to enter in a new telephone number.
  362.  
  363.   CBV_NoLocal
  364.   CBV_NoToll
  365.   CBV_NoLD
  366.   CBV_NoIntl --> Shown to callers if their calling region is set up as NEVER
  367.                  callback verify.
  368.  
  369.                                                                      (Page 6)
  370.         ┌─────────────────────────────────────────────────────────┐
  371.         │▓▒░            UltiCBV - ANS/ASC/AVT Files <cont>     ░▒▓│
  372.         └─────────────────────────────────────────────────────────┘
  373.  
  374.   CBV_NoTime --> Shown to users who do not have enough time left online to
  375.                  complete the callback process (5 minutes or less)
  376.  
  377.   CBV_NotValid --> Shown to users when their numbers are invalid.  This can
  378.                    be if their numbers were found in the TeleNums.Log file,
  379.                    PhoneCan file, or if their numbers/area codes were locked
  380.                    out by the SysOp.
  381.  
  382.   CBV_Successful --> Shown to successfully verified and validated users.
  383.  
  384.   CBV_Unsuccessful --> Shown to unsuccessfully verified users.
  385.  
  386.   NewApp --> Shown to users before they are pushed into "New User Email To
  387.              The SysOp" (If enabled).
  388.  
  389.  
  390.         ┌─────────────────────────────────────────────────────────┐
  391.         │▓▒░            UltiCBV - INSTALLATION                 ░▒▓│
  392.         └─────────────────────────────────────────────────────────┘
  393.  
  394.    To Install UltiCBV,  first you should unzip the distribution archive into
  395.    an empty TEMP directory and run INSTALLCBV.CMD.  You will be asked for the
  396.    DRIVE and PATH to your AdeptXBBS directory.  When you've supplied this
  397.    information,  InstallCBV will move the files into their proper directories.
  398.  
  399.    If you wish,  you can allow INSTALLCBV.CMD automatically install the needed
  400.    commands into AtStart.CMD for you.  If you allow INSTALLCBV.CMD to do this,
  401.    then a back up of your original AtStart.CMD is made and that back up is
  402.    named AtStart.Cmd.UltiBackup.  If there is a problem with the lines of code
  403.    that InstallCBV adds into your AtStart.CMD, just replace it with the
  404.    backup and contact me on the AdeptSoft echo with the problem.
  405.  
  406.    Included in this distribution archive is a file called SYSOP.MENU.  You'll
  407.    find it located in the Adept\CallBack directory.  You might want to move
  408.    this to your ADEPT\MENUS directory.  Then edit your MAIN.MENU <and/or
  409.    your other Menus> to add the following line into the menu:
  410.  
  411. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  412.  
  413.   *,  1, [*] SysOps Menu            ,SysOp.Menu,0,0,100,100,100
  414.  
  415.  
  416. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  417.  
  418.    Of course you need to make sure that * does not cause a conflict on your
  419.    Main Menu <or other.menu> with another command.  Further,  replace the
  420.    last two 100's on the line with Your (SysOp) security level so other
  421.    users will not be able to gain access to the command.  From this
  422.    point on... you can access the SysOps menu by hitting * from the Main Menu
  423.    <or Other.Menu>.
  424.  
  425.    From the SysOp menu you'll now be able to access ConfCBV.ERX. <when
  426.    you are logged on as the sysop>.
  427.  
  428.  
  429.                                                                      (Page 7)
  430.         ┌─────────────────────────────────────────────────────────┐
  431.         │▓▒░            UltiCBV - Configuration                ░▒▓│
  432.         └─────────────────────────────────────────────────────────┘
  433.  
  434.    ConfCBV.ERX is used to configure just about all options/settings and
  435.    switches for UltiCBV.  Below is a listing of the options available and
  436.    what they do.
  437.  
  438.  
  439.    ConfCBV.ERX
  440.  
  441. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  442.  
  443.      [1] General Configuration:
  444.  
  445.         [A] Max CallBack Attempts - The Maximum Tries That UltiCBV Will Make
  446.             When Trying To CallBack Verify A User Before Giving Up.
  447.             Valide Choices Are 1 Thru 255.  Recommended:  3
  448.  
  449.         [B] Max Password Attempts - The Maximum Amount Of Times A User Is
  450.             Given To Enter Their Correct Password.  '0' Disables Password
  451.             Checking.  If A User Exceeds This Amount Of Tries,  They Are
  452.             Shown CBV_FailPWord.Ans/Asc/Avt And Are Disconnected Without
  453.             Being Upgraded. Valid Choices Are 0 Thru 255.  Recommended:  3
  454.  
  455.         [C] Max Birthdate Attempts - The Maximum Amount Of Times A User Is
  456.             Given To Enter Their Correct Birthdate.  '0' Disables Birthdate
  457.             Checking.  If A User Exceeds This Amount Of Tries,  They Are
  458.             Shown CBV_FailBDay.Asc/Ans/Avt And Are Disconnected Without Being
  459.             Upgraded. Valid Choices Are 0 Thru 255.  Recommended: 2
  460.  
  461.         [D] Chk Users Time Before CBV - UltiCBV Can/Will Check To Make Sure A
  462.             User Has At Least 5 Minutes Of Online Time Left Before Attempting
  463.             To Continue The CallBack Verification Process.  If This Is Set To
  464.             Yes,  Then UltiCBV Will Check A Users Online Time Before Calling
  465.             Them Back... And If The User Doesn't Have Enough Time Left,
  466.             NoTime.Asc/Ans/Avt Is Displayed To The User And They Are Then
  467.             Disconnected.  If Set To No,  Then UltiCBV Ignores The Users Time
  468.             Left Online And Continues The CallBack Verification Procedured.
  469.             Valid Choices Are [Y]es or [N]o.  Recommended: Y
  470.  
  471.         [E] EMail Message Base - This Is Where You Define The AdeptXBBS
  472.             Message Base You Wish To Use For Private Email From All New Users
  473.             Going Through The CallBack Verification Procedure.  You Can Choose
  474.             Your Normal Private EMail Message Base Or Another Specifically Set-
  475.             Up For New User Applications/Registration.  ConfCBV Will
  476.             AutoMatically Show You All Available Message Bases In Adept And
  477.             Allow You To Choose Which One You Wish To Use For This Purpose.
  478.             Valid Choices Are ANY Of Your PreDefined AdeptXBBS Message Bases.
  479.  
  480.         [F] SysOp EMail Should Be Address To -  This Is The Name Of The
  481.             SysOp Or CoSysOp Who Will Be Handling New User Registration.
  482.             This Is Their REAL First And Last Name EXACTLY As It Appears In
  483.             Their User Records In Adept.  All EMail And UltiCBV Notifications
  484.             WilL Be Addressed To This Person Only.  This Is Helpful For Systems
  485.             Who Have Many SysOps Or CoSysOps Who Handle Different Aspects Of
  486.             Running A BBS (Like In Commercial Environments).
  487.  
  488.  
  489.                                                                      (Page 8)
  490.         ┌─────────────────────────────────────────────────────────┐
  491.         │▓▒░            UltiCBV - Configuration  <cont>        ░▒▓│
  492.         └─────────────────────────────────────────────────────────┘
  493.  
  494.  
  495.         [G] Allow Voice Number CallBack - This Defines Whether UltiCBV Should
  496.             Allow The User To Choose Their Voice Number (As Listed In Their
  497.             Users Records) To Be CallBack Verified On.  If Set To Yes Then
  498.             UltiCBV Will Automatically Strip/Clean/Check The Number To Insure
  499.             It Is A Valid Number Before Showing The User The Number As A Valid
  500.             Option.  If The Number Is Not Found To Be Valid,  The User Is
  501.             Prompted To Change/Fix It Before Continueing.  If This Is Set To
  502.             No,  Then The Number Is *NOT* Checked/Cleaned,  And It Is Not
  503.             Shown To The User As A Valid Number To Be CallBack Verified On.
  504.             Also,  If Set To NO, And UltiCBV Sees That This Field Is Blank,
  505.             It Will Replace It With '[Not Available]'.
  506.  
  507.         [H] Allow Data Number CallBack - Same As [G] Above But With A Few
  508.             Exceptions.  If Set To YES,  And The Users Record For Is Found
  509.             Blank,  It Is Replaced With '[Not Available'].  Also, Users Are
  510.             Given The Chance To Either ReEnter The Data Number, Or Enter
  511.             NA For Not Available.
  512.  
  513.         [I] Allow Fax Number Callback - Same As [H] Above, But For Users
  514.             Fax Number Fields.
  515.  
  516.         [J] Allow Work Number CallBack - Same As [H] Above But For Users
  517.             Work/Business Number Fields.
  518.  
  519.         [S] Save And Exit - Will Save The Current Configuration To The
  520.             Hard Disk And Exit ConfCBV.
  521.  
  522.         [Q] Quits Back To The Main Menu.
  523.  
  524. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  525.  
  526.      [2] Local/Toll/LD/International Set Ups.
  527.  
  528.         [A] Allow CallBack - This Will Allow You To Define <For Each Area
  529.             Above Listed> Whether Or Not To Actually Call The User Back,
  530.             Not Call Them Back,  AutoValidate Them,  Or Call Them Back During
  531.             PreDefined Time Windows.  Valid Choices Are:
  532.  
  533.                (1) Always CallBack - This Will Always Call Users In This
  534.                    Calling Area Without Checking For Time Windows.
  535.  
  536.                (2) Sometimes Allow CallBacks - This Will Check The Current
  537.                    Time,  And Check It Against The PreDefined Time Windows.
  538.                    If The Current Time Is Within This Time Zone,  Then The
  539.                    User Is CallBack Verified.  If The Current Time Falls
  540.                    Outside The Set Time Window,  The User Is Instructed Of
  541.                    The Valid Times Which Calls Made To This Calling Area Are
  542.                    Allowed And Told To Call Back During Those Times To Retry
  543.                    CallBack Verification.
  544.  
  545.                (3) Never Allow CallBacks - This Will Keep UltiCBV From Ever
  546.                    Attempting To CalLBack Verify Users In This Calling
  547.                    Region.
  548.  
  549.  
  550.                                                                      (Page 9)
  551.         ┌─────────────────────────────────────────────────────────┐
  552.         │▓▒░            UltiCBV - Configuration  <cont>        ░▒▓│
  553.         └─────────────────────────────────────────────────────────┘
  554.  
  555.  
  556.                (4) AutoValide Callers - This Will Also Keep UltiCBV From
  557.                    Ever Atempting To CallBack Verify Users In This Calling
  558.                    Region, But Automatically Upgrades Their Account Anyway
  559.                    So They Can Use The BBS As A Valid User.
  560.  
  561.         [B] AutoValidate Callers - <See Above>. This Toggles AutoValidation
  562.             For This Calling Area.
  563.  
  564.         [C] Begin Time - This Sets The Beginning Time For The PreDefined
  565.             CallBack Window.  This Should Be In Military Format Only.
  566.             (ie;  00:00:00 Is 12:00am Midnight,  12:00:00 is 12:00pm Noon)
  567.             This Is Only Active If You Have UltiCBV Configured To Use Time
  568.             Windows Before CallBack Verification.
  569.  
  570.         [D] End Time - Same As [C] Above But Sets Up The Ending Time For The
  571.             PreDefined CallBack Time Window.
  572.  
  573.         [E] Upgraded Users "Users Group" - This Is The New User Group That
  574.             Validated Or AutoValidated Users Will Be Upgraded To.  UltiCBV
  575.             Will Automatically Show You All The PreDefined Users Groups Setup
  576.             In AdeptXBBS And Allow You To Pick And Choose From There.  Below
  577.             The User Group,  The Screens Shows You The Security Levels,
  578.             Group Flags, Time Per Day, Time Per Call, Maximum Time Bank,
  579.             Max U/L KBytes Per Day, Max D/L KBytes Per Day, Days To Expiration,
  580.             Flags 1 And 2, And What Level Expired Users Are Changed To For The
  581.             User Group Configured.
  582.  
  583.         [F] Add To Online Time - This Is The Time Credited To The Successfully
  584.             Validated User (In Minutes).  This Can Be Used To Give The User
  585.             Time Back For The Amount Of Time They Spent Doing The New User
  586.             Log On And CallBack Verification (5 To 10 Minutes Is Generally
  587.             More Than Enough Time For This).  Valid Choices Are 0 Through 255.
  588.             Recommended: 10
  589.  
  590.         [G] Add To TimeBank Account - This Allows You To Give Successfully
  591.             Validated Users Some Extra Time (In Minutes) In Their Time Bank.
  592.             Valid Choices Are 0 Through 255.  Recommended: 45
  593.  
  594.         [H] Add To U/L Numbers - This Allows You To Give Successfully Validated
  595.             User Extra File Credits <Number Of Files Uploaded>.  Valid Choices
  596.             Are 0 Through 255.  Recommended: 5
  597.  
  598.         [I] Add To U/L KBytes - Same As [H] But Used To Set Up Uploaded
  599.             K-Bytes Instead Of Number Of Files.  Valid Choices Are 0 - Unlimited.
  600.             Recommended:  500
  601.  
  602.         [J] Add To NetMail Credits - If Your System Allows Users To Send Netmail
  603.             Then You Can Use This To Award Successfully Upgraded Users Netmail
  604.             Credits.  Valid Choices Are 0 Thru 9999.  Recommended:  100.
  605.  
  606.  
  607. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  608.  
  609.  
  610.                                                                      (Page 10)
  611.         ┌─────────────────────────────────────────────────────────┐
  612.         │▓▒░         UltiCBV - AREA CODES CONFIGURATION        ░▒▓│
  613.         └─────────────────────────────────────────────────────────┘
  614.  
  615.   You define special Area Codes in the AREACODES.CFG File.  This is a plain
  616.   Text file which you can edit with any text editor.  The following Keyword
  617.   Verbs are used in AreaCodes.CFG:
  618.  
  619.  
  620.  
  621.   Local:  Your Local AreaCode.
  622.  
  623.   LocalPreOK:  Some areas in the USA have a local Area Code but not all numbers
  624.                numbers within that Area Code are billed as local calls.  These
  625.                areas commonly use Dialing Prefixes (the first three numbers of
  626.                a Telephone number> to distinguish which calls are billed as
  627.                local calls and which are bills as Long Distance.  If this
  628.                applies to your Local Area Code,  then use LocalPreOK to set up
  629.                the dialing prefixes which are LOCAL and billed as LOCAL.
  630.  
  631.  LocalPreLD:  To go with LocalPreOK above,  this configures dialing prefixes
  632.               which are within your Local Area Code, but billed as Long
  633.               Distance.  Any dialing prefix found within the localPreLD will
  634.               be treated as Normal Long Distance (ie: a 1- is added before the
  635.               Area Code before dialing) and will be regulated by whatever
  636.               restrictions the SysOp defines for Long Distance Callers.
  637.  
  638.  LocalPreLDStrip:  This works like LocalPreLD above, except that any dialing
  639.               prefixes found in the LocalPreLDStrip configuration will be
  640.               handled as Long Distance,  however the Area Code is stripped from
  641.               the telephone number before dialing <as if it were a local call>
  642.  
  643.  Toll:        Some areas (Like New York City) have area codes which are
  644.               different, but still billed as local calls even though they are
  645.               not in the 'local' area code.  If you live in such a calling
  646.               region/situation,  then use the TOLL keyword verb to set up
  647.               area codes which are NOT local,  but are billed as local calls
  648.               none-the-less
  649.  
  650.  LongDistanceOK:  If You Wish To Have UltiCBV Allow "Certain" Long
  651.                Distance Callers, But Not Others <Based On Whatever..
  652.                Usually Price Of The Calls>... Then You Can Configure
  653.                The LongDistanceOK To Include Area Codes Which You Wish
  654.                To Allow CallBacks To.  This ... Used With The
  655.                LongDistanceNotOkay Configuration Will Allow You To
  656.                Let Only Those AreaCodes You Wish To Have Dialed..
  657.                Dialed.  Any Area Codes Listed Here WIll Be Dialed
  658.                **EVEN IF YOU HAVE ULTICBV SET UP TO NEVER ALLOW
  659.                LONG DISTANCE CALLBACKS**.  This Is Important To Note
  660.                So Be Careful With Setting This Up.  You Can Completely
  661.                Configure LongDistanceOK And LongDistanceNotOK... To
  662.                Very Effectly Lock Out AreaCodes You Wish.  If You
  663.                Simply Wish To Let ALL Long Distance Area Codes Be
  664.                Dialed Or Not Dialed (Based Upon Your UltiCBV Config.)
  665.                Then Simply Leave These Areas Commented Out.
  666.  
  667.                                                                      (Page 11)
  668.         ┌─────────────────────────────────────────────────────────┐
  669.         │▓▒░         UltiCBV - AREA CODES CONFIGURATION<cont>  ░▒▓│
  670.         └─────────────────────────────────────────────────────────┘
  671.  
  672.  
  673.  
  674.  LongDistanceNotOK:  Read Above.  This Will Effectively Lock Out Any Area
  675.                 Code You List As LongDistanceNotOkay.  Even If You
  676.                 Have UltiCBV Set Up To Allow Long Distance Callers
  677.                 ANY Area Codes Which Match What You Specify In The
  678.                 LongDistanceNotOkay Field Will Be Locked Out...
  679.                 Even If You Have UltiCBV Set Up To AutoValidate
  680.                 Long Distance Callers.  Be Very Careful When
  681.                 Setting Up LongDistanceOK And LongDistanceNotOK.
  682.  
  683.  
  684.  International Prefix:  Pretty Self Explainatory.  This Is The Dialing
  685.                  Prefix Needed To Dial "Out Of Country" Calls.
  686.                  In The USA This Would Be 011.
  687.  
  688.  
  689.  IllegalPrefixes:  Here Is Where You Can Effectively Lock Out Calls
  690.                   Made To Area Codes You *NEVER* Want Dialed.  This
  691.                   Should Include 1-900 Numbers,  And Obviously Bogus
  692.                   Area Codes Like 911, 000, 111, Etc.  1-900 And Other
  693.                   Such Area Codes Are "Charge By The Minute" Numbers
  694.                   Which Can Cost You Over $35.00 And Up <On Some
  695.                   Numbers> Just To Connect To.. So Obviously You Would
  696.                   Want These Permenantly Locked Out!
  697.  
  698.  
  699.  IllegalNumbers:  Here Is Where You Can Effectively Lock Out Any Calls
  700.                   To Illegal Numbers Such As 911, 411, 0, 611 And Any
  701.                   Other Number You Can Think Of Which Would Not Lead To
  702.                   A Real Telephone Number.  You Can Also Lock Out
  703.                   Local BBS Numbers,  Twit Users, Whatever.  Remember
  704.                   That UltiCBV Will Also Automatically Check Your
  705.                   Adept PHONECAN File.  So If You Have Numbers Locked
  706.                   Out There, Then There Is No Need To Duplciate Them
  707.                   Here.  However I Would Strongly Suggest Keeping 911
  708.                   And A Few Other Numbers Already Configured Below In
  709.                   Both Files Just To Be Extra Safe.  If You Find Other
  710.                   Illegal Numbers Which SHould Be Locked Out... Leave
  711.                   Me Email In AdeptSoft Support And I'll Make Sure To
  712.                   Add Them Into Future Versions Of UltiCBV.
  713.  
  714.  
  715.  
  716.  
  717.  
  718.   For More Information On The Format Of AreaCodes.CFG,  Read The Sample
  719.   AreaCodes.CFG Supplied In The Distribution Archive.
  720.  
  721.                                                                      (Page 12)
  722.         ┌─────────────────────────────────────────────────────────┐
  723.         │▓▒░            UltiCBV - APPENDICES                   ░▒▓│
  724.         └─────────────────────────────────────────────────────────┘
  725.  
  726.  
  727.   CONTACTING THE AUTHOR:
  728.  
  729.   You can contact me with questions,  problems,  suggestions or questions in
  730.   a variety of ways:
  731.  
  732.  
  733.   Via US Mail to:
  734.  
  735.  
  736.                 John F. Doran
  737.                 209 East 56th Street
  738.                 Suite 11Q
  739.                 New York,  NY  10022
  740.  
  741.  
  742.   Via BBS:
  743.  
  744.  
  745.                 The NightStalker BBS
  746.                 (212) 486-6281
  747.  
  748.  
  749.  
  750.   Via AdeptSoft Support Echo.
  751.  
  752.  
  753.   REGISTRATION froms must be sent via U.S. Mail.
  754.  
  755.  
  756.  
  757.  
  758.   USER RESTRICTIONS:
  759.  
  760.   You Are Granted Permission To Test Out And Review The Ultimate CallBack
  761.   Verifier <Also Known As UltiCBV> For A Period Of No More Than 30 Days.  During
  762.   This 30 Day Test Period,  *ALL* Features Of UltiCBV Will Be Available And In
  763.   Use.  Nothing Will Be Crippled!
  764.  
  765.   Use Of This Program Beyond The 30 Day Evaluation Period Is Illegal And
  766.   Unethical!  If You Continue To Use This Program For Longer Than The Alloted
  767.   30 Day Evaluation Period Without Registering It,  Certain Features Will
  768.   Become Disabled.  Below Is A List Of The Features Which Will Become Affected
  769.   By Non-Registration After 30 Days....
  770.  
  771. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  772.  
  773.  
  774.                                                                      (Page 13)
  775.         ┌─────────────────────────────────────────────────────────┐
  776.         │▓▒░            UltiCBV - APPENDICES <cont>            ░▒▓│
  777.         └─────────────────────────────────────────────────────────┘
  778.  
  779. **************
  780. ULTICBV.ERX
  781. **************
  782.  
  783.  SysOp Logging:  UltiCBV Will No Longer Write Users Info, Validation Attempts
  784.  And Other CallBack Verification Processes To The SysOp Log or SysOp ListBox.
  785.  
  786.  UltiCBV Logging:  UltiCBV Will No Longer Write Users Info, Validation Attempts
  787.  And Other CallBack Verification Proccesses To UltiCBV's Seperate Logs.
  788.  
  789.  UltiCBV Telephone Number Logging.  UltiCBV Will No Longer Log Validated And
  790.  AutoValidated Users Telephone Numbers To The "TELENUMS.LOG" File,  Meaning
  791.  Those Numbers Will *NOT* Be Checked In Future CallBack Verification Attempts
  792.    <In Other Words:  Duplicate Telephone Numbers/Accounts Can Slip Through
  793.     UltiCBV If Unregistered Over 30 Days>.
  794.  
  795.  Users "SysOp Comments" Field Will No Longer Be Updated During CallBack
  796.  Procedures.  They Will Be Left Blank.
  797.  
  798.  Local CallBack Similation Will Be Disabled.
  799.  
  800.  Local SysOp Status Screens During CallBack Verification Attempts Will Be
  801.  Disabled.
  802.  
  803.  
  804. **************
  805. CONFCBV.ERX
  806. **************
  807.  
  808.  The Only Thing Disabled In CONFCBV.ERX For Unregistered SysOps Is The
  809.  Ability To Do Configuration From Remote.  Once Registered,  SysOps Will
  810.  Be Able To Configure UltiCBV Locally AND/OR From Remote.  UnRegistered Users
  811.  Can Still Use CONFCBV.ERX Locally.
  812.  
  813. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  814.  
  815.  *NONE* Of This Affects The User.  All Basic Functions Of UltiCBV Will Still
  816.  Be Available To Them.  They Will *NOT* Recieve Nag Screens,  Unregistered
  817.  Comments... All That Nasty Crap!  Only The SysOp Will Know That UltiCBV Is
  818.  Still UnRegistered!
  819.  
  820.  **HOWEVER**
  821.  
  822.  If You Continue To Use UltiCBV Well Past The 30 Day Trial Period <60 Days
  823.  To Be Exact),  UltiCBV Will Totally And Completely Refuse To Work!  ALL
  824.  Features Of UltiCBV Will Become Automatically Disabled Until It Becomes
  825.  Registered!  The Same Holds True For ConfCBV.  After 60 Days, It Will Become
  826.  Diabled.
  827.  
  828.  
  829. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  830.  
  831.  
  832.  
  833.                                                                      (Page 14)
  834.         ┌─────────────────────────────────────────────────────────┐
  835.         │▓▒░            UltiCBV - REGISTRATION                 ░▒▓│
  836.         └─────────────────────────────────────────────────────────┘
  837.  
  838.  
  839.  
  840.    To Register This Program,  Fill Out The Below Form And Mail It To The
  841.    Address Shown Along With A Check For The Price Shown Below.
  842.  
  843.  
  844.  
  845.                  UltiCBV List Prices As Of 06/06/95..
  846.                  (Registers BOTH UltiCBV And ConfCBV)
  847.  
  848.   2 Node Version:.................................................$ 20.00 (US)
  849.   4 Node Version:.................................................$ 30.00 (US)
  850.   8 Node Version:.................................................$ 40.00 (US)
  851.   16 Node Version:................................................$ 50.00 (US)
  852.  
  853.  
  854.  
  855.   All Upgrades Will Be Available For Downloading Through The NightStalker BBS
  856.   At (212) 486-6281... Or Via One Of My Support Sites.
  857.  
  858.  
  859.   To Register:
  860.  
  861.   Send A Check Or Money Order <No Cash> Made Payble To:
  862.  
  863.                         John F. Doran
  864.  
  865.   And Mail To:
  866.  
  867.                         John F. Doran
  868.                     209 East 56th Street
  869.                         Suite 11Q
  870.                     New York,  NY  10022
  871.  
  872.   (Sorry,  But I Don't Handle Credit Cards At This Point In Time.  If
  873.   There Is Enough Call For My Utilities,  Then I'll Set Myself Up To
  874.   Recieve Faxed Registration And Credit Cards).
  875.  
  876.  
  877.  
  878.         ┌─────────────────────────────────────────────────────────┐
  879.         │▓▒░            UltiCBV - REGISTRATION FORM            ░▒▓│
  880.         └─────────────────────────────────────────────────────────┘
  881.          REGISRATION FORM FOR 'THE ULTIMATE CALLBACK VERIFIER' v1.0
  882.  
  883.  
  884.  Company Name: _____________________________________________________________
  885.   <If Applicable>
  886.  
  887.  SysOp Name:________________________________________________________________
  888.   <This Should Match Exactly With The Name Configured In Adept For SysOp>
  889.  
  890.  Address:___________________________________________________________________
  891.  
  892.  
  893.  City:_________________________  State:__________________ Zip:______________
  894.  
  895.  
  896.  BBS Name:___________________________________________________________________
  897.   <This Should Match Exactly With The Name Configured In Adept For BBS Name>
  898.  
  899.  Voice Number:______________________  BBS Number:__________________________
  900.  
  901.  
  902.  FidoNet:__________________________ (If Available)
  903.  
  904.  
  905.  
  906.   Mr. John Doran,
  907.  
  908.   I am hereby registering UltiCBV Version 1.0.  Enclosed with this form is
  909.   a check or money order in the amount of $______________ (in US Funds) for
  910.   the ________ Node Version Of UltiCBV.  This shows my support for both the
  911.   Shareware concept and to encourage further development of UltiCBV and/or
  912.   other 'Ulti' Utilities written by you for AdeptXBBS.
  913.  
  914.   I further agree not to distribute registered copies of UltiCBV, or its
  915.   registration key(s) without your expiressed written consent.  I further
  916.   agree that if I DO distribute registered versions of UltiCBV or its
  917.   registration key(s) without your prior written consent that I can and will
  918.   be held liable for all copy(s) of the program(s) released.
  919.  
  920.   I understand that UltiCBV is provided 'As-Is' with no warranties implied or
  921.   otherwise,  and that I use UltiCBV at my own risk.
  922.  
  923.   Should I have any comments or suggestions, I understand that I may contact
  924.   you via US Mail at the address listed above,  or through your BBS System
  925.   as listed above.
  926.  
  927.  
  928.   Signed:_________________________________________ Date:____________________
  929.  
  930.  
  931.   (  ) Please add me to your user list on The NightStalker BBS and provide
  932.        me with access to the special directory set up for Registered
  933.        UltiCBV Users, and your other 'Ultimate' line of Utilities for
  934.        AdeptXBBS.
  935.  
  936.  
  937.