home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / easyon1a.zip / EASYON.TXT < prev    next >
Text File  |  1994-03-26  |  13KB  |  308 lines
  1.  
  2.  
  3.          ▓▓▓▓▓▓▓▓                          ▓▓▓▓▓▓▓
  4.          ▓▓                               ▓▓     ▓▓
  5.          ▓▓         ▓▓    ▓▓▓▓▓▓ ▓▓    ▓▓ ▓▓     ▓▓  ▓▓▓    ▓▓
  6.          ▓▓▓▓▓▓    ▓  ▓   ▓▓      ▓▓  ▓▓  ▓▓     ▓▓  ▓▓ ▓   ▓▓
  7.          ▓▓       ▓▓▓▓▓▓  ▓▓▓▓▓▓   ▓▓▓▓   ▓▓     ▓▓  ▓▓  ▓  ▓▓
  8.          ▓▓       ▓▓  ▓▓      ▓▓    ▓▓    ▓▓     ▓▓  ▓▓   ▓ ▓▓
  9.          ▓▓▓▓▓▓▓▓ ▓▓  ▓▓  ▓▓▓▓▓▓    ▓▓     ▓▓▓▓▓▓▓   ▓▓    ▓▓▓
  10.  
  11.  
  12. Version 1.01
  13. copyright 1993 by Mark Bernard
  14.  
  15. Maximus copyright by Scott Dudley.
  16. BinkleyTerm copyright by Bit Bucket Software.
  17. OS/2 by IBM
  18.  
  19. Use at your own risk an all that usual stuff.... no guarantees whatsoever.
  20.  
  21. I can be reached at Fido: 1:153/868
  22.  
  23. -Features:
  24.  
  25.  
  26. Each of these can be Sysop-selectable
  27.  
  28. -Log file entry of call number (this can be the only thing done, if desired).
  29. -Automatic Username entry if a matching phone number is found in your user.bbs.
  30.    -if you desire, the script will find the last user (from a given number)
  31.     that logged on, otherwise it will default to the first found.
  32. -Automatic Password entry.  The user also has to select this (by changing 
  33.  his/her password).
  34. -Ability to not allow "blocked" calls.
  35. -Ability to not allow calls from a "bad list". (New in 1.1)
  36.  
  37. Compatability:
  38.  
  39. Tested on:
  40.  
  41. 486-33, 8MB RAM. 
  42. Running OS/2 2.0 (GA + kernal fix + SOM fix + REXXUtil update) and 2.1 GA.
  43.  
  44. Using Binkley 2.56, Binkley 2.58 and Maximus 2.01wb.
  45.  
  46. Supra 14.4 Faxmodem with 1.2J, and 1.70B-04 ROMs. (That DO NOT SUPPORT
  47. caller-id in my telephone exchange... so I made it work anyway!)
  48.  
  49.  
  50. Installation:
  51.  
  52.  1) Copy files.
  53.  
  54.    a) Copy EasyOn.cmd into your maximus directory
  55.    b) Copy the *.mec files to your usual mec/bbs directory ([path]\max\misc), 
  56.       and compile them with meccap.exe.
  57.    
  58.  2) Edit Files.
  59.  
  60.    a) Edit your EasyOn.cmd configuration (first lines of file).
  61.  
  62.       i) Paths and Filenames. (include full paths! and BE ACCURATE!!!)
  63.  
  64.          UserFile: This should be your Maximus user.bbs file.
  65.  
  66.          LogFile:  This should be your binkley.log file.
  67.  
  68.          OutputFile: This is a small file containing the calling number.  It 
  69.                   can be used in MECCA files utilizing the [link] token.
  70.  
  71.                   example:(where OutputFile = "[path]\misc\phone.bbs")
  72.  
  73.                   [yellow]Your number in our records is:[white][phone]
  74.                   [yellow]You are calling from:[white][link]misc\phone
  75.  
  76.          CmdFile: This is the file created by the script that actually loads
  77.                   maximus. It includes the command line switches specified in
  78.                   "MaxString" (with the proper parameters from binkley).
  79.  
  80.                   If AutoName is enabled, and this "program" finds a user that
  81.                   matches the number received from the modem, it will insert 
  82.                   them into the command line before any other switches using 
  83.                   the "-j" switch.
  84.                   example:
  85.                   Maxp "-jJoe Sysop" <other switches and parameters>
  86.  
  87.                   If you have enabled AutoPwd, then it will add a 
  88.                   ";Y;<password>".
  89.                   example:
  90.                   Maxp "-jJoe Sysop;Y;SysopPass" <other switches/parameters>
  91.  
  92.          EasyOnLog: Log of calls & Numbers.
  93.  
  94.          BadList: A flat ascii file listing phone numbers that the BBS will
  95.                   not allow calls from.  On each line, anything after a ";"
  96.                   is ignored, and may be used as a comment.  DO NOT put a "1"
  97.                   in front of long distance numbers. (see sample)
  98.  
  99.  
  100.       ii) MaxString
  101.  
  102.          This should be your "usual" command line for loading Maximus, 
  103.          including all switches. (same as in your SpawnBBS.cmd)
  104.  
  105.  
  106.       iii) Options
  107.  
  108.  
  109.          MoreThanOne: If enabled, will look through the entire user.bbs and use
  110.                   the caller from that number with the latest last logged-on
  111.                   time. If disabled, will use the first match (lowest 
  112.                   user-number).
  113.  
  114.          AutoName: If enabled, will log on the user's name and stop at the
  115.                   prompt "Joe Sysop [Y,n]?"
  116.  
  117.  
  118.          AutoPwd: If enabled, will allow users to log-on entirely (provided 
  119.                   they change their password, and make the first letter a "!".
  120.  
  121.  
  122.          TurfBlock: Allows you to not allow access to users blocking the 
  123.                   caller-id information.
  124.  
  125.          TurfBad:   Allows you to refuse BBS access to callers from specified
  126.                   numbers.
  127.  
  128.                   To utilize "TurfBlock/TurfBad", You must have a caller in
  129.                   your user.bbs with the name as specified in the "BlockName"
  130.                   variable, and a password as specified in the BlockPwd 
  131.                   variable. (or BadName / BadPwd).
  132.  
  133.                   Method 1
  134.                   ~~~~~~~~
  135.                Make these users have a Priv Level of Twit. In the first line 
  136.                of your Welcome.bbs/mec, make the first line: 
  137.                [EQTWIT Show][ckoff][display]misc\blocker
  138.  
  139.                Your "blocker.mec/bbs" can give the caller a message
  140.                as to why he is being turfed, then the token [hangup]
  141.                (see blocker.mec for example).
  142.  
  143.  
  144.                   Method 2
  145.                   ~~~~~~~~
  146.                Give these callers a "custom welcome screen" as described in
  147.                the Maximus Operations Manual (page 14).  This BBS file is 
  148.                displayed BEFORE the Welcome.bbs.  Just make sure these MEC's
  149.                have [ckoff][hangup] in them (and mecca(P) them, of course).
  150.                They must be named #.bbs, where "#" is the user number to show
  151.                the file to. (ie. Create a "user" with the name "Badlist Name",
  152.                and a password of "!InBadList".  If this is user number 124,
  153.                then name the file 124.bbs.  Note: these custom BBS's MUST be
  154.                in your Maximus directory (not ..\misc).
  155.  
  156.                With this method, you don't waste a priv. level.
  157.  
  158.                MAKE SURE YOU MAKE THIS USER PERMANENT.
  159.  
  160.          CallidLog: If enabled, Logs numbers/messages into file specified in
  161.                EasyOnLog.
  162.  
  163.          LogOnly: If enabled, will Log callers number, then exit. It will still
  164.                provide a CmdFile, but no "-j" switch and keystuffing.
  165.  
  166.  
  167.       iv) Other
  168.  
  169.          ConnectString: A string that is ALWAYS in your LogFile (Binkley.Log),
  170.                and located, AFTER the caller-id info.  This is used as an error
  171.                checking tool to ensure that if caller-id is disabled for some
  172.                reason, then the previous user won't get logged on.
  173.  
  174.                Note: I made mine "Connect " (note the space to differentiate 
  175.                      from "Connection").  Could probably be "Spawn". Anything
  176.                      that ALWAYS occurs AFTER the call-id info (within 2 
  177.                      lines), and BEFORE the BBS is spawned.
  178.  
  179.          MdmString: The string receieved from your modem (and in LogFile) that
  180.                has the phone-number after it. This should be the most frequent
  181.                one. (usually "Nmbr =") 
  182.  
  183.                Some modems (mine included) don't recognize caller-id 
  184.                information from the newer (Multi-message data format) exchanges,
  185.                and don't return the proper return code (usually Nmbr =),
  186.                and instead returns a "Mesg =" followed by the "raw" number.
  187.  
  188.                In my case, I made MdmString = "Mesg =", since I get this more 
  189.                often than the strings the modem recognizes (Out of area, and
  190.                Private).
  191.  
  192.                Until the fixes come in from the modem manufacturers,I have
  193.                written a routine to clean up the numbers so they are useable,
  194.                (but still be able to work for modems that are returning "normal"
  195.                information.
  196.  
  197.  
  198.          MdmString2: This is an alternate for MdmString. 
  199.                If your modem DOES support the new exchanges, then make it
  200.                whatever MdmString is NOT. (ie. If MdmString = "Nmbr =", then
  201.                make MdmString2 = "Mesg ="... or visa versa -- your strings may
  202.                differ).
  203.  
  204.  
  205.          BlockIdString: the string received by your modem from callers blocking 
  206.                caller-id.
  207.  
  208.  
  209.          BlockName: The Name in your user.bbs you want to log blocking callers 
  210.                on with, if using the TurfBlock option.
  211.  
  212.          
  213.          BlockPwd: The password you want to use with BlockName, remember to make
  214.                the first character of BlockPwd a "!", and it must match the
  215.                "(ab)user's" password in the user.bbs as well.
  216.  
  217.  
  218.          BadName: The Name in your user.bbs you want to log bad-list callers
  219.                 on with, if using the TurfBad option.
  220.  
  221.  
  222.          BadPwd: The password you want to use with BadName, remember to make
  223.                the first character of BadPwd a "!", and it must match the
  224.                "(ab)user's" password in the user.bbs as well.
  225.  
  226.  
  227.          AreaCode: This should be your local area-code, and will it will be 
  228.                stripped from incoming numbers, if present, and the user's 
  229.                phone numbers (for comparison purposes).  Out of exchange calls
  230.                will still work fine.
  231.  
  232.  
  233.  b) Edit your SpawnBBS.cmd
  234.  
  235.       example (where CmdFile = "[path]\maxp\EasyBBS.cmd")
  236.  
  237.  
  238.         cd\maxp
  239.         call EasyOn.cmd %1 %2 %3 %4 %5 %6 %7 %8 %9
  240.         call EasyBBS.CMD
  241.  
  242. rem Max loading without EasyOn
  243. rem maxp -b%2 -p%3 -t%4 -s%1 -n2 -lLine2.log -z\pipe\snoop2
  244.  
  245.      [rest deleted]
  246.   
  247.       The "%" parameters in the EasyOn.cmd must be exact and in that order,
  248.       as this script will take the parameters from binkley, and place 
  249.       them into your max string accordingly.
  250.  
  251.  
  252.  e) Edit your binkley.cfg
  253.  
  254.       Edit the Answer line (if necessary) so that your modem answers incoming 
  255.       calls AFTER the second ring. The caller-id information is received 
  256.       between the first and second rings. You can play with this string, but
  257.       after fiddling a bit, I found putting "~~~" before the "ATA worked. 
  258.       Two ~'s only worked some of the time, three ~'s worked everytime.
  259.       I also played with the "S0" register, but didn't have much success.
  260.  
  261.  d) Edit your Menus.ctl (and Re-SiltP)
  262.  
  263.       To use the EasyOn informational mecca file, to one of your menus, add
  264.       the line....
  265.  
  266.        display_file    misc\EasyOn     Disgrace "EasyOn Info"
  267.  
  268.       If "E" is already the first letter of a menu-choice on that menu, then
  269.       put another character in front. (ie. "!EasyOn Info" )
  270.    
  271.       
  272.  
  273. That's about it.
  274.  
  275. Notes:
  276.  
  277.    I've tried to make this as error-proof as possible, it will default to the 
  278.    basic maximus command line (as specified in MaxString) if it detects
  279.    anything strange. I HAVE NOT put in checking for valid path/file names. 
  280.    This is up to you (it'll crap out if you specify a wrong LogFile for sure.)
  281.  
  282.    If MoreThanOne = 1, and a second user with the same number is found, it will
  283.    log on the latest one who was on but will also turn off AutoPwd for that 
  284.    user. (This makes sense, I think.)
  285.  
  286.    Don't be scared to enable the AutoPwd.  Let it be up to the user (just make 
  287.    them aware of the what could happen if someone else from their number calls.)
  288.  
  289.    If you wish to test this program, copy your binkley.log file to another
  290.    directory, and point to it with the LogFile in th configuration. The script
  291.    will choke if it tries to access a binkley.log file in use. It's works in
  292.    normal operation.
  293.  
  294.    It will probably be faster if the binkley.log is not too huge.  This should 
  295.    not normally be a problem, as most sysops have some sort of maintenance
  296.    routine that starts a new binkley.log either daily or weekly.
  297.  
  298.    This will not work if Binkley does not get the caller id information.
  299.    This will happen when a caller calls while Bink is recycling. (The first
  300.    ring occurs while bink is loading, and the caller-id info is lost into the 
  301.    ether, as the information is only sent between the first and second rings.)
  302.  
  303.    I also have not tested this with a large user.bbs.  If it's too slow, try 
  304.    setting MoreThanOne = 0, then it'll stop at the first hit.
  305.    
  306.                                 
  307.  
  308.