home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / c / csver229.zip / CSVERIFY.DOC < prev    next >
Text File  |  1993-03-25  |  11KB  |  216 lines
  1.        (*****************************************************)
  2.        (* CSVerify 2.0   Written by Gary Bouchard           *)
  3.        (* SysOp - The Computer Store BBS                    *)
  4.        (* St. Augustine, Florida (904)794-0063              *)
  5.        (* Copyright(c) 1992....All Rights Reserved          *)
  6.        (* Released                 Modified                 *)
  7.        (*****************************************************)
  8.  
  9.  
  10.  
  11.                             What is it?
  12.  
  13. CSVerify is a Callback verification Door written specifically for PCBoard
  14. version 14.5 or greater. CSVerify can handle local or long distance callbacks,
  15. including International Numbers, and has many SysOp configurable options for
  16. ease of use and setup. CSVerify supports multiple communications
  17. configurations, and provides Fossil Driver Support to make it also compatible
  18. with PCBoards new "/M" versions.
  19.  
  20. CSVerify can also be used as a noisy line callback door with complete checking
  21. of long distance parameters.
  22.  
  23. CSVerify allows for local testing of the program, and automatically enters
  24. TEST mode on local calls.
  25.  
  26. Upon successful callback verification, CSVerify will update the users record
  27. to reflect any changes made to the phone number used, security level updates,
  28. and Expiration date changes.
  29.  
  30. Information diplayed to the user while running the program comes from display
  31. files which support all PCBoard @x## macros, and Multi-Language requirements.
  32. These files are easily updated, and or maintained by the SysOp.
  33.  
  34.                      Installation of CSVerify
  35.  
  36. Create a directory to keep CSVerify in. There is a sample PCB bat file
  37. included that you can modify to your liking. Go into PCBsetup, and go to the
  38. MainBoard setup. Move the cursor to Doors.dat and press F2 to edit it. Make an
  39. entry for CSVerify, the security required to access it, then answer YES to
  40. logon, and YES to USERS.SYS.
  41.  
  42. USERS.SYS is important, because once a caller is verified thru the phone
  43. number given, the information is then written back to the USERS.SYS file and
  44. in turn PCBoard updates the users record from the USERS.SYS file.
  45.  
  46. Example;
  47. ╔══════════════════════════════════════════════════════════════════════════════
  48. ║                        Edit User Record (Long Form)     Record   125 of   125
  49. ║
  50. ║  Name        : PETER FONDA                 Last DIR Listing : 07-18-92
  51. ║  City        : ST. AUGUSTINE, FLORIDA      Last Date On     : 07-18-92
  52. ║  B/D Phone   : 904 999-9999 <<Updated     .Last Time On     : 19:12
  53. ║  H/V Phone   : 904 794-0063                Elapsed Time On  :     5
  54. ║  Password    : TEST                        Number Times On  :     1
  55. ║  Security    :  60  <<Updated Info.        Number Uploads   :     0
  56. ║  Expert      : N                           Number Downloads :     0
  57. ║  Protocol    : Z                           Daily Download   :          0
  58. ║  Page Len    : 23                          Total Upload     :          0
  59. ║  Reg Ex Date : 03-18-93   <<Updated        Total Download   :          0
  60. ║  Expired Sec :  30        <<Updated        Messages Read    :          0
  61. ║  Msg Clear   : Y                           Messages Left    :          0
  62. ║  Last in     :     0                       Editor Default   : A
  63. ║  Delete User : N
  64. ║
  65. ║  Comment1    : IBM
  66. ║  Comment2    : XXX XXX-XXXX was/not verified. <<Updated information
  67. ║
  68. ╚══ 08:49:16 ═══ 07-19-92 ══════ F1 ═ help ════ caps: OFF  num: ON   ins: OFF ═
  69.  
  70. The B/D phone number is optionally replaced with the telephone number the user
  71. entered into the program to be verified. This phone number is formatted to
  72. PCBoard specs, and in the SysOp Comment Field (Comment 2) the text "XXX
  73. XXX-XXXX was/not verified." is optionally inserted.
  74.  
  75. In this way you can tell which users in your users file have been verified by
  76. this program.
  77.  
  78. The text files included are used by my board, and can be modified to your
  79. liking. They have the capability, as you will see, to expand the standard
  80. PCBoard @xxxx@ macros, and color macros.
  81.  
  82.  
  83. Activities performed by the program are logged into your PCBoard Callers log.
  84. If you have multiple nodes, the program will make the entry into the proper
  85. caller# log. If you require additional entries of some sort, please let me
  86. know, and if feasible, I will expand this.
  87.  
  88. Make sure that the information in the CSVerify.cnf file is correct for your
  89. BBS. The configuration file is setup using KEYWORDS, for ease of use, and
  90. allows for easy expansion in the future should the need arise.
  91.  
  92. Neither the KEYWORD's or the data are case sensitive, but you DO need to make
  93. sure that they are spelled correctly. If CSV does not recognize a KEYWORD in
  94. the file, it will use the DEFAULT for the keyword that is missing.
  95.  
  96. I do not include the area code or any prefixes in the dialing string unless
  97. you either specify the allowable callback areas, or allow long distance
  98. callback. If you do not include this information the program WILL NOT CALL
  99. LONG DISTANCE.
  100.  
  101. There are two files you should be using, even if you allow long distance
  102. callbacks. One is the Areacode File, and the other is the Exchangefile. In the
  103. front of you local phone book, you will find the area codes and exchanges in
  104. your calling area that are considered local calls. When the user's phone
  105. number is parsed into it's components, CSV checks these files for a match, and
  106. if NOT found, considers the call long distance, and it is dealt with
  107. accordingly.
  108.  
  109. If Long Distance callbacks are allowed, then the user is dealt with security
  110. level wise, as a local caller. If you do not allow long distance callbacks,
  111. you can alter the security level to the number you choose, including a Long
  112. Distance Expiration date, then return the caller back to the board.
  113.  
  114. The security level you give to the long distance user is entirely up to you...
  115. I usually give an intermediate level until I determine if the user is a
  116. visiting SysOp, then upgrade him/her later.
  117.  
  118. If you allow long distance calls, there is an option which you can configure
  119. so you can have CSV verify the number, then once the user is upgraded, tells
  120. the user that he/she is now verified, and tells them to call back for access.
  121. The program will them drop carrier and recycle.
  122.  
  123. There is a time table file included in the ZIP which is used to specify when a
  124. long distance callback can be made. This time table is very simple to work
  125. with. Each line contains a 3 letter Day of Week word, and following the word
  126. are 24 spaces which represent a time slot on the 24hour clock. Example;
  127.  
  128.                                 HOURS
  129.                         "0--------1----------2---"
  130.                         DOW "012345678901234567890123"
  131.                         =============================
  132.                         SUN  xxxxxxxxxxxxxxxx     xxx
  133.                         MON  xxxxxxx            xxxxx
  134.                         TUE  xxxxxxx            xxxxx
  135.                         WED  xxxxxxx            xxxxx
  136.                         THU  xxxxxxx            xxxxx
  137.                         FRI  xxxxxxx            xxxxx
  138.                         SAT  xxxxxxxxxxxxxxxxxxxxxxxx
  139.  
  140. Times start with Midnight or 00 hours military time, and go through to 23:00
  141. hours according to your PC clock. If there is an "x" in the time slot for that
  142. particular day, the system call the user back. If there is not "x" in that
  143. slot, the user will be displayed the file CALLTIME.CSV.
  144.  
  145. In this example, Saturday, long distance calls can be made all day. Sunday,
  146. calls can be made from 24:00 - 15:00 hours, then resumes at 21:00 hours.
  147.  
  148. There is a trashcan type of file included in the zip file you can use as a
  149. sample. You can add numbers to this list that you want rejected should they be
  150. entered by a user. Each time a user is successfully verified, the phone number
  151. and Name used by the caller is added to this list.
  152.  
  153. If a caller attempts to enter a number that has been used before, the program
  154. will display the phone number, and the user who used it to the caller, and
  155. give them a message to contact the SysOp if this is in error.
  156.  
  157. The SysOp has the ability to alter the users expiration date once he/she is
  158. verified. There is a variable in the configuration file called
  159. EXPIRATION_DAYS. This can be set anywhere from 1 day to whenever, and is
  160. adjusted by the day. If you set EXPIRATION_DAYS=730 then the users expiration
  161. date would be set for two years from the date of registration. On the other
  162. hand if you set it for 1 day, it would expire 1 day after registration.
  163.  
  164. Leaving it blank defaults to 365 days or 1 year, which is pretty much
  165. standard.
  166.  
  167. The program will support the 13 digit international phone numbers. To activate
  168. this feature, just add the keyword "INTERNATIONAL=Yes"  to the configuration
  169. file, and it will accept the long dialing string. What is not available here
  170. is support for local exchange/area code verification. The program accepts the
  171. number without spaces for 13 digits, and is not broken into its separate
  172. parts. The program will however check for a match in the trashcan.csv file
  173. before continuing.
  174.  
  175. Let me know if you need something else added to the program or datafile.
  176.  
  177. CSVerify has the ability to perform CALLBACK only type calls. Once a user has
  178. registered, and been successfully verified, you can set the program up to just
  179. disconnect the caller, and have CSV call the user back. Once connected, the
  180. usr is returned to PCBoard. In order to accomplish this task, you must in some
  181. way send an environment variable to CSV. CSV looks for the environment
  182. variable "PCBDOOR" when it is executed. If PCBDOOR is set to "CB" that the
  183. program will do a CALLBACK only, rather than a registration verification.
  184.  
  185. You can do this one of two ways, and I'll give you a couple of examples here;
  186.  
  187. 1) From the PCBoard menu, I have the letters "CSV" which open the callback
  188.    door. If I type CSV<space>CB, then when CSV executes, it is in callback
  189.    only mode. If I type CSV by itself, then the program is in
  190.    registration/verification mode. Typing the "CB" after the CSV command
  191.    places the "CB" into the environment variable PCBDOOR, and CSV will pick it
  192.    up.
  193.  
  194. 2) You can create a separate batch file for PCB to execute for callbacks which
  195.    would contain a line like "SET PCBDOOR=CB". You would then call the CSV
  196.    program as documented. At the end of the batch file you place the command
  197.    "SET PCBDOOR=" which would clear the environment variable for you when it
  198.    was finished.
  199.  
  200. By the Way:
  201.  
  202. I am awful at writing documentation.<g> If there is something missing from the
  203. documentation that you do not understand, please contact my BBS at the above
  204. number for clarification.
  205.  
  206. I use the History file as an addendum to the documentation, and there is a lot
  207. of information contained in the file, so please pay attention to what is in
  208. there, ok?
  209.  
  210.                         Helpful Information!
  211.  
  212. CSVerify is free to locally/privately owned PCBoard SysOps. Companies or
  213. Corpororations that wish to use CSVerify on their systems can obtain a license
  214. to use at a modest fee, and site licensing is available. Contact me at the
  215. number on the top of this document for details.
  216.