home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / t / tbcbv202.zip / CALLBACK.DOC < prev    next >
Text File  |  1993-03-03  |  16KB  |  319 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                     CallBack
  24.                       Callback Verifier for the TriBBS BBS
  25.                       Copyright (C) 1992 by Adam Zuckerman
  26.                               All rights reserved.
  27. CallBack version 2.0.2                                                   Page 1
  28.  
  29.  
  30. Files included with this ZIP:
  31.  
  32. File          Size      Date      Description
  33. ------------  --------  --------  ---------------------------------------------
  34.  
  35. CallBack.EXE    97,848  03-03-93  The executable file that performs the
  36.                                   callback verification.
  37.  
  38. CallBack.DOC    15,509  03-03-93  This document.
  39.  
  40. CallBack.CFG       949  07-30-92  This file is the configuration text for
  41.                                   CallBack.
  42.  
  43. CallBack.BAT        83  07-10-92  This file is the batch file that runs
  44.                                   CallBack.
  45.  
  46. BuildPH.EXE     44,088  10-26-92  The executable to build PHONES.DAT from your
  47.                                   TriBBS USERS.DAT file.
  48.  
  49. History.202      2,062  03-03-93  This file lists the changes for CallBack 
  50.                                   version 2.0.2
  51.  
  52. JokePhon.DAT       190  03-03-93  This is the sample file for Joker phone 
  53.                                   numbers and pattern matches.
  54. CallBack version 2.0.2                                                   Page 2
  55.  
  56. CallBack is shareware and is being released in a shareware fashion.  Shareware
  57. is a great concept.  It allows you to try before you buy.  Then you can decide
  58. if this software fills your needs or not.  The registration fee for CallBack is
  59. $15 US.  The registration fee gives you free updates (if there are any), a
  60. printed manual, and the ability to upgrade the caller's security level and
  61. remaining on-line time.  For registration of $100 US, you will also get the
  62. source code.  Registration outside the US is $15 US.  Registration outside the
  63. US is limited to only those countries whose phone system uses US style phone
  64. numbers (i.e. 404-292-5303).  If your country does not use this style of phone
  65. number, then send me private mail (see Support on how to contact me) and I will
  66. make a version specific to your country.  This software is the intellectual
  67. property of Adam Zuckerman.  You are given license to use the software for 30
  68. days.  If you do not register CallBack, you MUST discontinue its use.  Please
  69. support the shareware concept and register your copy of CallBack.
  70.  
  71.  
  72. Now that the legal stuff is out of the way, we should begin our discussion of
  73. CallBack.  CallBack is a program written in PDS 7.1 (QuickBASIC Professional).
  74. It allows your callers to be verified by your board.  It will prompt the caller
  75. for their data phone number and allow them to change it if necessary.  It will
  76. call back the user a specified number of times (sysop configurable).  You can
  77. use an unusual physical port address with CallBack.  Upon verification, you can
  78. add to the caller's time and security level (registered version only).
  79.  
  80.  
  81. CallBack has been thoroughly tested under Desqview.  The few problems that have
  82. occurred have been related to opening a DOS window with communications set to
  83. NONE.  If this occurs (extremely remote possibility), have the caller attempt
  84. the callback verification again.  I have also been told to set Optimize 
  85. Communications to NO.
  86. CallBack version 2.0.2                                                   Page 3
  87.  
  88.  
  89. The format of the configuration file is:
  90.  
  91. The Dining Room                         ; BBS name
  92. Adam Zuckerman                          ; SysOp name
  93. C:\TriBBS                               ; Path to TriBBS node 1
  94. C:\TriBBS                               ; Path to current TriBBS node
  95. COM1                                    ; Com port (1 or 2 only)
  96. 3F8                                     ; Com port physical address
  97. ATM1E1Q0H0                              ; Modem init string
  98. ATDT                                    ; Dialing prefix
  99. CONNECT                                 ; Connect message from modem
  100. 15                                      ; Security level after verification
  101. 10                                      ; Minutes to add to caller's time
  102. 3                                       ; Number of callback attempts to make
  103. 1                                       ; Long distance: 0-all, 1-drop, 2-none
  104. 15                                      ; Time to pause between attempts
  105.  
  106.  
  107. All filenames must have the complete pathname for the file including the drive
  108. letter specification.  Expect the configuration file to change with any later
  109. releases of CallBack.  The configuration file has not changed between 1.2 and
  110. 2.0.2.
  111.  
  112.  
  113. Now, let's look at the configuration file in detail.  First, the first 2 lines
  114. are self-explanatory.
  115.  
  116.      The Dining Room                         ; BBS name
  117.      Adam Zuckerman                          ; SysOp name
  118.  
  119. Change these to suit your board.  Next comes the pathes to TriBBS.  Line 3 is
  120. the path to your node 1 directory.  If node 1 is in C:\TriBBS then you won't
  121. have to change a thing.  If you are running a single node system, line 4 will
  122. be the same as line 3.  Otherwise, you will need to change it to the full path
  123. that leads to node 2 (e.g. Node 2 is in C:\TriBBS2, line 4 would be
  124. C:\TriBBS2).
  125.  
  126.      C:\TriBBS                               ; Path to TriBBS node 1
  127.      C:\TriBBS                               ; Path to current TriBBS node
  128.  
  129. Line 5 is going to be a bit tricky to explain.  It must be COM1 or COM2.  This
  130. is the communications port name.  If you are using COM3, then tell CallBack to
  131. use COM1 and change the physical address in line 6.  More on this in a minute.
  132. Line 6 is the physical port address of the communications port.  For COM1, it
  133. is normally 3F8.  COM2 is 2F8.  COM3 is 3E8.  And COM4 is 2E8.  If you are
  134. using COM3 or COM4, then you will have to change the physical port address in
  135. line 6.  If you are not sure what the physical address is, contact me directly,
  136. via The Dining Room bbs (404) 292-5303.  I'll get a program to you that will
  137. let you know what your physical port addresses are.  If you are using COM3 or
  138. COM4, changing the physical port address will allow you to continue to use that
  139. communications port.  DOUBLE CHECK the physical port address if you change it.
  140. If you put in a WRONG ADDRESS, YOU CAN HANG YOUR SYSTEM OR CAUSE DAMAGE TO YOUR
  141. DATA.
  142.  
  143.      COM1                                    ; Com port (1 or 2 only)
  144.      3F8                                     ; Com port physical address
  145. CallBack version 2.0.2                                                   Page 4
  146.  
  147.  
  148. Line 7 is the initialization string for your modem.  If your are using a HAYES
  149. compatible modem, then the initialization string listed will work best for you.
  150. Consult your modem manual to insure that the command echo is turned on,
  151. responses are set to verbose (e.g CONNECT, BUSY, NO CARRIER), and your modem
  152. goes on-hook (hangs up).  It may be necessary to change the default init string.
  153.  
  154.      ATM1E1Q0H0                              ; Modem init string
  155.  
  156. Line 8 is the dialing prefix string needed to call the user back.  For most
  157. systems, the default is all you need.  If you run your board out of a business
  158. where dialing out requires a special code (e.g. 9 for an outside line), the
  159. you would change line 8.  If you have call-waiting, change line 8 to ATDT*70,
  160.  
  161.      ATDT                                    ; Dialing prefix
  162.  
  163. Line 9 is the message sent back from your modem indicating that a connection
  164. has been made.  Some modems do not send out a standard HAYES response.  Change
  165. this as necessary.
  166.  
  167.      CONNECT                                 ; Connect message from modem
  168.  
  169. Line 10 is the security level that a verified caller will receive upon
  170. completion of the callback process (registered version only).  If a caller 
  171. with a higher security level attempts to use CallBack, they will receive a
  172. message stating that their security level is too high and be returned to the
  173. board.
  174.  
  175.      15                                      ; Security level after verification
  176.  
  177. Line 11 is the amount of time to add to a caller's on-line time once they have
  178. been verified.  This is an exclusive feature of CallBack (registered version
  179. only).  You can add from 0 to as many minutes as you want.  Only TriBBS limits
  180. what you can set.  TriBBS will still limit the caller to the maximum time per
  181. call set up in the node configuration.
  182.  
  183.      10                                      ; Minutes to add to caller's time
  184.  
  185. Line 12 tells CallBack how many attempts to make to reach the caller at the
  186. number supplied by the caller.  Again, you can set this as high as you would
  187. like.
  188.  
  189.      3                                       ; Number of callback attempts
  190.  
  191. Line 13 sets CallBack to accept or deny long distance callbacks.  Setting line
  192. 13 to 0 says to accept all callbacks.  Upon verification, drop back to TriBBS
  193. and continue.  Leaving line 13 set to 1 will have CallBack accept the long
  194. distance callback.  Upon verification, the caller is told that their time and
  195. security level have been upgraded (registered version only).  It then tells the
  196. caller that he/she will have the modem hang up.  Changing line 13 to 2 will
  197. tell CallBack not to accept any long distance callbacks.
  198.  
  199.      1                                       ; Long distance: 0-all, 1-drop
  200. CallBack version 2.0.2                                                   Page 5
  201.  
  202.  
  203. Line 14 tells CallBack how long to pause between callback attempts.  I 
  204. recommend setting it to 15 secondes.  If there is no value in this line, then
  205. CallBack defaults to 15 seconds.
  206.  
  207.      15                                      ; Time to pause between attempts
  208.  
  209.  
  210.  
  211. For the following examples, CBV1.BAT is used for the batch file name.  If you
  212. have 2 or more nodes, I recommend using CBV1.BAT for node 1, CBV2.BAT for node
  213. 2, etc.  Also do the same with the configuration files (e.g. CBV1.CFG for node
  214. 1, CBV2.CFG for node 2, etc.).  The default setup from me has the batch and
  215. configuration files called CALLBACK.???.
  216.  
  217.  
  218. Setting up CallBack as a door is fairly simple.  The door type is T for TriBBS.
  219. The batch file should be set up in the current node and look like the batch
  220. file listed further down on this page.  Security level should be set to your
  221. new user security level.
  222.  
  223.      T,Call Back Verifier,CBV1.BAT,10
  224.  
  225.  
  226. Setting up CallBack in your NEWUSER.BAT is also fairly simple.  Just have a
  227. batch file that looks like this:
  228.  
  229.     cd c:\TriBBS\doors\CallBack
  230.     CallBack CBV1.CFG
  231.     cd c:\TriBBS
  232.     board
  233.  
  234. CBV1.CFG is the configuration file for the current node.
  235.  
  236.  
  237. CallBack can also be setup up as an extended menu command.  Refer to the TriBBS
  238. documentation for further details.
  239.  
  240.  
  241. With release 1.2, I have included a utility program for building the PHONES.DAT
  242. file.  This program (BuildPH.EXE) will go through your USERS.DAT file, finding
  243. all of you callers with a specified security level or higher, and build the
  244. duplicate phone number data file (PHONES.DAT).  This program requires your 
  245. CallBack.KEY to be in the same directory when executed.  This utility is a one
  246. time only kind of utility.  Once you run it, it has built the PHONES.DAT file
  247. for you.  It won't be necessary to use it again (excepting any loss of data).
  248. To start BuildPhone, type at the DOS prompt:
  249.  
  250.      BuildPH C:\TriBBS C:\TriBBS\doors\CallBack 15
  251.  
  252. This will build PHONES.DAT with all callers from your USERS.DAT file with a
  253. security level of 15 or higher.  The first path is the path to TriBBS's node 1.
  254. The second path is to CallBack's sub-directory (where PHONES.DAT is actually
  255. located.
  256. CallBack version 2.0.2                                                   Page 6
  257.  
  258.  
  259.                                     Support
  260.  
  261. For support, I can be reached via TTN, SmartNet, AFS, or my board, The Dining
  262. Room (404) 292-5303.   The fastest way to reach me would be my board.  Leave me
  263. a comment.  I will respond within 24 hours.  I will help all users of CallBack.
  264. If you are not registered, don't worry.  I won't bite your head off.  I will
  265. help you with whatever problem you have.
  266.  
  267.  
  268. Once you have registered, all subsequent versions of CallBack will accept your
  269. registration key (thanks to Mark Goodwin for the idea).
  270.  
  271.  
  272. Please fill out the enclosed registration form and mail it to:
  273.  
  274.    Adam Zuckerman
  275.    1364 Debden Place
  276.    Stone Mountain, GA 30083-1212
  277.  
  278. Please make all checks payable to Adam Zuckerman.
  279.  
  280.  
  281.  
  282.  
  283.                            CallBack Registration Form
  284.  
  285. +------------------------------------------------------------------------------+
  286. |                                                                              |
  287. |  Name:___________________________________  [] CallBack Registration $15.00US |
  288. |                                            [] Printed Manual           N/C   |
  289. |  Address:________________________________  [] Foreign Registration     N/A   |
  290. |                                            [] Source Code           $85.00US |
  291. |  City:___________________ State:_________  [] Catalog of software      N/C   |
  292. |                                                                              |
  293. |  Zip Code:_______________ Zip+4:_________                                    |
  294. |                                                                              |
  295. |  Make checks payable to: Adam Zuckerman        Total Enclosed    $_____.___  |
  296. |                                                                              |
  297. |  What is the name of your BBS?                                               |
  298. |                            Name ___________________________________________  |
  299. |                            Phone number:       (_____)____-_________         |
  300. |                                                                              |
  301. |  Where did you get CallBack?                                                 |
  302. |  [] Local BBS              Name ___________________________________________  |
  303. |                            Their phone number: (_____)____-_________         |
  304. |                                                                              |
  305. |  [] Information Service    [] America On Line                                |
  306. |                            [] BIX                                            |
  307. |                            [] Compuserve                                     |
  308. |                            [] Delphi                                         |
  309. |                            [] GEnie                                          |
  310. |                            [] Other _______________________________________  |
  311. |                                                                              |
  312. |  [] Directly from me (Adam Zuckerman)                                        |
  313. |                                                                              |
  314. |  [] Friend                 Name ___________________________________________  |
  315. |                                                                              |
  316. |  [] Shareware outlet house Name ___________________________________________  |
  317. |  2.0.2                                                                       |
  318. +------------------------------------------------------------------------------+
  319.