home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / scb_121.zip / SCB.DOC < prev    next >
Text File  |  1994-06-01  |  12KB  |  314 lines
  1.        Synchronet Callback v1.21   Copyright 1993 Digital Dynamics
  2.        -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  3.  
  4.       Callback Verification Program for Synchronet Multinode BBS Software
  5.  
  6.  
  7. Installation:
  8. ============
  9.  
  10.  1. Create a directory called "SCB" off of your Synchronet XTRN directory.
  11.  
  12.     Example:
  13.  
  14.         MD C:\SBBS\XTRN\SCB
  15.  
  16.  2. Copy all SCB files into this new directory.
  17.  
  18.     Example:
  19.  
  20.         COPY *.* C:\SBBS\XTRN\SCB
  21.  
  22.     Note, SCB files include:
  23.  
  24.         SCB.DOC     This file
  25.         ORDER.TXT    Purchase order form
  26.         SCB.EXE     Callback verifier external program
  27.         SCBCFG.EXE    Sysop configuration program for SCB
  28.         ALLOWED.DAT    List of allowable number prefixes
  29.         LDPREFIX.DAT    List of same-area prefixes that are long dist
  30.         SCB.MSG     The opening screen for SCB
  31.         REFUSED.MSG    Verification refused
  32.         INSTRUCT.MSG    Instructions
  33.         NO_ONE.MSG    Long distance starting with 1 not allowed
  34.         NO_ZERO.MSG    Long distance starting with 0 not allowed
  35.         LD_TIME.MSG    Not within long distance callback time range
  36.         TOOSHORT.MSG    Phone number less than minimum number of digits
  37.         TOOLONG.MSG    Phone number more than maximum number of digits
  38.         PHONECAN.MSG    Phone number found in trash can file
  39.         VERIFIED.MSG    Displayed to users after verification
  40.  
  41.  3. Run SCFG from your NODE1 directory.
  42.  
  43.  4. Go to the External Programs->Online Programs menu.
  44.  
  45.  5. Hit the <INSERT> key and enter "Synchronet Callback".
  46.  
  47.  6. Hit <ENTER> to edit the configuration for this new program.
  48.  
  49.  7. Set the "Start-up Directory" to "..\XTRN\SCB".
  50.  
  51.  8. Set "Multiuser" to "Yes".
  52.  
  53.  9. Set "Modify Uesr Data" to "Yes".
  54.  
  55. 10. Set "BBS Drop File Type" to "Synchronet XTRN.DAT"
  56.  
  57. 11. If you wish to have SCB run automatically for new users or as a logon
  58.     event for unvalidated users, set the "Execute on Event" option to the
  59.     appropriate event type. Use "Access Requirements" if you wish SCB to be
  60.     only available to unvalidated users (i.e. "LEVEL NOT 20").
  61.  
  62. Example SCFG screen:
  63.  
  64.     ╔[■][?]════════════════════════════════════════════════════╗
  65.     ║             Synchronet Callback           ║
  66.     ╠══════════════════════════════════════════════════════════╣
  67.     ║ │Name               Synchronet Callback       ║
  68.     ║ │Start-up Directory          ..\XTRN\SCB           ║
  69.     ║ │Command Line           scb               ║
  70.     ║ │Clean-up Command Line                   ║
  71.     ║ │Cost in Credits          0                ║
  72.     ║ │Access Requirements          LEVEL NOT 20           ║
  73.     ║ │Execution Requirements                   ║
  74.     ║ │ANSI Required          No               ║
  75.     ║ │Multiuser              Yes               ║
  76.     ║ │Intercept I/O Interrupts   No               ║
  77.     ║ │Shrink BBS              No               ║
  78.     ║ │Modify User Data          Yes               ║
  79.     ║ │Uses WWIV Color Codes      No               ║
  80.     ║ │Execute on Event          Logon               ║
  81.     ║ │Menu Command Keys          Main ( )          Transfer ( ) ║
  82.     ║ │BBS Drop File Type          Synchronet      XTRN.DAT       ║
  83.     ║ │Place Drop File In          Node Directory           ║
  84.     ╚══════════════════════════════════════════════════════════╝
  85.  
  86.  
  87. Configuration:
  88. =============
  89.  
  90.  1. Go into your SCB directory and run SCBCFG.
  91.  
  92.     Example:
  93.  
  94.         CD \SBBS\XTRN\SCB
  95.         SCBCFG
  96.  
  97.     You will see a menu similar to the following:
  98.  
  99.     ╔[■][?]════════════════════════════════════════════════════╗
  100.     ║          Synchronet Callback Configuration        ║
  101.     ╠══════════════════════════════════════════════════════════╣
  102.     ║ │Toggle Options...                       ║
  103.     ║ │Validation Values...                    ║
  104.     ║ │Allowed Prefix List...                   ║
  105.     ║ │Long Distance Prefix List...                ║
  106.     ║ │Long Distance Calling Times...               ║
  107.     ║ │Phone Number Trash Can   \SBBS\TEXT\PHONE.CAN       ║
  108.     ║ │Validated Phone List     \SBBS\TEXT\PHONE.CAN       ║
  109.     ║ │Callback Attempts        4                   ║
  110.     ║ │Minimum Phone Length     7                   ║
  111.     ║ │Maximum Phone Length     11                   ║
  112.     ║ │BBS Area Code        714                ║
  113.     ║ │Send Message to Sysop    User #1               ║
  114.     ╚══════════════════════════════════════════════════════════╝
  115.  
  116.  2. If your Synchronet text directory is in a directory or drive other
  117.     than "\SBBS\TEXT", change the Phone Can and Validated Phone List options
  118.     to reflect the correct location of your PHONE.CAN file.
  119.  
  120.     If you want to allow duplicate validated phone numbers, change the
  121.     Validated Phone List to another path and/or filename.
  122.  
  123.     The phone number list(s) use the same syntax for trashcan files as
  124.     Synchronet BBS. Appending a '~' to a line specifies that the string
  125.     cannot be located anywhere within the phone number. Appending a '^'
  126.     indicates that the phone number cannot begin with the string.
  127.  
  128.     The stock PHONE.CAN for Synchronet BBS contains the following:
  129.  
  130.     0-^
  131.     1-^
  132.     000-~
  133.     111-~
  134.     123-^
  135.     222-^
  136.     333-^
  137.     444-^
  138.     555-~
  139.     666-^
  140.     777-^
  141.     888-^
  142.     999-^
  143.     900-^
  144.     411-~
  145.     911-~
  146.     976-~
  147.     411^
  148.     911^
  149.  
  150.     Since SCB does not allow non-numeric characters in phone numbers, all
  151.     entries with the dash (-) character above are ignored.
  152.  
  153.  3. SCB uses the dial string specified in the modem configuration in SCFG
  154.     for each node for dialing the remote user's modem. The default dial
  155.     string is "ATDT".
  156.  
  157.  4. Use the "Toggle Options" sub-menu to configure your preferences.
  158.  
  159.     ╔[■][?]═══════════════════════════════════════════════╗
  160.     ║             Toggle Options              ║
  161.     ╠═════════════════════════════════════════════════════╣
  162.     ║ │Validate if Unable to Verify        No          ║
  163.     ║ │Put Result in User Note           Yes          ║
  164.     ║ │Long Distance if not an Allowed Prefix  No          ║
  165.     ║ │Allow Long Distance (Starting with 0)   No          ║
  166.     ║ │Allow Long Distance (Starting with 1)   Yes          ║
  167.     ║ │U.S. Style Phone Format (AAA-PPP-SSSS)  Yes          ║
  168.     ║ │Stay Connected After Callback       No          ║
  169.     ╚═════════════════════════════════════════════════════╝
  170.  
  171.     If the "Validate if Unable to Verify" option is set to "Yes", users will
  172.     always be validated. Even if their number was not verified.
  173.  
  174.     If the "Put Result in User Note" option is set to "Yes", the result of
  175.     the verification attempt will be placed in the user's note field
  176.     (in the Synchronet BBS user database).
  177.  
  178.     If the "Long Distance if not an Allowed Prefix" option is set to "Yes",
  179.     then all numbers will be considered long distance unless the prefix
  180.     is specifically listed in the "Allowed Prefix List" off of the main
  181.     menu. If this option is set to "Yes", the "Long Distance Prefix List"
  182.     is not used.
  183.  
  184.     If the "Allow Long Distance (starting with 0)" options is set to "Yes",
  185.     then numbers starting with '0' will be verified.
  186.  
  187.     If the "Allow Long Distance (starting with 1)" options is set to "Yes",
  188.     then numbers starting with '1' will be verified.
  189.  
  190.     If the "U.S. Style Phone Format" option is set to "Yes", then SCB will
  191.     assume that phone numbers are in the AAA-PPP-SSSS format, and will
  192.     automatically strip the BBS area code from the prefix if the user
  193.     entered a number in the same area code as the BBS and included the
  194.     area code (both AAA and 1AAA will be stripped).
  195.  
  196.     The "Stay Connected After Callback" option can be set to "Yes", "No",
  197.     or "Local Only". SCB will not disconnect after calling the user back
  198.     if this option is set to "Yes". If set to "Local Only", SCB will only
  199.     remain connected if the number verfied does not begin with a '1' or '0'.
  200.  
  201.  5. Use the "Validation Values" sub-menu to configure how you want validated
  202.     users' accounts to be modified.
  203.  
  204.     ╔[■][?]════════════════════════════════════════════════════════╗
  205.     ║            Validation Values               ║
  206.     ╠══════════════════════════════════════════════════════════════╣
  207.     ║ │Security Level           23                   ║
  208.     ║ │Flag Set 1               CDLN                ║
  209.     ║ │Flag Set 2                               ║
  210.     ║ │Flag Set 3                               ║
  211.     ║ │Flag Set 4               -V                   ║
  212.     ║ │Exemptions                               ║
  213.     ║ │Restrictions            -CX                   ║
  214.     ║ │Days to Extend Expiration       0                   ║
  215.     ║ │Credits to Add                           ║
  216.     ║ │Minutes to Add                           ║
  217.     ╚══════════════════════════════════════════════════════════════╝
  218.  
  219.     Note: The DEMO version will only set new security level and add credits.
  220.       The other validation options are only available in the registered
  221.       version.
  222.  
  223.  6. Use the "Allowed Prefix List" sub-menu to set which prefixes will NOT be
  224.     affected by long distance restrictions (such as long distance
  225.     calling times, and numbers starting with 0 or 1). This option is useful
  226.     for specifying local numbers in other area codes. For example, in the
  227.     714 area code, 529 prefix, the following non-714 prefixes are local (*):
  228.  
  229.     1310690 1310691 1310694 1310697 1310902 1310905 1310943 1310947
  230.     1818330 1818333 1818336 1818369 1818810 1818854 1818855 1818912
  231.     1818913 1818937 1818961 1818964 1818965 1818968 1909396 1909468
  232.     1909594 1909595 1909598 1909860 1909861 1909869
  233.  
  234.     * Multiple entries per line to conserve documentation space
  235.  
  236.     If the "Long Distance if not an Allowed Prefix" toggle option is set to
  237.     "Yes", then any number that is NOT included in this list will be
  238.     considered long distance.
  239.  
  240.  7. Use the "Long Distance Prefix List" sub-menu to set which SAME-AREA
  241.     prefixes will be considered long distance. If the "Long Distance if not
  242.     an Allowed Prefix" toggle option is set to "Yes", then this list is not
  243.     used. For example, in the 714 area code, 529 prefix, the following
  244.     714 prefixes are long distance (*):
  245.  
  246.     241 258 259 265 285 418 432 433 434 435 436 437 438 479 480
  247.     505 513 531 540 541 542 543 544 545 546 547 549 550 554 556
  248.     557 558 560 564 565 566 567 568 569 571 573 641 647 648 662
  249.     664 665 667 668 669 691 708 730 731 751 754 755 775 832 834
  250.     835 836 838 839 850 953 954 957 966 967 972 973 977 979
  251.  
  252.     * Multiple entries per line to conserve documentation space
  253.  
  254.  8. Use the "Long Distance Calling Times" sub-menu to set the times on each day
  255.     when SCB is allowed to place long distance calls.
  256.  
  257.  9. Hit ESC from the main SCB configuration menu and select "Yes" to save
  258.     the configuration file.
  259.  
  260.  
  261. Notes:
  262. =====
  263.  
  264. All SCB activity is logged to the file SCB.LOG in the SCB directory in
  265. the format:
  266.  
  267.     Node 7         : Mon Sep 27 16:44:31 1993
  268.     User Name    : Digital Man
  269.     Voice Number : 714-529-6328
  270.     Modem Number : 5295313
  271.     Result         : Verified
  272.  
  273. Results     Description
  274. -------     -----------
  275. Hung up     User hung up before or during validation process
  276. Refused     User refused validation
  277. Long Dist    User is a long distance call and long distance is disallowed
  278. Invalid #    User entered a number that is in the trashcan file, less than
  279.             minimum length, or begins with a disallowed number (0 or 1)
  280. No Init     Modem could not be initialized
  281. No Connect    Modem could not connect to user's modem (possibly wrong #)
  282. Verified    User was called, modem connected, and password verified
  283. Bad Pass    User was called, modem connected, and incorrect password
  284.  
  285.  
  286. Customizations:
  287. ==============
  288.  
  289. The following files can be modified (optionally using Ctrl-A codes for color):
  290.  
  291. SCB.MSG     The opening screen for SCB
  292. REFUSED.MSG    Verification refused
  293. INSTRUCT.MSG    Instructions
  294. NO_ONE.MSG    Long distance numbers starting with 1 not allowed
  295. NO_ZERO.MSG    Long distance numbers starting with 0 not allowed
  296. LD_TIME.MSG    Not within allowed long distance callback time range
  297. TOOSHORT.MSG    Phone number is less than configured minimum number of digits
  298. PHONECAN.MSG    Phone number found in trashcan file
  299. VERIFIED.MSG    Displayed to users after verification
  300.  
  301.  
  302. Registration:
  303. ============
  304.  
  305. If you wish to order a registered copy of SCB at the same time as Synchronet,
  306. use the Synchronet ORDER.TXT file (in the SBBS\DOCS directory).
  307.  
  308. If registering SCB after already purchasing a copy of Synchronet, call
  309. Digital Dynamics voice at 714-529-6328, Support BBS at 714-529-5313 (and use
  310. Domain Shopper), or complete the ORDER.TXT file in the SCB directory and mail
  311. or fax it to Digital Dynamics.
  312.  
  313. /* End of SCB.DOC */
  314.