home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / ra / mc_cbv10.zip / MC_CBV.DOC < prev    next >
Text File  |  1993-03-16  |  16KB  |  367 lines

  1. ===============================================================================
  2.         Program    : MC_CBV                     Version    : 1.00
  3.         Contact    : Rod Hancock                Date       : Mar 16, 1993
  4.         Voice      : (416) 404-2756             FidoNet    : 1:229/418
  5. ===============================================================================
  6.  
  7.                                  MC_CBV
  8.                       Automated Callback verifier
  9.                                   for
  10.                               RemoteAccess
  11.  
  12.                 Copyright 1992,1993 Motor City Software
  13.                           All Rights Reserved
  14.  
  15. ┌─────────────────────────────────────────────────────────────────────────────┐
  16. │▓▓▓▓▓ Introduction ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  17. └─────────────────────────────────────────────────────────────────────────────┘
  18.  
  19.   This is Motor City Software's CallBack Verification System for RemoteAccess.
  20.  
  21.   This version is written to work with RemoteAccess V1.1x and V2.00 GAMMA.
  22.  
  23.   If the User has less than 10 Minutes remaining when they enter the CallBack
  24.   Door, they will have their time reset to 10 minutes in order to allow them
  25.   to complete the CallBack Process.
  26.  
  27.   The Following Sysop Keys are available:
  28.  
  29.     Alt-C     Chat With User
  30.     Alt-J     Jump To Dos
  31.     Alt-R     Return To BBS
  32.     UpArrow   Add 1 Minutes Time
  33.     DownArrow Deduct 1 Minutes Time
  34.  
  35.   While MC_CBV is calling the user back, you may abort by hitting ESCAPE.
  36.  
  37. ┌─────────────────────────────────────────────────────────────────────────────┐
  38. │▓▓▓▓▓ Setup ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  39. └─────────────────────────────────────────────────────────────────────────────┘
  40.  
  41.   Run CBVSetup to configure the CallBack Verifier.
  42.  
  43.  
  44.   SYSTEM INFORMATION
  45.   ==================
  46.  
  47.   Full Path to Users.BBS
  48.     This is the full path, including trailing backslash to your USERS.BBS This
  49.     is used to find the Users.BBS (If scanning it for dupe #'s) and the Message
  50.     base files.
  51.  
  52.   Your City & State Location
  53.     The location of your BBS. This should be accurate, as it is used when
  54.     asking the user if the phone number is correct when dialed from this
  55.     location. Eg. Does 555-5555 look correct to call you from Oshawa Ontario?
  56.  
  57.   Use RA Extended Log Format
  58.     Not implemented yet (uses Extended RA log format)
  59.  
  60.   Choose Phone Number Format
  61.     "0" for US style
  62.     "1" for European style (This door hasn't been tested using Unformatted #'s)
  63.  
  64.   Check for Duplicate Number
  65.     "0" Do Not Check For Dupes
  66.     "1" Check Numbers Already Called by MC-CBV
  67.     "2" Check Voice & Data Numbers From USERS.BBS
  68.  
  69.     If Set to "1" or "2" then this will force the CBV to REFUSE to call a
  70.     duplicate number. Note this will be a problem if you have more than one
  71.     user in a family for instance. NOTE, The Callback Door KNOWS which version
  72.     of RemoteAccess you are using, and will use the correct USERS.BBS
  73.     structures when reading that file.
  74.  
  75.   Message Base To Use
  76.     If you want the Callback Door to send messages to the Sysop or User, then
  77.     you may enter the message base # here. If you set it to 0, then CBV will
  78.     NOT post any messages. NOTE this supports ONLY the Hudson Message Base.
  79.  
  80.  
  81.  
  82.   MODEM INFORMATION
  83.   =================
  84.  
  85.   Modem Init STRING
  86.     String to initialize your modem. MUST include | on end of string!
  87.  
  88.   Make Long Distance CallBack
  89.     Allow LD users to do callback?
  90.  
  91.   # of Times to Redial Number
  92.     How many time should you try to call the user back.
  93.  
  94.   # of PassWord Attempts to allow
  95.     Give the user how many tries at their password?
  96.  
  97.   Wait How Long for Carrier
  98.     Time to allow for your modem to hangup on the user, call the user back,
  99.     wait for the user to figure out how to type in ATA and hit Enter, and for
  100.     the modem to connect to the person it called.  You must also allow time for
  101.     the user to figure out your modem is calling and type in ATA and hit Enter
  102.     until their modem responds.  Remember, a lot of users have internal modems
  103.     with no lights so keep this in mind. AT LEAST 30 seconds is recommended.
  104.  
  105.   Delay Before Redail Number
  106.     Wait how long between retries to callback the user.
  107.  
  108.   Dial Out Prefix
  109.     ATDT or ATDP normally
  110.  
  111.   Long Distance Prefix
  112.     Number added before hpone number to call Long Distance numbers, normally
  113.     1- in the US.
  114.  
  115.   Your Area Code
  116.     Your LOCAL area code.
  117.  
  118.   Hangup After L/D Call
  119.     If you allow LD call backs, should MC_CBV hangup immediately after the
  120.     callback is successful? (ie. If you say no here YOU WILL have to pay for
  121.     the user to use your BBS for however long they take on this call.
  122.  
  123.   Hangup After Local Call
  124.     Same as hangup after LD for those cases where YOU have to pay for the
  125.     phone call.
  126.  
  127.  
  128.  
  129.   USER INFORMATION
  130.   ================
  131.  
  132.   Validate Via Auto EMSI
  133.     If the user logged on using EMSI should they be automatically validated?
  134.  
  135.   Log Off Twit Not-Valid User
  136.     Should the program hang up on a user that the system is configured to be
  137.     able to callback, but refuses to use it?
  138.  
  139.   LockOut Twit Not-Valid User
  140.     Should the program LOCK OUT a user that the system is configured to be
  141.     able to callback, but refuses to use it?
  142.  
  143.   Allow User to Change Number
  144.     Should the user be allowed to enter another phone number to call their
  145.     modem at? An example would be the user is calling from a friends house
  146.     etc.
  147.  
  148.   Make Bulletin of Twit Users
  149.     Should a list of those who, for one reason or another, refuse to use the
  150.     callback?
  151.  
  152.   Min Level to NOT Use CBV
  153.     Security level at which the program should just exit and tell the user that
  154.     he/she is already validated.
  155.  
  156.   Validated New CBV Flags
  157.     RA user flags to give a user who successfully completes the callback.
  158.     This also includes Long Distance and IEMSI users if you validate them
  159.     without calling them.
  160.     The following characters may be entered here:
  161.       X  Turn This Flag ON
  162.       -  Turn This Flag OFF
  163.       ?  DO NOT Change This Flag
  164.       *  Toggle This Flag (If ON, Turn It OFF, If OFF, Turn It ON)
  165.  
  166.   UpDate Users Security After
  167.     Should MC_CBV raise the users security level if they do the callback right?
  168.  
  169.   Validated Security Level
  170.     Security level to give a user who uses the callback successfully.
  171.  
  172.   Security Level for LD User
  173.     Security to give an LD caller if you don't allow LD callbacks.
  174.  
  175.   Non-Validated User SubDays
  176.   Registered Version Only
  177.     If this is 0, then the users Subscription Expiry Date is NOT updated.
  178.     You may enter a number from 1 to 1000 for the number of days until the
  179.     users BBS Account expires. This is for users who would not use the CBV
  180.     or those who did not reconnect and get updated.
  181.  
  182.   Validated User SubDays
  183.   Registered Version Only
  184.     If this is 0, then the users Subscription Expiry Date is NOT updated.
  185.     You may enter a number from 1 to 1000 for the number of days until the
  186.     users BBS Account expires. This is for users who the CBV DID call back
  187.     and reconnect with. This includes IEMSI logons if you update them without
  188.     callback.
  189.  
  190.   Long Distance User SubDays
  191.   Registered Version Only
  192.     If this is 0, then the users Subscription Expiry Date is NOT updated.
  193.     You may enter a number from 1 to 1000 for the number of days until the
  194.     users BBS Account expires. This is for Long Distance users if you do not
  195.     allow LD Callbacks.
  196.  
  197. ┌─────────────────────────────────────────────────────────────────────────────┐
  198. │▓▓▓▓▓ Command line parameters ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  199. └─────────────────────────────────────────────────────────────────────────────┘
  200.  
  201.   Usage: MC_CBV /N2 /NoAC
  202.  
  203.     /N Defines the node number using CBV. You may use /N*N on the optional data
  204.        line in the RA Menu option.
  205.  
  206.     /NoAC If the number is in your area code, but not a local call, then do NOT
  207.           dial the area code. It will still insert a  1- before the  number but
  208.           the area code is stripped out.
  209.  
  210.  
  211.     Example:  D:\BBS\CBV\MC_CBV.EXE /N*N
  212.  
  213.     If No Command Line Parameters are used, then it defaults to NODE 1.
  214.  
  215.     Place MM_CBV.EXE in its own directory,  and call the  MC_CBV.EXE  from your
  216.     Top Menu as a type 7. It will look for the  EXITINFO.BBS  and  DORINFO1.DEF
  217.     in the CURRENT Directory.
  218.  
  219. ┌─────────────────────────────────────────────────────────────────────────────┐
  220. │▓▓▓▓▓ Optional Message Template Files ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  221. └─────────────────────────────────────────────────────────────────────────────┘
  222.  
  223.   MC_CBV  will  Post  Messages to the  Sysop if certain  Message Template Files
  224.   exist  AND  you have chosen a valid  Hudson  Message Base in  CBVSetup. These
  225.   files are  ASCII  Text files created using any text editor.  We have included
  226.   samples in an archive called  MESSAGES.ARJ  In each of these files,  you will
  227.   notice that line 1 contains the SUBJECT of the message. The rest of the lines
  228.   may contain whatever you like,  and the following  TextFile Control Codes are
  229.   Valid. (As used in RemoteAccess)
  230.  
  231.     ^FA - Current Users Full Name
  232.     ^FO - Current Users Security Level
  233.     ^F4 - Date of Current Users FIRST Call to BBS
  234.     ^F6 - Current Users Subscription Expiry Date
  235.     ^FE - Current Users Voice Phone Number
  236.     ^FD - Current Users Data Phone Number
  237.     ^F3 - Current Users Handle
  238.     ^FB - Current Users Location
  239.  
  240.   The following  Templates have been included,  and if they exist,  and a valid
  241.   Hudson Message Base has been chosen, will cause a message to be written. Feel
  242.   free to modify these as you see fit.
  243.  
  244.     NONEED.MSG    - Registered Version Only
  245.                     If this template exists in the same directory as MC_CBV.EXE
  246.                     and a user has a  high enough security level to exempt them
  247.                     from using CBV, this message will be posted to alert you.
  248.  
  249.     NOTUSED.MSG   - Registered Version Only
  250.                     If this template exists in the same directory as MC_CBV.EXE
  251.                     and the user for whatever reason does NOT use the CBV, then
  252.                     this will alert you.  Once the template has been posted,  a
  253.                     one line  Reason is added to the message,  explaining where
  254.                     the user Quit.
  255.  
  256.     VERIFIED.MSG  - Registered Version Only
  257.                     If this template exists in the same directory as MC_CBV.EXE
  258.                     then this  message will be  posted to you when the user has
  259.                     completed the callback process.
  260.  
  261.     LDUPDATE.MSG  - Registered Version Only
  262.                     If this template exists in the same directory as MC_CBV.EXE
  263.                     and you update LD callers without calling them back, this
  264.                     message will be posted to you.
  265.  
  266.     IEMSI.MSG     - Registered Version Only
  267.                     If this template exists in the same directory as MC_CBV.EXE
  268.                     and you automatically update IEMSI users, then this message
  269.                     will be posted to you.
  270.  
  271.     FAILPW.MSG    - Registered Version Only
  272.                     If this template exists in the same directory as MC_CBV.EXE
  273.                     and the user reconnects,  but gets the password wrong, then
  274.                     this message will be posted to you.
  275.  
  276.     WELCOME.MSG   - If this template exists in the same directory as MC_CBV.EXE
  277.                     then it will be posted to the  USER when they are verified.
  278.                     This will include  IEMSI  and  LD users if you  update them
  279.                     without doing the callback.  This can be used to  give them
  280.                     more information about joining your  BBS,  or anything  you
  281.                     desire. This message will be posted  TO the User,  From the
  282.                     Sysop as defined in Dorinfo1.Def
  283.  
  284.     NOTE: If you are NOT registered, then the ONLY Message that you may post is
  285.           WELCOME.MSG  to the  user.  A reminder is written to the  end of this
  286.           message stating that this is an  Unregistered  Evaluation  Copy,  and
  287.           requires registration after evaluating it.
  288.  
  289. ┌─────────────────────────────────────────────────────────────────────────────┐
  290. │▓▓▓▓▓ Optional Information text files ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  291. └─────────────────────────────────────────────────────────────────────────────┘
  292.  
  293.   MC_CBV  allows up to  7  text files to be used to  describe the door  for the
  294.   users.  If the file isn't present then  MC_CBV  will use default text.  These
  295.   files should be located in the same directory as MC_CBV.EXE  Samples of these
  296.   files are included in the archive CBV_TEXT.ARJ
  297.  
  298.   Brief descriptions are as follows:
  299.  
  300.    The files support the RA Text File Control Codes for UserName, Phone Numbers
  301.    etc.
  302.  
  303.    ADDPHONE.TXT - Displayed to user before showing ASKPHONE.TXT
  304.  
  305.    ASKPHONE.TXT - Message to the  User to see if the  phone  number looks right
  306.                   before before calling.
  307.  
  308.    EXPLAIN.TXT  - If the user did not understand how to use the CBV,  then this
  309.                   is where you may  try to  explain it  one last time.  If they
  310.                   still do not understand, then the door will exit and you will
  311.                   have to verify them another way, or they may try again.
  312.  
  313.    LOCHANG.TXT  - Tells the  User why the door is  hanging up  on  them after a
  314.                   successful local callback.
  315.  
  316.    LDHANG.TXT   - Tells the  User  why the  door is hanging up  on them after a
  317.                   successful long distance callback.
  318.  
  319.    NO_LD.TXT    - Shown to Long Distance users if you don't allow LD calls.
  320.  
  321.    PRECALL.TXT  - Shown just prior to dialing the users number and explains how
  322.                   to make their modem answer when they are called.
  323.  
  324.    TELSYSOP.TXT - Message to user if  they say the  number  the door  will call
  325.                   them at doesn't look right.
  326.  
  327.    UINFO.ANS    - This is the User Information Screen.  This one allows  you to
  328.                   create an ANS and an ASC version.
  329.  
  330. ┌─────────────────────────────────────────────────────────────────────────────┐
  331. │▓▓▓▓▓ Data text files ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  332. └─────────────────────────────────────────────────────────────────────────────┘
  333.  
  334.   Samples are provided in the archive EXAMPLES.ARJ
  335.   Data Text files:  (* - means it's required)
  336.  
  337.   * MC_CBV.LOC - List of the  AREA CODE  AND  First 3 Numbers  of phone numbers
  338.                  that are local to you.  Example 416-579   If the  area code is
  339.                  the  same as that in  CBVSetup,  then it is  stripped from the
  340.                  phone number  when it is dialed.  If you have OTHER area codes
  341.                  which are local,  then you may also add them to this file, and
  342.                  the area code will  NOT be stripped when those are dialed. The
  343.                  number will simply be dialed as  AAA-NNN-NNNN where AAA is the
  344.                  area code, and NNN-NNNN is the rest of the number. IF you MUST
  345.                  dial a 1 in front of this 'local' area code, you  may add a 1-
  346.                  in FRONT of the AREA CODE in the MC_CBV.LOC file. For example,
  347.                  804-256 is  local,  but  requires a  1 in front,  then you put
  348.                  1-804-256 in here and it will dial the 1 first.  I am not very
  349.                  familiar with having more than one local area code,  so if you
  350.                  have  ANY  problems,  contact us and we'll  fix it up for your
  351.                  particular needs.
  352.  
  353.                  YOU MUST MAKE THIS FILE!
  354.  
  355.     MC_CBV.LOG - Log of the doors activity.  Made by the door.
  356.  
  357.     MC_CBV.BAD - List of phone number NOT TO CALL (ie your local police station
  358.                  fire station, etc.)  MC_CBV will  automatically not call  411,
  359.                  911, 900 numbers and 555-1212 (directory assistance). You have
  360.                  to make this file if you want to define other Bad Numbers.
  361.  
  362.     MC_CBV.OK  - List of numbers the door has successfully called.
  363.  
  364.     MC_CBV.TWT - Semi-informative Log of twits using the door.
  365.  
  366.  
  367.