home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / CVS12RA.ZIP / CVS.DOC < prev    next >
Encoding:
Text File  |  1995-08-06  |  19.3 KB  |  480 lines

  1.  
  2.                            ▄█████▄ ██   ██ ▄█████▄
  3.                            ██      ██   ██ ██▄▄▄▄
  4.                            ██      ██▄ ▄██  ▀▀▀▀██
  5.                            ▀█████▀  ▀███▀  ▀█████▀
  6.  
  7.             
  8.               Copyrighted Multiboard Communications Centre, 1995
  9.                         All rights reserved, worldwide.
  10.  
  11.  
  12. ╓───────────────────────────────────────────────────────────────────────────╖
  13. ║ What is it?                                                               ║
  14. ╙───────────────────────────────────────────────────────────────────────────╜
  15.  
  16.     A friendly, easy to use  callback verifier, with many  configurable
  17.     options, such as bad and duplicate phone number scanning, LD calls,
  18.     message posting, call collision detection and much more.
  19.  
  20.  
  21. ╓───────────────────────────────────────────────────────────────────────────╖
  22. ║ CVSSETUP.EXE - Configuration program                                      ║
  23. ╙───────────────────────────────────────────────────────────────────────────╜
  24.  
  25.     CVS is very easy to install.
  26.  
  27.       1) First, unpack the contents of the archive into a directory
  28.       2) Run the CVSSETUP.EXE program...
  29.  
  30.  
  31.     System Information
  32.     ──────────────────────────────────────────────────────────────────
  33.  
  34.           ═══ BBS name
  35.  
  36.                   The name of your BBS.
  37.  
  38.           ═══ Sysop name
  39.  
  40.                   This is your name.  When registering,  it is
  41.                   imperative that you specify the name exactly
  42.                   as it appears  here INCLUDING  WHICH LETTERS
  43.                   ARE CAPITALS.  For example the name  'Darryl
  44.                   Olthoff' and 'Darryl olthoff' are  different
  45.                   Sysop names as the "O" is uppercase  in one,
  46.                   and lower case in the other.  The  same goes
  47.                   for the System name above.
  48.  
  49.           ═══ Serial #
  50.  
  51.                   Here you the serial number that was received
  52.                   with your  registration code.  Please ensure
  53.                   that  this number is input  correctly or CVS
  54.                   will still claim unregistered.
  55.  
  56.           ═══ Registration #
  57.  
  58.                   Here you  enter the registration number that
  59.                   was received  with the purchase of CVS.   If
  60.                   this code is  entered incorrectly, then your
  61.                   copy of CVS will claim to be unregistered.
  62.  
  63.           ═══ Path to USERS.BBS
  64.  
  65.                   This is where you enter the path to the user
  66.                   file.  If  the file  does not exist  in  the
  67.                   path, you will be warned, however the change
  68.                   will be allowed.
  69.  
  70.           ═══ Path to JAMBASE
  71.  
  72.                   The path to  the jambase must  also  include
  73.                   the message area you would like the messages
  74.                   posted to.  Once  again, you will  be warned
  75.                   if the file  doesn't exist,  but will permit
  76.                   the change.
  77.  
  78.  
  79.     Data Checking
  80.     ───────────────────────────────────────────────────────────────────
  81.  
  82.           ═══ Check for duplicate numbers
  83.  
  84.                   If you would like to check  the phone number
  85.                   to the other  users number, set  this option
  86.                   to YES.
  87.  
  88.  
  89.           ═══ Security level to check against
  90.  
  91.                   When  checking for duplicate  phone numbers,
  92.                   CVS by default checks all users. If you wish
  93.                   to check for duplicate numbers against users
  94.                   with security levels  greater than a certain
  95.                   number, you  can change  it  by setting  the
  96.                   environment variable to the  desired number.
  97.                   If you do  not set the  environment variable
  98.                   duplicate  numbers will  be checked  against
  99.                   users  who have a security  greater than  or
  100.                   equal to 0.  This used to be  available only
  101.                   by setting an environment variable.  If both
  102.                   environment  variable and  this is set,  but
  103.                   contain  different values then  the variable
  104.                   set in the environment will be used.
  105.  
  106.  
  107.           ═══ Action on duplicate numbers
  108.  
  109.                   If  you  are  checking for  duplicate  phone
  110.                   numbers, then there  are three options.  You
  111.                   can abort  the CVS door, you  can hang up on
  112.                   user, or you  can let  him continue with the
  113.                   door.  The default is  to ABORT the  program
  114.                   if the user fails the duplicate check.  This
  115.                   can only be  changed in the  registered copy
  116.                   of CVS.
  117.  
  118.  
  119.           ═══ Allow user to change phone #
  120.  
  121.                   This option lets  you decide whether  or not
  122.                   allow your users to  change the phone number
  123.                   they will be called back at.
  124.  
  125.  
  126.           ═══ Format of the phone #
  127.  
  128.                   This  option lets you  decide the  format of
  129.                   the phone  number.   You can format  it with
  130.                   dashes,  or let it remain  the way  the user
  131.                   entered it.
  132.  
  133.  
  134.           ═══ Default Area Code
  135.  
  136.                   The default  areacode is  the areacode  that
  137.                   will be  entered if  the user does not enter
  138.                   an areacode.
  139.  
  140.  
  141.           ═══ Modify comment field on a fail
  142.  
  143.                   This  option will modify  the users  comment
  144.                   field, indicating why he failed the callback
  145.                   verifier.
  146.  
  147.  
  148.     Program Settings
  149.     ───────────────────────────────────────────────────────────────────
  150.  
  151.        LD Options
  152.        ══════════
  153.  
  154.           ═══ Verify LD Callers
  155.  
  156.                   If you don't mind calling  the long distance
  157.                   to validate your users, the turn this option
  158.                   to YES.  The  default is to only  call LOCAL
  159.                   numbers.  This option can only be changed in
  160.                   the registered copy of CVS.
  161.  
  162.  
  163.           ═══ Action on verified LD callers
  164.  
  165.                   Once the user has verified his name, you can
  166.                   either let  the user  continue his call,  or
  167.                   hangup.  This  option is only  available  in
  168.                   the registered copy of CVS.
  169.  
  170.        Phone Options
  171.        ═════════════
  172.  
  173.           ═══ Dialing Method
  174.  
  175.                   Would you  like to  dialout using the tones,
  176.                   or the pulse?
  177.  
  178.  
  179.           ═══ Initialization String
  180.  
  181.                   This is the modem initialization string. Use
  182.                   whatever options your modem requires.
  183.  
  184.  
  185.           ═══ Dialing Attempts
  186.  
  187.                   This option allows you to set how many times
  188.                   the user  should be  called.  CVS will  call
  189.                   user this many  times, or until a connection
  190.                   is made.
  191.  
  192.        Callback Options
  193.        ════════════════
  194.  
  195.           ═══ Name entry attempts
  196.  
  197.                   This allows  you to set  the number of times
  198.                   that  a user  can enter  his name  to verify
  199.                   with CVS.
  200.  
  201.  
  202.           ═══ Passing Security
  203.  
  204.                   This is the security level  the user will be
  205.                   given when correctly verifying the name.
  206.  
  207.  
  208.           ═══ Failing Security
  209.  
  210.                   This is the security level  the user will be
  211.                   given when incorrectly verifying the name.
  212.  
  213.  
  214.           ═══ Subscription Days
  215.                                                              .
  216.                   This  option  will  enter  the  subscription
  217.                   expiry date.   If the value is set to 0 then
  218.                   no date  will be entered.   This  feature is
  219.                   only available  in the registered version of
  220.                   CVS.  The default is 0.
  221.  
  222.  
  223.     File Based Settings
  224.     ──────────────────────────────────────────────────────────────────
  225.  
  226.           ═══ CVS.CTL
  227.  
  228.                   The local  prefix section  lists area  codes
  229.                   that you are  willing to  call, usually your
  230.                   specific area code will be sufficient.
  231.  
  232.                    [LOCAL PREFIX]
  233.                    519-      Allows 519 area code to be called
  234.  
  235.                    The bad phone  numbers section  lists phone
  236.                    numbers that can not be called.  Police and
  237.                    delivery numbers might be a good idea.  The
  238.                    number, if it is not a complete number must
  239.                    be trailed by a  -  or any number with that
  240.                    sequence will  be denied.  Lines  beginning
  241.                    with a ; will not be read.  This is so that
  242.                    phone numbers can be commented.
  243.  
  244.                    [BAD PHONE NUMBERS]
  245.                    434-4444
  246.                    ;Kentucky Fried Chicken Delivery
  247.                    911-
  248.                    ;Police emergency
  249.                    976-
  250.                    ;Pay per call lines
  251.                    000-
  252.                    ;Operator
  253.  
  254.                    If you were  to simply use 0 to deny access
  255.                    the operator,  then all phone  numbers with
  256.                    the number 0 will be denied.  (ie 660-1234)
  257.                    This file  must exist in  the same  path as
  258.                    the executable.
  259.  
  260.           
  261.           ═══ CVSHELP
  262.  
  263.                   This file can  be both ANSI and ASCII.  This
  264.                   allows the sysop  to create  custom help for
  265.                   their users.  Only the .ASC file  must exist
  266.                   for display, but  ANSI users might  enjoy an
  267.                   ANSI screen.  This file must be located with
  268.                   the executable.
  269.  
  270.           ═══ SYSOP.MSG
  271.  
  272.                   If this file is found in  the same directory
  273.                   as the executable, this message will be sent
  274.                   to the sysop, once the door has successfully
  275.                   been completed.  This file can be editted to
  276.                   use all possible METASTRINGS. (Below)
  277.  
  278.                   Available METASTRINGS:
  279.  
  280.                      %USER%              Users name
  281.                      %FIRST%             Users first name
  282.                      %LAST%              Users last name
  283.                      %HANDLE%            Users handle
  284.                      %LOCATION%          Users location
  285.                      %DATAPHONE%         Users data phone number
  286.                      %VOICEPHONE%        Users voice phone number
  287.                      %NODE%              Node user called on
  288.                      %SEX%               Users gender
  289.                      %DAILYTIMELIMIT%    Users daily time limit
  290.                      %TIMEDEDUCTED%      Time deducted  
  291.                      %TIMEELAPSED%       Time elapsed
  292.                      %CALLS%             Number of calls by user
  293.                      %SECURITY%          Users security
  294.                      %TIMELIMIT%         Users time limit
  295.                      %TIMELEFT%          Users time left    
  296.                      %CALLTIME%          Time user called
  297.                      %CALLDATE%          Date user called
  298.                      %LASTCALLTIME%      Last time user called
  299.                      %LASTCALLDATE%      Last date user called
  300.                      %SUBEXPIRE%         Date subscription expires
  301.                      %BIRTHDATE%         Users date of birth
  302.                      %BBS%               Board name
  303.                      %SYSOP%             Sysop name
  304.                      %NUMBERSELECTED#%   # 1-9 lists selected numbers
  305.                      %NUMBERSELECTED%    Last number dialed
  306.                      %NUMBERSTATUS#%     # 1-9 lists numbers status 
  307.                      %NUMBERSTATUS%      Last number's status
  308.                      %CALLSTATUS#%       # 1-9 lists the connection attempts
  309.                      %CALLSTATUS%        Last connection attempt
  310.                      %USERSTATUS%        User status (Pass, Failed)
  311.  
  312.  
  313.           ═══ USERPASS.MSG
  314.  
  315.                   If this file is found in  the same directory
  316.                   as the executable, this message will be sent
  317.                   to the user,  once the door has successfully
  318.                   been completed.  This file can be editted to
  319.                   use all possible METASTRINGS.
  320.  
  321.            ═══ USERFAIL.MSG
  322.  
  323.                   If this file is found in  the same directory
  324.                   as the executable, this message will be sent
  325.                   to the user,  once the door has successfully
  326.                   been completed.  This file can be editted to
  327.                   use all possible METASTRINGS.
  328.  
  329.  
  330.  
  331.     Environment Settings
  332.     ──────────────────────────────────────────────────────────────────
  333.  
  334.            ═══ SET CVS=DUPELEVEL:##
  335.  
  336.                   When  checking for duplicate  phone numbers,
  337.                   CVS by default checks all users. If you wish
  338.                   to check for duplicate numbers against users
  339.                   with security levels  greater than a certain
  340.                   number, you  can change  it  by setting  the
  341.                   environment variable to the  desired number.
  342.                   If you do  not set the  environment variable
  343.                   duplicate  numbers will  be checked  against
  344.                   users  who have a security  greater than  or
  345.                   equal to 0.  This will override  the setting
  346.                   in the cvs.cfg file.
  347.  
  348.            ═══ SET CVS=COMMENT:YES/NO
  349.  
  350.                   Comments will modify the users comment field
  351.                   to a  description of why  the number did not
  352.                   pass the check.  It will let you know if the
  353.                   number was a duplicate number, a bad number,
  354.                   or a LD number, if you do not allow ld calls
  355.                   from  your system.   If you  do not set this
  356.                   variable,  then by default  there will be no
  357.                   commenting.  This will override  the setting
  358.                   in the cvs.cfg file.
  359.  
  360.                   Please use a space, a comma, or a semi-colon
  361.                   to  separate the two  environment variables,
  362.                   or the program may not operate as you intend
  363.                   it to.
  364.  
  365.                   Remember that you can remove the environment
  366.                   variable  after you run the  program from  a
  367.                   batch file.  For example:
  368.  
  369.                   @ECHO OFF
  370.                   SET CVS=DUPELEVEL:10,COMMENT:YES
  371.                   CVS %1
  372.                   SET CVS=
  373.  
  374.  
  375. ╓───────────────────────────────────────────────────────────────────────────╖
  376. ║ CVS.EXE - The program                                                     ║
  377. ╙───────────────────────────────────────────────────────────────────────────╜
  378.  
  379.     CVS can be run from any directory that you like.  You must  pass CVS
  380.     the EXITINFO.BBS file so that it can access the users data.  This is
  381.     so that  RemoteAccess  will read back any  changes made to the users
  382.     statistics.   The files that come with  CVS  should all be placed in
  383.     the same directory, as  CVS will look for them in the directory that
  384.     the CVS.EXE file is in.
  385.  
  386.     In RemoteAccess this is how the command setup would look.
  387.  
  388.     *C /C C:\RA\DOORS\CVS.BAT *N *M
  389.  
  390.     This calls a batch file that will run the  CVS door.  The batch file
  391.     is included in the archive.
  392.  
  393.  
  394. ╓───────────────────────────────────────────────────────────────────────────╖
  395. ║ Support                                                                   ║
  396. ╙───────────────────────────────────────────────────────────────────────────╜
  397.  
  398.    If you have any questions or comments, you  can netmail me at FidoNet
  399.    address 1:2401/305 (CM,VFC,V32).    Please poll back for your replies
  400.    as we get dozens of messages a day, and crashing them all out is just
  401.    too expensive -  or optionally,  make a note that you would like your
  402.    message routed back to you.  You can also contact me via the Internet
  403.    for faster responses, and directly sent out replies.   The address is
  404.    "support@mbcc.com"   Normally you will find me in the RA_UTIL FidoNet
  405.    area as well, as well as the MCC_SUPPORT echo of course.   The latest
  406.    version can always be FREQ'd from me with the magic name CVS.   Also,
  407.    newest MCC software is also now available via the Internet at... 
  408.    
  409.    ftp://  ra.fileshop.com/pub/ra/mcc
  410.    ftp://  ra.uti.com/sys/bbs/bbs/mcc
  411.    www://  www.uti.com/mcc
  412.  
  413.    You can also FREQ the files from us via Fidonet,  the  magic names to
  414.    file request are: OLMS,  UPCHECK, SPORTS,  ISERVER, GIFSEE,  VOTEBOX,
  415.    QF and CVS.
  416.  
  417.  
  418. ╓───────────────────────────────────────────────────────────────────────────╖
  419. ║ Registration                                                              ║
  420. ╙───────────────────────────────────────────────────────────────────────────╜
  421.  
  422.     ■ REGISTER.CAN - registration form for Canada
  423.     ■ REGISTER.USA - registration form for USA
  424.     ■ REGISTER.ASA - registration form for ASIA
  425.     ■ REGISTER.AUS - registration form for Australia
  426.  
  427.  
  428. ╓───────────────────────────────────────────────────────────────────────────╖
  429. ║ License and Disclaimer                                                    ║
  430. ╙───────────────────────────────────────────────────────────────────────────╜
  431.  
  432.     "CVS" is NOT free,  it is being  marketed under  the "try before you
  433.     buy" or shareware concept.  You are entitled to use CVS and CVSSETUP
  434.     for  a period  up to  forty-five (45) days,  after  which  you  MUST
  435.     register or stop using the program.
  436.  
  437.     Registration entitles  you to  use  CVS 1.1  as well  as  any future
  438.     versions of the program that may or may not be released,  subject to
  439.     any additional licensing conditions which may be attached.
  440.  
  441.     Registration  will also you to use all of the available functions of
  442.     CVS, take  away  the "Unregistered" message at start up, and help to
  443.     continue  to  develop  this program.  (not to  mention maintain  the
  444.     legality of this agreement)
  445.  
  446.     By running any of the  executable programs included,  you agree that
  447.     Pete Rocca, Darryl Olthoff, Multiboard Communications Centre nor any
  448.     affiliates of  the above mentioned  are responsible  for any  damage
  449.     ever  experienced, however  so created. If you cannot agree to this,
  450.     then your privilege to use any of these programs  is revoked  and it
  451.     becomes illegal for you to execute  any programs included with  this
  452.     documentation.
  453.  
  454.     You may freely copy and  distribute the  shareware version of CVS as
  455.     long as its original archived contents  are not modified in any way.
  456.     You may NOT  distribute any  registration keys  without the  express
  457.     written  consent of Pete Rocca  of Multiboard Communications Centre.
  458.     You may  not use a registration key that  is not  licensed to you by
  459.     Pete Rocca, or any of the registration sites appointed by Pete Rocca
  460.  
  461.     It is illegal to edit, alter, hack, reverse engineer and / or modify
  462.     any components of the CVS archive in any manner.
  463.  
  464.     If dispute of any issues on legal grounds said above, then governing
  465.     law of Ontario, Canada will rule.
  466.  
  467.     If you agree to all of the above,  then you  may use these programs.
  468.  
  469.     * REMEMBER THAT REGISTRATION IS QUITE INEXPENSIVE FOR ALL YOU GET! *
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.                                      
  480.