home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / maxid.lzh / maxid.doc < prev    next >
Text File  |  1993-01-30  |  31KB  |  707 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8. ┌──────────────────────────────────────────────────────────────────────────┐
  9. │ ██       ██                   ████ ███████▄                 Version 1.03 │
  10. │ ████   ████                    ██   ██     █      Featuring: * Caller-ID │
  11. │ ██ ██ ██ ██ ██▀▀▀█ █     █     ██   ██     █           * Auto Name Login │
  12. │ ██   █   ██ ██▄▄▄█  █▄▄▄█      ██   ██     █       * Auto Password Login │
  13. │ ██       ██ ██   █ ▄▀   ▀▄     ██   ██     █   For use with Maximus BBS, │
  14. │ ██       ██ ██   █ █     █    ████ ███████▀ and the Suprafax v.32b modem │
  15. │                                              with J-Roms compatible with │
  16. │ Copyright 1993 by Wayne Boyd                                   Caller-ID │
  17. │ FidoNet 1:153/763, OS/2 Net 81:980/763, ISKCONet 108:410/8               │
  18. ├──────────────────────────────────────────────────────────────────────────┤
  19. │                   Runs on OS/2 and DOS based systems.                    │
  20. │      May also be used with some limitations on other BBS packages.       │
  21. └──────────────────────────────────────────────────────────────────────────┘
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30. Table of Contents:
  31.  
  32.              Disclaimer...................................Page 1
  33.              Minimum System Requirements..................Page 2
  34.              Description..................................Page 2
  35.              Description of Files.........................Page 4
  36.              Quick and Dirty Setup........................Page 4
  37.              Explanation of MaxID.CFG.....................Page 5
  38.                LOGFILE....................................Page 6
  39.                MODEMSTRING................................Page 6
  40.                AREACODE...................................Page 7
  41.                OUTPUT.....................................Page 7
  42.                USERBBS....................................Page 8
  43.                DISABLE_AUTOLOGIN..........................Page 8
  44.                LOADMAX....................................Page 8
  45.                BATCH......................................Page 9
  46.                ALLOWPASSWORD..............................Page 9
  47.              SpawnBBS Example.............................Page 9
  48.              Setting up Your Modem........................Page 9
  49.              Errorlevels..................................Page 10
  50.              Terms and Conditions of Use..................Page 10
  51.              Credits......................................Page 11
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60. I borrowed the following disclaimer from RABITLOC.DOC, a fossil unlock
  61. program for RandomAccess BBS, which, by the way, you don't need with this
  62. program and isn't relevant to this discussion in the least.
  63.  
  64. STANDARD DISCLAIMER (I'm sure you've seen it before somewhere)
  65. ~~~~~~~~~~~~~~~~~~~
  66. This product is meant for educational purposes only. Any resemblance to
  67. real persons, living or dead is purely coincidental. Void where
  68. prohibited. Some assembly required. List each check separately by bank
  69. number. Batteries not included. Contents may settle during shipment. Use
  70. only as directed. No other warranty expressed or implied. Do not use
  71. while operating a motor vehicle or heavy equipment. Postage will be paid
  72. by addressee. Subject to CAB approval. This is not an offer to sell
  73. securities. Apply only to affected area. May be too intense for some
  74. viewers. Do not stamp. Use other side for additional listings. For
  75. recreational use only. Do not disturb. All models over 18 years of age.
  76. If condition persists, consult your physician. No user-serviceable parts
  77. inside. Freshest if eaten before date on carton. Subject to change
  78. without notice. Times approximate. Simulated picture. No postage
  79. necessary if mailed in the United States. Breaking seal constitutes
  80. acceptance of agreement. For off-road use only. As seen on TV. One size
  81. fits all. Many suitcases look alike. Contains a substaintial amount of
  82. non-tobacco ingredients. Colors may, in time, fade. We have sent the
  83. forms which seem to be right for you. Slippery when wet. For office use
  84. only. Not affiliated with the American Red Cross. Drop in any mailbox.
  85. Edited for television. Keep cool, process promptly. Post office will not
  86. deliver without postage. List was current at time of printing. Return to
  87. sender, no forwarding order on file, unable to forward. Not responsible
  88. for direct, indirect, incidental or consequential damages resulting from
  89. any defect, error or failure to perform. At participating locations
  90. only. Not the Beatles. Penalty for private use. See label for sequence.
  91. Substantial penalty for early withdrawal. Do not write below this line.
  92. Falling rock. Lost ticket pays maximum rate. Your cancelled check is
  93. your receipt. Add toner. Place stamp here. Avoid contact with skin.
  94. Sanitized for your protection. Be sure each item is properly endorsed.
  95. Sign here without admitting guilt. Slightly higher west of the
  96. Mississippi. Employees and their families are not eligible. Beware of
  97. owl. Contestants have been briefed on some questions before the show.
  98. Limited time offer, call now to insure prompt delivery. You must be
  99. present to win. No passes accepted for this engagement. No purchase
  100. necessary. Processed at location stamped in code at top of carton.
  101. Shading within a garment may occur. Use only in well-ventilated area.
  102. Keep away from fire or flame. Replace with same type. Approved for
  103. veterans. Booths for two or more. Check here if tax deductible. Some
  104. equipment shown is optional. Price does not include taxes. No Canadian
  105. coins. Not recommended for children. Prerecorded for this time zone.
  106. Reproduction strictly prohibited. No solicitors. No alcohol, dogs, or
  107. horses. No anchovies unless otherwise specified. Restaurant package, not
  108. for resale. List at least two alternate dates. First pull up, then pull
  109. down. Call toll free before digging. Driver does not carry cash. Some of
  110. the trademarks mentioned in this product appear for identification
  111. purposes only. Record additional transactions on back of previous stub.
  112.  
  113. This supersedes all previous notices.
  114.  
  115.  
  116.  
  117. MaxID Version 1.03                                     Page 1
  118.  
  119. MINIMUM SYSTEM REQUIREMENTS
  120. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  121. To run this program you need the following system requirements:
  122.  
  123. o  Maximus BBS 2.00 or greater either DOS or OS/2 version.... OR...
  124.  
  125. o  If you don't run Maximus, you can still use this program with some
  126.             restrictions. See DISABLE_AUTOLOGIN in the "EXPLANATION OF
  127.             MAXID.CFG" section below.
  128.  
  129. o  BinkleyTerm 2.50 or higher version. (Another mailer *might* work.
  130.             Might work with Frontdoor if you can get it to record all
  131.             the stuff that comes from the modem in the log file.)
  132.  
  133. o  A Suprafax V.32B modem with J-Roms or other compatible modem that
  134.             supports Caller-ID
  135.  
  136. o  A telephone company that supports Caller-ID or sometimes they call it
  137.             Call Display, and you have to tell them to activate it for
  138.             you. Caller-ID is not available in all areas with all phone
  139.             companies. Check with your phone company if it is available
  140.             in your area.
  141.  
  142. I will assume you have assembled all these toys together, and that you
  143. have them all setup and working (no, I have NO intention of telling you
  144. how to do that). Now I'll tell you what MaxID can do.
  145.  
  146. DESCRIPTION
  147. ~~~~~~~~~~~
  148. This is a highly specialized program that does an *amazing* thing. I'm
  149. going to tell you what this program does on my computer. I can't
  150. guarantee it will do the same for you. If you don't have what it takes
  151. to run this program, then I recommend you go and get what you need, even
  152. if it means buying a Suprafax modem! You have never seen anything quite
  153. like what this program does. It will dazzle the sysop and the callers
  154. too. It may also eliminate the need for a call back verifier on your
  155. BBS too.
  156.  
  157. Here, in a nutshell, are the three features of MaxID:
  158.  
  159. 1) When a new caller logs on your bulletin board, your BBS can now tell
  160.    the caller in the logon sequence what his or her phone number is even
  161.    before the caller provides the BBS with his or her phone number. This
  162.    feature can be available to most BBS packages. This information is
  163.    sent by the phone company to the modem, the modem tells Binkleyterm,
  164.    Binkleyterm tells it's log files, and this program reads the
  165.    Binkleyterm Log file from the bottom up to find the information. No
  166.    need for a call back verifier since the caller can see you already
  167.    know his or her phone number.
  168.  
  169.    This feature is called Caller-ID
  170.  
  171. 2) For users who are already registered on your BBS, MaxID will identify
  172.    the callers phone number from the Binkleyterm log as supplied by the
  173.    modem, and will then search the Maximus USER.BBS file for a matching
  174.    phone number. If it finds a match, it will extract the callers name
  175.  
  176. MaxID Version 1.03                                     Page 2
  177.  
  178.    from the user list and create a batch file to load Maximus with the
  179.    caller's name on the command line. The caller will simply discover,
  180.    upon logging on, that Maximus will present him or her with his or her
  181.    name. THIS FEATURE AND THE NEXT FEATURE ARE PRESENTLY ONLY AVAILABLE
  182.    TO USERS OF MAXIMUS BBS. Upon calling your BBS, the Maximus caller
  183.    will be greeted something like this:
  184.  
  185. Maximus v.2.01wb
  186. Joe Duffy (Y/n)?
  187.  
  188.    In other words, even without the caller typing in his or her name,
  189.    the BBS will mysteriously already know who they are just because of
  190.    the phone number they used to call the board. If the caller happens
  191.    NOT to be Joe Duffy, he can answer NO to the question above and
  192.    re-enter his name. This could happen if two people use the same
  193.    computer at the same phone number. All this will happen automatically
  194.    when your callers phone your BBS.
  195.  
  196.    This feature is called "Auto Name Login".
  197.  
  198. 3) Also specific to Maximus users, MaxID is capable of auto logging a
  199.    caller's password at the discretion of the caller. This is an
  200.    optional feature. If you enable this feature here, and if a caller
  201.    wants to have AutoLogin including his or her password, he/she would
  202.    simply have to add a ! as the first character of their password. To
  203.    deactivate this feature, they simply would need to remove the ! from
  204.    the first character of their password in the CHANGE menu. This gives
  205.    the option to the caller if they want AutoLogin to also include the
  206.    password, and they can decide if they want to take this risk.
  207.    Obviously someone who shares a computer/phone line with other members
  208.    of the same household or business would NOT want this, and they can
  209.    just omit the exclamation mark from the first character of their
  210.    password. But if someone has exclusive use of a computer and phone
  211.    line, they may want this feature implemented. In any case, I left the
  212.    SysOp in control (although I feel the sysop should let the caller
  213.    decide). If the SysOp does not want this feature of MaxID then he/she
  214.    can configure this program to disallow it. I recommend to allow the
  215.    callers to decide if they want it on an individual basis. It's their
  216.    password. Let them decide how to use it.
  217.  
  218.    This feature is called "Auto Password Login".
  219.  
  220. DESCRIPTION OF FILES
  221. ~~~~~~~~~~~~~~~~~~~~
  222. With this package are the following files. If you don't have them all,
  223. you don't have an authorized version and you should get one. You can
  224. always file request the latest version of MaxID from my board at Fidonet
  225. 1:153/763.
  226.  
  227. MAXID.EXE.............This is a DOS program. There's NO OS/2 version :-(
  228.                       But don't worry! I run a purely OS/2 system
  229.                       including Maximus/Binkleyterm/Squish, and this
  230.                       program still works, does it's job seamlessly and
  231.                       is perfectly okay to use. I'll explain it to you
  232.                       as you read on. But for now, if you run an OS/2
  233.                       mailer and an OS/2 BBS, you can still use this
  234.  
  235. MaxID Version 1.03                                     Page 3
  236.  
  237.                       program without problems even though it's a DOS
  238.                       executable.
  239.  
  240. MAXID.CFG.............This is the configuration file for the MaxID
  241.                       program. This is what you fiddle with to make
  242.                       MaxID work. Use a vanilla ascii editor for this.
  243.  
  244. MAXID.DOC.............If you were really observant, you might have
  245.                       noticed that this is the name of the document you
  246.                       are presently reading.
  247.  
  248. AUTOLOG.MEC...........An explanation to your callers how to take
  249.                       advantage of Auto Name Login and Auto Password
  250.                       Login and possible risks involved in Auto Password
  251.                       Login. Also explains to them how to activate and
  252.                       deactivate Auto Password Login if the sysop has
  253.                       allowed this feature. This is a Maximus MECCA file
  254.                       and is not much use unless you operate a Maximus
  255.                       BBS.
  256.  
  257. NOTFOUND.MEC..........A suggestion of how to take advantage of Caller-ID
  258.                       when dealing with new callers. This is what I use.
  259.                       You can change it around as you like. This is also
  260.                       a Maximus MECCA file and not much use unless you
  261.                       operate a Maximus BBS.
  262.  
  263. WHATSNEW.DOC..........These are the latest, greatest changes, updates and
  264.                       bug fixes to MaxID over previous versions.
  265.  
  266. QUICK AND DIRTY SETUP
  267. ~~~~~~~~~~~~~~~~~~~~~
  268. If you don't want to read all the nitty-gritty details of this program
  269. and just want to get it going quickly on a Maximus system, this is what
  270. you have to do. If you don't run Maximus, you are very limited what you
  271. can do with this program. For non-Maximus users, please see the
  272. DISABLE_AUTOLOGIN section below.
  273.  
  274. STEP ONE:
  275. Copy the MECCA files (*.MEC) into your \max\misc directory and compile
  276. them with MECCA.EXE. If you don't know how to do that, what are you
  277. doing with this program??
  278.  
  279. STEP TWO:
  280. Copy MAXID.EXE and MAXID.CFG anywhere you want. Might be convenient to
  281. put them in your Maximus system directory (\max)
  282.  
  283. STEP THREE:
  284. Edit MAXID.CFG with an ascii editor. A lot is explained in there and you
  285. can get a feel for it right away. You *must* edit it or it will not work
  286. properly. Go in there and look at it.
  287.  
  288. STEP FOUR:
  289. Edit your batch file that loads Maximus. Remove the line that normally
  290. calls Maximus and replace it with the following:
  291.  
  292. MAXID MAXID.CFG
  293.  
  294. MaxID Version 1.03                                     Page 4
  295.  
  296.  
  297. or if you have MaxID in a different directory, then:
  298.  
  299. d:\path\MAXID d:\path\MAXID.CFG
  300.  
  301. NOTE FOR OS/2 USERS: It doesn't matter if you are running OS/2 and this
  302. is a DOS program. Since the program is fast and does not access the
  303. comport, it will not interfere with anything. OS/2 users must NOT use
  304. "START" to run this program. It must be called directly from the command
  305. line. It will start a brief DOS session, run the program, and return to
  306. the OS/2 batch file without dumping the caller. Trust me. I wrote the
  307. program, and I also run an OS/2 BBS.
  308.  
  309. In the line AFTER loading MaxID in your batch file, call the name of the
  310. batch file that MaxID creates. This is configured in MAXID.CFG. By
  311. default, MaxID will create BBS.CMD (for OS/2) and BBS.BAT (for DOS).
  312.  
  313. REM This is how you would do it for DOS
  314. Call BBS.BAT %1 %2 %3 %4 %5 %6 %7 %8 %9
  315.  
  316. REM This is how you would do it for OS/2
  317. Call BBS.CMD %1 %2 %3 %4 %5 %6 %7 %8 %9
  318.  
  319. NOTE: This is NOT where you load your BBS with all the switches. That's
  320. done by putting all the switches in MaxID.CFG. The parameters %1 through
  321. %9 SHOULD be in sequential order here, just like the way you see it
  322. above.
  323.  
  324. STEP FIVE:
  325. Create a Maximus menu option so the callers can see and read the
  326. AUTOLOG.MEC file that you copied into \max\misc and compiled. I do it
  327. off my main menu. The NOTFOUND.MEC file will be displayed to callers
  328. when they first call into your BBS.
  329.  
  330. That's it.
  331.  
  332. EXPLANATION OF MAXID.CFG
  333. ~~~~~~~~~~~~~~~~~~~~~~~~
  334. MaxID.CFG is the configuration file for MaxID. MaxID must be told the
  335. name and location of this file on the command line in order for it to
  336. function properly. The following is a detailed description of the
  337. "keywords" in the configuration file.
  338.  
  339. All "keywords" must be present in the configuration file. None of them
  340. should be commented out. Lines beginning with a semi-colon (;) in the
  341. extreme left margin are considered comment lines and are ignored. The
  342. file is not case sensitive and you may use any combination of upper or
  343. lower case letters.
  344.  
  345. MaxID takes one and only one command line parameter. If this is not
  346. supplied, it will not run. You MUST tell MaxID the location and filename
  347. of the configuration file on the command line. See examples below.
  348.  
  349. Example 1: (how to load MaxID from the command line)
  350.  
  351. MaxID MaxID.cfg
  352.  
  353. MaxID Version 1.03                                     Page 5
  354.  
  355.  
  356.  
  357. Example 2: (how to load MaxID from the command line when MaxID is in
  358.             another subdirectory).
  359.  
  360. c:\batch\MaxID c:\batch\MaxID.CFG
  361.  
  362.  
  363.  
  364.    KEYWORD explanation:
  365.  
  366.        LOGFILE <drive:\path\filename.ext>
  367.  
  368.            Defines the name and location of your Binkleyterm (or
  369.            other mailer?) log files. MaxID will read the log file from
  370.            the bottom backwards. This insures that even if the logfile
  371.            is very large, it will not take MAXID any longer to locate
  372.            the correct phone number of the incoming call than for a
  373.            short log file. MaxID extracts the incoming callers phone
  374.            number from this logfile as supplied by your modem and phone
  375.            company.
  376.  
  377.            MaxID will not search backwards indefinitely. If it doesn't
  378.            find the phone number after searching back 20 lines, it will
  379.            assume the number is unavailable.
  380.  
  381.  
  382.        MODEMSTRING <string>
  383.  
  384.            This keyword is provided for possible compatibility with
  385.            modems other than the Suprafax v.32b with J-Roms. <string> is
  386.            here defined as the characters that the modem sends prior to
  387.            the phone number. A snippet from BinkleyTerm's log files
  388.            might look like this:
  389.  
  390.            # 25 Jan 15:21:43 BINK Ring
  391.            # 25 Jan 15:21:49 BINK Date = 0125
  392.            # 25 Jan 15:21:49 BINK Time = 1520
  393.            # 25 Jan 15:21:49 BINK Nmbr = 4310499
  394.            : 25 Jan 15:22:14 BINK Connect 2400
  395.            + 25 Jan 15:22:14 BINK Spawning BBS
  396.  
  397.            In this case <string> should be defined as Nmbr =
  398.            Do not put quotations around this string. Default for this
  399.            setting is MODEMSTRING Nmbr =
  400.  
  401.            This is the string MaxID will look for in order to locate the
  402.            telephone number in the log file.
  403.  
  404.  
  405.        AREACODE <number>
  406.  
  407.            This defines your area code. Usually, as the telephone
  408.            company sends it, caller-id for local calls does not include
  409.            the areacode. However the problem is that many callers have
  410.            put an areacode in their userfile when they registered, so
  411.  
  412. MaxID Version 1.03                                     Page 6
  413.  
  414.            this would mean the two numbers would not match. Or it may go
  415.            the other way that caller-id may report the areacode and the
  416.            number in user.bbs does not contain an areacode. To fix this
  417.            problem, place the number of your areacode here. This will
  418.            cause MaxID to strip your areacode both from the Binkleyterm
  419.            log file and from the phone strings it finds in user.bbs to
  420.            find a match. NOTE: strings like () and - are automatically
  421.            ignored by MaxID and so make no difference whether they are
  422.            present or not present.
  423.  
  424.            This keyword will not affect what is written in the callers
  425.            file which is untouched by this program.
  426.  
  427.  
  428.        OUTPUT <drive:\path\filename.BBS>
  429.  
  430.            MaxID will create a file which can be read by Maximus
  431.            directly to display the callers phone number to the caller.
  432.            Put the path and name of this file after this keyword. The
  433.            file name should have .BBS as an extension. By default it
  434.            should normally be \max\misc\phone.bbs for Maximus users.
  435.  
  436.            This file will contain only the phone number of the caller in
  437.            formatted form. For example, if the phone number in
  438.            BINKLEY.LOG was 4316260 then the phone number in the file
  439.            created by OUTPUT will appear as 431-6260. Similarly, if the
  440.            mailer log file gives the phone number as 6044316260, then
  441.            the number will appear in the OUTPUT file as (604)431-6260.
  442.  
  443.            If the caller's number is unlisted or unavailable to the
  444.            phone company at the time the call was made, MaxID will write
  445.            the phone number as "unavailable." Note the period at the end of
  446.            the word, and the word also begins with a lower case letter.
  447.  
  448.            Maximus sysops can take advantage of this file in MECCA files
  449.            by using the [link] token to display the phone number to the
  450.            caller.
  451.  
  452.            Example:
  453.  
  454.            The phone number you are calling from is [link]misc\phone
  455.  
  456.            If the call is coming from 4316260 this will display to the
  457.            caller in the BBS as follows:
  458.  
  459.            The phone number you are calling from is 431-6260
  460.  
  461.            If the call is coming from an unlisted number it will display
  462.            to the caller in the BBS as follows:
  463.  
  464.            The phone number you are calling from is unavailable.
  465.  
  466.  
  467.        USERBBS <drive:path\name.ext>
  468.  
  469.            This is the name and location of your Maximus USER.BBS file
  470.  
  471. MaxID Version 1.03                                     Page 7
  472.  
  473.            containing the users of your BBS. If you don't have one,
  474.            change it to NUL.
  475.  
  476.            The default is USERBBS c:\max\user.bbs
  477.  
  478.  
  479.        DISABLE_AUTOLOGIN <Yes/No>
  480.  
  481.            If you don't want to use any of the autologin features, but
  482.            simply want to use this program to utilize Caller-ID and show
  483.            that information in the bulletin board to the callers, you
  484.            can disable AutoLogin entirely. If you set DISABLE_AUTOLOGIN
  485.            to YES then the program will not search USER.BBS for a
  486.            matching phone number and name, and will not write a batch
  487.            file that can be called by you to enable autologin. In
  488.            otherwords, when DISABLE_AUTOLOGIN is set to YES then this
  489.            program functions as a simple caller-ID program that writes
  490.            the phone number found in the mailer log file to a single
  491.            disk file and that's all. This will cause the program to run
  492.            slightly faster of course, but effectively removes the
  493.            ability of Maximus to know the name of the caller.
  494.  
  495.            This is also useful for compatibility with other BBS packages
  496.            that may not be able to load the caller's name and optional
  497.            password directly from the command line. In such cases, you
  498.            COULD use this program only for caller-ID which creates a
  499.            file that could be read from the BBS.
  500.  
  501.            The default setting is "DISABLE_AUTOLOGIN No"
  502.  
  503.  
  504.        LOADMAX <string>
  505.  
  506.            This is where you tell MaxID what your batch file normally
  507.            uses to load Maximus after a caller presses escape and exits
  508.            the mailer to load the BBS. You should normally copy the
  509.            string directly from your old batch file and place it here
  510.            after the LOADMAX keyword.
  511.  
  512.            If, for example, your batch file normally loads Maximus like
  513.            this --
  514.  
  515.            maxp max -b%2 -p%3 -t%4 -s%1 -n1 -z\pipe\maxsnoop
  516.  
  517.            Then you would put this in MaxID.CFG:
  518.  
  519.            LOADMAX maxp max -b%2 -p%3 -t%4 -s%1 -n1 -z\pipe\maxsnoop
  520.  
  521.            Note: maxP is the OS/2 version of Maximus, which is what I
  522.            run over here.
  523.  
  524.  
  525.        BATCH <filename>
  526.  
  527.            MaxID will create a batch file upon termination that should
  528.            be CALLed from your normal batch file. The name of the batch
  529.  
  530. MaxID Version 1.03                                     Page 8
  531.  
  532.            file should go here. If you are running DOS you must append
  533.            the file name with .BAT and if you are running OS/2 software
  534.            then you must append the filename with .CMD
  535.  
  536.            You can also include a drive and path statement to <filename>
  537.            if you wish to create the batch file in a different directory
  538.            other than the one where MaxID is running.
  539.  
  540.            Note: You will still have to provide the BBS batch file with
  541.            command line parameters. See below how to call BBS.BAT or
  542.            BBS.CMD in the section entitled "Spawnbbs Example"
  543.  
  544.            The default is BATCH bbs.cmd
  545.  
  546.            If you are running DOS the default should be BATCH bbs.bat
  547.  
  548.  
  549.        ALLOWPASSWORD <YES/NO>
  550.  
  551.            If you want to disable the ability of callers to take
  552.            advantage of Auto Password Login in addition to Auto Name
  553.            Login, then set ALLOWPASSWORD to NO. If you want to allow
  554.            callers to be able to decide themselves if they want it on an
  555.            individual basis, set this to YES.
  556.  
  557.            Default: ALLOWPASSWORD YES
  558.  
  559.  
  560. SPAWNBBS EXAMPLE
  561. ~~~~~~~~~~~~~~~~
  562. If you run OS/2, like me, you use SPAWNBBS.CMD to load Maximus. Here's a
  563. snippet of mine:
  564.  
  565. [SPAWNBBS.CMD]
  566. cd \max
  567. maxid maxid.cfg
  568. call bbs.cmd %1 %2 %3 %4 %5 %6 %7 %8 %9
  569.  
  570. This is also applicable to DOS users, except obviously in that case it
  571. would be spawnbbs.bat. Note that although MaxID is a DOS based
  572. application, it can still be run under OS/2 and works fine here.
  573.  
  574. BBS.CMD (or BBS.BAT) is created by MaxID. If a matching phone number was
  575. located in USER.BBS then MaxID will add the caller's name and optional
  576. password to the command line string to load the BBS.
  577.  
  578.  
  579. SETTING UP YOUR MODEM
  580. ~~~~~~~~~~~~~~~~~~~~~
  581. I don't know how other modems do it, but the Suprafax v.32b modem with
  582. J-Roms does it with an AT command. MaxID needs to have human readable
  583. responses from the Caller-ID of the modem. The following "AT" command
  584. activates this when entered or added to your Binkleyterm or other mailer
  585. modem init string.
  586.  
  587. AT#CID=1
  588.  
  589. MaxID Version 1.03                                     Page 9
  590.  
  591.  
  592.  
  593. The next thing to be aware of is that the Caller-ID information comes
  594. between the first and second ring, so Binkleyterm cannot answer the
  595. phone right away. On the other hand if it waits TOO long, you will get a
  596. lot of lost carriers. There is a delicate balance. In my binkley.cfg
  597. I have the following answer string which seems to work quite well:
  598.  
  599. Answer ~~~ATA|
  600.  
  601. This causes Binkleyterm to wait just long enough to get the caller-id
  602. information before answering the call.
  603.  
  604. ERRORLEVELS
  605. ~~~~~~~~~~~
  606. If MaxID encounters problems, it exits with errorlevels that can be
  607. captured with your batch file. This is a list of them:
  608.  
  609. errorlevel 4 .........cannot find next record in USER.BBS
  610.                       EXPLANATION: Something is wrong with your USER.BBS
  611.  
  612. errorlevel 3 .........cannot find a file (i/o error).
  613.                       EXPLANATION: A path or file name is wrong in the
  614.                       configuration file.
  615.  
  616. errorlevel 2 .........The config file could not be found.
  617.                       EXPLANATION: The command line parameter pointing to
  618.                       the config file is incorrect.
  619.  
  620. errorlevel 1 .........You tried to run MaxID without a command line parameter.
  621.                       EXPLANATION: MaxID has to be run with a command
  622.                       line parameter that points to the configuration
  623.                       file.
  624.  
  625. errorlevel 0 .........Normal termination. The program did it's thing okay.
  626.  
  627.  
  628. TERMS AND CONDITIONS OF USE
  629. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  630. You are not required to register MaxID unless you run MaxID in a
  631. commercial environment or on a commercial BBS. If your BBS users require
  632. to send you money for access to your system, then you are required to
  633. send me $25.00 for a license to use this program. Otherwise, the program
  634. is free, and no other registration is required.
  635.  
  636. However, anyone may choose to register the program, and those that
  637. choose to do so should send a cheque or money order for $25.00 to the
  638. address below. In response, you will receive a registration number. You
  639. can enter this registration number in MaxID.CFG. There is no difference
  640. in the way the registered version of MaxID behaves and the unregistered
  641. version with one exception. The unregistered version writes the words
  642. "MaxID (UnRegistered)" just below the telephone number in the OUTPUT
  643. file (see MaxID.CFG for more information about this file). This is
  644. removed in the registered version.
  645.  
  646. To Register this program please send me the following information:
  647.  
  648. MaxID Version 1.03                                     Page 10
  649.  
  650.  
  651. 1) Your Name, exactly as it will appear in MaxID.CFG
  652. 2) Your areacode string, exactly as it will appear in MaxID.CFG
  653.  
  654. You will receive a registration number which you can then enter in
  655. MaxID.CFG. This registration number is a composite derived from the
  656. information above as you supplied it to me. This will remove the
  657. unregistered notice in the file created by the OUTPUT keyword in the
  658. configuration file.
  659.  
  660. I may be reached in the following ways:
  661.  
  662. Send your registration information to:
  663.  
  664.         Wayne Boyd
  665.         c/o Vipramukhya Swami
  666.         5462 S.E. Marine Drive
  667.         Burnaby, BC V5J 3G8
  668.         CANADA
  669.  
  670. I may also be reached in the following ways:
  671.  
  672. By Fidonet Netmail... 1:153/763
  673.  
  674. By OS/2 Netmail.......81:980/763
  675.  
  676. By BBS phone: (604)431-6260  1200,2400,9600,7200,12000,14000 bps.
  677.  
  678. CREDITS
  679. ~~~~~~~
  680. I would like to thank Matt Ion for giving me some of the ideas for this
  681. program. He also encouraged me to keep the Auto Password Login available
  682. although I originally thought it should be left out. After all, why not?
  683. Let the caller decide or at least the sysop if they want the feature. I
  684. am using it here, and it's really nice. The callers love it too.
  685.  
  686.                   Wayne Boyd
  687.                   Sita and the Ring (OS/2) BBS
  688.                   Running Maximus (OS/2 version)
  689.                   and BinkleyTerm (OS/2 version)
  690.  
  691.                   Needless to say, I also have a
  692.                   Suprafax v.32b modem with J-Roms
  693.  
  694. One final note. If you don't believe this all works... call my BBS and
  695. see for yourself. Although caller ID doesn't work here for callers
  696. outside of Canada, you will still get the idea.
  697.  
  698.                             Hare Krishna!
  699.  
  700.  
  701.  
  702.  
  703.  
  704. MaxID Version 1.03                                     Page 11
  705.  
  706.  
  707.