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