home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbs / ezv133.zip / EZVERIFY.DOC < prev    next >
Text File  |  1994-02-21  |  17KB  |  478 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                             EZVERIFY 1.33
  12.  
  13.                  Copyright (c) 1993-94 by Mark Hanson
  14.                          ALL RIGHTS RESERVED
  15.  
  16.  
  17. Disclaimer
  18. ----------
  19. This software and documentation are supplied "AS IS".  The author
  20. makes no warranty of any kind, either express or implied, with
  21. respect to this software and accompanying documentation. 
  22.  
  23. IN NO EVENT SHALL THE AUTHOR OF THIS SOFTWARE BE LIABLE FOR ANY
  24. DAMAGES ARISING OUT OF THE USE OF THIS PRODUCT.  YOUR USE OF THIS 
  25. SOFTWARE INDICATES THAT YOU HAVE READ AND AGREE TO THESE TERMS.
  26.  
  27.  
  28. License
  29. -------
  30. EZVERIFY is not public domain or free software.
  31.  
  32. You are granted a license to use the shareware version of EZVERIFY
  33. for an evaluation period of 30 days.  After 30 days, registration is
  34. required.  The shareware version of EZVERIFY may be duplicated and
  35. distributed for the purpose of evaluation only.  No fee may be
  36. charged for distributing the shareware version (other than an
  37. administrative fee not exceeding $5).
  38.  
  39.  
  40. Registration                                                      
  41. ------------
  42. Features of the registered version include:
  43.  
  44.     - The right to edit any or all of the external display files.
  45.  
  46.     - The display of your BBS name when calling a user back.
  47.  
  48.     - The display of your registration name when the program starts,
  49.       with no delay whatsoever.
  50.  
  51. To receive a registered version of EZVERIFY, you may print out and
  52. complete the text file named "ORDER.FRM".  If you cannot print the
  53. order form, just write the equivalent information out by hand.  Send
  54. the order information, along with a check or money order for $20 in
  55. US funds ($25 outside the US) payable to Mark Hanson to:
  56.  
  57.         Mark Hanson                 
  58.         PO Box 10154
  59.         Rochester, NY 14610-0154
  60.         USA
  61.  
  62. After payment is received, a serial number based on your registration
  63. name will be generated for you.  Your serial number will be mailed to
  64. you within 10 days.  If you supplied a FidoNet address with your
  65. information, your serial number will be netmailed to you.
  66.  
  67. When you receive your serial number, run the setup program and enter
  68. your registration name and serial number.  The registration name must
  69. be typed EXACTLY as it appeared on the order form.  Your personalized
  70. serial number will work with all future releases of EZVERIFY.
  71.  
  72.  
  73. Introduction
  74. ------------
  75. EZVERIFY is an automated callback verifier created specifically for
  76. Ezycom.  EZVERIFY makes it unnecessary for a sysop to call BBS users
  77. by voice to verify their phone numbers. By using EZVERIFY, you never
  78. have to worry about people calling under duplicate accounts again! 
  79. EZVERIFY can automatically call back first-time callers.  If the
  80. caller's phone number is valid, EZVERIFY will instantly upgrade his
  81. or her time limit and security level.  EZVERIFY is multi-node aware,
  82. and automatically detects which node it's running on.
  83.  
  84.  
  85. Installation
  86. ------------
  87. To install EZVERIFY, simply create a directory for it and copy the
  88. distribution files to that directory.
  89.  
  90. After the files are in their own directory, create a menu option for
  91. EZVERIFY using EZYMENU.  The required fields for the option are:
  92.  
  93.     Data: <path>\EZVERIFY.EXE *M
  94.           (where <path> is the drive/directory you installed to)
  95.  
  96.     Menu Type: 7
  97.                (Menu Type 7 means "Shell to DOS program")
  98.  
  99. Sysops who run multi-node systems should have the TASK environment
  100. variable set correctly.  If you do not set TASK, placing -n*N on the
  101. command line after EZVERIFY.EXE will specify the correct node number.
  102.  
  103. Please be sure that the EZY environment variable is set correctly.
  104.  
  105. After creating a menu option for EZVERIFY, you must run the setup
  106. program to specify a few options.  See the section on setup below.
  107.  
  108. Support
  109. -------
  110. EZVERIFY is supported on: 
  111.       
  112.         BBS: 1 X. I. S.
  113.       Where: Rochester, NY USA
  114.       Sysop: Mike Shimkus      
  115.       Phone: (716) 671-7745
  116.       Speed: 12-14.4K v32
  117.     FidoNet: 1:2613/119
  118.  
  119.     To download the latest version of EZVERIFY or to receive support,
  120.     sign on with the user name "EZVERIFY".
  121.  
  122.     EZVERIFY may also be File Requested with the magic name "EZV".
  123.  
  124.     Any questions or comments you have about EZVERIFY may be
  125.     addressed to "Mark Hanson" in the EZVERIFY support conference.
  126.  
  127.     You may also send netmail to "Mark Hanson" at 1:2613/119.
  128.  
  129.  
  130. Setup
  131. -----
  132. To set up EZVERIFY, first switch to the directory that contains the
  133. program files.  Then, run EZVSETUP.  EZVSETUP allows you to change
  134. many options concerning how EZVERIFY works.
  135.  
  136. The opening screen presents a main menu.  Select a menu option by
  137. clicking with the mouse, pressing enter, or hitting the highlighted
  138. letter.  Use the arrow keys or a mouse to move among menu options or
  139. fields.  The status line at the bottom of the screen provides a
  140. description of each menu option and field.
  141.  
  142.  
  143. Setup - System
  144. --------------
  145.  
  146.     Registration Name
  147.     -----------------
  148.     If you have registered EZVERIFY, enter the registration name as
  149.     it appears on the order form into this field.
  150.  
  151.     Serial Number
  152.     -------------
  153.     Complete this field if you have registered EZVERIFY.
  154.  
  155.     Local Area Code
  156.     ---------------
  157.     EZVERIFY must be aware of your local area code to implement it's
  158.     intelligent dialing features.  Even if you don't want to make    
  159.     toll calls, be sure the local area code is correct.
  160.  
  161.     Local Exchange
  162.     --------------
  163.     As with the Local Area Code, EZVERIFY must be aware of your local
  164.     telephone exchange.  By having this information, EZVERIFY can
  165.     automatically build a list of calls that are local to you.  In
  166.     North America, the exchange is the first three digits of your
  167.     phone number (without the area code).
  168.  
  169.     Verify Only
  170.     -----------
  171.     If set to "Y"es, EZVERIFY will ALWAYS hang up on the user after
  172.     verification is complete.  This is desirable to sysops who run
  173.     their BBS on "metered" phone lines.
  174.  
  175.     Duplicate Check
  176.     ---------------
  177.     If set to "Y"es, two events will occur:
  178.         
  179.         EZVERIFY will record the phone number of every successful
  180.         verification in a file called "EZVERIFY.DUP".
  181.  
  182.         If a user's phone number appears in "EZVERIFY.DUP",
  183.         verification will not proceed.
  184.  
  185.  
  186.     Use Alias
  187.     ---------
  188.     If set to "Y"es, a user's alias will be used in preference to his
  189.     or her real name.
  190.  
  191.     Enforce LOCAL.EZV
  192.     -----------------
  193.     If set to "Y"es, EZVERIFY will never ask a caller if the phone
  194.     number is a toll call.  All local numbers must be defined in
  195.     "LOCAL.EZV" for this to work.
  196.  
  197.     Verified Level
  198.     --------------
  199.     This field designates the security level to grant to a newly      
  200.     verified user.  This level must be defined in the BBS in order to
  201.     correctly set the user's time left after verification.
  202.  
  203.     Flags A-D
  204.     ---------
  205.     These fields indicate how to set a user's Ezycom "flags" upon
  206.     verification.  Each flag has 8 positions.  An "X" in a position
  207.     means "turn this position on".  An "O" in a position means "turn
  208.     this position off".  A "-" or space means "ignore this position".
  209.  
  210.     Time To Bank
  211.     ------------
  212.     If a value is entered in this field, the user's banked time will
  213.     be increased by this amount (in minutes) after verification.
  214.  
  215.     KB To Bank
  216.     ----------
  217.     If a value is entered in this field, the user's banked kilobytes
  218.     will be increased by this amount after verification.
  219.  
  220.     User Comment
  221.     ------------
  222.     If this field is not blank, the Ezycom "User Comment" will be
  223.     set to the this value upon verification.
  224.  
  225.  
  226. Setup - Modem
  227. -------------
  228.  
  229.     You may define different modem information for each node of the
  230.     BBS.  If you are running a multi-node system, press the PageUp
  231.     and PageDown keys to configure the modem for each node.
  232.     
  233.     Init String
  234.     -----------
  235.     If this field is not blank, it will be sent to your modem before
  236.     EZVERIFY places a call to a user.  There are 40 characters
  237.     available, to allow things such as turning the modem speaker off.
  238.     As in Ezycom, use a "|" character to represent a carriage return.
  239.  
  240.  
  241.     Dial Prefix
  242.     -----------
  243.     This is the prefix to send to the modem before a phone number. 
  244.     For most modems, it should be "ATDT" for touch-tone dialing, or
  245.     "ATDP" for pulse dialing.  Do NOT append a "|" character to it.
  246.  
  247.     Hangup String
  248.     -------------
  249.     This is only used if EZVERIFY is having problems hanging up on a
  250.     user.  For most modems, "ATH|" will work fine.
  251.  
  252.     Redial Attempts
  253.     ---------------
  254.     Set this to the maximum number of tries that EZVERIFY will make
  255.     at connecting to a user, not counting the first try.
  256.  
  257.     Redial Delay
  258.     ------------
  259.     Set this to the number of seconds to wait before redialing a
  260.     user's phone number (if the first attempt was not successful).
  261.  
  262.  
  263. Setup - Toll Calling
  264. --------------------
  265.  
  266.     Allow Toll Calls
  267.     ----------------
  268.     If set to "Y"es, EZVERIFY will place toll calls within the times
  269.     specified by you.  If set to "N"o, EZVERIFY will never place a
  270.     toll call.  EZVERIFY will always hangup on the user after a toll
  271.     call.  If a toll caller is successfully verified, he or she will
  272.     be granted the access specified in this dialog box.
  273.  
  274.     Toll Prefix
  275.     -----------
  276.     This specifies the digits to place before a phone number that is
  277.     a toll call.  This will most likely be "1" in North America.
  278.  
  279.     Auto Verify
  280.     -----------
  281.     If you don't want to make toll calls, you can set this to "Y"es
  282.     and long distance users will be granted the access specified
  283.     in this dialog box.  This is provided so toll callers can be
  284.     granted at least slightly better access, even if they are not
  285.     called back.
  286.  
  287.     Sunday-Saturday
  288.     ---------------
  289.     These fields specify the start and end times to allow toll calls
  290.     on each day of the week.  The times must be entered in 24-hour
  291.     format.  To disallow toll calling on a specific day, enter 00:00
  292.     in each of that day's fields.
  293.  
  294.  
  295.     Remaining Fields
  296.     ----------------
  297.     The remaining fields describe what should take place if a toll
  298.     caller is successfully verified (or "Auto Verified").  The fields
  299.     are independent and will not be combined with the similar fields
  300.     in  "Setup - System" or "Setup - Age Checking".
  301.  
  302.     SEE "Setup - System" FOR AN EXPLANATION OF THE REMAINING FIELDS.
  303.  
  304. Setup - Age Checking
  305. --------------------
  306.  
  307.     Age Checking
  308.     ------------
  309.     By setting this field to "Y"es, EZVERIFY will check a user's age
  310.     upon verification.  If the user's age is at or above the Minimum
  311.     Age, he or she will be granted the access specified in this
  312.     dialog box.
  313.  
  314.     Minimum Age
  315.     -----------
  316.     The is the minimum age that a user must be to receive the access
  317.     specified in this dialog box.  It is only effective if Age
  318.     Checking is turned on.
  319.  
  320.     Remaining Fields
  321.     ----------------
  322.     The remaining fields describe what should take place if a person
  323.     of the specified age is successfully verified.  The fields are 
  324.     independent and will not be combined with the similar fields in
  325.     "Setup - System" or "Setup - Toll Calling".
  326.  
  327.     SEE "Setup - System" FOR AN EXPLANATION OF THE REMAINING FIELDS.
  328.  
  329.  
  330. Setup - Local Calls
  331. -------------------
  332.     This option brings up a miniature text editor to allow viewing
  333.     and/or changing the contents of the "LOCAL.EZV" file described
  334.     below.
  335.  
  336.  
  337. Setup - Blocked Calls
  338. ---------------------
  339.     This option brings up a miniature text editor to allow viewing
  340.     and/or changing the contents of the "NOCALL.EZV" file described
  341.     below.
  342.  
  343.  
  344. Phone Numbers
  345. -------------
  346. EZVERIFY only works with the numeric digits of a user's phone number.
  347. Any formatting characters, such as dashes and parentheses, are
  348. ignored.  This way, it doesn't matter how a user's phone number is
  349. formatted.  EZVERIFY will always work consistently.
  350.  
  351. When EZVERIFY processes a user's phone number, it first strips out
  352. any non-numeric characters.  Then, if the phone number begins with
  353. your local area code, it strips out the area code.
  354.  
  355. When entering phone numbers in "LOCAL.EZV" and "NOCALL.EZV"
  356. (described below), it is important to not include the area code if it
  357. is the same as your local area code.  Also, never include any
  358. formatting characters in a phone number.  All numbers in "LOCAL.EZV"
  359. and "NOCALL.EZV" must consist of numeric digits only.
  360.  
  361.  
  362. LOCAL.EZV
  363. ---------
  364. "LOCAL.EZV" is a normal ASCII text file used to automatically
  365. determine if a number is local.  The file can be edited with any text
  366. editor or the editor built into EZVSETUP.  If a user's phone number
  367. does not match one in "LOCAL.EZV", he or she will be asked if it's a
  368. toll call.
  369.  
  370. Each line of "LOCAL.EZV" should include a number that is known to be
  371. local (excluding the local area code).  An "X" can be used to
  372. represent an unknown digit.  Only the leftmost portion of the phone
  373. number that is meaningful must be entered.
  374.  
  375. For example, let's assume that all the numbers you can call locally
  376. begin with 762, 343, or 344.  Your "LOCAL.EZV" file would look like:
  377.  
  378. 762
  379. 343
  380. 344
  381.  
  382. If you don't feel like typing in all your local exchanges, EZVERIFY
  383. can do it for you!  Every time a local connection is made (that was
  384. not previously known to be local), the exchange from the user's phone
  385. number will be added to "LOCAl.EZV".  After some time, EZVERIFY will
  386. have automatically built a list of your local exchanges!
  387.  
  388. If you live in an area where some numbers in a different area code
  389. are local, EZVERIFY can handle that also.  Just place the area
  390. code/exchange on a line of "LOCAL.EZV", including the toll prefix
  391. before the number.  
  392.  
  393. For example, let's assume that you are in area code 716, but
  394. exchanges 589 and 483 of area code 315 are actually local to you. 
  395. Part of your "LOCAL.EZV" could include:
  396.  
  397. 1315589
  398. 1315483
  399.  
  400. This is the only way EZVERIFY will dial local numbers in a different
  401. area code.
  402.                           
  403.  
  404. NOCALL.EZV
  405. ----------
  406. "NOCALL.EZV" is a normal ASCII text file used determine what numbers
  407. should not be called under any circumstances.  The file can be edited
  408. with any text editor or the editor built into EZVSETUP.  If a user's
  409. phone number matches one in "NOCALL.EZV", he or she will receive a
  410. message indicated the number is not callable.
  411.  
  412. Each line of "NOCALL.EZV" should include a number that you don't want
  413. to be called.  An "X" can be used to represent an unknown digit.  Only
  414. the leftmost portion of the phone number that is meaningful must be
  415. entered.
  416.  
  417. For example, let's assume that you don't want EZVERIFY to call 911,
  418. 411, or 555-1212 in any area code.  Your "NOCALL.EZV" would look like:
  419.  
  420. 911
  421. 411
  422. 5551212
  423. XXX5551212
  424.  
  425.  
  426. External Text Files
  427. -------------------
  428. Nearly all of the messages in EZVERIFY are stored in external text
  429. files.  Registered users may edit these text files to their liking.
  430. EZVERIFY supports ASCII and ANSI text files.  ASCII files have an
  431. extension of ".ASC", while ANSI files have an extension of ".ANS". 
  432. Users with Avatar support turned on will receive the ANSI versions.
  433.  
  434. The text file names (without the extension) are as follows:
  435.  
  436.     EZV01 - Information and instructions
  437.  
  438.     EZV02 - Final instructions
  439.  
  440.     EZV03 - Password is correct and user is now verified
  441.  
  442.     EZV04 - User is a toll caller and was auto-verified
  443.  
  444.     EZV05 - User is already verified
  445.  
  446.     EZV06 - Password was incorrect
  447.  
  448.     EZV07 - User's phone number is a duplicate
  449.  
  450.     EZV08 - User's phone number is a toll call
  451.  
  452.     EZV09 - User's phone number is blocked
  453.  
  454.  
  455. Logging
  456. -------
  457. Any fatal errors that occur during a verification are recorded in a
  458. log file named "EZVERIFY.ERR".  Each line of this file contains a
  459. date, time, error code, and description.  This file is for
  460. informational purposes only, and may be edited or deleted at will.
  461.  
  462. Anything that happens, including fatal errors, is logged in a file
  463. named "EZVERIFY.LOG".  This file supercedes the "EZVERIFY.ERR" file.
  464.  
  465. If running on a multi-node system, EZVERIFY will maintain a separate
  466. log file for each node.  
  467.  
  468.  
  469. Acknowledgments
  470. ----------------
  471. Ezycom is copyrighted by Peter Davies.
  472.  
  473.  
  474. Feedback
  475. --------
  476. Suggestions, comments, and criticisms are always welcome.  The author
  477. may be contacted via the methods discussed in the section on support.
  478.