home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / desqview / bbsctrl.zip / BBSCTRL.DOC next >
Text File  |  1993-10-25  |  5KB  |  126 lines
  1.                    BBSctrl version 1.01. (c)1993 Jordi Mas.
  2.                 Serial port supervisor for DESQview environment
  3.  
  4. Introduction
  5. ------------
  6.  
  7. BBSctrl is an utility created to add stability to BBSs that are running under
  8. DESQview, DESQview-386 or DESQview/X environments. BBSctrl can recover from
  9. crashes in these environment due to:
  10.  
  11. * Exceptions inside of DESQview windows (the must common are 12 and 13)
  12.  
  13. * Utilities errors or abnormal termination of programs running inside of
  14. DESQview, such as "run time error" or "abnormal termination", that is to say,
  15. application errors.
  16.  
  17. * Error of comparing files on multi-line systems, where DESQview uses its own
  18. error controller y keeps waiting for an answer.
  19.  
  20. * Hard crashes of tasks. Thanks to the task protection system that DESQview
  21. uses, it may crash on one task but not on the others.
  22.  
  23. BBSctrl watches the serial ports that we the him, were it is suppose to be
  24. a modem waiting for calls. If in certain period of time that we setup there
  25. is no carrier, BBSctrl will make a reset or exit to DOS with an errorlevel.
  26.  
  27. On multi-line systems, if BBSctrl does not detect carrier during a certain
  28. period of time on one line, before resets or exits with an errorlevel, it will
  29. check the other task to see if there's carrier present. If carrier is present 
  30. in the other line, it will wait until carrier is gone. If not, it will execute 
  31. the reset or exit to dos with an errorlevel. That way it will not hangup to
  32. users on the other line.
  33.  
  34. At this point is when the BBSctrl will make a reset at any time. There is a
  35. solution to this. BBSctrl may check if there is a semaphore file. If not it 
  36. will reset the system. In case that there is a semaphore, BBSctrl will wait 
  37. the time giving at the /m parameter, up to the total time giving with the 
  38. parameter /v.
  39.  
  40. BBSctrl is optimize so it will not use almost any CPU time, anyhow it will 
  41. use up to the 10% of CPU's total time, which is not a significant time.
  42.  
  43. Running
  44. -------
  45.  
  46. BBSCTRL takes the following parameters:
  47.  
  48. /pxxx    Serial port where XXX is the serial port to control (hex address)
  49. /txxx    Time to count in minutes
  50. /nl      No disk log
  51. /o       Starts as hidden task
  52. /exxx    Exit with errorlevel xxx instead of making a reset
  53. /s:xxx   If xxx file is found, it will not exit
  54. /mxxx    Time to add if a semaphore is found
  55. /vxxx    Maximum of time to add if a semaphore is found
  56.  
  57.  
  58. Samples:
  59.  
  60. Command : BBSctrl /p3f8 /t60
  61. Comment : Controls port 3f8 and it will reset the system in 60 minutes
  62.         : if no carrier if found.
  63.  
  64. Command : BBSctrl /p3f8 /t60 /2e8
  65. Comment : Controls port 3f8 and 2e8, and it will reset the system in
  66.         : 60 minutes if no carrier is found.
  67.  
  68. Command : BBSctrl /p3f8 /t60 /s:c:\ra\bbsctrl.loc /m15 /v3
  69. Comment : Controls port 3f8 and 2e8 and it will reset the system in
  70.         : 60 minutes if no carrier if found in one line.
  71.         : If c:\ra\bbsctrl.loc is found, it will add 15 minutes to the
  72.         : waiting time. So on up to 3 times.
  73.  
  74. Program's keys
  75. --------------
  76.  
  77. Once loaded the BBSctrl program you may use:
  78.  
  79. F1      -  To see who many time is left before resetting at that moment
  80. F10     -  To stop the program and exit.
  81.  
  82. Installation
  83. ------------
  84.  
  85. To startup BBSctrl in DESQview, you must create a DVP with the following
  86. data:
  87.  
  88. Writes text directly to screen.......: [N]
  89. Displays graphics information........: [N]
  90. Virtualize text/graphics (Y,N,T).....: [N]
  91. Uses serial ports (Y,N,1,2)..........: [Y]
  92. Requires floppy diskette.............: [N]
  93.  
  94.  
  95. BBSctrl only uses about 35Kb of memory, and in any case needs EMS or XMS.
  96.  
  97. It is necessary to startup BBSctrl every time you startup DESQview.
  98.  
  99.  
  100. Credits
  101. -------
  102.  
  103. BBSctrl is owned by its author Jordi Mas, and it is donated to public domain.
  104. This soft has been programmed on spare time using Turbo C 2.0 and DESQview
  105. API Toolkit for C.
  106.  
  107. From here I will like to thank to the following people for their help testing
  108. this program: Efraim Bayarri (2:343/105), Richard W. Burton (2:343/117), 
  109. Miquel Piulats (2:343/113), Jose Gonzalvo (2:343/129). Special thanks to
  110. Richard W. Burton for the Spanish to English documentation translation and
  111. to Rosario Saavedra for her sexual support.
  112.  
  113. DESQview, DESQview-386, DESQview/X are trademarks of Quarterdeck Office
  114. Systems.
  115.  
  116. For any comment, program error report, ideas for the next version, or just if
  117. you use this program and it works fine, you may write to:
  118.  
  119.  
  120.                                    Jordi Mas
  121.                                Fidonet 2:343/121
  122.                                RedBBS  57:101/4
  123.                           PARADISE_BCN 34-3-4432190/1
  124.  
  125.  
  126.