home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbs / clbkv161.zip / CALLBK.DOC < prev    next >
Text File  |  1993-02-01  |  20KB  |  518 lines
  1.  
  2.    ┌───────────────────────────────────────────────────────────────┐
  3.    │          W E L C O M E   to... CALLBK version 1.60            │
  4.    │                                                               │
  5.    │    The callback verifier door for RBBS-PC sysops worldwide.   │
  6.    │                                                               │
  7.    │         Copyright (c) 1992 SteveSoft Software. USA.           │
  8.    │                                                               │
  9.    │                       All Rights Reserved.                    │
  10.    │                                                               │
  11.    └───────────────────────────────────────────────────────────────┘
  12.  
  13.  
  14. There  has  long  been  a  need  for  a dedicated call back verification
  15. program  for  RBBS  sysops.  Until  now,  there  were  a  few  that were
  16. relatively well programmed, however, after having tried two or three  of
  17. them,  and  after  having  determined   that  they  didn't  quite   meet
  18. my expectations, I felt  it necessary to create  one. The result is  the
  19. program that you, the RBBS  sysop, will shortly have fully   operational
  20. on your system.
  21.  
  22. RBBS has long had  the ability to allow  the use of a  verification door
  23. built-in, or more accurately, a registration door. This program, CALLBK
  24. takes full advantage of that RBBS ability.
  25.  
  26. CALLBK is small, fast, and above all, reliable. It will run on any  IBM
  27. system,  or  compatible   computer  on   which  you  operate  your  RBBS
  28. (INCLUDING a LAN and DESQVIEW).  It will take some time for  you to edit
  29. the sysop configurable files which are described in more detail later in
  30. this documentation. Other than  that, it should be fully  operational on
  31. your system in about 10 minutes!
  32.  
  33. In RBBS-PC v17.3C, and RBBS v17.4  CONFIG PARAMETER 107 is used to  tell
  34. RBBS-PC what the door name is to check new users at log-in. For example,
  35. I use "F:\RBBS\DOORS\VALIDATE.BAT"
  36.  
  37. CONFIG PARAMETER  108 is  the parameter  to tell  RBBS-PC "This security
  38. level AND lower, must  be sent to the above named door". For  example, I
  39. have it set to level 30. Everyone  is at level 30 on my RBBS  until they
  40. are called back with the verifier.  The verifier can easily be setup  to
  41. increase the callers' security level  when a given caller has  responded
  42. successfully to  the callback  question, and  has been  logged back into
  43. your RBBS.
  44.  
  45. Installation  of  CALLBK  is  pretty  much  straight forward and should
  46. cause  no  difficulty  for  most  experienced  sysops.   If  you  are  a
  47. 'freshman' RBBS  sysop, I  strongly suggest  that you  read this  entire
  48. document  to  obtain  maximum  performance  of  the CALLBK program. The
  49. following describes the required files and their purposes.
  50.  
  51.  
  52. The batch file needed to call CALLBK from RBBS...
  53. ──────────────────────────────────────────────────
  54.  
  55. This example assumes that you are using XU.EXE and it reflects the
  56. lines about XU.EXE as shown...
  57.  
  58. You can name the following as CALLBACK.BAT just as a reference when you
  59. are looking through the dozens of BAT files on your system.
  60.  
  61. ────────────────────────
  62. The VALIDATE.BAT file...
  63. ────────────────────────
  64. @echo off
  65. XU WATCHCD:0:OFF
  66. @Echo Please stand by... > com1
  67. cd \rbbs\doors\mycalbk
  68. MYcalbk %1  /wait:7
  69. cd \rbbs
  70. IF NOT EXIST VER%NODE% GOTO DONE
  71. msgform /LTR:\rbbs\newwelc.def /MSG:\RBBS\SYSTEM\MAINM.DEF /SEC:30 ────┐
  72. ┌──────────────────────────────────────────────────────────────────────┘
  73. └─── /PRI /NET /DOR:\RBBS\DORINFO%node%.DEF del ver%node% :DONE XU
  74. :DONE
  75. WATCHCD:0:ON
  76.  
  77. The   VERx  file  is  a  SEMAPHORE  file  to  allow  you  to  create  an
  78. Auto-welcome message for your new user.  I use MSGFORM.EXE but  you  may
  79. use  something different, OR process the new user differently.  Possibly
  80. "tossing" the user into  another  door  (Now  that  you  know  they  are
  81. verified).
  82.  
  83. * One note.  Do not use a .BAT file named VERIFY as DOS will not execute
  84. it.  (VERIFY is a DOS keyword.)
  85.  
  86. The Configuration files and samples...
  87. ──────────────────────────────────────
  88. ────────────
  89. MYCALBKx.CFG  (Where 'x' = node number).
  90. ────────────
  91. F:\rbbs
  92. YELLOW          <---- NEW!!!!!!!!
  93. F:\bulletin\b1
  94. ATE1V1Q0X4
  95. 00000
  96.  
  97. Line 1 = Path to your RBBS  DORINFOx.DEF file.
  98. Line 2 = Background Color of "desktop". (BLACK or BLUE not recommended!).
  99. Line 3 = Path to ASCII bulletin...(not used but necessary).
  100. Line 4 = MODEM init string to get "OK" out of it.
  101. Line 5 = Registration  code.  The five  (5)  zeros   * MUST * be  there!
  102.  
  103. When you register MYCALBK you will receive a registration key which  you
  104. type in place  of the  five (5)  zeros. The  five zeros  simply put  a
  105. small message on the  monitor that  this  copy is not  registered.  When
  106. you do get around to registering, I  will send you  a  registration  key
  107. which will then put  a message on the  monitor that you have  registered
  108. this copy, along with the name of your RBBS. Please see the  information
  109. about registering near the end of this document.
  110.  
  111.  
  112. ──────
  113. SL.CFG       * NOTE * SL.CFG is: Security level configuration.
  114. ──────                           If you do not have a security listed
  115. 30,60,30                         here, MYCALBK will NOT upgrade thier
  116. 65,65,65                         security.
  117. 60,60,30
  118. 0,30,0
  119.  
  120. Parameter 1 = ENTRANCE security (What they will be when they get here).
  121. Parameter 2 = PASS security (what to upgrade to if they pass).
  122. Parameter 3 = FAIL security (what to drop them to if they fail).
  123.  
  124. ────────
  125. LDSL.CFG     * NOTE * LDSL.CFG is: Long distance security level cfg.
  126. ────────
  127. 30,61,30
  128. 65,65,65
  129.  
  130. Parameter 1 = ENTRANCE security (What they will be when they get here).
  131. Parameter 2 = PASS security (what to upgrade to if they pass).
  132. Parameter 3 = FAIL security (what to drop them to if they fail).
  133.  
  134. If  you  enable  LD  calls,  you  MUST  have  this file.  Otherwise your
  135. callers SECURITY  LEVEL will  be set  to  0 (zero)  when they return. It
  136. allows you   to  "bump   up"  LONG   DISTANCE  callers   so  they   have
  137. more   time  on-line   (Some   SysOps   prefer   their   long   distance
  138. callers  to  have  an  extra  15  minutes  on-line. After  all, they are
  139. calling long  distance to visit your RBBS).   If you do  not like  that,
  140. then just set it  the same as SL.CFG.
  141.  
  142. ────────────
  143. AREACODE.CFG
  144. ────────────
  145. 803,0000,2359,1
  146. 919,1800,0800,1
  147.  
  148. Parameter 1 = areacode approved for call back.
  149. Parameter 2 = time to  START  call backs...(no colons, 24hr time!).
  150. Parameter 3 = time to  STOP  call backs...(no colons, 24hr time!).
  151. Parameter 4 = hang up flag.  1 = hang up after verify.
  152.                               0 = stay on the line (at YOUR expense!).
  153.  
  154. First areacode  * MUST * be  YOUR area code!  Don't make an  error here!
  155. (Please  note,  if  the  supplied  AREACODE.CFG  file  does  not contain
  156. all United States   areacodes,  please   let  me   know  so   I  may add
  157. them in future releases).
  158.  
  159. ────────────
  160. LCLXCHNG.CFG   *NOTE* LCLXCHNG.CFG is: Local exchanges cfg.
  161. ────────────
  162. 393
  163. 332
  164. 669
  165. 665
  166.  
  167. Local exchanges are ones that do NOT require a '1-' in front of them and
  168. are in your areacode.
  169.  
  170.  
  171. ───────────
  172. LDXCHNG.CFG   *NOTE* LDXCHNG.CFG is: Long distance exchanges cfg.
  173. ───────────
  174. 803,1800,0700,1
  175. 919,1800,0700,1
  176.  
  177. LONG DISTANCE exchanges in YOUR state (USA) or province (Canada) that
  178. you want to call back to.
  179.  
  180. Parameter 1 = exchange number
  181. Parameter 2 = start time...(military time.  NO COLONS!)
  182. Parameter 3 = end time.....(military time.  NO COLONS!)
  183. Parameter 4 = hang up flag.  1 = hang up after verify.
  184.                              0 = stay on the line (at YOUR expense).
  185.  
  186.  
  187. ───────────
  188. NO-1AC.CFG   *NOTE* NO-1AC.CFG is: Area codes that do NOT require
  189. ───────────                        a 1- in front of the number!
  190. 803
  191.  
  192. What  the  Bells  have done now is this...  They make it MUCH easier for
  193. you to call Long Distance by now not telling  you  it's  Long  Distance!
  194. This I feel is wrong, but we have to deal with it!
  195.  
  196. Let's  say  you  have  configured a Long distance area code in the ABOVE
  197. .CFG file.  Now, you can call Long distance to that area code without  a
  198. 1! So, add it into this .CFG file here.  It must be 1 of 2 things.  YOUR
  199. base areacode or Areacodes defined in the LDXCHNG.CFG file!  That's it.
  200.  
  201. ───────────
  202. ###XCHNG.CFG  *NOTE* ###XCHNG.CFG is: The  area  code  is ### and the
  203. ───────────                           exchanges inside this  .CFG  file
  204. 395                                   are local calls.
  205.  
  206. Another fine problem to deal with with the "BELLS".  Apparantley in some
  207. portions  of  the  country,  you can dial to more than one area code and
  208. it's a local call.  So to handle this problem, I have created this  .CFG
  209. file.  If  you  have  defined an exchange in LCLXCHNG.CFG that is NOT in
  210. your areacode, remove it from there and enter it  in  this  file.   This
  211. will  allow  local  calls  made across area codes to be made without the
  212. program "thinking" they are LD and restrict them.
  213.  
  214.  
  215. MYCALBK  4
  216.          ^  Node  number  even  if  you  only  run  1  node!   See   the
  217. CALLBACK.BAT sample file which will make this clear to you.
  218.  
  219. Command line switches...
  220. ────────────────────────
  221. NOTE ***  ALL command line switches  * MUST * begin with the forward
  222. slash (/) in order to be initiated. See the CALLBACK.BAT file for more
  223. details. Also, please take note of the full colon (:) as part of the
  224. command switch. Very important...
  225.  
  226. ───────────────────────────────────────────
  227. /PREFIX:0,,,   /SUFFIX:18005551212,,####,,,
  228. ───────────────────────────────────────────
  229.  
  230. Allows you to use Sprint or whatever number you want to use to call
  231. back LD calls.
  232.  
  233.  
  234. ─────────────
  235. /REDIALTIME:5
  236. ─────────────
  237.  
  238. Controls how long between calls  (when dialing the caller) that  MYCALBK
  239. waits. Defaults  to 10  seconds. NOTE:  if you  are using  a high  speed
  240. modem  such  as  the  USRobotics  HST,  a  setting  for this switch of 3
  241. seconds has proven to be very effective.
  242.  
  243. ────────
  244. /WAIT:8
  245. ────────
  246.  
  247. Allows you to control how long MYCALBK waits until it tries to call  the
  248. caller back.   Defaults to   15 seconds.   Also, you  should know   that
  249. MYCALBK  will  attempt  to  place  a  call  to  the  caller  three   (3)
  250. times.  If  a  connection  is   not  made  after  three  (3)   attempts,
  251. that's it! It's recycle time! The caller will have to try again at  some
  252. future date.   NOTE: if  you are  using a  high speed  modem such as the
  253. USRobotics HST, a setting for this switch of 3 seconds has proven to  be
  254. very effective.
  255.  
  256. ─────
  257. /DUMP
  258. ─────
  259.  
  260. Instead of allowing the caller back into the BBS when a duplicate number
  261. is detected,  this switch  simply disconnects them. In  other words,  if
  262. someone logs-in  using  the name  Wayne Gretzky  with a  phone number of
  263. say, 403-123-4567, and  is verified, and  then, if someone  logs-in from
  264. the  SAME  number  using  the  name  Eric  Lindros,  unfortunately   for
  265. Eric Lindros, he  will be disconnected  as quickly as  a hockey puck  is
  266. dropped to start a game! Real fast!
  267.  
  268. ─────
  269. /NO-1
  270. ─────
  271.  
  272. I have been told that there are  areas in the US that allow one  to dial
  273. any number in their area code  without a 1.   This switch takes  care of
  274. that. The door defaults to dialing a 1 if the call is long distance.
  275.  
  276. ───────────────────
  277. /FOSSIL:  ON or OFF
  278. ───────────────────
  279.  
  280. Use this to FORCE Fossil status.  Mainly  used for debugging  but I have
  281. left  the  code  intact  for your use.
  282.  
  283. /FOSSIL:ON will force the use of the FOSSIL even  if  your  DORINFOx.DEF
  284. file does not have it enabled.
  285.  
  286. /FOSSIL:OFF  will  force  the  use  of  the  FOSSIL  off  even  if  your
  287. DORINFOx.DEF file enables it.
  288.  
  289.  
  290.  
  291. ───────────────────
  292. /LPT:#
  293. ───────────────────
  294.  
  295. Use  this switch to get a print out of the callers as they are verified.
  296. Usefull to see what has happened during the day.
  297.  
  298. # is a valid DOS printer port from 1 - 3.
  299.  
  300. SysOp configurable files...
  301. ───────────────────────────
  302.  
  303. Please  see  the  enclosed  sample  files  for each of the following for
  304. your convenience.  You can edit them with any ASCII text editor to  suit
  305. your particular system.
  306.  
  307. There are five (5) files in this package that are SysOp "adjustable".
  308. The FIRST  line  * MUST *  be one of the eight valid IBM colors...
  309.       (RED, GREEN, BLUE, CYAN, YELLOW, WHITE, BLACK, and MAGENTA)
  310.  
  311. Here's a description of each file and the output to the caller.
  312.  
  313. WELCOME   Shown to the caller when they first log-in.
  314.  
  315. NODUPES   Shown to the caller when that phone number has already been used.
  316.  
  317. SORRYAC   Shown to the caller when their area code is not one you
  318.           selected to call back.
  319.  
  320. INSTRUCT  Shown to the caller just before disconnect, explains to caller
  321.           what to do at his/her end.
  322.  
  323. NOTTIME   Shown to the caller when you have configured to call LD
  324.           callers back but this is not the right time to do it.
  325.  
  326. Again, please take  the time to  view the enclosed  sample files if  you
  327. are not quite able  to make sense of  any of the foregoing.  Sometimes a
  328. sample can be worth more that a thousand words...
  329.  
  330.  
  331. Once you have edited the necessary files discussed above, you should  be
  332. ready to begin using MYCALBK. You  may want to make a subdirectory  from
  333. your RBBS subdirectory and put all the MYCALBK files in it. For  example
  334. E:\RBBS\CALBAK (You can rename CALBAK as  shown, to  any legitimate  DOS
  335. subdirectory). Then put the MYCALBK files into it. The CALLBACK.BAT  file
  336. can be easily put  into your RBBS subdirectory  where RBBS can find  and
  337. read it instantly. It's only a  few bytes in size. Don't forget  to tell
  338. the RBBS config  (CONFIG)  where the  CALLBACK.BAT file  is located.  Use
  339. RBBS config parameter  107 where   you type the name of the  CALLBACK.BAT
  340. file for  RBBS to find, and  then check the security level for new users
  341. for the verification,  parameter 108. The enclosed CALLBACK.BAT file will
  342. give you a sample of what to put in the CALLBACK.BAT file for those using
  343. Ray Gwinn's XU/X00.
  344.  
  345.  
  346. And while I have  your attention, please don't  forget to add a  line to
  347. you RBBS DOORS.DEF file so RBBS can readily find this program. The  line
  348. you  type  into  your  DOORS.DEF  file  should  like  something like the
  349. following...
  350.  
  351. DOORS.DEF
  352.  
  353. CALLBACK,5,,D,"CALLBACK.BAT [NODE]",N,,
  354.  
  355. *REMEMBER*  Do not call this .BAT file VERIFY.  VERIFY is a DOS keyword.
  356.  
  357. For more explicit  information regarding DOORING,  please read the  area
  358. in the  RBBS-PC Technical  Reference Manual.  It lists  complete details
  359. and several examples regarding the parameters required to operate  doors
  360. smoothly and efficiently with RBBS.
  361. OUTPUT files generated by MYCALBK...
  362. ────────────────────────────────────
  363.  
  364. MYCALBK will generate files for you with relevant information  pertinent
  365. to  the  related  activities  of  callers  who  are  swept into the RBBS
  366. registration  door.  The  information  generated  is  for  the   sysop's
  367. information.
  368.  
  369. ───────────
  370. MYCALBK1.LOG
  371. ───────────
  372.  
  373. This file will  list any errors  that may have  been caused by  a faulty
  374. installation.  As  an  example,  if   you  should  accidentally  put   the
  375. MYCALBK.CFG  file  into  the  wrong  sub-directory,  it will generate an
  376. error messages as follows...
  377.  
  378. Couldn't find .CFG file!
  379.  
  380. If you should see such information, then it becomes quite clear as to
  381. what your next step should be.   ...A N D  also the following...
  382.  
  383. SAMPLE ONLY! of the MYCALBK1.LOG file generated by MYCALBK.EXE
  384. ^^^^^^^^^^^^
  385. MYCALBK 1.00 Firing up!
  386. User on-line -> DAVE CHABUN @ 01:52:04 on 08-19-1992
  387. FOSSIL present and ACTIVATED!
  388. Initing modem, Try #1
  389. Modem init response OK
  390.  
  391. Dialing 432-1097 Try #  1
  392. Modem dial response
  393. CONNECT 9600/ARQ
  394.  
  395. DAVE CHABUN @ 432-1097 Verified!
  396. Upgraded security to 6
  397. DAVE CHABUN Exited Door.
  398. MYCALBK 1.00 Firing up!
  399. User on-line -> BOB SINGLEMAN @ 14:58:23 on 08-19-1992
  400. FOSSIL present and ACTIVATED!
  401. Initing modem, Try #1
  402. Modem init response OK
  403.  
  404.  
  405. Dialing 457-0114 Try #  1
  406. Modem dial response
  407. CONNECT 9600/ARQ
  408.  
  409. BOB SINGLEMAN @ 457-0114 Verified!
  410. Upgraded security to 6
  411. BOB SINGLEMAN Exited Door.
  412. MYCALBK 1.00 Firing up!
  413. User on-line -> WIL MA @ 16:28:46 on 08-19-1992
  414. FOSSIL present and ACTIVATED!
  415. WIL MA aborted call back
  416. WIL MA Exited Door.
  417. MYCALBK 1.00 Firing up!
  418. User on-line -> JOHN RIVEST @ 17:00:18 on 08-19-1992
  419. FOSSIL present and ACTIVATED!
  420. JOHN RIVEST aborted call back
  421. JOHN RIVEST Exited Door.
  422.  
  423. ────────────
  424. VERIFIED.LOG
  425. ────────────
  426.  
  427. This file will hold the information regarding new callers to your  RBBS.
  428. You should  note that  this file  is dynamically  expanding, so  keep in
  429. mind that  you have  enough disk  space to  allow this  file to  grow by
  430. leaps and bounds!  The information listed  contains the phone  number of
  431. the caller,  the name  of the  caller, the  date, and  the time that the
  432. caller used the MYCALBK door on your RBBS.
  433.  
  434. SAMPLE ONLY! of the VERIFIED.LOG file generated by MYCALBK.EXE
  435. ^^^^^^^^^^^^
  436.  
  437. 403-475-3844 BUBBA SMITH 08-15-1992 12:31:45
  438. 403-672-0923 BILLY-JOE BOB 08-15-1992 15:17:42
  439. 403-461-5704 ELVIS PRESLEY 08-15-1992 17:25:05
  440. 403-437-1444 JO-DON BAKER 08-15-1992 19:10:11
  441. 403-961-3034 STEVE STEVENS 08-15-1992 20:56:01
  442. 403-456-9017 GLEN SATHER 08-15-1992 22:04:31
  443. 403-479-6239 WAYNE GRETZKY 08-16-1992 09:31:07
  444. 403-467-1117 MIMI LAMOUR 08-16-1992 10:51:40
  445. 403-962-0407 EDGAR HOOVER 08-16-1992 11:35:17
  446. 403-477-6475 CANDY SAMPLES 08-16-1992 17:54:25
  447. 403-469-3705 JOHNNY LARUE 08-16-1992 22:29:19
  448.  
  449. In conclusion, MYCALBK  has proven to  be highly reliable  and stable on
  450. the beta test sites, and  on other systems that are  currently operating
  451. with this program. If you are an RBBS sysop in Canada, please feel  free
  452. to  call   the  two   systems  listed   at  the  end of this   document,
  453. Alberta One RBBS @8:990/105  -or-  Alberta Express @8:990/106,   for any
  454. assistance you  may require.   If you  are in  the USA,  please try your
  455. best to   get in touch   with me, rather  than Rod Bowman,  who is  very
  456. busy looking after the RBBSnet worldwide network.
  457.  
  458.  
  459.  
  460. Registration...
  461. ───────────────
  462. Dear fellow RBBS SysOp...
  463.  
  464. MYCALBK required  considerable time  and effort,  and many  updates with
  465. suggestions and  ideas from  several participating  beta test  sites (in
  466. the USA and Canada). Therefore if you like and use MYCALBK on a  regular
  467. basis on  your RBBS,  and you  find it  does exactly  what it should do,
  468. then please consider registering this quality RBBS utility.
  469.  
  470. Please review the enclosed REGISTER.FRM  file and ensure you respond  to
  471. the questions accurately.    I will then mail you your registration key,
  472. netmail it to you, -OR- put in on hold in the P)ersonal downloads of  my
  473. RBBS for you to retrieve.
  474.  
  475. A financial contribution  of $20.00 to  $30.00 (US Funds)  would be much
  476. appreciated.
  477.  
  478. Payment may  be made  with  certified cheque,  money orders, or personal
  479. cheque (Please note, personal cheques require a delay in processing).
  480.  
  481. Your support is much appreciated.
  482.  
  483. Thank you for supporting CALLBK...THE RBBS-PC caller verification
  484. utility.
  485.  
  486. Steve Stevens   The Neutral Zone 8:927/2
  487.  
  488. Queries? Feel free to...
  489. 1). Leave questions addressed to me Via NETMAIL
  490. 2). Call me VOICE @ (803)-393-0246
  491. 3). Call my BBS at (803)-395-6286.
  492. 4). Post a message in RBBS-PC, RBBS-SYSOP or RBBS-DEV Echos.
  493.  
  494.  
  495.  
  496. ***  Special thanks to the following people and beta sites, in the
  497. evaluating and for making helpful tips and hints, in the development of
  498. CALLBK ***
  499.  
  500. Frank Harman    Sysop of Alberta One RBBS       (Canada) @8:990/105
  501. Casey Vanloo    Sysop of Alberta Express RBBS   (Canada) @8:990/106
  502. Fred Busteed    Sysop of Arcs and Sparks RBBS   (USA)
  503. Rod Bowman      Sysop of PC-Spectrum (tm) RBBS  (USA)    @8:8/8
  504. Dan Shore       SysOp of ShoreLine BBS          (USA)    @1:109/458
  505.  
  506.       Plus several others who have slipped my mind at the moment.
  507.  
  508.  
  509. ─────── Without all of you, this would not have been possible.───────
  510.  
  511. RBBS-PC is copyright 1992 Tom Mack, and probably Ken Goosens. USA.
  512. IBM is the registered trademark of International Business Machines. USA.
  513. XU/X00 utilities, v1.01 is copyright 1990. Raymond L. Gwinn. USA.
  514. USRobotics, and HST are trademarks of USRobotics, Inc. USA.
  515. DESQview is the registered trademark of Quarterdeck Office Systems. USA.
  516. MSGFORM.EXE is copyright 1990 Mike Zakharoff.  USA
  517.  
  518.