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