home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / SCB_112.ZIP / SCB.DOC < prev    next >
Text File  |  1994-01-19  |  11KB  |  329 lines
  1.        Synchronet Callback v1.12   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
  230.     1310691
  231.     1310694
  232.     1310697
  233.     1310902
  234.     1310905
  235.     1310943
  236.     1310947
  237.     1818330
  238.     1818333
  239.     1818336
  240.     1818369
  241.     1818810
  242.     1818854
  243.     1818855
  244.     1818912
  245.     1818913
  246.     1818937
  247.     1818961
  248.     1818964
  249.     1818965
  250.     1818968
  251.     1909396
  252.     1909468
  253.     1909594
  254.     1909595
  255.     1909598
  256.     1909860
  257.     1909861
  258.     1909869
  259.  
  260.     If the "Long Distance if not an Allowed Prefix" toggle option is set to
  261.     "Yes", then any number that is not included in this list will be
  262.     considered long distance.
  263.  
  264.  7. Use the "Long Distance Prefix List" sub-menu to set which SAME-AREA
  265.     prefixes will be considered long distance. If the "Long Distance of not
  266.     an Allowed Prefix" toggle option is set to "Yes", then this list is not
  267.     used.
  268.  
  269.  8. Use the "Long Distance Calling Times" sub-menu to set the times on each day
  270.     when SCB is allowed to place long distance calls.
  271.  
  272.  9. Hit ESC from the main SCB configuration menu and select "Yes" to save
  273.     the configuration file.
  274.  
  275.  
  276. Notes:
  277. =====
  278.  
  279. All SCB activity is logged to the file SCB.LOG in the SCB directory in
  280. the format:
  281.  
  282.     Node 7         : Mon Sep 27 16:44:31 1993
  283.     User Name    : Digital Man
  284.     Voice Number : 714-529-6328
  285.     Modem Number : 5295313
  286.     Result         : Verified
  287.  
  288. Results     Description
  289. -------     -----------
  290. Hung up     User hung up before or during validation process
  291. Refused     User refused validation
  292. Long Dist    User is a long distance call and long distance disallowed
  293. Invalid #    User entered a number that is in trashcan file, less than 6
  294.             digits, or begins with a disallowed number (0 or 1)
  295. No Init     Modem could not be initialized
  296. No Connect    Modem could not connect to user's modem (possibly wrong #)
  297. Verified    User was called, modem connected, and password verified
  298. Bad Pass    User was called, modem connected, and incorrect password
  299.  
  300.  
  301. Customizations:
  302. ==============
  303.  
  304. The following files can be modified (optionally using Ctrl-A codes for color):
  305.  
  306. SCB.MSG     The opening screen for SCB
  307. REFUSED.MSG    Verification refused
  308. INSTRUCT.MSG    Instructions
  309. NO_ONE.MSG    Long distance numbers starting with 1 not allowed
  310. NO_ZERO.MSG    Long distance numbers starting with 0 not allowed
  311. LD_TIME.MSG    Not within allowed long distance callback time range
  312. TOOSHORT.MSG    Phone number is less than configured minimum number of digits
  313. PHONECAN.MSG    Phone number found in trash can file
  314. VERIFIED.MSG    Displayed to users after verification
  315.  
  316.  
  317. Registration:
  318. ============
  319.  
  320. If you wish to order a registered copy of SCB at the same time as Synchronet,
  321. use the Synchronet ORDER.TXT file (in the SBBS\DOCS directory).
  322.  
  323. If registering SCB after already purchasing a copy of Synchronet, call
  324. Digital Dynamics voice at 714-529-6328, Support BBS at 714-529-5313 (and use
  325. Domain Shopper), or complete the ORDER.TXT file in the SCB directory and mail
  326. or fax it to Digital Dynamics.
  327.  
  328. /* End of SCB.DOC */
  329.