home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / EVENTS / CBVV12.ZIP / CBV.DOC next >
Text File  |  1995-01-28  |  118KB  |  3,651 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                      ▄▄▄▄▄▄ ▄     ▄▄▄▄▄▄▄▄▄▄    ▄▄▄▄▄  ▄▄▄▄
  12.                     ██     █▀      ▄█▀    ██     ██     █
  13.                   ▄█▀      ▀       ██    ▄██     ██   ▄▀
  14.                   ██              ███▄▄▄▄█▀▀     ███ ▄▀
  15.                   ██             ▄██     ██      ████
  16.                   ██     █       ██▀    ▄█▀      ███
  17.                   ▀█▄▄▄▄▄▀     ▄███▄▄▄▄▄█▀       █▀   v1.2
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.                            Datagen Software Designs'
  50.                     Call Back Verification System v1.2
  51.  
  52.                       (c) 1995 Datagen Software Designs
  53.                      written & programmed by John Dailey
  54.  
  55. ─────────────────────────────────────────────────────────────────────────────
  56.  ░ Warranty And Disclaimer ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  57. ─────────────────────────────────────────────────────────────────────────────
  58.  
  59.     This software is provided AS IS without any expressed or implied
  60. warranties whatsoever.  No warranty of fitness for a particular purpose is
  61. offered. The author of this software cannot be held responsible for DIRECT,
  62. INDIRECT  INCIDENTAL, CONSEQUENTIAL, or ANY OTHER damages due to your ability
  63. or inability to use this software, even if the author has  been advised of
  64. the possibility of such damages. The user assumes full responsibility for the
  65. use of this software.
  66.  
  67. ─────────────────────────────────────────────────────────────────────────────
  68.  ░ About Distributing CBV ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  69. ─────────────────────────────────────────────────────────────────────────────
  70.  
  71.     CBV may be distributed freely in its unmodified, self-extracting,
  72. archived form.  For those systems that do not allow self-extracting uploads,
  73. please archive the CBV self-extracting archive within another archive instead
  74. of unarchiving and re-archiving the package for distribution.  This will help
  75. ensure reliability of the program to all users.
  76.  
  77.     Thank you for your cooperation.  Enjoy the software!
  78.  
  79. ─────────────────────────────────────────────────────────────────────────────
  80.  ░ Table Of Contents ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  81. ─────────────────────────────────────────────────────────────────────────────
  82.  
  83.  
  84. Files Included In This Archive. . . . . . . . . . . . . . . . . . . . .   1
  85.  
  86. What Exactly Is CBV?. . . . . . . . . . . . . . . . . . . . . . . . . .   2
  87.  
  88. Features Of CBV . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  89.  
  90. Quick Installation. . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  91.  
  92. The Pre/Post-Processor Concept. . . . . . . . . . . . . . . . . . . . .   6
  93.     Developing Pre/Post-Processors. . . . . . . . . . . . . . . . . . .   7
  94.     Requesting A Pre/Post-Processor . . . . . . . . . . . . . . . . . .   8
  95.  
  96. Upgrading From Previous Versions. . . . . . . . . . . . . . . . . . . .   9
  97.  
  98. Installation Of CBV Files . . . . . . . . . . . . . . . . . . . . . . .  11
  99.  
  100. Configuration of CBV. . . . . . . . . . . . . . . . . . . . . . . . . .  12
  101.     File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  102.          Info . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  103.          Save . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  104.          Quit . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  105.     BBS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  106.          Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  107.          Area Code. . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  108.          LD Prefix. . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  109.          CBV Path . . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  110.          Disp Path. . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  111.          Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  112.          Mail File. . . . . . . . . . . . . . . . . . . . . . . . . . .  14
  113.          Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  114.     Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  16
  115.          Password Attempts. . . . . . . . . . . . . . . . . . . . . . .  16
  116.          Minimum SL To CBV. . . . . . . . . . . . . . . . . . . . . . .  16
  117.          Maximum SL To CBV. . . . . . . . . . . . . . . . . . . . . . .  16
  118.          Security Level Settings. . . . . . . . . . . . . . . . . . . .  16
  119.               System SL (SL). . . . . . . . . . . . . . . . . . . . . .  16
  120.               Download SL (DSL) . . . . . . . . . . . . . . . . . . . .  16
  121.               Exemptions. . . . . . . . . . . . . . . . . . . . . . . .  16
  122.               Restrictions. . . . . . . . . . . . . . . . . . . . . . .  17
  123.               User Flags (AR/DAR) . . . . . . . . . . . . . . . . . . .  17
  124.          Restriction and Flag Settings. . . . . . . . . . . . . . . . .  17
  125.          Regular User SL. . . . . . . . . . . . . . . . . . . . . . . .  19
  126.          Long Distance SL . . . . . . . . . . . . . . . . . . . . . . .  19
  127.          Bad Password SL. . . . . . . . . . . . . . . . . . . . . . . .  19
  128.          Aborted SL . . . . . . . . . . . . . . . . . . . . . . . . . .  19
  129.          Bad Number SL. . . . . . . . . . . . . . . . . . . . . . . . .  19
  130.          Duplicate Number SL. . . . . . . . . . . . . . . . . . . . . .  19
  131.  
  132.     Modem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  133.          Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  134.               Port Number . . . . . . . . . . . . . . . . . . . . . . .  20
  135.               Base Address. . . . . . . . . . . . . . . . . . . . . . .  20
  136.               Base IRQ. . . . . . . . . . . . . . . . . . . . . . . . .  20
  137.          Escape Command . . . . . . . . . . . . . . . . . . . . . . . .  21
  138.          Hangup . . . . . . . . . . . . . . . . . . . . . . . . . . . .  21
  139.          Dial Prefix. . . . . . . . . . . . . . . . . . . . . . . . . .  21
  140.          Pickup . . . . . . . . . . . . . . . . . . . . . . . . . . . .  21
  141.          Modem Init . . . . . . . . . . . . . . . . . . . . . . . . . .  21
  142.          OK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  21
  143.          NO CARRIER . . . . . . . . . . . . . . . . . . . . . . . . . .  21
  144.          NO DIAL TONE . . . . . . . . . . . . . . . . . . . . . . . . .  22
  145.          CONNECT. . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  146.          RING . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  147.          BUSY . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  148.          VOICE. . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  149.          Result Wait. . . . . . . . . . . . . . . . . . . . . . . . . .  22
  150.          Carrier Wait . . . . . . . . . . . . . . . . . . . . . . . . .  22
  151.          Redial Pause . . . . . . . . . . . . . . . . . . . . . . . . .  22
  152.          Dial Attempts. . . . . . . . . . . . . . . . . . . . . . . . .  22
  153.     Numbers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  154.          Validated Numbers. . . . . . . . . . . . . . . . . . . . . . .  23
  155.          Bad Numbers. . . . . . . . . . . . . . . . . . . . . . . . . .  23
  156.          Valid Exchanges. . . . . . . . . . . . . . . . . . . . . . . .  23
  157.     Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  24
  158.          Ask Password . . . . . . . . . . . . . . . . . . . . . . . . .  24
  159.          Allow Walk-through . . . . . . . . . . . . . . . . . . . . . .  24
  160.          Allow New Numbers. . . . . . . . . . . . . . . . . . . . . . .  24
  161.          Allow LD Validations . . . . . . . . . . . . . . . . . . . . .  24
  162.          Hangup After LD. . . . . . . . . . . . . . . . . . . . . . . .  26
  163.          Hangup Aborted User. . . . . . . . . . . . . . . . . . . . . .  26
  164.          Hangup Bad Password. . . . . . . . . . . . . . . . . . . . . .  26
  165.          Hangup After Callback. . . . . . . . . . . . . . . . . . . . .  26
  166.          Validated Duplicates . . . . . . . . . . . . . . . . . . . . .  26
  167.          Auto-Validate Duplicates . . . . . . . . . . . . . . . . . . .  26
  168.          Phone In User Note . . . . . . . . . . . . . . . . . . . . . .  26
  169.  
  170. Controlling Bad Numbers . . . . . . . . . . . . . . . . . . . . . . . .  27
  171.  
  172. Defining Local Numbers With Area Codes And Exchanges. . . . . . . . . .  28
  173.  
  174. Running CBV From The BBS. . . . . . . . . . . . . . . . . . . . . . . .  30
  175.     Installation for systems using EXITINFO.BBS (Remote Access,
  176.          ProBoard). . . . . . . . . . . . . . . . . . . . . . . . . . .  31
  177.     Installation for systems using DOOR.SYS (TriBBS). . . . . . . . . .  32
  178.     Installation for WWIV BBS systems . . . . . . . . . . . . . . . . .  33
  179.  
  180. Pre/Post-Processors . . . . . . . . . . . . . . . . . . . . . . . . . .  34
  181.     EXITINFO.BBS (RA v2.00+, ProBoard). . . . . . . . . . . . . . . . .  34
  182.     DOOR.SYS (TriBBS) . . . . . . . . . . . . . . . . . . . . . . . . .  35
  183.     WWIV. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  36
  184.          Configuration. . . . . . . . . . . . . . . . . . . . . . . . .  36
  185.          Modified User Record Structures. . . . . . . . . . . . . . . .  38
  186.  
  187. User E-Mail Files . . . . . . . . . . . . . . . . . . . . . . . . . . .  41
  188.     VOICE.MSG . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  41
  189.     TIMEOUT.MSG . . . . . . . . . . . . . . . . . . . . . . . . . . . .  41
  190.     BUSY.MSG. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  41
  191.     FAILED.MSG. . . . . . . . . . . . . . . . . . . . . . . . . . . . .  41
  192.     SUCCESS.MSG . . . . . . . . . . . . . . . . . . . . . . . . . . . .  41
  193.     SUCCESSL.MSG. . . . . . . . . . . . . . . . . . . . . . . . . . . .  41
  194.  
  195. ANSI/ASCII Display Files. . . . . . . . . . . . . . . . . . . . . . . .  42
  196.     Main Program Display Files. . . . . . . . . . . . . . . . . . . . .  42
  197.     Walk-through Display Files. . . . . . . . . . . . . . . . . . . . .  45
  198.  
  199. Local Console Key Controls. . . . . . . . . . . . . . . . . . . . . . .  47
  200.     Auto Upgrade Keys . . . . . . . . . . . . . . . . . . . . . . . . .  47
  201.     Sysop Bar Information . . . . . . . . . . . . . . . . . . . . . . .  47
  202.     Return User To BBS. . . . . . . . . . . . . . . . . . . . . . . . .  47
  203.     Hang Up On User . . . . . . . . . . . . . . . . . . . . . . . . . .  47
  204.     Split-Screen Chat . . . . . . . . . . . . . . . . . . . . . . . . .  47
  205.     Shell To DOS. . . . . . . . . . . . . . . . . . . . . . . . . . . .  48
  206.  
  207. Multi-Node Configuration. . . . . . . . . . . . . . . . . . . . . . . .  49
  208.     Node Identification By Command-Line . . . . . . . . . . . . . . . .  50
  209.     Node Identification By Environment Variable . . . . . . . . . . . .  51
  210.  
  211. Registration Of CBV . . . . . . . . . . . . . . . . . . . . . . . . . .  53
  212.  
  213. Support BBS Information . . . . . . . . . . . . . . . . . . . . . . . .  54
  214.  
  215. Author's Notes And Credits. . . . . . . . . . . . . . . . . . . . . . .  57
  216.  
  217. Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  58
  218.  
  219. ─────────────────────────────────────────────────────────────────────────────
  220.  ░ Files Included In This Archive ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  221. ─────────────────────────────────────────────────────────────────────────────
  222.  
  223.     CBV     .DOC ─── CBV Documentation
  224.     CBV     .REG ─── CBV Registration Form
  225.     CBV     .HIS ─── CBV Program History File
  226.     CBVCFG  .EXE ─── CBV Configuration Software
  227.     CBV     .EXE ─── CBV Main Executable
  228.     CBVBAD# .DAT ─── Sample Bad Phone Number Configuration File
  229.     DISPLAY1.EXE ─── Sample CBV External ANSI/ASCII Display Files 1[2]
  230.     DISPLAY2.EXE ─── Sample CBV External ANSI/ASCII Display Files 2[2]
  231.     EXIT_PPP.EXE ─── EXITINFO.BBS (RA v2.00+ Format) Pre/Post-Processor
  232.     DOOR_PPP.EXE ─── DOOR.SYS Pre/Post Processor
  233.     WWIV_PPP.EXE ─── WWIV v4.20+ Pre/Post Processor
  234.     WWIV_PPP.CFG ─── WWIV v4.20+ Pre/Post Processor Sample Config File
  235.     RACBV   .BAT ─── Sample RA Batch File
  236.     WWIVCBV .BAT ─── Sample WWIV Batch File
  237.  
  238.     [14 Files]
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.                                    Page 1
  275.  
  276. ─────────────────────────────────────────────────────────────────────────────
  277.  ░ What Exactly Is CBV? ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  278. ─────────────────────────────────────────────────────────────────────────────
  279.  
  280.     CBV, otherwise known as Call Back Verification has become much the
  281. standard for new user validation on Bulletin Boards around the globe.  The
  282. concept comes with the idea that there must be a user on the other end of the
  283. phone line currently in use.
  284.  
  285.     CBV works by gathering the user's phone numbers (either data or voice),
  286. and calls the user back at one of those numbers.  Upon modem connection, the
  287. user is granted a higher security level because we now know that indeed,
  288. someone is calling from the number specified, and are thus less likely to
  289. wreck havoc to the system.
  290.  
  291.     There are many different Call Back Verifiers floating around in the BBS
  292. world.  Very few of them are not cripple-ware, meaning that some features of
  293. the program have been disabled until the sysop sends in the suggested
  294. registration fee.  Datagen's CBV is NOT cripple-ware, and does not have any
  295. "nag screens" or lengthy delays if unregistered.
  296.  
  297.     During this documentation, display files may be referenced as CBV*.A??. 
  298. The A?? merely signifies that the file will either have an .ANS or an .ASC
  299. extension.  Files ending with ANS are displayed to ANSI (color) user's, while
  300. files ending in ASC are displayed to non-ANSI user's.
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.                                    Page 2
  332.  
  333. ─────────────────────────────────────────────────────────────────────────────
  334.  ░ Features Of CBV ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  335. ─────────────────────────────────────────────────────────────────────────────
  336.  
  337.     Below is a list of general features that Datagen Software Designs' Call
  338. Back Verification System offers:
  339.  
  340.  
  341.   General
  342.  
  343.   o Will work with ALL BBS systems given that a pre/post-processor is used
  344.     for that system.  Direct support for systems that utilize the
  345.     EXITINFO.BBS file for external programs (Remote Access, ProBoard),
  346.     systems that write and read from the DOOR.SYS dropfile (TriBBS), and WWIV
  347.     is included with the package, but support for any other software can be
  348.     added by simply adding a pre/post-processor for that BBS type.
  349.   o TOTALLY configurable look.  Repeat - TOTALLY  (No nasty neon Colors! ;)
  350.     All screens used by the program are external in ANSI and ASCII form.
  351.     Program text colors can be configured to go with display files.
  352.   o Multi-node capable.
  353.   o Multi-configuration capable, allow you to define different modem command
  354.     setups, different setups for different nodes, different security level
  355.     settings for different nodes, etc.
  356.  
  357.  
  358.   Long Distance Configurations
  359.  
  360.   o Multiple local area-code support.  Up to 25 local area codes may be
  361.     defined.
  362.   o Optional LD Validation Capability.
  363.   o Optional Define LD Calling Hours.  Define LD callbacks to only be allowed
  364.     during certain times of day.
  365.   o Display LD Calls On Specific Days.
  366.   o Optional Hang-up on LD Callers after Validation.
  367.   o Optional capability to define all local exchanges for each area code.  Up
  368.     to 600 exchanges may be defined for each area code.
  369.  
  370.  
  371.   System Security
  372.  
  373.   o Five (5) different upgrade security level settings :
  374.         For regular validated users
  375.         For regular long distance users
  376.         For aborted callbacks
  377.         For callbacks where number is a "Bad Number"
  378.         For callbacks where a number is duplicated
  379.         Each of these is optional
  380.   o A "Bad Phone Number" Control File.
  381.   o Checking of duplicate numbers/validations.
  382.   o Auto Validate Duplicate Numbers.
  383.   o Sysop quick validation keys to bypass the callback and assign one of the
  384.     five pre-defined security settings.
  385.   o Secure password checking using CRC32 with RA v2.00+.
  386.   o Support for modifying restrictions and exemptions with WWIV v4.20+.
  387.   o Hang up on users that abort the call-back.
  388.  
  389.                                    Page 3
  390.  
  391.   o Hang up on users that enter an incorrect password too many times.
  392.   o Hang up on users after validation.
  393.   o The ability to write a text file for import as e-mail to the user upon an
  394.     error, or successful callback.
  395.  
  396.  
  397.   Modem
  398.  
  399.   o Voice pickup detection (modem supporting only).
  400.   o Call-Collision handling.
  401.   o Configurable results codes and modem command strings.
  402.   o Modem response window that displays responses from modem during callback.
  403.   o Capability for definition of non-standard com ports and IRQ information.
  404.  
  405.  
  406.   BBS User Friendly Features
  407.  
  408.   o Optional capability to allow user to enter a number not in their
  409.     information.
  410.   o Walk-through tutorial on the call-back process.
  411.   o Online instructions
  412.  
  413.  
  414.   Sysop Friendly Features
  415.  
  416.   o LOG capabilities.
  417.   o *NOT* Crippleware.  All said features are fully functional.
  418.   o Support for both modified and unmodified userrecs with WWIV BBS systems.
  419.   o Storing of the validated number in the user's note/comment
  420.     (pre/post-processor supporting only).
  421.   o DOS Shell (with memory swap to EMS or disk).
  422.   o Split-Screen and regular chat modes.
  423.   o Function Keys To Do The Following:
  424.         Return user to BBS
  425.         Hang up on user
  426.         Do both of the above, AND lock the user from the system by adding
  427.          their phone numbers to the BAD Number file and setting their
  428.          security level to zero.
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.                                    Page 4
  447.  
  448. ─────────────────────────────────────────────────────────────────────────────
  449.  ░ Quick Installation ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  450. ─────────────────────────────────────────────────────────────────────────────
  451.  
  452.     It is suggested that sysops read through this documentation in its
  453. entirety.  However, we realize the length of the documentation exceeds 50
  454. pages, and some elements of the software may not need in depth explanations. 
  455. This is why we have included a step-by-step quick installation guide.  Refer
  456. to the complete documentation for a more thorough explanation and examples.
  457.  
  458.     If you are upgrading from a previous version of CBV, please refer to the
  459. section on upgrading rather than this quick installation section.  It is
  460. assumed that you already have an average knowledge of DOS and experience in
  461. setting up BBS utilities in general during this quick installation.
  462.  
  463.  
  464.     1.   Unarchive the main archive files into a separate directory off of
  465.          your main BBS system directory.  We suggest a directory named "CBV"
  466.          or something similar such as C:\BBS\CBV.
  467.  
  468.     2.   Unarchive a display file archive (DISPLAY1.EXE or DISPLAY2.EXE) into
  469.          another directory off of the directory you placed the CBV files in. 
  470.          If the example directory in step number one is used, we suggest
  471.          making this directory C:\BBS\CBV\DISPLAY.
  472.  
  473.     3.   Run the configuration program (CBVCFG.EXE), and modify your system
  474.          name, area codes, and the location of the display files.  Modify
  475.          other items as you see fit.  Most are self-explanatory.
  476.  
  477.          WWIV sysops should also modify the WWIV_PPP.CFG file with a standard
  478.          text editor.  Instructions for the configuration file are included
  479.          in the sample configuration file itself.
  480.  
  481.     4.   Create a batch file to call CBV from your BBS.  Follow the outline
  482.          of the example batch file below.  As shown, be sure to call the
  483.          specific Pre/Post-Processor for your BBS software before AND after
  484.          calling CBV.
  485.  
  486.          @ECHO OFF
  487.          EXIT_PPP -R C:\BBS C:\BBS\CBV
  488.          CBV C:\BBS\DOOR.SYS C:\BBS\CBV\CBV.CFG C:\BBS\CBV
  489.          EXIT_PPP -W C:\BBS C:\BBS\CBV -D
  490.  
  491.          Batch files for all BBS types will most likely be identical aside
  492.          from which Pre/Post-Processor program you execute before and after
  493.          the main CBV program.  Select the Pre/Post-Processor that works
  494.          correctly with your system.
  495.  
  496.     5.   Modify your BBS to call the batch file.  For WWIV sysops, it is
  497.          suggested that you setup your BBS to shrink when calling CBV.
  498.  
  499.  
  500.  
  501.  
  502.  
  503.                                    Page 5
  504.  
  505. ─────────────────────────────────────────────────────────────────────────────
  506.  ░ The Pre/Post-Processor Concept ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  507. ─────────────────────────────────────────────────────────────────────────────
  508.  
  509.     While developing Datagen's Call Back Verification System, we wanted to
  510. make sure that ALL sysops could benefit from its features, capabilities,
  511. configurability, and low registration fee.  This posed quite a problem due to
  512. the lack of similarities between BBS types and their format for storing user
  513. records and information.  It was ascertained that most BBS softwares have the
  514. following information for all users on record:
  515.  
  516.     o Name and/or handle
  517.     o Voice phone number
  518.     o Data phone number
  519.     o Security level
  520.     o Flags
  521.  
  522.     This is all the basic information needed in order to successfully control
  523. a user's security.  However, for this minute amount of information, one would
  524. need to know the structure of each and every BBS software package to directly
  525. support them from within the CBV program.
  526.  
  527.     The idea itself seems quite outlandish, and the actual technical means
  528. of doing so would increase program size and memory requirements, while at the
  529. same time decreasing efficiency, speed, and ease of configuration.
  530. Therefore, we developed a system of acquiring that information without
  531. the actual CBV program needing to support ANY of the BBS structures.
  532.  
  533.     The concept works on the idea similar to BBS door dropfiles, as in the
  534. popular DOOR.SYS.  CBV manages its own "drop file" to keep track of a
  535. particular user's security level, thus eliminating the need to know any other
  536. structures but its own.  This drop file is stored in a plain text-file format
  537. under the filename of CBV_PPP.DAT.  Its format is outlined below, and is
  538. described further in the section concerning development of processors.
  539.  
  540.     User's Real Name
  541.     User's Handle (Real Name If No Handle)
  542.     User's Text Password
  543.     Is Password CRC32 Value Instead Of Text? (1 = Yes, 0 = No)
  544.     User's Password CRC32 Value (If supported)
  545.     User's Data Phone Number
  546.     User's Voice Phone Number
  547.     User's Flags
  548.     User's Exemption (0 - 255)
  549.     User's Restrictions
  550.     User's Security Level
  551.     User's Download Security Level
  552.     User's Note/Sysop Comment
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.                                    Page 6
  561.  
  562.     Understanding this "drop file" allows us to write programs that read a
  563. user's information directly from the BBS data files, and write the "drop
  564. file" that CBV needs before CBV is ran.  After CBV is ran, this same program
  565. (or another program if need be), reads CBV's "drop file", and writes the
  566. user's new information to the BBS data files.  Now, all that is needed to
  567. support a particular BBS software is what we've come to call a Pre/Post-
  568. Processor; a program that pre-processes and post-processes the user's
  569. information to/from CBV's built-in format.
  570.  
  571.     CBV is still in itself its own program.  There is no need to update the
  572. whole software package when new BBS softwares are developed, nor when a
  573. particular BBS package updates and changes its user structure.  Only the
  574. pre/post-processor program needs to be changed, and with an average kilobyte
  575. size of under 10k, this is no major feat compared to the near 100k of the CBV
  576. executable.
  577.  
  578.  
  579. Developing Pre/Post-Processors
  580.  
  581.     CBV comes with three Pre/Post-Processor packages in the distribution
  582. archive.  Addition processors will become available as they are developed
  583. and/or discovered.  The processors included will pre and post-processes the
  584. CBV "drop file" for:
  585.  
  586.     o    Any BBS system that utilizes the EXITINFO.BBS file during execution
  587.          of external programs, such as Remote Access v2.00+ software.  The
  588.          BBS software MUST re-read this file upon return and make changes to
  589.          the user's information if any were made.  (EXIT_PPP.EXE)  Three
  590.          popular software packages that utilize this method are Remote
  591.          Access, QuickBBS, and ProBoard.
  592.  
  593.     o    Any BBS software that directly utilizes the DOOR.SYS dropfile itself
  594.          as a means for keeping track of user information, such as TriBBS. 
  595.          The BBS software must write this drop file before executing an
  596.          external program, and then read the file upon return to see if any
  597.          changes were made to the users information.  (DOOR_PPP.EXE)  Again,
  598.          TriBBS is an example BBS software package that works well with this
  599.          method.
  600.  
  601.     o    WWIV BBS software v4.20+.  Due to the non-standardization of WWIV,
  602.          it requires its own special Pre/Post-Processor.  Modified user
  603.          record structures are also supported with the WWIV Pre/Post-
  604.          Processor via an offset configuration file.  The WWIV Pre/Post-
  605.          Processor reads from and writes to the BBS user database directly. 
  606.          (WWIV_PPP.EXE)
  607.  
  608.     Sysops who wish to develop their own Pre/Post-Processor are encouraged to
  609. do so.  Those sysops who do develop a Pre/Post-Processor for their BBS
  610. software are also encouraged to send a working copy to Datagen Software
  611. Designs to make available for all users of DSD CBV.
  612.  
  613.  
  614.  
  615.  
  616.  
  617.                                    Page 7
  618.  
  619. Requesting A Pre/Post-Processor
  620.  
  621.     Those sysops who wish to have a processor for their software, but are
  622. however unable to develop one themselves are encouraged to submit a request
  623. to Datagen Software Designs at any one of John Dailey's e-mail addresses, or
  624. DSD's post-office address.  Before actually submitting a request, please be
  625. sure that one of the already included Pre/Post-Processors WILL NOT work with
  626. your BBS Software.  After this fact has been determined, feel free to submit
  627. a request.
  628.  
  629.     Sysops who do submit a request should also enclose with their request:
  630.  
  631.     o    A complete copy of the programmer's user record structures for that
  632.          particular package.  This text file is usually outlined in the BBS
  633.          package's documentation, or as a separate text file such as
  634.          STRUCT.BBS.  In this documentation will be a list of the variables
  635.          and their sizes that are stored for each user.  User variables are
  636.          items such as the user's name, user's handle, date of first call,
  637.          screen size, etc.
  638.  
  639.     o    A sample, dummy user database as created by his/her BBS software (if
  640.          possible) for testing of the Pre/Post-Processor during programming.
  641.  
  642.     Requests will be processed and completed as soon as possible.  Requestors
  643. should allow at least two weeks before inquiring as to the status of their
  644. request.  Requestors are encouraged to test out the particular Pre/Post-
  645. Processor for some time before distributing it.
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.                                    Page 8
  675.  
  676. ─────────────────────────────────────────────────────────────────────────────
  677.  ░ Upgrading From Previous Versions ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  678. ─────────────────────────────────────────────────────────────────────────────
  679.  
  680.     Upgrading from any version lower than 1.1 will require a total
  681. replacement of executable files and configuration files.  If you are
  682. upgrading from a version 1.0, 1.0α or 1.1ß, it is suggested that you do a
  683. total re-install of CBV.
  684.  
  685.     Upgrading from 1.1 to 1.2 requires no major tasks.  Follow these few
  686. simple steps below:
  687.  
  688.     1.   Replace all your current executable with the new executable files
  689.          from the 1.2 archive.
  690.  
  691.     2.   If you're using the standard display files, replace the old versions
  692.          that specify the old version number with the new ones from the 1.2
  693.          archive.
  694.  
  695.     3.   Run the new CBVCFG.EXE configuration program.  CBVCFG will
  696.          automatically notice your old configuration and upgrade it
  697.          accordingly.
  698.  
  699.     4.   Modify your local area codes and calling exchanges according to the
  700.          new format.  If you have defined exchanges, it is easiest to take
  701.          the exchange data file (CBVEXCH.DAT) from your old configuration,
  702.          and separate each group of numbers for each area code by a blank
  703.          line, and add their specific area codes to the top of each list. 
  704.          After completing this, rename the file to CBVAREA.DAT.  For example,
  705.          if you had area codes 407, 305, and 904 local to you, and exchanges
  706.          were configured in CBVEXCH.DAT as:
  707.  
  708.          855
  709.          857
  710.          275
  711.          859
  712.          123
  713.          321
  714.          987
  715.          919
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.                                    Page 9
  732.  
  733.          And the first four were local to 407, the next two local to 305, and
  734.          the last two local to the 904 area code, you would modify the file
  735.          to look like so:
  736.  
  737.          407
  738.          855
  739.          857
  740.          275
  741.          859
  742.  
  743.          305
  744.          123
  745.          321
  746.  
  747.          904
  748.          987
  749.          919
  750.  
  751.  
  752.     Make sure all other options are configured to your specifications, and
  753. your upgrade is complete.
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.                                    Page 10
  789.  
  790. ─────────────────────────────────────────────────────────────────────────────
  791.  ░ Installation Of CBV Files ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  792. ─────────────────────────────────────────────────────────────────────────────
  793.  
  794.     Installation of CBV for the first time is fairly simple.  Follow the few
  795. steps outlined in this documentation for best results.
  796.  
  797.     First, create a directory off of your main BBS directory that will store
  798. CBV's files.  Because there are quite a few files in the CBV archive, it is
  799. a wise idea to store them by themselves and keep your BBS directory
  800. uncluttered.  In the following setup examples, we assume that your main BBS
  801. directory is C:\BBS and that you are installing the CBV files in C:\BBS\CBV. 
  802. The following DOS commands accomplish this task:
  803.  
  804.     CD\BBS
  805.     MD CBV
  806.  
  807.     Next, unarchive or move the CBV package into this newly created
  808. directory.  Do this by first moving into the subdirectory you've created, and
  809. run this self-extracting archive.  The following commands will accomplish
  810. this:
  811.  
  812.     CD\BBS\CBV
  813.     <path to CBV archive>\CBVV12.EXE
  814.  
  815.     Or, if the archive is already in your CBV directory:
  816.  
  817.     CD\BBS\CBV
  818.     CBVV12.EXE
  819.  
  820.     All of CBV's screens are external, and because there are a large number
  821. of them, it is advised that you should place these display files in their own
  822. directory as well.  Throughout this documentation, display files are assumed
  823. to be located in C:\BBS\CBV\DISPLAY.  The following commands install the
  824. display screens in this directory:
  825.  
  826.     CD\BBS\CBV
  827.     MD DISPLAY
  828.     CD DISPLAY
  829.     ..\DISPLAY1.EXE
  830.  
  831.     Or, if you wish to use the second group of display files, substitute the
  832.     last line above with:
  833.  
  834.     ..\DISPLAY2.EXE
  835.  
  836.     Two different display file groups are included with the distribution
  837. archive of DSD CBV.  Be sure to specify if you would like to use DISPLAY1.EXE
  838. or DISPLAY2.EXE.
  839.  
  840.     The basic files for CBV have now been installed, however, before you are
  841. able to run the software package, you will need to configure it for your
  842. system as outlined in the next section.
  843.  
  844.  
  845.                                    Page 11
  846.  
  847. ─────────────────────────────────────────────────────────────────────────────
  848.  ░ Configuration of CBV ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  849. ─────────────────────────────────────────────────────────────────────────────
  850.  
  851.     The next step in installing CBV is to configure the software to your
  852. specific needs.  By using the included configuration software (CBVCFG.EXE),
  853. you can configure nearly all aspects of the Call Back Verification door.  
  854.  
  855.     To start the configuration software, move to CBV's directory, and type
  856. CBVCFG, followed by the enter key, at the DOS prompt.  If you wish to specify
  857. a filename for the configuration file, you may do so on the command line
  858. here.  For example:
  859.  
  860.     CBVCFG.EXE [filename]
  861.  
  862.     CBVCFG.EXE NODE1.CFG
  863.  
  864.     Otherwise, CBVCFG will assume the configuration file is to be read from
  865. and written to as CBV.CFG.  
  866.  
  867.     Move the highlight bar to the menu item you wish to modify/access and
  868. press the enter key.  When you have made all necessary changes, you may save
  869. them by either going under the "File" menu and pressing enter on the save
  870. option, or by pressing ESCape from the main menu to quit.  CBVCFG will prompt
  871. you if you wish to save your changes if any are made.
  872.  
  873.     Pressing ESCape will also exit you to the previous menu, or cancel
  874. changes to a specific option that requires input.  Each main menu option is
  875. listed in the following pages.
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.                                    Page 12
  903.  
  904.     File
  905.     ────
  906.  
  907.     Under this menu, you will find general information about CBV, the save
  908.     configuration option, and the selection to quit CBV.
  909.  
  910.     Info
  911.     This selection merely gives general information about CBV, and its cause.
  912.  
  913.     The information screen will not disappear until you move the highlight
  914.     bar to another menu.
  915.  
  916.     Save
  917.     This menu option simply saves the current configuration, bad number
  918.     information (if any), and the valid exchanges (if any) to their
  919.     respective files.  The configuration is saved in CBV.CFG, while the bad
  920.     number information is stored in CBVBAD#.DAT, and area codes and valid
  921.     exchanges are saved in CBVEXCH.DAT.
  922.  
  923.     Quit
  924.     This option simply quits CBVCFG and returns to the operating system
  925.     prompt.  If any changes have been made, CBVCFG will prompt the user
  926.     accordingly.
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.                                    Page 13
  960.  
  961.     BBS
  962.     ───
  963.  
  964.     This menu contains configuration aspects that pertain to your system.
  965.  
  966.     Name
  967.     Obviously, your bulletin board system's name goes in this setting.  Be
  968.     sure to enter it exactly as you wish it to be displayed to your new
  969.     users.  In some places during software execution, CBV will chop off
  970.     extremely long system names to fit the name into parts of the screen.
  971.  
  972.     Area Code
  973.     This selection allows you to specify all area codes that are local to
  974.     your BBS system.  You must enter at least one area code here.  CBV will
  975.     abort with a notice that you need to set your area code in the
  976.     configuration if you do not specify at least one area code.  A maximum of
  977.     25 local area codes may be defined.
  978.  
  979.     LD Prefix
  980.     In this option, specify the dialing information that you require to
  981.     access long distance calls in your area.  For most systems this will be
  982.     the default of "1-".  If you need to dial specific codes to access long
  983.     distance calls, enter that dial information here.  All valid modem
  984.     commands may be entered in the LD dialing prefix.
  985.  
  986.     CBV Path
  987.     Enter on this line the path to your CBV program files,  Leaving this line
  988.     blank will tell CBV to look in the current directory.  In our above
  989.     example, you would enter C:\BBS\CBV.  An ending backslash is not
  990.     required.
  991.  
  992.     Disp Path
  993.     This is the full path to where CBV's display files are located.  In our
  994.     example, this should be set to C:\BBS\CBV\DISPLAY.  Again, leaving this
  995.     line blank specifies the current directory, and no ending backslash is
  996.     needed.
  997.  
  998.     Log
  999.     CBV has the ability to log all its actions during use.  If you don't wish
  1000.     to log anything, simply keep this option blank.  If you wish to have CBV
  1001.     create its own log file in the CBV directory, then just specify a name
  1002.     for the file (CBV.LOG).  However, if you'd like, CBV can also add it
  1003.     right to your BBS log file by specifying the path and name of that log
  1004.     file (C:\BBS\RA.LOG).
  1005.  
  1006.     Mail File
  1007.     CBV also has the ability to copy specific files to a general text file
  1008.     for import as e-mail to your user based on certain events.  This
  1009.     configuration slot is where you would specify the complete filename and
  1010.     path to which CBV is to write the completed text file for import.  See
  1011.     the section on E-Mail Files for more information on the Mail File.
  1012.  
  1013.  
  1014.  
  1015.  
  1016.                                    Page 14
  1017.  
  1018.     Colors
  1019.     The first and foremost option on configuring the look of CBV is the
  1020.     colors that text is to be displayed in.  From this menu, you will get to
  1021.     choose the colors for all text displayed by the door to the user, and as
  1022.     well, the specific color combination for the sysop information bar
  1023.     located at the bottom of the screen.  Simply move the highlight bar to
  1024.     the item you wish to change the color for, press enter, and enter the
  1025.     foreground and background color numbers you desire.  For your
  1026.     convenience, a color chart is displayed next to the menu showing the
  1027.     available colors and their corresponding numbers.
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.                                    Page 15
  1074.  
  1075.     Security
  1076.     ────────
  1077.  
  1078.     This menu sports various options concerning the security and validation
  1079.     process of CBV.  Security level values are dependent on your BBS
  1080.     software.  For RA systems, these values can range from 0 to 65535, while
  1081.     for WWIV software, these values can range from 0 to 255.  Setting any SL
  1082.     configuration to zero (0) will tell CBV to NOT modify the user's security
  1083.     level at any time.
  1084.  
  1085.     Password Attempts
  1086.     After a successful callback, CBV has the option to prompt the user to
  1087.     enter their login password.  The password attempts option specifies the
  1088.     number of tries that a user will receive to enter the correct password
  1089.     before exiting the call back verification door.  Usually, the default of
  1090.     three (3) attempts should suffice.  If the ask for password feature is
  1091.     disabled, this option has no affect.
  1092.  
  1093.     Minimum SL To CBV
  1094.     This option specifies the security level that a user must have or exceed
  1095.     in order to run CBV.  For example, if this option is set to 10, any user
  1096.     that enters CBV with a security level of nine (9) or below will not be
  1097.     permitted to be called back and CBV will merely exit back to the board. 
  1098.     All users with a security level of 10 and above will be permitted.
  1099.  
  1100.     Maximum SL To CBV
  1101.     The opposite of Minimum SL To CBV, this option specifies the maximum
  1102.     security level allowed for call back.  For example, if set to 49, all
  1103.     users with a security level of 50 and above will not be permitted in the
  1104.     door.  Most often, this feature will come in handy for WWIV sysops who
  1105.     have installed CBV as part of their CHAINS menu.
  1106.  
  1107.     Security Level Settings
  1108.     The next six (6) options deal with specific security levels that you wish
  1109.     to award users with for certain call backs.  Each one contains the
  1110.     following in a submenu:
  1111.  
  1112.          System SL (SL)
  1113.          This is the security level that you wish to assign the user for main
  1114.          BBS access.
  1115.  
  1116.          Download SL (DSL)
  1117.          Mainly for WWIV systems, this is the SL you wish to assign the user
  1118.          for transfer/file area access.
  1119.  
  1120.          Exemptions
  1121.          Mainly for WWIV systems, this defines the exemption that you wish to
  1122.          assign the user.  It is a number ranging from 0 to 255.  Please
  1123.          consult your WWIV documentation for more information on each
  1124.          exemption.
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.                                    Page 16
  1131.  
  1132.          Restrictions
  1133.          Mainly for WWIV systems, this defines the restrictions that you wish
  1134.          to assign/toggle for users.  WWIV's restrictions follow the order of
  1135.          LCMA*PEVKNU.  Each restriction may be turned on, off, toggled, or
  1136.          left alone via this option.  See the section below on restriction
  1137.          and flag settings for information.
  1138.  
  1139.          User Flags (AR/DAR)
  1140.          This setting pertains to a user's flags.  With WWIV, sysops may
  1141.          recognize these better as the user's ARs and DARs.  Regardless, they
  1142.          work fundamentally the same for each and every BBS type that
  1143.          utilizes flags.  See the section below on restriction and flag
  1144.          settings for more information.
  1145.  
  1146.  
  1147.     Restriction and Flag Settings
  1148.  
  1149.     Datagen's CBV uses a very unique method for modifying a users
  1150.     restrictions and flags, which makes it possible for the verification door
  1151.     to work well with nearly all types of BBS software.
  1152.  
  1153.     User flags are used on BBS systems as a signal that a particular user has
  1154.     access (and in some cases, does not have access) for some particular
  1155.     function of the BBS.  Sysops can use flags to signify if a user has done
  1156.     certain things, or signify users with extra-special access to areas that
  1157.     regular users don't get.  With Remote Access type systems, the flags are
  1158.     divided into four (4) groups of eight (8) flags, known as A1-A8, B1-B8,
  1159.     C1-C8, and D1-D8.  WWIV flags (better known as ARs and DARs) are divided
  1160.     into two (2) groups of sixteen (16) flags as A-P for ARs, and A-P for
  1161.     DARs.  (And it's not coincidence that this is exactly the same number of
  1162.     flags for both software types)
  1163.  
  1164.     With CBV, each flag can be represented as a dash (-) in the configuration
  1165.     program.  For Remote Access, this would be:
  1166.  
  1167.     -------- -------- -------- --------
  1168.     A1 - A8  B1 - B8  C1 - C8  D1 - D8
  1169.  
  1170.     For WWIV, this would be:
  1171.  
  1172.     ---------------- ----------------
  1173.     ABCDEFGHIJKLMNOP ABCDEFGHIJKLMNOP
  1174.  
  1175.     When you start CBVCFG for the first time (or when a configuration file is
  1176.     not found), the flags section for each security level will be defined to
  1177.     either of the two (or blank), depending on the BBS software you are
  1178.     running.
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.                                    Page 17
  1188.  
  1189.     A dash (-) symbol in a flag slot signifies that CBV is to leave that flag
  1190.     UNCHANGED.  Placing an X, or a letter in a specific flags slot will tell
  1191.     CBV to turn that flag on.  Placing an equals sign (=) in a specific flags
  1192.     slot will tell CBV to turn that flag off, and placing a percent sign (%)
  1193.     will tell CBV to toggle the current state of the flag (ie. if it's on,
  1194.     turn it off, and if it's off, turn it on).  Spaces in the flags and
  1195.     restriction settings are ignored.  You may include spaces to keep your
  1196.     flag sections separated into their corresponding groups.  Dashes and/or
  1197.     symbols beyond the length of all the flags are ignored.
  1198.  
  1199.     Again:
  1200.  
  1201.           "-"          = Leave Flag Alone.  Do Not Modify It.
  1202.           "A-Z", "0-9" = Turn Flag On.
  1203.           "="          = Turn Flag Off.
  1204.           " "          = Ignore.
  1205.  
  1206.  
  1207.     With that in mind, if we tell CBV the following configuration for a flags
  1208.     setting:
  1209.  
  1210.     -X-----= ---%---- -------- -----%--
  1211.  
  1212.     The A2 flag will be turned on, the A8 flag will be turned off, and the B4
  1213.     and D6 flags current states will be toggled.  All other flags will remain
  1214.     at their current setting.
  1215.  
  1216.     Likewise, for a WWIV system, if the following configuration for a flags
  1217.     setting was given:
  1218.  
  1219.     ----X----------- --=-------K---%-
  1220.  
  1221.     The E AR, and the K DAR would be turned on, the C DAR would be turned
  1222.     off, and the O DAR would be toggled.  All other flags would remain
  1223.     unchanged.
  1224.  
  1225.     Restrictions work the same way.  WWIV's restrictions are again, in the
  1226.     order of LCMA*PEVKNU, so given the following example of:
  1227.  
  1228.     -X---=-VK--
  1229.  
  1230.     The C, V, and K restrictions would all be turned on, while the P
  1231.     restriction would be turned off.  Notice that you can use a symbolic
  1232.     letter (or asterisk) as well as the 'X' to turn on specific ARs, DARs,
  1233.     and restrictions.  All other restrictions in this example would remain
  1234.     unchanged.
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.                                    Page 18
  1245.  
  1246.     Regular User SL
  1247.     This security level and settings is assigned to a user who successfully
  1248.     completes the call back verification process.
  1249.  
  1250.     Long Distance SL
  1251.     Users that call long distance can have a special security level after
  1252.     they have been validated.  If LD callbacks have been disabled, this menu
  1253.     option has no effect.
  1254.  
  1255.     Bad Password SL
  1256.     If a use enters an incorrect password the maximum number of times, you
  1257.     can instruct CBV to assign them this security level and settings.  This
  1258.     security level serves just that purpose.  If password asking has been
  1259.     disabled, this option has no effect.
  1260.  
  1261.     Aborted SL
  1262.     If a user aborted the callback, then this security level is assigned to
  1263.     them.
  1264.  
  1265.     Bad Number SL
  1266.     If a user desires a callback at a number listed in the bad phone numbers
  1267.     file, this security level is assigned to them.
  1268.  
  1269.     Duplicate Number SL
  1270.     If a user has a duplicate number (one that CBV has already validated),
  1271.     CBV will assign this specific security level to them.
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.                                    Page 19
  1302.  
  1303.     Modem
  1304.     ─────
  1305.  
  1306.     The modem menu lists options specific to controlling the modem during the
  1307.     callback process.  With the modem string commands you may enter these
  1308.     additional characters that are interpreted by CBV:
  1309.  
  1310.     | = Carriage Return - most of your commands should end with this. 
  1311.     Without this at the end of a modem command, your modem will not recognize
  1312.     the commands.  The exception to this rule is the dial command.  It is
  1313.     important that you DO NOT place this at the end of the dial command.
  1314.  
  1315.     ~ = Pause 1/4s - this character will cause CBV to pause for a quarter of
  1316.     a second while sending the string to the modem.
  1317.  
  1318.     ^ = Raise DTR - this character, if included in a modem string will tell
  1319.     CBV to raise the DTR.  This is the same as picking up the modem and
  1320.     taking it "off-hook."
  1321.  
  1322.     v = Lower DTR - is a character that will tell CBV to lower the DTR line.
  1323.     This has the same affect as hanging up the modem or putting it "on-hook."
  1324.     Please note that this is a LOWER CASE v.
  1325.  
  1326.  
  1327.     Hardware
  1328.     Under the hardware submenu, you'll find configuration options specific to
  1329.     the modem port that this configuration of CBV will be using.  Each is
  1330.     listed below:
  1331.  
  1332.          Port Number
  1333.          Specify which communications port your modem is hooked up to.  If
  1334.          you'd like, CBV can read this number from your DOOR.SYS BBS
  1335.          dropfile.  Simply enter the port number here, or a zero (0) if you
  1336.          want CBV to read it from the BBS dropfile.
  1337.  
  1338.          Base Address
  1339.          This is the base address (in hexadecimal notation) of your modem com
  1340.          port as defined in the Port Number configuration option.  Default
  1341.          address for ports 1 through 4 are 3F8, 2F8, 3E8, 2E8 respectively.
  1342.  
  1343.          Base IRQ
  1344.          The IRQ/Interrupt value for the assigned port number.  IRQ numbers
  1345.          for com ports 1 through 4 are 4, 3, 4, 3 respectively.
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.                                    Page 20
  1359.  
  1360.     Escape Command
  1361.     This is the command that will make a modem already connected to another
  1362.     modem go into command mode, allowing the use of "AT" commands.  For most
  1363.     modems, this is three plus signs in a row (+++).  Your modem may require
  1364.     a delay before and after this command.  Enter enough pauses (~) to
  1365.     suffice.
  1366.  
  1367.     Hangup
  1368.     This command tells your modem to hangup, or go on-hook.  Usually, this
  1369.     string should be set to the default, vATH0|.  The lower-case "v" that is
  1370.     in this string as the default lowers the DTR line of the modem.  In most
  1371.     cases, this will cause the modem to hang up.  If you experience problems
  1372.     with CBV hanging up, you may want to remove the "v" from this string.  It
  1373.     is not necessary to enter the escape command (+++) in front of the hangup
  1374.     string, as CBV will do that automatically during the callback.
  1375.  
  1376.     Dial Prefix
  1377.     This command precedes the number in a dialing command.  More often than
  1378.     not, this string should be set to the default of ATDT, and you SHOULD NOT
  1379.     place a carriage return at the end of it.  Some individuals may discover
  1380.     that they will need to dial a number to get an outside line before a call
  1381.     can be placed.  If so, you can add the correct dialing sequence in this
  1382.     slot.  For example, if you need to dial a nine (9) to get an outside
  1383.     line, you could set your dialing prefix to "ATDT9~" to dial 9 and pause
  1384.     for a quarter of a second.  CBV will automatically add the number to be
  1385.     dialed and a carriage return to the end of this string.
  1386.  
  1387.     Pickup
  1388.     This command, often known as the off-hook string is the command that
  1389.     tells your modem to pickup, or go off-hook.  The default string of ATH1|
  1390.     should suffice, however, you may need to add a raise DTR command.
  1391.  
  1392.     Modem Init
  1393.     This string is sent to your modem before each dial.  This command should
  1394.     merely set your modem to return "voice" or text connect messages and turn
  1395.     the speaker off if enabled.  The default string, with most Hayes
  1396.     compatible modems, does just that.  ATQ0V1X4M0|
  1397.  
  1398.  
  1399.     The modem responses are keywords returned by your modem when certain
  1400.     events occur.  These should all be in capital letters with no spaces
  1401.     before or after the string.  The defaults are pretty much standard for
  1402.     Hayes compatible modems.
  1403.  
  1404.  
  1405.     OK
  1406.     Otherwise known as the "ready response," this is the response sent by the
  1407.     modem indicating that the last command was processed completely without
  1408.     any errors.  Usually this is simply set to "OK."
  1409.  
  1410.     NO CARRIER
  1411.     When a modem detects that no carrier was present to connect with, this
  1412.     result is returned.  The default setting of "NO CARRIER" should be
  1413.     sufficient.
  1414.  
  1415.                                    Page 21
  1416.  
  1417.     NO DIAL TONE
  1418.     When dialing, sometimes there may not be a dial tone for various reasons. 
  1419.     When the modem detects that no dial tone is present, it returns this
  1420.     string.  The default for this string is set to "NO DIAL."
  1421.  
  1422.     CONNECT
  1423.     This is the base for the connect response generated upon a successful
  1424.     connection.  This string should be set to what your modem returns when it
  1425.     connects, minus the baud/bps rate.  For most modems this is either the
  1426.     default setting of "CONNECT," or "CARRIER."
  1427.  
  1428.     For example, if your modem returns "CONNECT 2400" upon a successful 2400
  1429.     baud connection, you would put "CONNECT" in this option, however, if your
  1430.     modem returned "CARRIER 38400," then you would need to specify "CARRIER"
  1431.     here.  Be sure that you do not include the baud/bps rate in this option.
  1432.  
  1433.     RING
  1434.     When the line rings that your modem is connected to, the modem will
  1435.     generate this response.  This is almost always "RING."
  1436.  
  1437.     BUSY
  1438.     The busy response is the response when a call reports a busy signal. 
  1439.     This is almost always "BUSY."
  1440.  
  1441.     VOICE
  1442.     Some modems have a feature that detects when a person talks into the
  1443.     phone.  These modems usually have a result code of "VOICE" when such a
  1444.     detection is made.  If your modem supports this feature, enter the return
  1445.     string here.  CBV will log all voice pickups.
  1446.  
  1447.  
  1448.     Result Wait
  1449.     This is the amount of seconds that CBV will wait for the OK results code
  1450.     to be returned by the modem after commands.  If the OK results code is
  1451.     not received in this time, CBV will abort back to the system.
  1452.  
  1453.     Carrier Wait
  1454.     Maximum wait time for carrier specifies the amount of time, in seconds,
  1455.     that you wish CBV to wait after a dial before determining that no
  1456.     connection will be made.  The default value of 60 seconds should be fine,
  1457.     however, you may find that you can safely set this to 30 seconds.  Be
  1458.     sure that there is enough time for your modem to connect.  If not, your
  1459.     modem may be in the connection process when this time limit runs out, and
  1460.     CBV will hang up.
  1461.  
  1462.     Redial Pause
  1463.     This setting defines the number of seconds to wait between each dial
  1464.     attempt to the user.  CBV will also pause for this amount of time before
  1465.     the first dial attempt to give the user time to prepare.
  1466.  
  1467.     Dial Attempts
  1468.     Maximum attempts for callback specifies the total number of times that
  1469.     you wish CBV to try for a connect.  The default of 3 callback attempts
  1470.     should be sufficient.
  1471.  
  1472.                                    Page 22
  1473.  
  1474.     Numbers
  1475.     ───────
  1476.  
  1477.     This menu sports some features that deal with already validated numbers,
  1478.     numbers that CBV is not allowed to call, and valid exchanges and area
  1479.     codes that are local to your calling area.
  1480.  
  1481.     Validated Numbers
  1482.     This option will simply display the file CBVNUMS.DAT, which contains each
  1483.     number validated by CBV.
  1484.  
  1485.     Bad Numbers
  1486.     This menu selection will bring up an input window.  Here, you may enter
  1487.     all of the numbers, and parts of numbers, that you do not wish CBV to
  1488.     call.  To enter a number, or part of a phone number, simply being typing
  1489.     that phone number.  To delete a number, move the highlight bar to the
  1490.     number you wish to delete, and press the delete key on your keyboard.
  1491.  
  1492.     Simply put any number that you don't want CBV to callback in this menu
  1493.     entry.  Or put a section of a number in this file to limit multiple phone
  1494.     number restrictions.  For example, if the numbers 555-1212 (directory
  1495.     assistance), 123-1234, and 123-4567 were entered in this menu option,
  1496.     they will not be called.  If 911- or 411- were included, any numbers that
  1497.     include 911- or 411- will also be avoided. Be sure to include the dash
  1498.     after three digit numbers.  If the 911- was entered as just 911 (no
  1499.     dash), all numbers that had 911 in them would be restricted, ie. 
  1500.     851-9112, 234-0911, etc.  Using the dash as the end will restrict a
  1501.     three-digit number.
  1502.  
  1503.     See the section on Controlling Bad Numbers for more information.
  1504.  
  1505.     Valid Exchanges
  1506.  
  1507.     By default, CBV will simply ask the user if their phone number is long
  1508.     distance from the BBS.  If you'd like CBV to already know if a user's
  1509.     number is local or not, you can configure the local exchanges for each
  1510.     local area code to your system.
  1511.  
  1512.     The exchange part of a phone number is the first three digits of a seven
  1513.     digit number.  For example, in 275-5996, 275 is the exchange.  Each
  1514.     calling area in a given area code may call specific exchanges charge-free
  1515.     by the telephone company.  You can usually find a listing of toll-free
  1516.     exchanges in the first few pages of your residential phone book.  If not,
  1517.     call your local telephone company to acquire a listing.
  1518.  
  1519.     To enter exchanges for each area code, simply select the "Valid
  1520.     Exchanges" menu option.  Next, a list of local defined area codes will be
  1521.     presented to you.  Select the area code that you wish to modify exchanges
  1522.     for.  Another window will replace the area code listing, and you may
  1523.     begin entering exchanges for that area code.  To enter an exchange,
  1524.     simply start typing the three digit number, and press Enter to save it in
  1525.     the list.  To delete a number from the list, move the highlight bar to
  1526.     the one you wish to delete, and press the delete key on your keyboard.
  1527.  
  1528.     See the section on Defining Local Numbers With Area Codes And Exchanges
  1529.     for more information.
  1530.  
  1531.                                    Page 23
  1532.  
  1533.     Options
  1534.     ───────
  1535.  
  1536.     This menu controls some various miscellaneous features of CBV.  Each
  1537.     setting can either be 'yes' or 'no'.  To change the selected feature,
  1538.     simply press the Enter or space bar.
  1539.  
  1540.     Ask Password
  1541.     When a successful connection is made in CBV, you can instruct the program
  1542.     to ask for the login password the user used to log onto the system with. 
  1543.     Setting this to yes enables this feature.   CBV will ask the user for
  1544.     their password the number of times that you configured CBV to under the
  1545.     security menu.
  1546.  
  1547.     Allow Walk-through
  1548.     Datagen's CBV features a walk through explanation of the call back
  1549.     verification process.  If you wish your users to be able to use this walk
  1550.     through to learn exactly what it's like to do a call back, enable this
  1551.     feature.  The choice will be presented to them from the main menu.
  1552.  
  1553.     Allow New Numbers
  1554.     This setting, when enabled, will add a menu selection from CBV's main
  1555.     menu to allow the user to enter a number other than their voice or data
  1556.     number to be called back at.  CBV will also ask for a reason, and write
  1557.     that reason to the log file (if enabled), as well as the number called
  1558.     itself.  CBV will not call a user-entered number until the reason has
  1559.     been answered.
  1560.  
  1561.     This may be handy for some user's that may be calling from a friend's
  1562.     house.  However, it can be a major downfall to system security.  For
  1563.     example, a user could call your system, say they are someone, enter a
  1564.     "supposed" number as their voice and data phone numbers, and be validated
  1565.     at a totally different number via this feature if it is enabled. 
  1566.     However, CBV will log the phone number used, and if the phone in user
  1567.     note feature is enabled, will also put the phone number the user was
  1568.     called back at in their sysop comment field of their user record
  1569.     information.
  1570.  
  1571.     Allow LD Validations
  1572.     If enabled, this will allow CBV to call long distance numbers back for
  1573.     validation.  YOU WILL BE CHARGED FOR THE CALL UNTIL THE USER HANGS UP! 
  1574.     If you wish to not be charged any additional amount after the user has
  1575.     been validated, be sure to instruct CBV to hangup on the LD users after
  1576.     validation.  Changing this option to yes from a setting of no will bring
  1577.     up the Long Distance Hours window.  In this window, you can set the days
  1578.     and hours that you wish to allow and disallow long distance call-backs. 
  1579.     Setting this feature to no disables the LD hours submenu.
  1580.  
  1581.          Each day appears on the menu with two times in 24 hour format
  1582.          (00:00-23:59).  Simply move the highlight bar to the day that
  1583.          you wish to define the hours for and press the enter key. 
  1584.          CBV's day begins at 00:00 (midnight), and ends at 23:59
  1585.          (11:59pm).  Leaving a specific day blank will disable long
  1586.          distance call backs on that specific day.
  1587.  
  1588.                                    Page 24
  1589.  
  1590.          For example, if we define Sunday to have the following hours:
  1591.  
  1592.               12:00 - 19:00
  1593.  
  1594.          Long distance callbacks will only be allowed between the
  1595.          hours of noon and 7:00pm.  Likewise, if we defined the
  1596.          hours of:
  1597.  
  1598.               00:00 - 23:59
  1599.  
  1600.          Long distance callbacks would be allowed all day long.
  1601.  
  1602.          If you wish to have long distance callbacks allowed from 9:00pm on
  1603.          Monday to 7:00am Tuesday, you would need to specify times as
  1604.          follows:
  1605.  
  1606.               Monday:     21:00 - 23:59
  1607.               Tuesday:    00:00 - 07:00
  1608.  
  1609.          As you can see, Tuesday begins at midnight, therefore, the times
  1610.          after midnight (12:01am - 7:00am) must be defined on Tuesday, while
  1611.          the times before midnight are still officially Monday, and must be
  1612.          defined as such.
  1613.  
  1614.          Sysops may wish to use this feature to only allow LD callbacks
  1615.          during the least expensive times of the day, and on weekends.
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.                                    Page 25
  1646.  
  1647.     Hangup After LD
  1648.     After a long distance validation, you have the option to hang up on the
  1649.     caller so that he/she can call the system back.  If enabled, CBV will
  1650.     hang up on a long distance caller after successful callback.  It is
  1651.     suggested that if you are enabling LD callbacks, that you also enable
  1652.     this feature to minimize long distance charges.  If CBV calls a LD number
  1653.     back for verification, and you do not hang up on the user, YOU WILL BE
  1654.     CHARGED BY YOUR PHONE COMPANY FOR THE REMAINDER OF THE USERS TIME!
  1655.  
  1656.     Hangup Aborted User
  1657.     If a user aborts the call back process, you can also have CBV hang up on
  1658.     them as well.  Enable this feature if you wish to hang up on users that
  1659.     abort CBV by quitting the program before being called back.
  1660.  
  1661.     Hangup Bad Password
  1662.     As well as for users that abort CBV, you can also have CBV hang up on
  1663.     users that enter the incorrect password too many times.  Enable this
  1664.     feature if you would like CBV to hang up after the user enters the
  1665.     incorrect password too many times as defined under the security menu.
  1666.  
  1667.     Hangup After Callback
  1668.     If this feature is enabled, CBV will hang up on ALL users after
  1669.     validation.
  1670.  
  1671.     Validated Duplicates
  1672.     CBV logs every call that it makes and successfully connects to to a file
  1673.     called CBVNUMS.DAT.  If this feature is disabled, CBV will not let a user
  1674.     with a number contained in that file to be validated.
  1675.  
  1676.     Auto-Validate Duplicates
  1677.     CBV also has the ability to automatically upgrade users whose number has
  1678.     already been validated by CBV in the past.  This feature can be handy for
  1679.     users who get deleted by the system due to lack of regular calls to the
  1680.     system.  If this feature is enabled, CBV will not call the user back to
  1681.     verify that they exist if their phone number to be called back at is
  1682.     found in the CBVNUMS.DAT file, and upgrade their security accordingly.
  1683.  
  1684.     Phone In User Note
  1685.     If enabled, will tell CBV to write the phone number that the user was
  1686.     validated at to the sysop comment/note line of the user's record.
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.                                    Page 26
  1703.  
  1704. ─────────────────────────────────────────────────────────────────────────────
  1705.  ░ Controlling Bad Numbers ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1706. ─────────────────────────────────────────────────────────────────────────────
  1707.  
  1708.     The CBVBAD#.DAT file is the control file to disallow calls to certain
  1709. phone numbers.  This file is a plain text file and can be edited with any
  1710. text editor that saves in plain text format.  Lines that begin with
  1711. semi-colons (;) and blank lines are ignored.  Below is an example CBVBAD#.DAT
  1712. file.
  1713.  
  1714.  
  1715. ; CBV v1.2
  1716. ; (c) 1995 Datagen Software Designs
  1717. ; written & programmed by John Dailey
  1718. ;
  1719. ; Bad phone number control file
  1720. ;
  1721. ; Lines preceded with a semi-colon (;) are considered comment lines.  Blank
  1722. ; lines are ignored.   Enter each phone number that you wish not to be
  1723. ; called.  Entering a part of a phone number will disable calls to any phone
  1724. ; number that contains the section listed.
  1725. ;
  1726. ; ie.  If 111 is listed in this file, all numbers that contain '111' in them
  1727. ; will not be called.  That means that 855-1110 will not be called, nor will
  1728. ; 111-4561, 855-2111, or 111-855-1231.
  1729. ;
  1730. ; To disable calls to certain area codes, simply put a three digit area code
  1731. ; followed by a dash as in '102-'.  All area code '102' numbers in this
  1732. ; example will not be called.
  1733. ;
  1734. ; Sysops may wish to put their BBS number in this file as well as the few
  1735. ; listed below for added security.
  1736.  
  1737. 911-
  1738. 411-
  1739. 555-1212
  1740. 123-1234
  1741. 123-4567
  1742.  
  1743. ; End of bad phone number control file
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.                                    Page 27
  1760.  
  1761. ─────────────────────────────────────────────────────────────────────────────
  1762.  ░ Defining Local Numbers With Area Codes And Exchanges ░░░░░░░░░░░░░░░░░░░░
  1763. ─────────────────────────────────────────────────────────────────────────────
  1764.  
  1765.     Area codes and phone number exchanges are the key to deciphering what
  1766. phone numbers are local and long distance from your BBS.  A basic U.S. phone
  1767. number can be split up into four parts:
  1768.  
  1769.      1-407-275-5996
  1770.      │  │   │   │
  1771.      │  │   │   Extension
  1772.      │  │   │
  1773.      │  │   Exchange
  1774.      │  │
  1775.      │  Area Code
  1776.      │
  1777.      Country Code (LD access code)
  1778.  
  1779.     As you can see in the phone number above, the first group of three
  1780. numbers after the country code is the area code (407), and the exchange (275)
  1781. is the first three non-area code digits of a phone number.  Each specific
  1782. area code (depending on where you are calling from) has a list of exchanges
  1783. that can be called toll free.
  1784.  
  1785.     Local exchanges for a particular area code can usually be found in the
  1786. front few pages of your residential phone book.  Call your local telephone
  1787. company for information on obtaining a listing if you cannot find one.
  1788.  
  1789.     By default, only defining the area codes that are local to you will
  1790. configure CBV to simply ask each user if their number is long distance from
  1791. your BBS.  Instead of leaving this up to your users, you may want CBV to be
  1792. able to tell automatically.  This is easily accomplished by configuring CBV
  1793. with all local area codes, and their respective exchanges via CBVCFG. 
  1794. Advantages of this feature are only for system security.  Setting up your
  1795. copy of CBV to recognize local numbers will keep users from having your CBV
  1796. call long distance numbers for "the fun of it," or by accident.
  1797.  
  1798.     To define your local calling exchanges, simply enter CBVCFG and modify
  1799. the settings to reflect your calling area.  First, under the BBS menu, add in
  1800. all area codes that are local (non-LD) to your system's phone number.  Up to
  1801. 25 local area codes can be defined.  Next, choose the "Numbers" menu, select
  1802. each area code, and enter each exchange as listed in your phone book,
  1803. respectively.  A maximum of 600 exchanges can be defined per each area code.
  1804.  
  1805.     Beginning with version 1.2 of Datagen's Call Back Verification System,
  1806. all area code and exchange information is saved in one file named
  1807. CBVAREA.DAT.  This file is a simple plain ASCII text file with each area code
  1808. listed in succession.  Under each area code are the valid exchanges for that
  1809. area code, and each group of area code/exchanges is separated by a blank
  1810. line.  Below is an example area code and exchange configuration file:
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.                                    Page 28
  1817.  
  1818. ; CBV v1.2
  1819. ; (c) 1995 Datagen Software Designs
  1820. ; written & programmed by John Dailey
  1821. ;
  1822. ; Local Area Codes And Exchanges Control File
  1823. ;
  1824. ; Lines preceded with a semi-colon (;) are considered comment lines.  Blank
  1825. ; lines are ignored.   Enter each area code that is local to your BBS on
  1826. ; individual lines, followed by all exchanges associated with that area code.
  1827. ; Separate each group of area codes and exchanges with a blank line:
  1828. ;
  1829. ; 407  (Area Code)
  1830. ; 855  (Exchange)
  1831. ; 857  (Exchange)
  1832. ; 275  (Exchange)
  1833. ;
  1834. ; 305  (Area Code)
  1835. ; 565  (Exchange)
  1836. ;
  1837. ; 215  (Area Code)
  1838. ; ...etc.
  1839. ;
  1840.  
  1841. 407
  1842. 855
  1843. 857
  1844. 275
  1845. 658
  1846.  
  1847. ; End Of Area Code And Exchanges Configuration File
  1848.  
  1849.     In the above example, only the 407 area code is local to the BBS.  The
  1850. only exchanges that are local are 855, 857, 275, and 658.  Any others are
  1851. considered long distance.  In this example, if a user was to call with the
  1852. phone number 407-275-5996, CBV would know that this number is local because
  1853. its exchange (275) is listed in the exchange configuration for its area code
  1854. (407).  However, if a user with the phone number 407-294-9446 entered CBV,
  1855. CBV would only call that number if the sysop has allowed long distance
  1856. callbacks because it's exchange (294) is not listed as a local number for the
  1857. BBS's 407 area code.  A phone number of 305-123-1234 would also be considered
  1858. long distance simply because the area code is not listed as a local area code
  1859. in the above example.
  1860.  
  1861.  
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.                                    Page 29
  1874.  
  1875. ─────────────────────────────────────────────────────────────────────────────
  1876.  ░ Running CBV From The BBS ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  1877. ─────────────────────────────────────────────────────────────────────────────
  1878.  
  1879.     The last steps in configuring CBV is to create the actual batch files
  1880. that you will call from your BBS software to run the door, and modify your
  1881. BBS to call those batch files.  It is suggested that you place CBV's batch
  1882. file in your main BBS directory, however, it is not required that you do so.
  1883.  
  1884.     CBV as it is to be run online requires three different command line
  1885. parameters.  Running CBV with no parameters will bring up a display screen
  1886. showing the correct calling method for the program.  These parameters,
  1887. in order they must appear on the command line, are:
  1888.  
  1889.     CBV.EXE <drop file> <configuration filename> <CBV_PPP.DAT location>
  1890.  
  1891.     <drop file> - The full path and filename of your BBS drop file. 
  1892.          Currently, DOOR.SYS and CHAIN.TXT are the two directly supported
  1893.          drop file formats from within CBV.  Using a door drop file converter
  1894.          such will make many more drop files usable.
  1895.  
  1896.     <configuration filename> - The full path and filename of your CBV
  1897.          configuration file.  This command line parameter makes it easy to
  1898.          incorporate different configuration files for specific nodes,
  1899.          different modems, etc.
  1900.  
  1901.     <CBV_PPP.DAT location> - The full path to where CBV can find the CBV
  1902.          Pre/Post-Processor data file as created by the processor software
  1903.          (CBV_PPP.DAT).  The CBV_PPP.DAT file is what CBV uses to read and
  1904.          write the user's information.  CBV will not function if it does not
  1905.          find this file.  For more information on the CBV_PPP processor file,
  1906.          refer to the section on the Pre/Post-Processor concept, and the
  1907.          section on setting up CBV's included Pre/Post-Processors.
  1908.  
  1909.     Depending on your Pre/Post-Processor software, you will probably also
  1910. need to specify a few parameters on its command line as well.  Refer to the
  1911. processor's documentation for specific details when dealing with processor's
  1912. not included with the distribution archive of CBV.
  1913.  
  1914.  
  1915.     Your basic CBV batch file should consist of three lines:
  1916.  
  1917.     1.  A call to the Pre/Post-Processor to read the user's information and
  1918.         create the CBV_PPP.DAT file.
  1919.  
  1920.     2.  A call to the actual CBV program with needed command-line parameters.
  1921.  
  1922.     3.  A call to the Pre/Post-Processor to read the CBV_PPP.DAT file and
  1923.         update the user's information.
  1924.  
  1925.  
  1926.  
  1927.  
  1928.  
  1929.  
  1930.                                    Page 30
  1931.  
  1932. Installation for systems using EXITINFO.BBS (Remote Access, ProBoard)
  1933.  
  1934.  
  1935.     For RA BBS Systems, your batch file should resemble the following:
  1936.  
  1937.     @ECHO OFF
  1938.     CD\RA\CBV
  1939.     EXIT_PPP -R C:\RA\ C:\RA\
  1940.     CBV C:\RA\DOOR.SYS C:\RA\CBV\CBV.CFG C:\RA\
  1941.     EXIT_PPP -W C:\RA\ -D
  1942.     CD\RA
  1943.  
  1944.     After creating a batch file, create a menu option from your BBS that will
  1945. run that batch file.  For Remote Access v2.00+, the correct command line
  1946. (assuming you've installed it into the example directories) is shown below:
  1947.  
  1948.     *C /C C:\RA\CBV.BAT *M
  1949.  
  1950.     The *C tells Remote Access to engage a DOS shell that will not remain
  1951. permanent (the /C tells DOS that), and run the batch file CBV.BAT located in
  1952. the main BBS directory.  The *M parameter instructs Remote Access to swap its
  1953. memory.  This swapping may not be necessary for your system.
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.                                    Page 31
  1988.  
  1989. Installation for systems using DOOR.SYS (TriBBS)
  1990.  
  1991.  
  1992.     @ECHO OFF
  1993.     CD\TRIBBS\CBV
  1994.     DOOR_PPP -R C:\TRIBBS\DOOR.SYS C:\TRIBBS\CBV
  1995.     CBV C:\TRIBBS\DOOR.SYS C:\TRIBBS\CBV\CBV.CFG C:\TRIBBS\CBV
  1996.     DOOR_PPP -W C:\TRIBBS\DOOR.SYS C:\TRIBBS\CBV -D
  1997.     CD\TRIBBS
  1998.     BOARD.BAT
  1999.  
  2000.     Sample doors menu line for TriBBS:
  2001.  
  2002.     D,Call Back Verification,CBV.BAT,10
  2003.  
  2004.     The 'D' at the beginning of the line signifies that TriBBS is to create
  2005.     the DOOR.SYS type dropfile before running the batch file CBV.BAT.  The 10
  2006.     at the end of the line signifies that users must have at least a security
  2007.     level of 10 to choose this menu option.
  2008.  
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.  
  2044.                                    Page 32
  2045.  
  2046. Installation for WWIV BBS systems
  2047.  
  2048.  
  2049.     For WWIV users, you may either call the CBV batch file from your new user
  2050. event, or from your on-line programs menu.  Wherever you decide to call CBV
  2051. from, be sure to shrink the BBS, usually done via a menu/setup option.  Below
  2052. is a sample batch file for WWIV systems.
  2053.  
  2054.     CD\WWIV\CBV
  2055.     WWIV_PPP -R C:\WWIV\CBV\WWIV_PPP.CFG
  2056.     CBV C:\WWIV\CHAIN.TXT C:\WWIV\CBV\CBV.CFG C:\WWIV\
  2057.     WWIV_PPP -W C:\WWIV\CBV\WWIV_PPP.CFG -D
  2058.     CD\WWIV
  2059.  
  2060.     If you are calling CBV from your chains menu in WWIV, be sure that you
  2061. have turned DOS calls OFF, and set the BBS to shrink before running the
  2062. program.  Not setting the shrink to be on will cause CBV to not update the
  2063. user's time remaining online before returning control back to the BBS.  All
  2064. other settings are left to the sysop's discretion.  CBV does not require that
  2065. your users have ANSI graphics capabilities in order to function.
  2066.  
  2067.  
  2068.     Basic installation and configuration is now complete.
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.  
  2088.  
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.                                    Page 33
  2102.  
  2103. ─────────────────────────────────────────────────────────────────────────────
  2104.  ░ Pre/Post-Processors ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2105. ─────────────────────────────────────────────────────────────────────────────
  2106.  
  2107.     Datagen's CBV comes with three complete Pre/Post-Processor programs.  One
  2108. for systems utilizing the EXITINFO.BBS dropfile (Remote Access, ProBoard),
  2109. one for systems using the DOOR.SYS dropfile for all record keeping purposes
  2110. (TriBBS), and one for WWIV BBS software.  They are named EXIT_PPP.EXE,
  2111. DOOR_PPP.EXE, and WWIV_PPP.EXE respectively.  Both has its unique command
  2112. line parameters, but they are very similar in most respects.  Running the
  2113. executable without any command line parameters will bring up a screen showing
  2114. the proper usage of the program.
  2115.  
  2116.     The proper command line for the EXITINFO.BBS (RA v2.00+, ProBoard)
  2117. Pre/Post-Processor is as follows:
  2118.  
  2119.     EXIT_PPP.EXE <-R | -W> <EXITINFO.BBS> <CBV_PPP.DAT> [-D]
  2120.  
  2121.     -R   Tells the processor to read the EXITINFO.BBS file, and write the
  2122.          CBV_PPP.DAT file.
  2123.  
  2124.     -W   Tells the processor to read the CBV_PPP.DAT file, and write changes
  2125.          (if any) to the EXITINFO.BBS file.
  2126.  
  2127.     <EXITINFO.BBS> Specifies the full path to the BBS's EXITINFO.BBS file
  2128.                    created when the system gives control to an external
  2129.                    program.  Usually created in the main BBS directory, or in
  2130.                    each node's directory.
  2131.  
  2132.     <CBV_PPP.DAT>  Specifies the full path of where to read from and write to
  2133.                    CBV's CBV_PPP.DAT file.  
  2134.  
  2135.     -D   Specifying this parameter will tell the Pre/Post-Processor to delete
  2136.          the CBV_PPP.DAT file after it has written changes to the
  2137.          EXITINFO.BBS file.  This option only takes affect when using the -W
  2138.          command line parameter.
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.                                    Page 34
  2159.  
  2160.     The proper command line for the DOOR.SYS (TriBBS) reading/writing
  2161. Pre/Post-Process is as follows:
  2162.  
  2163.     DOOR_PPP.EXE <-R | -W> <DOOR.SYS> <CBV_PPP.DAT> [-D]
  2164.  
  2165.     -R   Tells the processor to read the DOOR.SYS BBS dropfile, and write the
  2166.          CBV_PPP.DAT file.
  2167.  
  2168.     -W   Tells the processor to read the CBV_PPP.DAT file, and write changes
  2169.          (if any) to the BBS DOOR.SYS dropfile.
  2170.  
  2171.     <DOOR.SYS>     Specifies the full path to BBS's DOOR.SYS drop file
  2172.                    created when the system gives control to an external
  2173.                    program.  Usually created in the main BBS directory, or in
  2174.                    each node's directory.
  2175.  
  2176.     <CBV_PPP.DAT>  Specifies the full path of where to read from and write to
  2177.                    CBV's CBV_PPP.DAT file.  
  2178.  
  2179.     -D   Specifying this parameter will tell the Pre/Post-Processor to delete
  2180.          the CBV_PPP.DAT file after it has written changes to the
  2181.          EXITINFO.BBS file.  This option only takes affect when using the -W
  2182.          command line parameter.
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.  
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.                                    Page 35
  2216.  
  2217.     The WWIV Pre/Post-Processor command lines are:
  2218.  
  2219.     WWIV_PPP.EXE <-R | -W> <CONFIG> [-D]
  2220.  
  2221.     -R   Tells the processor to read the USERS.BBS file, and write the
  2222.          CBV_PPP.DAT file.
  2223.  
  2224.     -W   Tells the processor to read the CBV_PPP.DAT file, and write changes
  2225.          (if any) to the USERS.BBS file.
  2226.  
  2227.     <CONFIG>  Specifies the full path AND filename of the WWIV_PPP
  2228.               configuration file.  See the below section for more information
  2229.               on the format for this configuration file.
  2230.  
  2231.     -D   Specifying this parameter will tell the Pre/Post-Processor to delete
  2232.          the CBV_PPP.DAT file after it has written changes to the
  2233.          EXITINFO.BBS file.  This option only takes affect when using the -W
  2234.          command line parameter.
  2235.  
  2236.  
  2237.     The WWIV_PPP Configuration File
  2238.  
  2239.     To facilitate the possibility of some sysops running multi-node systems,
  2240. version 1.2+ of the WWIV Pre/Post-Processor uses a configuration file. 
  2241. Sysops should create a configuration file for each node of their BBS.  
  2242.  
  2243.     The format for this file is very similar to all the other text
  2244. configuration files for CBV.  Lines that are blank or preceded by a semi-
  2245. colon (;) are considered comments and ignored.  All other lines are
  2246. considered part of the configuration.  Each configuration file created should
  2247. contain the following options in this specified order:
  2248.  
  2249.     Path To Read/Write CBV_PPP.DAT CBV Pre/Post-Processor File
  2250.     Path To WWIV's User Record File USER.LST
  2251.     Path To Main BBS System Files
  2252.     Path And Filename Of BBS Drop File (CHAIN.TXT)
  2253.     Path And Filename Of BBS Shrink File (RESTORE.WWV)
  2254.  
  2255.     Below is a sample configuration file for the WWIV Pre/Post-Processor:
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.                                    Page 36
  2273.  
  2274. ; WWIV_PPP v1.2
  2275. ; (c) 1995 Datagen Software Designs
  2276. ; written & programmed by John Dailey
  2277. ;
  2278. ; WWIV_PPP Configuration File
  2279. ;
  2280. ; Lines that are blank or contain a semi-colon (;) as the first character are
  2281. ; considered comments and are ignored.  Enter each configuration option on
  2282. ; the start of a new line in the order shown below.
  2283. ;
  2284. ; Sysops who are running multi-node systems should create a configuration
  2285. ; file for each node that will be utilizing the WWIV Pre/Post-Processor.
  2286. ;
  2287.  
  2288. ; Path To Read/Write CBV_PPP.DAT CBV Pre/Post-Processor File
  2289. ; This path should be the same location you are instructing CBV to look for
  2290. ; the CBV_PPP.DAT file.  This file should be created in separate directories
  2291. ; for each node of your BBS.
  2292. \WWIV\CBV\
  2293.  
  2294. ; Path To WWIV's User Record File USER.LST
  2295. \WWIV\DATA\
  2296.  
  2297. ; Path To Main BBS System Files
  2298. \WWIV\
  2299.  
  2300. ; Path And Filename Of BBS Drop File (CHAIN.TXT)
  2301. ; For multi-node systems, you can specify filenames such as CHAIN.001,
  2302. ; CHAIN.002, etc. for each node.
  2303. \WWIV\CHAIN.TXT
  2304.  
  2305. ; Path And Filename Of BBS Shrink File (RESTORE.WWV)
  2306. ; This file is created when you instruct WWIV to shrink before running a
  2307. ; particular external program.  It is usually created in the main BBS
  2308. ; directory.  Multi-node systems will need to specify RESTORE.001,
  2309. ; RESTORE.002, etc. for each node.
  2310. \WWIV\RESTORE.WWV
  2311.  
  2312. ; End Of WWIV_PPP.CFG File
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.  
  2321.  
  2322.  
  2323.  
  2324.  
  2325.  
  2326.  
  2327.  
  2328.  
  2329.                                    Page 37
  2330.  
  2331.     Modified User Record Structures
  2332.  
  2333.     The WWIV Pre/Post-Processor that comes with Datagen's CBV also has the
  2334. capability to support both unmodified and modified user record structures. 
  2335. This support is accomplished via a offset configuration file named
  2336. WWIV_PPP.OFS.  This file contains the offsets (in bytes) for each item in the
  2337. user record needed by CBV.  If this file is not found, the unmodified user
  2338. record structure for WWIV v4.20+ will be assumed.
  2339.  
  2340.     WWIV_PPP.OFS must reside in the directory that WWIV_PPP.EXE is being
  2341. called from.  The offset configuration file is a plain ASCII text file, with
  2342. a configuration items residing on the beginning of each line.  Lines that
  2343. begin with a semi-colon (;) and blank lines are ignored by the processor,
  2344. thus allowing comments within the configuration file.  Below is a sample WWIV
  2345. Pre/Post-Processor offset configuration file.
  2346.  
  2347.  
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.  
  2386.                                    Page 38
  2387.  
  2388. ; WWIV_PPP v1.2
  2389. ; (c) 1995 Datagen Software Designs
  2390. ; written & programmed by John Dailey
  2391. ;
  2392. ; WWIV_PPP Offset Configuration File
  2393. ;
  2394. ; Each offset is the number of bytes from the beginning of the user record to
  2395. ; the specific data.  Calculate these numbers by adding the byte values for
  2396. ; each variable in the userrec, up to, but not inclusive of, the variable you
  2397. ; are defining.  Blank lines, and lines beginning with a semi-colon (;) are
  2398. ; ignored.  Below is a list of C variable types and their byte values.
  2399. ;
  2400. ; char   1 byte (for each character)
  2401. ; int    2 bytes
  2402. ; float  4 bytes
  2403. ; double 8 bytes
  2404. ;
  2405.  
  2406. ; Total Length Of User Record In Bytes (Add Up All Byte Values)
  2407. 1024
  2408.  
  2409. ; Offset To User's Handle (userrec.name)
  2410. 0
  2411.  
  2412. ; Offset To User's Real Name (userrec.realname)
  2413. 31
  2414.  
  2415. ; Offset To User's Voice Phone Number (userrec.phone)
  2416. 59
  2417.  
  2418. ; Offset To User's Data Phone Number (userrec.dataphone)
  2419. 72
  2420.  
  2421. ; Offset To User's Password (userrec.pw)
  2422. 165
  2423.  
  2424. ; Offset To User's Sysop Comment (userrec.note)
  2425. 192
  2426.  
  2427. ; Offset To User's Board Security Level (usrerec.sl)
  2428. 584
  2429.  
  2430. ; Offset To User's Download Security Level (userrec.dsl)
  2431. 585
  2432.  
  2433. ; Offset To User's Exemptions (userrec.exempt)
  2434. 586
  2435.  
  2436. ; Offset To User's AR Flags (userrec.ar)
  2437. 706
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.                                    Page 39
  2444.  
  2445. ; Offset To User's DAR Flags (userrec.dar)
  2446. 708
  2447.  
  2448. ; Offset To User's Restrictions (userrec.restrict)
  2449. 710
  2450.  
  2451. ; Offset To Active Security Level In RESTORE.WWV (actsl)
  2452. 266
  2453.  
  2454. ; End Of WWIV_PPP.CFG File
  2455.  
  2456.  
  2457.     All but the last offset can be found in the user record information file
  2458. (USERS.BBS).  The last offset, which references the file RESTORE.WWV is found
  2459. in the actual file RESTORE.WWV when WWIV shrinks to run an external program. 
  2460. The active security level (actsl), controls aspects such as time remaining
  2461. for the user.  It is important that this value is modified correctly after a
  2462. validation so that users will have the correct amount of time remaining after
  2463. validated.
  2464.  
  2465.  
  2466.  
  2467.  
  2468.  
  2469.  
  2470.  
  2471.  
  2472.  
  2473.  
  2474.  
  2475.  
  2476.  
  2477.  
  2478.  
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.                                    Page 40
  2501.  
  2502. ─────────────────────────────────────────────────────────────────────────────
  2503.  ░ User E-Mail Files ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2504. ─────────────────────────────────────────────────────────────────────────────
  2505.  
  2506.     Want to e-mail the user after a successful callback?  With the help of a
  2507. text-file import program you can do just that.  CBV sports the ability to
  2508. write a text file for import into your BBS e-mail to notify the user of
  2509. certain events.  Below are the specific files that may be created to be sent
  2510. as e-mail to the user:
  2511.  
  2512.     VOICE.MSG
  2513.     This file is copied if a user picked up voice during the callback
  2514.     process.  This feature will only work if your modem returns a result code
  2515.     for a voice pickup (VOICE).
  2516.  
  2517.     TIMEOUT.MSG
  2518.     If no connection was made at all during the callback due to a time-out,
  2519.     this message can be sent to the user specifying that for some reason, no
  2520.     connection was made to the user's modem within the given time limit.  It
  2521.     may have resulted from a wrong number.
  2522.  
  2523.     BUSY.MSG
  2524.     If the user's phone number was busy for all tries to callback, this
  2525.     message can be sent to the user explaining that they need to free up the
  2526.     line as soon as possible so that CBV may get through to their modem.
  2527.  
  2528.     FAILED.MSG
  2529.     A general callback failure message for the user.  If a callback fails,
  2530.     and any other failed message file is missing, this one will be copied for
  2531.     e-mail instead.
  2532.  
  2533.     SUCCESS.MSG
  2534.     This file is copied for e-mail for users that successfully completes the
  2535.     callback process.
  2536.  
  2537.     SUCCESSL.MSG
  2538.     This e-mail file is copied to be sent to users that are calling long
  2539.     distance, and have successfully completed the callback process.
  2540.  
  2541.  
  2542.     After creating the needed text files, you will need to specify what
  2543. filename that this message file is to be copied to via CBV's configuration
  2544. software.  Under the BBS menu, modify the "E-Mail File" parameter to meet
  2545. this specification.  You may include the complete path as well as the
  2546. filename in this option.  For example, if you need a file created in your
  2547. main BBS directory (C:\BBS) called INFILE.TXT, you would specify
  2548. C:\BBS\INFILE.TXT in the "E-Mail File" configuration slot.  CBV would then
  2549. copy the correct message file to that file for your import program to import
  2550. as e-mail.
  2551.  
  2552.     Please note that in order for this feature to work completely, you will
  2553. need to employ an external program that imports text files into your system's
  2554. e-mail data file.  You should install this program as the last command in
  2555. your CBV batch file before returning command to your BBS software.
  2556.  
  2557.                                    Page 41
  2558.  
  2559. ─────────────────────────────────────────────────────────────────────────────
  2560.  ░ ANSI/ASCII Display Files ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2561. ─────────────────────────────────────────────────────────────────────────────
  2562.  
  2563.     For the ability for sysops to have as much control over the look of the
  2564. CBV as possible, we've made nearly every display aspect of the program
  2565. external in the files listed below.  These files are standard ANSI files, and
  2566. can be modified to suit the look of your BBS.  An explanation of when each is
  2567. displayed is also listed.  Files with an .ANS extension are displayed to ANSI
  2568. (color) user's, while .ASC files are displayed to non-ANSI user's.  If a
  2569. particular ANSI display file is not found, CBV will display the ASCII
  2570. equivalent instead.
  2571.  
  2572.     Main Program Display Files
  2573.  
  2574.     CBVABORT.A??
  2575.     This file is displayed right after a user has opted to abort the callback
  2576.     and right before returning control back to the BBS.  It should explain
  2577.     that the user's security level has or has not been modified according to
  2578.     the sysop's configuration.
  2579.  
  2580.     CBVBAD# .A??
  2581.     This file is displayed if a user's phone number they wish to be called
  2582.     back at is entered in the bad phone numbers control file, and before
  2583.     returning control to the BBS.  This file should explain that the user's
  2584.     number is not allowable per CBV's configuration.
  2585.  
  2586.     CBVBADPW.A??
  2587.     This display file is displayed to a user who enters an incorrect password
  2588.     the maximum times after a successful callback, and before returning
  2589.     control to the BBS.  This file should let the user know that they have
  2590.     entered a bad password too many times, and their security level has or
  2591.     has not been adjusted.
  2592.  
  2593.     CBVBYELD.A??
  2594.     If the option to hang up on long distance callers is enabled, this file
  2595.     will be displayed right before dropping carrier on the long distance
  2596.     user.  This file should explain that the user is being hung up on to keep
  2597.     the sysop's costs down.
  2598.  
  2599.     CBVCHANG.A??
  2600.     This display file is displayed to the user when they wish to change the
  2601.     phone number to be called back at, and right before they are prompted for
  2602.     a reason for the change.
  2603.  
  2604.     CBVDIAL .A??
  2605.     Displayed to the user right before displaying the number that CBV is
  2606.     preparing to dial for the callback verification process, and before
  2607.     determining if a phone number is long distance or local to the system.
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.                                    Page 42
  2615.  
  2616.     CBVDUPE .A??
  2617.     If a user's phone number has already been validated, and the check
  2618.     duplicate numbers feature is enable, this file will be displayed right
  2619.     before returning control to the BBS.  It is not shown to users if the
  2620.     sysop has configured CBV to automatically upgrade users with duplicate
  2621.     numbers.   This file should explain that the user's number has already
  2622.     been validated by CBV, and therefore, is not allowed to call back.
  2623.  
  2624.     CBVHABT .A??
  2625.     This file is displayed to a user who aborts CBV and when CBV has been
  2626.     configured to hang up on aborted users after the CBVABORT.A?? file has
  2627.     been displayed.  This file should merely state that the BBS is now
  2628.     hanging up on the user.
  2629.  
  2630.     CBVHANG .A??
  2631.     This file is displayed after a user is successfully verified and if the
  2632.     system has set the "Hang up after validation of all users" option on. 
  2633.     After displaying this file, CBV will hangup if enabled.  This display
  2634.     file should simply state that CBV is hanging up, and the reasons that CBV
  2635.     is doing it.
  2636.  
  2637.     CBVHBPW .A??
  2638.     This file is display to users who enter a bad password too many times,
  2639.     and when CBV is configured to hang up on the user.  This file is
  2640.     displayed immediately after CBVBADPW.A?? and should merely state that the
  2641.     BBS is now hanging up on the user.
  2642.  
  2643.     CBVINVAL.A??
  2644.     This file is displayed to the user if their format has been entered in an
  2645.     extremely incorrect format.  CBV will correct numbers and place them in
  2646.     the XXX-XXX-XXXX format, however, if CBV is unable to correct a number,
  2647.     this file will be displayed before returning control to the BBS.  This
  2648.     display file should let the user know that their phone number is invalid,
  2649.     and to send the sysop a message with the correct formatted number.
  2650.  
  2651.     CBVLDT  .A??
  2652.     This file is displayed to a long distance user who is calling during a
  2653.     time that CBV is not allowed to validate long distance.  After displaying
  2654.     this file, CBV will display the times that long distance call-backs are
  2655.     allowed.  If the file LDT.A?? is found in the display directory, however,
  2656.     CBV will display that file (which should contain a display of the
  2657.     allowable hours) instead of using the built-in format.  This file should
  2658.     merely state that long distance call-backs are only allowed at the times
  2659.     shown on the screen.
  2660.  
  2661.     CBVMAXSL.A??
  2662.     This file is displayed to users if their security level is greater than,
  2663.     or equal to the maximum SL allowed to use CBV.  CBV then returns control
  2664.     to the BBS.  This should explain that the user has already been
  2665.     validated, or a similar message.
  2666.  
  2667.     CBVMINSL.A??
  2668.     This file is displayed to users if their security level is less than the
  2669.     minimum SL allowed to use CBV.  CBV will then return control to the BBS. 
  2670.     This file should explain that the user's security level is too low to run
  2671.     CBV.
  2672.  
  2673.                                    Page 43
  2674.  
  2675.     CBVNOLD .A??
  2676.     If long distance calls are not allowed, and a user wants to initiate a
  2677.     long distance callback, this file is displayed right before returning
  2678.     control to the BBS.  It should explain to the user that the sysop is not
  2679.     allowing long distance calls, and that they will be upgraded manually by
  2680.     the sysop.
  2681.  
  2682.     CBVPNUM .A??
  2683.     This display file tells the user to make sure that they have selected the
  2684.     phone number to which their modem is currently hooked up to.  It is
  2685.     displayed right after the user selects a number to be called back at.
  2686.  
  2687.     CBVPRED .A??
  2688.     Displayed right after making sure that CBV will be calling the right
  2689.     phone number and right before hanging up, CBV displays this file which
  2690.     should remind the user to type 'ATA' to make their modem answer the BBS
  2691.     calling them.
  2692.  
  2693.     CBVSUCC .A??
  2694.     This display file is shown to the user right after a successful local
  2695.     callback.  If a long distance success display file is not present, this
  2696.     file is also displayed to LD callbacks completed successfully.  This is
  2697.     the last file displayed to the user before exiting CBV on a successful
  2698.     callback.
  2699.  
  2700.     CBVSUCCL.A??
  2701.     Also displayed right after a successful callback, this file is only
  2702.     display to users calling and being validated Long Distance.
  2703.  
  2704.     CBVTOP  .A??
  2705.     This display file is simply a top-of-screen attention-getter.  It is
  2706.     displayed before putting up the main menu, and before showing the help
  2707.     file.  To keep uniformity, you may want to place this same display file
  2708.     at the top of all other display files.
  2709.  
  2710.     CBVHELP .TXT
  2711.     When a user wishes to view the help file for CBV, this standard text file
  2712.     is displayed after clearing the screen and displaying CBVTOP.A??.  It
  2713.     should contain general information on the use of CBV.
  2714.  
  2715.     CBVVDUPE.A??
  2716.     This file is displayed to users who have chosen a number that was
  2717.     previously validated by CBV, and when the sysop has opted to
  2718.     automatically upgrade users with duplicate numbers.  It should explain
  2719.     that CBV has already validated the user's number, and therefore, has no
  2720.     need to call it again.
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729.  
  2730.                                    Page 44
  2731.  
  2732.     Walk-through Display Files
  2733.  
  2734.     The next eight display files are displayed as part of the walk-through
  2735. tutorial.  Each one is displayed in succession during the walk-through. 
  2736. Sysops should try to make these screens as informative as possible.  Below is
  2737. a complete description of what each file should contain.
  2738.  
  2739.     CBV_WK1. A??
  2740.     Displays general information about the callback and that the modem will
  2741.     almost always display a "NO CARRIER" when the BBS hangs up.  It should
  2742.     also state that the user MUST NOT hang up on the CBV program.
  2743.  
  2744.     CBV_WK2. A??
  2745.     States that the BBS will call back in a few seconds.  Sysops may wish to
  2746.     specify exactly how many seconds they have configured to wait between
  2747.     dials, as CBV will wait this length before actually placing the first
  2748.     call.  Also specify that the modem will display a "RING" message on the
  2749.     screen when the BBS is calling.
  2750.  
  2751.     CBV_WK3. A??
  2752.     On this walk-through screen, it is important to instruct the user how to
  2753.     answer the CBV telephone call with the modem.  The last few lines of this
  2754.     display file should tell the user to type "ATA" (in all capital letters)
  2755.     to answer a simulated CBV call.  After displayed, CBV will display "RING"
  2756.     on the screen until the user types "ATA" to answer the simulated call.
  2757.  
  2758.     CBV_WK4. A??
  2759.     Displays information about the actual "CONNECT" message returned by the
  2760.     modem when it actually connects.
  2761.  
  2762.     CBV_WK5. A??
  2763.     This display file should explains that the occurrence of line noise after
  2764.     the connection process is perfectly normal.  CBV will simulate fake line
  2765.     noise at this point.
  2766.  
  2767.     CBV_WK6. A??
  2768.     Here, the display file should ask the user to enter their login password
  2769.     as they would in a real callback after connection.  This display file
  2770.     only takes part if the sysop has configured CBV to actually ask for the
  2771.     user's password during the callback process.
  2772.  
  2773.     CBV_WK7. A??
  2774.     This screen should instruct the user to call back if the system doesn't
  2775.     call them back in a few minutes.  Something may have gone wrong with the
  2776.     callback, and therefore they will need to call and try again, or mail the
  2777.     sysop to let him/her know of a possible problem.
  2778.  
  2779.     CBV_WK8. A??
  2780.     Finally, this walk-through screen congratulates the user for completing
  2781.     sample call back.  You may also wish to specify any further instructions
  2782.     that you feel are necessary here.
  2783.  
  2784.  
  2785.  
  2786.  
  2787.                                    Page 45
  2788.  
  2789.    CBV will wait for input from the user for 2 minutes.  If no input is
  2790. received from the modem within that amount of time, CBV will exit with an
  2791. inactivity message.  CBV beeps at the user, 1 minute into the count to
  2792. notify them that they are going to be returned to the BBS.
  2793.  
  2794.  
  2795.  
  2796.  
  2797.  
  2798.  
  2799.  
  2800.  
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.  
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.                                    Page 46
  2845.  
  2846. ─────────────────────────────────────────────────────────────────────────────
  2847.  ░ Local Console Key Controls ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2848. ─────────────────────────────────────────────────────────────────────────────
  2849.  
  2850.     At any time while a user is online, you may press one of the sysop
  2851. functions keys.  Each is described below:
  2852.  
  2853.     Auto Upgrade Keys (ALT-1 Through ALT-6)
  2854.          At any time of the callback (aside from the actual time when CBV is
  2855.          placing a call), the sysop may automatically upgrade OR downgrade a
  2856.          user by pressing one of the auto-upgrade keys:
  2857.  
  2858.          ALT-1  =  Regular caller security level
  2859.          ALT-2  =  Long distance caller security level
  2860.          ALT-3  =  Bad password security level
  2861.          ALT-4  =  Aborted CBV security level
  2862.          ALT-5  =  Bad number (contained in CBVBAD#.DAT) security level
  2863.          ALT-6  =  Duplicate number (contained in CBVNUMS.DAT) security level
  2864.  
  2865.          Each security level setting may be defined via CBVCFG.EXE under the
  2866.          Security menu.
  2867.  
  2868.     Sysop Bar Information (F1)
  2869.          The sysop bar displays vital information about the user currently
  2870.          online to CBV.  There are a few individual display modes for this
  2871.          information bar, and by pressing the F1 key, the sysop can scroll
  2872.          through them one at a time.  The first few displays contain
  2873.          information about the user, his or her security level information,
  2874.          and the current connection rate.  The last display of the sysop bar
  2875.          contains a quick guide to the sysop keys that may be used while in
  2876.          CBV.
  2877.  
  2878.     Return User To BBS (F4, Shift-F4)
  2879.          Pressing the F4 function key will simply exit the user back to the
  2880.          system without any messages.  Pressing the shift key and F4 at the
  2881.          same time will lock the user out of CBV and return them to the
  2882.          system.  Locking a user from CBV also sets the user's security level
  2883.          to zero and writes this information to the CBV_PPP.DAT file for the
  2884.          Pre/Post-Processor to take care of.  For most BBS systems, this
  2885.          should lock out the user from your system totally.  CBV also adds
  2886.          their number to the CBVBAD#.DAT bad phone number file.
  2887.  
  2888.     Hang Up On User (F5, ALT-H, Shift F5)
  2889.          Pressing the F5 function key or ALT-H will hangup on the user and
  2890.          return control to the system without any messages.  Again, pressing
  2891.          shift and the F5 key will lock the user out and hang up on them,
  2892.          returning control to the system.
  2893.  
  2894.     Split-Screen Chat (F10, ALT-C)
  2895.          You may chat with the user at any time by pressing the F10 function
  2896.          key or ALT-C.  If the user has ANSI, this chat will be split screen
  2897.          with the sysop on the top half of the screen and the user on the
  2898.          lower half.  If a user does not have ANSI, it will be merely two-way
  2899.          chat mode.  Press F10, or ESCape to exit chat mode.
  2900.  
  2901.                                    Page 47
  2902.  
  2903.     Shell To DOS (Shift F10, ALT-J)
  2904.          Pressing and holding the shift key, while pressing F10 (Or by
  2905.          pressing ALT-J) will shell to DOS.  A short "Please Wait" message is
  2906.          displayed to the user before shelling, and erased upon return.  Type
  2907.          "EXIT" at the command line to return to CBV.  CBV will swap as much
  2908.          memory as possible to either EMS memory or disk, depending on which
  2909.          is available first.
  2910.  
  2911.  
  2912.  
  2913.  
  2914.  
  2915.  
  2916.  
  2917.  
  2918.  
  2919.  
  2920.  
  2921.  
  2922.  
  2923.  
  2924.  
  2925.  
  2926.  
  2927.  
  2928.  
  2929.  
  2930.  
  2931.  
  2932.  
  2933.  
  2934.  
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.  
  2957.  
  2958.                                    Page 48
  2959.  
  2960. ─────────────────────────────────────────────────────────────────────────────
  2961.  ░ Multi-Node Configuration ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  2962. ─────────────────────────────────────────────────────────────────────────────
  2963.  
  2964.     With the ability to have multiple configuration files, and non-standard
  2965. communications port settings, CBV becomes a very multi-node capable program. 
  2966. Sysops who wish to set up CBV with their multi-node systems should keep the
  2967. following points in mind when doing so:
  2968.  
  2969.     o    If your BBS system has the capability to send the current node
  2970.          number to your CBV batch file via command-line parameters, use that
  2971.          feature to specify filenames needed for the Pre/Post-Processor and
  2972.          CBV itself.
  2973.  
  2974.     o    If your BBS system does not do the above, but uses an environment
  2975.          variable to specify the current node, create a single batch file for
  2976.          CBV that utilizes that variable.
  2977.  
  2978.     o    Remember that non-standard communication port settings can be
  2979.          configured for each configuration file.  You may specify the exact
  2980.          port to use, the address and IRQ via CBVCFG.EXE.  CBV will use these
  2981.          values, overriding whatever is contained in the BBS dropfile
  2982.          DOOR.SYS.
  2983.  
  2984.     o    Name each configuration file in a meaningful way, such as NODE1.CFG,
  2985.          NODE2.CFG, etc. for each node of your system.  If you will not be
  2986.          making different configurations for each node, using the standard
  2987.          filename of CBV.CFG will suffice.
  2988.  
  2989.     Example multi-node batch files are included below.  
  2990.  
  2991.  
  2992.  
  2993.  
  2994.  
  2995.  
  2996.  
  2997.  
  2998.  
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.  
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.  
  3015.                                    Page 49
  3016.  
  3017. Node Identification By Command-Line
  3018.  
  3019.     If you are running a multi-node copy of CBV with multiple configurations,
  3020. and passing the current node number via command-line parameters, follow the
  3021. outline of:
  3022.  
  3023.     @ECHO OFF
  3024.     CD\BBS\CBV
  3025.     EXIT_PPP -R C:\BBS\NODE%1\ C:\BBS\NODE%1\
  3026.     CBV C:\BBS\NODE%1\DOOR.SYS C:\BBS\CBV\NODE%1.CFG C:\BBS\CBV\NODE%1\
  3027.     EXIT_PPP -W C:\BBS\NODE%1\ C:\BBS\NODE%1\
  3028.     CD\BBS
  3029.  
  3030.     In this example, it is assumed that C:\BBS is your main BBS directory,
  3031.     CBV's main files are stored in C:\BBS\CBV, and each node's information
  3032.     files are stored in C:\BBS\NODE%1, where %1 is the corresponding node
  3033.     number (C:\BBS\NODE1, C:\BBS\NODE2, etc.).
  3034.  
  3035.     In the example above, we are creating the CBV_PPP.DAT file in each node's
  3036.     directory to ensure that CBV reads and writes information in a spot where
  3037.     the correct node will receive it.  
  3038.  
  3039.     Also in this example, each configuration file for the nodes are named
  3040.     NODE1.CFG, NODE2.CFG, etc.  The correct calling of this batch file would
  3041.     be:
  3042.  
  3043.     CBV.BAT <node number>
  3044.  
  3045.     ie.  CBV.BAT 1
  3046.  
  3047.     If you are running a multi-node copy of CBV with ONE configuration, and
  3048. passing the current node number via command-line parameters, modify the
  3049. fourth line above (the actual call to CBV.EXE) to read:
  3050.  
  3051.     CBV C:\BBS\NODE%1\DOOR.SYS C:\BBS\CBV\CBV.CFG C:\BBS\CBV\NODE%1\
  3052.  
  3053.  
  3054.  
  3055.  
  3056.  
  3057.  
  3058.  
  3059.  
  3060.  
  3061.  
  3062.  
  3063.  
  3064.  
  3065.  
  3066.  
  3067.  
  3068.  
  3069.  
  3070.  
  3071.  
  3072.                                    Page 50
  3073.  
  3074. Node Identification By Environment Variable
  3075.  
  3076.     If you are utilizing a BBS system's environment variable which specifies
  3077. the current node number, follow either outline shown below.  Where a %v% is
  3078. located, be sure to substitute the actual environment variable that your
  3079. system uses.  For example, if the environment variable is BBS_NODE (SET
  3080. BBS_NODE=1, etc.), you would specify a %BBS_NODE% wherever a %v% appears in
  3081. the batch file below:
  3082.  
  3083.     @ECHO OFF
  3084.     CD\BBS\CBV
  3085.     EXIT_PPP -R C:\BBS\NODE%v%\ C:\BBS\NODE%v%\
  3086.     CBV C:\BBS\NODE%v%\DOOR.SYS C:\BBS\CBV\NODE%v%.CFG C:\BBS\CBV\NODE%v%\
  3087.     EXIT_PPP -W C:\BBS\NODE%v%\ C:\BBS\NODE%v%\
  3088.     CD\BBS
  3089.  
  3090.     Again, it is assumed that C:\BBS is your main BBS directory, CBV's main
  3091.     files are stored in C:\BBS\CBV, and each node's information files are
  3092.     stored in C:\BBS\NODE%1, where %1 is the corresponding node number
  3093.     (C:\BBS\NODE1, C:\BBS\NODE2, etc.).
  3094.  
  3095.     In the example above, we are creating the CBV_PPP.DAT file in each node's
  3096.     directory to ensure that CBV reads and writes information in a spot where
  3097.     the correct node will receive it.  
  3098.  
  3099.     Also in this example, each configuration file for the nodes are named
  3100.     NODE1.CFG, NODE2.CFG, etc.  The correct calling of this batch file would
  3101.     be:
  3102.  
  3103.     CBV.BAT
  3104.  
  3105.     Be sure that your BBS environment variable that specifies the current
  3106.     node number is also set.
  3107.  
  3108.     If you are running a multi-node copy of CBV with ONE configuration,
  3109. modify the fourth line above (the actual call to CBV.EXE) to read:
  3110.  
  3111.     CBV C:\BBS\NODE%v%\DOOR.SYS C:\BBS\CBV\CBV.CFG C:\BBS\CBV\NODE%v%\
  3112.  
  3113.  
  3114.  
  3115.  
  3116.  
  3117.  
  3118.  
  3119.  
  3120.  
  3121.  
  3122.  
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.  
  3129.                                    Page 51
  3130.  
  3131.     You may also wish to follow the format below if your BBS software
  3132. utilizes the environment variable method of specifying node numbers.  In this
  3133. example, we use DOS "GOTO" batch command to list specific instructions for
  3134. each node's call to CBV.  Again, substitute your actual BBS environment
  3135. variable wherever a %v% appears.  In this example, you can specify specific
  3136. instructions for each node's call to CBV.
  3137.  
  3138.     @ECHO OFF
  3139.     GOTO Start
  3140.  
  3141.     :1
  3142.     EXIT_PPP -R C:\BBS\NODE1\ C:\BBS\NODE1\
  3143.     CBV C:\BBS\NODE1\DOOR.SYS C:\BBS\CBV\NODE1.CFG C:\BBS\CBV\NODE1\
  3144.     EXIT_PPP -W C:\BBS\NODE1\ C:\BBS\NODE1\
  3145.     Goto End
  3146.  
  3147.     :2
  3148.     EXIT_PPP -R C:\BBS\NODE2\ C:\BBS\NODE2\
  3149.     CBV C:\BBS\NODE2\DOOR.SYS C:\BBS\CBV\NODE2.CFG C:\BBS\CBV\NODE2\
  3150.     EXIT_PPP -W C:\BBS\NODE2\ C:\BBS\NODE2\
  3151.     Goto End
  3152.  
  3153.     :3
  3154.     EXIT_PPP -R C:\BBS\NODE3\ C:\BBS\NODE3\
  3155.     CBV C:\BBS\NODE3\DOOR.SYS C:\BBS\CBV\NODE3.CFG C:\BBS\CBV\NODE3\
  3156.     EXIT_PPP -W C:\BBS\NODE3\ C:\BBS\NODE3\
  3157.     Goto End
  3158.  
  3159.     :Start
  3160.     CD\BBS\CBV
  3161.     Goto %v%
  3162.  
  3163.     :End
  3164.     CD\BBS
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.  
  3176.  
  3177.  
  3178.  
  3179.  
  3180.  
  3181.  
  3182.  
  3183.  
  3184.  
  3185.  
  3186.                                    Page 52
  3187.  
  3188. ─────────────────────────────────────────────────────────────────────────────
  3189.  ░ Registration Of CBV ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3190. ─────────────────────────────────────────────────────────────────────────────
  3191.  
  3192.      We at Datagen Software Designs take pride in our efforts to produce
  3193. quality software/shareware with little or no registration.  In order to do
  3194. so, some of our programs require a small registration fee.
  3195.  
  3196.      CBV is being released by Datagen Software Designs under the Shareware
  3197. concept, which encourages the users of a program to register that software
  3198. after a given number of days.
  3199.  
  3200.      Registration of CBV is simple, and will not put a hole in your wallet! 
  3201. As well as receiving a registered copy of the program, you will receive
  3202. updates of CBV as they evolve (registrations cover copies of the same
  3203. version number, ie. 1.x  Registrations for pre version 1 files (.99) are
  3204. also good for updates through version 1), information on new releases from
  3205. Datagen Software Designs and more when you register the program!
  3206.  
  3207.      Registration for CBV is $10.00 US
  3208.  
  3209.      To register your copy, print out the enclosed registration form (or
  3210. print the information on paper), enclose a check or money order made payable
  3211. to John Dailey, and mail it to the address indicated on the form.
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.  
  3240.  
  3241.  
  3242.  
  3243.                                    Page 53
  3244.  
  3245. ─────────────────────────────────────────────────────────────────────────────
  3246.  ░ Support BBS Information ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3247. ─────────────────────────────────────────────────────────────────────────────
  3248.  
  3249.     The page following is a Datagen Software Designs Support BBS Application.
  3250. To apply for distribution site status, please fill out the form completely,
  3251. and mail it to any of our E-mail or US Postal addresses, or call our HQ BBS
  3252. and upload your application.
  3253.  
  3254.  
  3255.  
  3256.  
  3257.  
  3258.  
  3259.  
  3260.  
  3261.  
  3262.  
  3263.  
  3264.  
  3265.  
  3266.  
  3267.  
  3268.  
  3269.  
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.  
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300.                                    Page 54
  3301.  
  3302.                Datagen Software Designs Support BBS Application
  3303.                ________________________________________________
  3304.  
  3305.   For application to become a  respectable Datagen Software Designs support
  3306.   Bulletin Board System, simply fill out the following information and mail
  3307.   to the below address.  Please be sure to include all information.
  3308.  
  3309.   Name   __________________________________________________________________
  3310.           Last,                          First                          MI
  3311.  
  3312.   Age    ______       Phone  _________________________
  3313.                              Area Code
  3314.   Address__________________________________________________________________
  3315.           Street
  3316.  
  3317.          __________________________________________________________________
  3318.  
  3319.          __________________________________________________________________
  3320.          City,               State                    Zip
  3321.  
  3322.  
  3323.   BBS Name ________________________________________________________________
  3324.  
  3325.   BBS Sysop Handle ________________________________________________________
  3326.  
  3327.   BBS Number ________________________  BBS Baud Rates _____________________
  3328.              Area Code
  3329.  
  3330.   BBS Hours
  3331.  
  3332.   [  ] 24 hours    [  ] Part-Time (Specify Hours) _________________________
  3333.  
  3334.   BBS Type And Version ____________________________________________________
  3335.  
  3336.   BBS Net/Node (If Applicable) ____________________________________________
  3337.  
  3338.   BBS Time Running (Continuously) _________________________________________
  3339.  
  3340.   Disk Information
  3341.  
  3342.   [  ] 3 1/2" Diskette    [  ] 5 1/4" Diskette
  3343.   [  ] High Density       [  ] Double Density
  3344.  
  3345.   Reason For Wanting To Become A Support BBS:
  3346.  
  3347.  
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.   Sysop's requesting to become a  support board will be notified as soon as
  3354.   possible on their request once received.  Send all applications to:
  3355.  
  3356.           Support BBS Applications
  3357.           Datagen Software Designs
  3358.           1732 Wind Drift Rd.
  3359.           Orlando, FL  32809
  3360.  
  3361.                                    Page 55
  3362.  
  3363. ─────────────────────────────────────────────────────────────────────────────
  3364.  ░ Author's Notes And Credits ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3365. ─────────────────────────────────────────────────────────────────────────────
  3366.  
  3367.      Questions, comments, complaints, or to receive a complete listing and
  3368. description of all Datagen products, mail John Dailey at any of the below
  3369. address:
  3370.  
  3371.        73124,2612                      [Compuserve]
  3372.        John.Dailey%277@satlink.oau.org [Internet]
  3373.        73124.2612@compuserve.com       [Internet]
  3374.        MKHH05B                         [Prodigy]
  3375.        1:363/277                       [FIDONet]
  3376.        154:204/9                       [RIPNet!]
  3377.        166@2522                        [WWIVNet]
  3378.        1@4706                          [TerraNET]
  3379.        1@4701                          [Alliance]
  3380.  
  3381.     Or call BBS Avalon, Datagen Software Designs' HQ BBS in Orlando, FL:
  3382.  
  3383.        BBS Avalon
  3384.        (407) 275-5996
  3385.        24 hours
  3386.        1200 - 14.4, N81, ANSI Highly Recommended
  3387.        FIDONet 1:363/277
  3388.        RIPNET! 154:204/9
  3389.        Alliance @4701
  3390.        TerraNET @4706
  3391.  
  3392.      Thank you for your support!
  3393.  
  3394.        CBV v1.2
  3395.        c/o John Dailey
  3396.        1732 Wind Drift Rd.
  3397.        Orlando, FL  32809
  3398.  
  3399.  
  3400.         WWIV BBS Software (c) Wayne Bell And WWIV Software Services
  3401.  Remote Access (RA) BBS Software (c) Andrew Milner And Wantree Development
  3402.                       QuickBBS (c) Steve Gabrilowitz
  3403.                     TriBBS Software (c) Mark D. Goodwin
  3404.                 ProBoard BBS Software (c) Philippe Leybaert
  3405.  
  3406.  
  3407.     Thanks to Kevin Taylor and Adam Shiver for beta-testing the CBV
  3408.     product over and over, submitting their user records to the constant
  3409.     abuse of the WWIV Pre/Post-Processor.  To our knowledge, no users were
  3410.     accidentally deleted during the testing.
  3411.  
  3412.  
  3413.  
  3414.  
  3415.  
  3416.  
  3417.  
  3418.                                    Page 56
  3419.  
  3420. ─────────────────────────────────────────────────────────────────────────────
  3421.  ░ Index ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
  3422. ─────────────────────────────────────────────────────────────────────────────
  3423.  
  3424. Area Codes  28
  3425.     Maximum Number Of  14
  3426.     Sample File  29
  3427.     v1.2 File Format  9
  3428. Bad Numbers  27
  3429. Batch Files
  3430.     Creating  5
  3431.     Generic Sample  5
  3432.     Outline  30
  3433.     RA, Proboard  31
  3434.     TriBBS  32
  3435.     WWIV  5, 33
  3436. CBV
  3437.     Command Line  30
  3438.     Features  3
  3439.     Running  30
  3440.     What Is?  2
  3441. Configuration  12
  3442.     Aborted SL  19
  3443.     Allow LD Validations  24
  3444.     Allow New Numbers  24
  3445.     Allow Walk-through  24
  3446.     Area Code  14
  3447.     Ask Password  24
  3448.     Auto-Validate Duplicates  26
  3449.     Bad Number SL  19
  3450.     Bad Numbers  23
  3451.     Bad Password SL  19
  3452.     Batch Files  30
  3453.     BBS  14
  3454.     BUSY  22
  3455.     Carrier Wait  22
  3456.     CBV Path  14
  3457.     Colors  15
  3458.     CONNECT  22
  3459.     Default Filename  12
  3460.     Dial Attempts  22
  3461.     Dial Prefix  21
  3462.     Disp Path  14
  3463.     Download SL (DSL)  16
  3464.     Duplicate Number SL  19
  3465.     E-Mail File  14
  3466.     Escape Command  21
  3467.     Exchanges  23, 28
  3468.     Exemptions  16
  3469.     file  12, 13
  3470.     Hangup  21
  3471.     Hangup Aborted User  26
  3472.     Hangup After Callback  26
  3473.     Hangup After LD  26
  3474.     Hangup Bad Password  26
  3475.  
  3476.                                    Page 57
  3477.  
  3478.     Info  13
  3479.     LD Hours  24
  3480.     LD Prefix  14
  3481.     Log  14
  3482.     Long Distance SL  19
  3483.     Mail File  14
  3484.     Maximum SL To CBV  16
  3485.     Minimum SL To CBV  16
  3486.     Modem  20
  3487.     Modem Base Address  20
  3488.     Modem Base IRQ  20
  3489.     Modem Hardware  20
  3490.     Modem Init  21
  3491.     Modem Port Number  20
  3492.     Multi-Node  49
  3493.     Multiple  12
  3494.     Name  14
  3495.     NO CARRIER  21
  3496.     NO DIAL TONE  22
  3497.     Numbers  23
  3498.     OK  21
  3499.     Options  24
  3500.     Password Attempts  16
  3501.     Phone In User Note  26
  3502.     Pickup  21
  3503.     Quit  13
  3504.     Redial Pause  22
  3505.     Regular User SL  19
  3506.     Restriction and Flag Settings  17
  3507.     Restrictions  17
  3508.     Result Wait  22
  3509.     RING  22
  3510.     Save  13
  3511.     Security  16
  3512.     Security Level Settings  16
  3513.     System SL (SL)  16
  3514.     User Flags (AR/DAR)  17
  3515.     Valid Exchanges  23
  3516.     Validated Duplicates  26
  3517.     Validated Numbers  23
  3518.     VOICE  22
  3519. Defining Local Numbers  28
  3520. Display Files  2, 42
  3521.     CBV_WK1. A??  45
  3522.     CBV_WK2. A??  45
  3523.     CBV_WK3. A??  45
  3524.     CBV_WK4. A??  45
  3525.     CBV_WK5. A??  45
  3526.     CBV_WK6. A??  45
  3527.     CBV_WK7. A??  45
  3528.     CBV_WK8. A??  45
  3529.     CBVABORT.A??  42
  3530.     CBVBAD# .A??  42
  3531.     CBVBADPW.A??  42
  3532.     CBVBYELD.A??  42
  3533.  
  3534.                                    Page 58
  3535.  
  3536.     CBVCHANG.A??  42
  3537.     CBVDIAL .A??  42
  3538.     CBVDUPE .A??  43
  3539.     CBVHABT .A??  43
  3540.     CBVHANG .A??  43
  3541.     CBVHBPW .A??  43
  3542.     CBVHELP .TXT  44
  3543.     CBVINVAL.A??  43
  3544.     CBVLDT  .A??  43
  3545.     CBVMAXSL.A??  43
  3546.     CBVMINSL.A??  43
  3547.     CBVNOLD .A??  44
  3548.     CBVPNUM .A??  44
  3549.     CBVPRED .A??  44
  3550.     CBVSUCC .A??  44
  3551.     CBVSUCCL.A??  44
  3552.     CBVTOP  .A??  44
  3553.     CBVVDUPE.A??  44
  3554.     Walk-Through  45
  3555. Exchanges  23, 28
  3556.     Defining  28
  3557.     Entering  23
  3558.     Locating List Of  23, 28
  3559.     Maximum Number Of  28
  3560.     Sample File  29
  3561.     v1.2 File Format  9
  3562. Flags  17
  3563.     Toggling  18
  3564.     Turning Off  18
  3565.     Turning On  18
  3566.     Unmodified  18
  3567. Installation  11
  3568.     Configuration  12
  3569.     Quick  5
  3570.     Upgrading  9
  3571. Modem  20
  3572.     Base Address  20
  3573.     Base IRQ  20
  3574.     Carriage Return  20
  3575.     Lower DTR  20
  3576.     Pause 1/4s  20
  3577.     Port Number  20
  3578.     Raise DTR  20
  3579.     String Commands  20
  3580. Multi-Node Configuration  49
  3581.     Batch File Examples  50-52
  3582.     Command-Line Paramaters  49, 50
  3583.     Configuration Files  49
  3584.     Environment Variables  49, 51, 52
  3585.     Non-Standard Ports  49
  3586. Pre/Post-Processor  34
  3587.     Concept  6
  3588.     Developing  7
  3589.     DOOR.SYS  35
  3590.     DOOR.SYS (TriBBS)  7
  3591.  
  3592.                                    Page 59
  3593.  
  3594.     DOOR_PPP.EXE Command Line  35
  3595.     Drop File  6
  3596.     EXIT_PPP.EXE Command Line  34
  3597.     EXITINFO.BBS  34
  3598.     EXITINFO.BBS (RA, ProBoard)  7
  3599.     Offset Configuration  39
  3600.     ProBoard  34
  3601.     Remote Access  34
  3602.     Requesting  8
  3603.     TriBBS  35
  3604.     WWIV  7, 36
  3605.     WWIV Configuration  37
  3606.     WWIV Modified User Records  38
  3607.     WWIV_PPP.EXE Command Line  36
  3608. Registration  53
  3609. Support BBS  54
  3610. Sysop Keys  47
  3611.     Auto Upgrade  47
  3612.     Hang Up On User  47
  3613.     Locking Out User  47
  3614.     Return User To BBS  47
  3615.     Shell To DOS  48
  3616.     Split-Screen Chat  47
  3617.     Sysop Bar Information  47
  3618. User E-Mail Files  41
  3619.     BUSY.MSG  41
  3620.     FAILED.MSG  41
  3621.     Importing To BBS  41
  3622.     Specifying Filename For  41
  3623.     SUCCESS.MSG  41
  3624.     SUCCESSL.MSG  41
  3625.     TIMEOUT.MSG  41
  3626.     VOICE.MSG  41
  3627.  
  3628.  
  3629.  
  3630.  
  3631.  
  3632.  
  3633.  
  3634.  
  3635.  
  3636.  
  3637.  
  3638.  
  3639.  
  3640.  
  3641.  
  3642.  
  3643.  
  3644.  
  3645.  
  3646.  
  3647.  
  3648.  
  3649.                                    Page 60
  3650.  
  3651.