home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / BNU189G.ZIP / BNU.NOT < prev    next >
Encoding:
Text File  |  1993-07-07  |  4.6 KB  |  104 lines
  1. ----------------
  2. ADDITIONAL NOTES
  3. ----------------
  4.  
  5.  
  6. BNUHLP
  7. ======
  8.  
  9.     This is a BNU specific utility, which may be used with either the .COM
  10.     (memory resident TSR) or the .SYS (device driver) version of BNU.
  11.  
  12.     BNUHLP contains functions found only in the TSR version previously, and
  13.     some of the more often used functions of BNU.COM/.SYS are included in 
  14.     BNUHLP to make switching of drivers easier without having to modify your
  15.     batch files every time you change.
  16.  
  17.     Only a subset of the commands available with BNU.COM are provided.  
  18.     Those functions which are the same as BNU.COM are also identical in 
  19.     syntax, rules and usage.
  20.  
  21.     Following is the list of commands available in BNUHLP:
  22.  
  23.     /C      reCapture INT 14H vector  (required under DESQview etc.)
  24.             usage: /C
  25.     /Q      release INT 14H vector (removes BNU from the 14h chain)
  26.             usage: /Q
  27.     /B      reBoot system immediately (/B0 is cold boot, /B1 is warm)
  28.             usage: /B[0|1]     (boom!)
  29.     /F        (toggle) Fast screen write via ANSI driver
  30.             usage: /F[+|-]
  31.     /M      (toggle) init Message display
  32.             usage: /M[+|-]
  33.     /I      Initialise/deinitialise driver on port, or all ports
  34.             usage: /I<port>[+|-]
  35.              -or-  /I*       (deinits all)
  36.     /?      displays the Help screen
  37.             usage: /?
  38.     /W      enable/disable carrier Watchdog on a port
  39.             usage: /W<port>[+|-][,ticks]
  40.             (see above for optional [,ticks] parameter)
  41.     /O      Opus!Com/X00 cOmpatibility mode (fn 0x1c is max)
  42.             usage: /O[+|-]
  43.     /Z      sets 16550 FIFO buffering (as per .COm version)
  44.             usage: /Z          (use default buffering per hardware)
  45.              -or-  /Z<level>   (see 1.70's docs with exception above)
  46.     /X      XON/XOFF protocol select, toggles IXANY support
  47.             usage: /X[+|-]
  48.     /S      display driver Status
  49.             usage: /S
  50.     /H      force on/off given handshaking protocol
  51.             usage: /H[F|N]<port>,[X|C|R|A]     (see notes above)
  52.     /L      Lock/unlock port speed and/or parameters
  53.             usage: /L<port>:<baud>[,<parms>    (see docs v1.70)
  54.  
  55.  
  56. TASK MANAGER
  57. ============
  58.  
  59. This is a driver which interfaces to BNU to assist in running under
  60. multitasking software.  If used, it MUST BE RUN IMMEDIATELY AFTER
  61. LOADING BNU (or in the case of BNU.SYS, shortly after in AUTOEXEC.BAT).
  62. TM should _NEVER_ be loaded in a DESQview window if BNU is loaded prior
  63. to DV.  This is almost DEFINITELY cause a system lockup - sooner of
  64. later... Since BNU 'hooks into' TM, it is not separately unloadable.
  65. If BNU.COM is removed from memory, then memory allocated and used by
  66. TM will also be freed.
  67.  
  68. TM understands one command line parameter.  This indicates to the
  69. driver it's basic timeout period.  The timout period (expressed in
  70. clock ticks) is by default is around half a second (9 ticks), which
  71. is farily conservative. I've found best results at 4-5.
  72.  
  73. This release includes both TM for DESQview (TM-DV) and PC-MOS/386 (TM-PM).
  74.  
  75. HOW IT WORKS:  BNU has some "idle detect" hooks.  Whenever the
  76. communications driver is called, it examines the function being
  77. called.  Typically, a program calls BNU and "polls" when it's idle
  78. (which is a waste of cycles in most cases, but an application does
  79. have to keep an eye on things...), for port status, receive buffer
  80. status, or sometimes the transmit buffer is full, and no matter how
  81. hard the application tries, it cannot place any more characters there.
  82.  
  83. So, for these calls, BNU calls an "I think I'm being polled" hook in
  84. TM.  In turn, TM examines how long this has been occuring, and if it
  85. occurs for greater than the number of ticks specified (or 9 if no 
  86. command-line switch was used), it starts releasing time slices on 
  87. all subsequent "poll" calls.  BNU is also smart enough to detect 
  88. real activity occuring, and so terminates this arrangement 
  89. immediately things start to happen - the result is that by just 
  90. calling FOSSIL, the application automatically gives up time slices
  91. when it is truely idle.
  92.  
  93. For those using the diagnostics window, there is a field labelled "TMPoll",
  94. which indicates the current state of TM.  On a single tasking machine with
  95. TM either not loaded or inactive (multitasker is not loaded), this field
  96. will remain 0000.  When active, 0000 indicates that there's FOSSIL activity
  97. occuring, FFFF indicates a poll timeout (TM is time slicing!), and values
  98. in between denote that some calls are "polling", but not enough to trigger
  99. the idle detect switch on.
  100.  
  101. Each tick is approx 1/18th of a second.  The /T parameter takes arguments
  102. expressed in ticks.  The default is 9 (half a second), and as I've already
  103. said - 4 or 5 seems to work fine.
  104.