home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / CVS13RA.ZIP / CVS.DOC < prev    next >
Encoding:
Text File  |  1996-01-01  |  22.6 KB  |  539 lines

  1.  
  2.                            ▄█████▄ ██   ██ ▄█████▄
  3.                            ██      ██   ██ ██▄▄▄▄
  4.                            ██      ██▄ ▄██  ▀▀▀▀██
  5.                            ▀█████▀  ▀███▀  ▀█████▀
  6.  
  7.             
  8.              Copyrighted Multiboard Communications Centre, 1995-96
  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.           ═══ Validation Entry Type
  196.  
  197.                   You can choose whether the user should enter
  198.                   their name or their  password, when they are
  199.                   called back.  The third option allows you to
  200.                   have the user enter their password, and have
  201.                   the password stored in the comment field.
  202.  
  203.  
  204.           ═══ Entry attempts
  205.  
  206.                   This allows  you to set  the number of times
  207.                   that  a user  can enter his name or password
  208.                   to verify with CVS.
  209.  
  210.  
  211.           ═══ Passing Security
  212.  
  213.                   This is the security level  the user will be
  214.                   given when correctly verifying the name.
  215.  
  216.  
  217.           ═══ Failing Security
  218.  
  219.                   This is the security level  the user will be
  220.                   given when incorrectly verifying the name.
  221.  
  222.  
  223.           ═══ Subscription Days
  224.                                                              .
  225.                   This  option  will  enter  the  subscription
  226.                   expiry date.   If the value is set to 0 then
  227.                   no date  will be entered.   This  feature is
  228.                   only available  in the registered version of
  229.                   CVS.  The default is 0.
  230.  
  231.  
  232.     File Based Settings
  233.     ──────────────────────────────────────────────────────────────────
  234.  
  235.           ═══ CVS.CTL
  236.  
  237.                   The local  prefix section  lists area  codes
  238.                   that you are  willing to  call, usually your
  239.                   specific area code will be sufficient.
  240.  
  241.                    [LOCAL PREFIX]
  242.                    519-      Allows 519 area code to be called
  243.  
  244.                    The bad phone  numbers section  lists phone
  245.                    numbers that can not be called.  Police and
  246.                    delivery numbers might be a good idea.  The
  247.                    number, if it is not a complete number must
  248.                    be trailed by a  -  or any number with that
  249.                    sequence will  be denied.  Lines  beginning
  250.                    with a ; will not be read.  This is so that
  251.                    phone numbers can be commented.
  252.  
  253.                    [BAD PHONE NUMBERS]
  254.                    434-4444
  255.                    ;Kentucky Fried Chicken Delivery
  256.                    911-
  257.                    ;Police emergency
  258.                    976-
  259.                    ;Pay per call lines
  260.                    000-
  261.                    ;Operator
  262.  
  263.                    If you were  to simply use 0 to deny access
  264.                    the operator,  then all phone  numbers with
  265.                    the number 0 will be denied.  (ie 660-1234)
  266.                    This file  must exist in  the same  path as
  267.                    the executable.
  268.  
  269.           
  270.           ═══ CVSHELP
  271.  
  272.                   This file can  be both ANSI and ASCII.  This
  273.                   allows the sysop  to create  custom help for
  274.                   their users.  Only the .ASC file  must exist
  275.                   for display, but  ANSI users might  enjoy an
  276.                   ANSI screen.  This file must be located with
  277.                   the executable.  The file  must  be entitled
  278.                   CVSHELP.ASC or CVSHELP.ANS.
  279.  
  280.           ═══ SYSOP.MSG
  281.  
  282.                   If this file is found in  the same directory
  283.                   as the executable, this message will be sent
  284.                   to the sysop, once the door has successfully
  285.                   been completed.  This file can be editted to
  286.                   use all possible METASTRINGS. (Below)
  287.  
  288.                   Available METASTRINGS:
  289.  
  290.                      %USER%              Users name
  291.                      %FIRST%             Users first name
  292.                      %LAST%              Users last name
  293.                      %HANDLE%            Users handle
  294.                      %LOCATION%          Users location
  295.                      %DATAPHONE%         Users data phone number
  296.                      %VOICEPHONE%        Users voice phone number
  297.                      %NODE%              Node user called on
  298.                      %SEX%               Users gender
  299.                      %DAILYTIMELIMIT%    Users daily time limit
  300.                      %TIMEDEDUCTED%      Time deducted  
  301.                      %TIMEELAPSED%       Time elapsed
  302.                      %CALLS%             Number of calls by user
  303.                      %SECURITY%          Users security
  304.                      %TIMELIMIT%         Users time limit
  305.                      %TIMELEFT%          Users time left    
  306.                      %CALLTIME%          Time user called
  307.                      %CALLDATE%          Date user called
  308.                      %LASTCALLTIME%      Last time user called
  309.                      %LASTCALLDATE%      Last date user called
  310.                      %SUBEXPIRE%         Date subscription expires
  311.                      %BIRTHDATE%         Users date of birth
  312.                      %BBS%               Board name
  313.                      %SYSOP%             Sysop name
  314.                      %NUMBERSELECTED#%   # 1-9 lists selected numbers
  315.                      %NUMBERSELECTED%    Last number dialed
  316.                      %NUMBERSTATUS#%     # 1-9 lists numbers status 
  317.                      %NUMBERSTATUS%      Last number's status
  318.                      %CALLSTATUS#%       # 1-9 lists the connection attempts
  319.                      %CALLSTATUS%        Last connection attempt
  320.                      %USERSTATUS%        User status (Pass, Failed)
  321.  
  322.           ═══ USERPASS.MSG
  323.  
  324.                   If this file is found in  the same directory
  325.                   as the executable, this message will be sent
  326.                   to the user,  once the door has successfully
  327.                   been completed.  This file can be editted to
  328.                   use all possible METASTRINGS.
  329.  
  330.            ═══ USERFAIL.MSG
  331.  
  332.                   If this file is found in  the same directory
  333.                   as the executable, this message will be sent
  334.                   to the user,  once the door has successfully
  335.                   been completed.  This file can be editted to
  336.                   use all possible METASTRINGS.
  337.  
  338.            ═══ BADNUM
  339.  
  340.                   This file can  be both ANSI and ASCII.  This
  341.                   allows  the sysop to  create custom messages
  342.                   for  their users.  Only the  .ASC  file must
  343.                   exist for display, however ANSI  users might
  344.                   enjoy an  ANSI  screen.  This file  must  be
  345.                   located with the executable.  This file will
  346.                   represent the  message to tell the user that
  347.                   the number has failed the number scan.   The
  348.                   filename must be entitled  either BADNUM.ASC
  349.                   or BADNUM.ANS.
  350.  
  351.            ═══ DUPENUM
  352.  
  353.                   This file can  be both ANSI and ASCII.  This
  354.                   allows  the sysop to  create custom messages
  355.                   for  their users.  Only the  .ASC  file must
  356.                   exist for display, however ANSI  users might
  357.                   enjoy an  ANSI  screen.  This file  must  be
  358.                   located with the executable.  This file will
  359.                   represent the  message to tell the user that
  360.                   the number has failed the number scan.   The
  361.                   filename must be entitled either DUPENUM.ASC
  362.                   or DUPENUM.ANS.
  363.  
  364.            ═══ LDCALLER
  365.  
  366.                   This file can  be both ANSI and ASCII.  This
  367.                   allows  the sysop to  create custom messages
  368.                   for  their users.  Only the  .ASC  file must
  369.                   exist for display, however ANSI  users might
  370.                   enjoy an  ANSI  screen.  This file  must  be
  371.                   located with the executable.  This file will
  372.                   represent the  message to tell the user that
  373.                   the number has failed the number scan.   The 
  374.                   filename must be called either  LDCALLER.ASC
  375.                   or LDCALLER.ANS.
  376.  
  377.  
  378.     Environment Settings
  379.     ──────────────────────────────────────────────────────────────────
  380.  
  381.            ═══ SET CVS=DUPELEVEL:##
  382.  
  383.                   When  checking for duplicate  phone numbers,
  384.                   CVS by default checks all users. If you wish
  385.                   to check for duplicate numbers against users
  386.                   with security levels  greater than a certain
  387.                   number, you  can change  it  by setting  the
  388.                   environment variable to the  desired number.
  389.                   If you do  not set the  environment variable
  390.                   duplicate  numbers will  be checked  against
  391.                   users  who have a security  greater than  or
  392.                   equal to 0.  This will override  the setting
  393.                   in the cvs.cfg file.
  394.  
  395.            ═══ SET CVS=COMMENT:YES/NO
  396.  
  397.                   Comments will modify the users comment field
  398.                   to a  description of why  the number did not
  399.                   pass the check.  It will let you know if the
  400.                   number was a duplicate number, a bad number,
  401.                   or a LD number, if you do not allow ld calls
  402.                   from  your system.   If you  do not set this
  403.                   variable,  then by default  there will be no
  404.                   commenting.  This will override  the setting
  405.                   in the cvs.cfg file.
  406.  
  407.                   Please use a space, a comma, or a semi-colon
  408.                   to  separate the two  environment variables,
  409.                   or the program may not operate as you intend
  410.                   it to.
  411.  
  412.                   Remember that you can remove the environment
  413.                   variable  after you run the  program from  a
  414.                   batch file.  For example:
  415.  
  416.                   @ECHO OFF
  417.                   SET CVS=DUPELEVEL:10,COMMENT:YES
  418.                   CVS %1
  419.                   SET CVS=
  420.  
  421.  
  422. ╓───────────────────────────────────────────────────────────────────────────╖
  423. ║ CVS.EXE - The program                                                     ║
  424. ╙───────────────────────────────────────────────────────────────────────────╜
  425.  
  426.     CVS can be run from any directory that you like.  You must  pass CVS
  427.     the EXITINFO.BBS file so that it can access the users data.  This is
  428.     so that  RemoteAccess  will read back any  changes made to the users
  429.     statistics.   The files that come with  CVS  should all be placed in
  430.     the same directory, as  CVS will look for them in the directory that
  431.     the CVS.EXE file is in.
  432.  
  433.     In RemoteAccess this is how the command setup would look.
  434.  
  435.     *C /C C:\RA\DOORS\CVS.BAT *N *M
  436.  
  437.     This calls a batch file that will run the  CVS door.  The batch file
  438.     is included in the archive.
  439.  
  440.  
  441. ╓───────────────────────────────────────────────────────────────────────────╖
  442. ║ CVSSCAN.EXE - The program                                                     ║
  443. ╙───────────────────────────────────────────────────────────────────────────╜
  444.  
  445.     CVSSCAN  must be located in the  same directory as the CVS.CFG file.
  446.     CVSSCAN  requires at least on parameter, and that is the name of the
  447.     person to  scan numbers  against.  The first  and last name  must be
  448.     separated  by an underscore "_".  By  default the  program will stop
  449.     once a duplicate number has been found, but an optional parameter is
  450.     "/FULL" which will check the user against all of your users, whether
  451.     a duplicate number is found or not.  This program is useful when the
  452.     user request access, but refuses to use the callback verifier.
  453.  
  454.     You can use a batch file to call CVSSCAN so that it is in your path.
  455.     The batch file would look like this:
  456.  
  457.     @ECHO OFF
  458.     C:\RA\CVS\CVSSCAN %1 %2
  459.  
  460.     This will run the file and pass the 2 parameters.  If you only enter
  461.     one parameter the %2 will not be used.
  462.  
  463.  
  464. ╓───────────────────────────────────────────────────────────────────────────╖
  465. ║ Support                                                                   ║
  466. ╙───────────────────────────────────────────────────────────────────────────╜
  467.  
  468.    If you have any questions or comments, you  can netmail me at FidoNet
  469.    address 1:2401/305 (V34,VFAST).  Please poll back for your replies as
  470.    we get dozens of  messages a day, and  crashing them all  out is just
  471.    too expensive -  or optionally,  make a note that you would like your
  472.    message routed back to you.  You can also contact me via the Internet
  473.    for faster responses, and directly sent out replies.   The address is
  474.    "support@multiboard.com".  Normally you will  find me in  the RA_UTIL
  475.    FidoNet area as well, as well as the MCC_SUPPORT echo of course.  The
  476.    latest version can always be  FREQ'd from me with the magic name CVS.
  477.    Also, newest MCC software is also now available via the Internet at..
  478.  
  479.    ftp://ra.uti.com/sys/bbs/bbs/mcc
  480.    http://www.mgl.ca/~multib
  481.  
  482.    You can also FREQ a complete listing of all of the new products using
  483.    the magic name CATALOG.
  484.  
  485.  
  486. ╓───────────────────────────────────────────────────────────────────────────╖
  487. ║ Registration                                                              ║
  488. ╙───────────────────────────────────────────────────────────────────────────╜
  489.  
  490.     Please see the REGISTER.EXE file for a list of our registration site.
  491.     If you ever have questions about our registration sites, feel free to
  492.     post our infobot at "reginfo@multiboard.com", or send a netmail message
  493.     to us at 1:2401/305
  494.  
  495.  
  496. ╓───────────────────────────────────────────────────────────────────────────╖
  497. ║ License and Disclaimer                                                    ║
  498. ╙───────────────────────────────────────────────────────────────────────────╜
  499.  
  500.     "CVS" is NOT free,  it is being  marketed under  the "try before you
  501.     buy" or shareware concept.  You are entitled to use CVS and CVSSETUP
  502.     for  a period  up to  forty-five (45) days,  after  which  you  MUST
  503.     register or stop using the program.
  504.  
  505.     Registration entitles  you to  use  CVS 1.3  as well  as  any future
  506.     versions of the program that may or may not be released,  subject to
  507.     any additional licensing conditions which may be attached.
  508.  
  509.     Registration  will also you to use all of the available functions of
  510.     CVS, take  away  the "Unregistered" message at start up, and help to
  511.     continue  to  develop  this program.  (not to  mention maintain  the
  512.     legality of this agreement)
  513.  
  514.     By running any of the  executable programs included,  you agree that
  515.     Pete Rocca, Darryl Olthoff, Multiboard Communications Centre nor any
  516.     affiliates of  the above mentioned  are responsible  for any  damage
  517.     ever  experienced, however  so created. If you cannot agree to this,
  518.     then your privilege to use any of these programs  is revoked  and it
  519.     becomes illegal for you to execute  any programs included with  this
  520.     documentation.
  521.  
  522.     You may freely copy and  distribute the  shareware version of CVS as
  523.     long as its original archived contents  are not modified in any way.
  524.     You may NOT  distribute any  registration keys  without the  express
  525.     written  consent of Pete Rocca  of Multiboard Communications Centre.
  526.     You may  not use a registration key that  is not  licensed to you by
  527.     Pete Rocca, or any of the registration sites appointed by Pete Rocca
  528.  
  529.     It is illegal to edit, alter, hack, reverse engineer and / or modify
  530.     any components of the CVS archive in any manner.
  531.  
  532.     If dispute of any issues on legal grounds said above, then governing
  533.     law of Ontario, Canada will rule.
  534.  
  535.     If you agree to all of the above,  then you  may use these programs.
  536.  
  537.     * REMEMBER THAT REGISTRATION IS QUITE INEXPENSIVE FOR ALL YOU GET! *
  538.  
  539.