home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / comfiles / offhook.arj / OFFHOOK.DOC < prev    next >
Encoding:
Text File  |  1991-04-24  |  6.2 KB  |  176 lines
  1.  
  2.                               OffHook 1.0
  3.                       Modem off-hook/Delay Utility
  4.  
  5.                           by Lester B. Kooyman
  6.                          Caffeine-Free Software
  7.                               1:204/501.0
  8.  
  9.  
  10. 0. PACKING LIST
  11. ---------------
  12.  
  13. The archive OFFHOOK.LZH should contain:
  14.  
  15.         OFFHOOK.DOC     This document file
  16.         OFFHOOK.EXE     The executable program
  17.         OFFHOOK.286     Use for 286s, 386s and above (rename
  18.                         to OFFHOOK.EXE)
  19.         MODEMON.EXE     Program to go ON-hook
  20.  
  21. 1. WHY IT EXISTS
  22. ----------------
  23.  
  24. OffHook is a simple little program written to meet a need on my BBS - take
  25. the modem off hook (so that callers receive a busy signal rather than a
  26. ring-no-answer) and delay a user-specified number of minutes before
  27. terminating.
  28.  
  29. I wrote this program because I don't agree with the way Fido handles the
  30. telephone line whenever it decides for one reason or another not to answer
  31. the phone (modem). One example of this is the IDLE event. During Fido's
  32. IDLE event, Fido will sit idle, but will not answer the phone. This gives
  33. callers the impression that something may be wrong with your system - it
  34. was not answering the phone, so it must be broken, right? Better for the
  35. caller to receive a busy signal - this is an indication of life, rather than
  36. the nobody home approach of ring-no-answer.
  37.  
  38. This was never an issue for me until I converted my BBS to multiline
  39. operation. Now continuous mail gets a whole lot trickier! It's OK to
  40. receive mail on one line while callers are reading and entering messages
  41. on the other lines, it's just not OK to *toss* the mail while there are
  42. callers online! For this reason the additional lines of the multiline
  43. BBS will probably shut down once or twice per day for mail tossing. (The
  44. only alternative is BBS software that interacts with an active mail
  45. tosser, but I haven't seen software sophisticated enough to handle
  46. that as yet.) While one line will toss the mail, the other lines will
  47. wait, hopefully with their phones off-hook, a specified number of
  48. minutes. This program does that.
  49.  
  50.  
  51. 2. HOW TO USE IT
  52. -----------------
  53.  
  54. To use OffHook, put it in the batch file that runs the Fido line you
  55. wish to control. At the time you wish the offhook event to occur, exit
  56. with a specified errorlevel. This errorlevel will, in the batch file
  57. that runs Fido, cause the OffHook program to be run, with an optional
  58. wait. The syntax is:
  59.  
  60.      offhook /fp /wm
  61.  
  62. Where -
  63.  
  64.         fp = fossil port number (legal values are 0 through 7)
  65.         wm = wait minutes
  66.  
  67. So, to go offhook on fossil port 0 (usually COM1:), and delay for 15
  68. minutes, you would type:
  69.  
  70.      offhook /0 /15
  71.  
  72. Leaving off the number of minutes to wait causes no wait at all. The
  73. fossil port number must be the first parameter, and must be present.
  74.  
  75. Before returning to Fido, run the program MODEMON.EXE, with a single
  76. parameter of the fossil port. This will put the modem line back onhook
  77. before Fido tries to initialize the modem (Fido would leave it offhook
  78. if we didn't put it back onhook ourselves).
  79.  
  80. Here is a sample of a batch file to run a mythical Fido system using
  81. OffHook to simulate IDLE events. Note that Fido specifies comm ports
  82. differently. In the example, fido is initialized for COM2: with the
  83. "/2" switch. However, OFFHOOK and MODEMON specify the same port in
  84. terms of Ray Gwinn's X00 numbering scheme; that is, 0 to 7. So subtract
  85. 1 from the number you use for Fido; in this case, COM2: is the second
  86. FOSSIL port, so is specified as "/1" (the first is "/0").
  87.  
  88. /*--------------------Begin Batch file example------------------------*/
  89. @Echo Off
  90. :START
  91.   cls
  92.   D:
  93.   Cd \FIDO2
  94.   modemon /1
  95.   goto loop
  96. :RELOGIN
  97.   relogin
  98. :LOOP
  99.   cls
  100.   E:FIDO /2 2/I
  101.   if errorlevel 15 goto wait2
  102.   if errorlevel 10 goto wait1
  103.   if errorlevel 6 goto esp
  104.   if errorlevel 5 goto exit
  105.   goto exit
  106. :WAIT1
  107.   rem the following means go offhook for 45 minutes
  108.   offhook /1 /45
  109.   rem this puts the line back on hook for Fido.
  110.   modemon /1
  111.   goto loop
  112. :WAIT2
  113.   rem the following means go offhook for 60 minutes
  114.   offhook /1 /60
  115.   rem this puts the line back on hook for Fido.
  116.   modemon /1
  117.   goto loop
  118. :ESP
  119.   userdesc /1 /end /share /udspath=d:\fido /callerpath=d:\fido /fidopath=d:\fido2
  120.   if errorlevel 2 goto loop
  121.   goto relogin
  122. :EXIT
  123.   cls
  124.   be ask "End Fido operation for line 2? Y)es [N)o] ",yn default=N timeout=2 black on white
  125.   if errorlevel 2 goto loop
  126.   if errorlevel 1 goto byebye
  127.   goto loop
  128. :BYEBYE
  129.   offhook /1
  130.   exit
  131. /*--------------------End Batch file example--------------------------*/
  132.  
  133. Oh, one more thing. If you change your mind and want to terminate
  134. OFFHOOK's wait before it ends, type a control-C at the console and
  135. OFFHOOK will terminate.
  136.  
  137.  
  138. 3. REQUIRED TO USE IT
  139. -----------------------
  140.  
  141. An MSDOS computer running a FOSSIL communications port driver. Fido
  142. BBS software or equivalent. A modem that honors the "AT" command set.
  143.  
  144.  
  145. 4. GOODIES YOU ALSO GET!
  146. -------------------------
  147.  
  148. The program will detect it is running under DesqView and release its
  149. time slice, like a good multitasking citizen, while waiting. This means
  150. you won't burn your BBS machine's cycles on this program while it is
  151. watching the clock. Also, it does watch the clock. Because the program's
  152. wait routine is based on the system time of day clock rather than an
  153. artificial timing loop, it is independent of machine speed in timing,
  154. and will also time accurately under DesqView. All video I/O is done
  155. via DOS, and thus is well-behaved on non-386 machines under DesqView.
  156. (In this situation, DesqView cannot virtualize video, so ill-behaved
  157. applications would bleed over other windows.)
  158.  
  159. 5. YOU WANNA TALK?
  160. ------------------
  161.  
  162. This thing isn't guaranteed at all. If it works for you, great! I felt
  163. the need for it and it works for me. Should you want to correspond for
  164. some reason, you can most easily netmail me at 1:204/501.0. You can also
  165. send US Mail to me at:
  166.  
  167. Les Kooyman
  168. Caffeine-Free Software
  169. 2228 S. El Camino Real # 124
  170. San Mateo, California 94403
  171.  
  172. This program is copyrighted, and I retain all rights to it. You may use
  173. and freely copy the program as long as you don't change or modify the
  174. program in any way, or charge for providing copies.
  175.  
  176.