home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 2 BBS / 02-BBS.zip / BTMTEXE3.ZIP / BTP-MT.DOC < prev    next >
Text File  |  1992-04-26  |  7KB  |  176 lines
  1. BinkleyTerm/2-Multi Thread 2.40.03
  2. ----------------------------------
  3.  
  4.  
  5.  
  6. 1.  Copyright Information and Acknowlegements:
  7.     -----------------------------------------
  8.  
  9. (C) Copyright 1987-90 Bit Bucket Software Co., a Delaware Corporation.
  10. ALL RIGHTS RESERVED. COMMERCIAL DISTRIBUTION AND/OR USE PROHIBITED 
  11. WITHOUT WRITTEN PERMISSION FROM BIT BUCKET SOFTWARE CO.
  12.  
  13. Original port to OS/2 of BTP 2.40 by Bill Andrus at 1:109/301.10.
  14.  
  15. BT/2-MT enhancements by Chris Laforet Software at 1:3644/1 and
  16. 1:3644/2.  Enhancements are released henceforth into the public
  17. domain.
  18.  
  19.  
  20.  
  21. 2.  Source Code Availablity:
  22.     -----------------------
  23.  
  24. The original releases of BinkleyTerm for DOS and for OS/2 are available
  25. at either node of Chris Laforet Software (1:3644/1 or 2).  Source
  26. code is also available.
  27.  
  28. The code for BT/2-MT as well as the executable are also available from
  29. the same sources.
  30.  
  31.  
  32.  
  33. 3.  BinkleyTerm MultiThread:
  34.     -----------------------
  35.  
  36. Currently BT/2-MT uses 4 threads of execution.  Two of these handle the 
  37. com port.  One is in charge of the receive ring buffer and the other is
  38. in charge of the send ring buffer.  Another thread is used to handle
  39. timer information.  This thread is not doing much at present, but I
  40. have plans for it (such as monitoring of CD and preventing continual
  41. calls to the CD checking function from the main thread).  The last
  42. thread is the main program itself.
  43.  
  44.  
  45. 4.  Changes between BT/2-MT and Regular BTP:
  46.     ---------------------------------------
  47.  
  48.   a.  Execution is a lot faster.  
  49.   b.  The ESC key no longer shells.  Only Alt-J will do that.  The ESC 
  50.       had the potential for causing problems with the Ctrl-ESC and
  51.       Alt-ESC used by OS/2 (i.e. if you were sloppy while hitting one
  52.       of these kb combinations, you would take the board offline!).
  53.   c.  The Snoop-pipe stuff is history.
  54.   d.  Lockbaud now works correctly.  Just say:
  55.           
  56.           Baud max_baud
  57.           Lockbaud
  58.  
  59.       and the lockbaud will keep the port "locked" at the max_baud. 
  60.       However, internally BT/2-MT keeps track of the REAL baud rate
  61.       and all xfer times and % efficiency reports are based on that
  62.       baud.
  63.   c.  Connect strings that return a baud > 9600 and < 19200 will map to
  64.       19200 baud.
  65.   d.  BT/2-MT sets up the com port correctly with handshaking on.  It
  66.       should not touch the buffering question for folks who run
  67.       16550's, so you can keep using the mode statement if you desire.
  68.       There is an untested keyword "LeavePort" for the command line
  69.       which "should" allow BT/2-MT to behave like Andrus' BTP and not
  70.       set up handshaking.  *Warning*  To disable CTS-RTS handshaking is
  71.       equivalent to playing Russian Roulette.  You might get by with
  72.       it, but on the other hand, you might not!
  73.   e.  If Lockbaud is in action, SPAWNBBS is called with an extra
  74.       parameter:
  75.  
  76.           SPAWNBBS actual_baud port_handle time_to_next_event 
  77.                    modem_reliable locked_baudrate
  78.  
  79.       This way, if your BBS (like Simplex/2 BBS) doesn't change the
  80.       baud rate, you can pass it the correct baud of the connect so
  81.       that xfer rates are correctly calculated.  Otherwise you can
  82.       snag the locked_rate so that your BBS can set it correctly.
  83.   f.  Handshaking timing restrictions have been "bent" slightly to take
  84.       into consideration that OS/2 is a multitasking system.  Actually,
  85.       the BT/2-MT is so fast, it's handshaking leaves the older BTP in
  86.       the dust.
  87.   g.  I have attempted to clean up some of the code.  This is a large
  88.       project codewise, so I am by no means near completion.  I do hope
  89.       to move BT/2-MT over to complete ANSI-C since the OS/2 version
  90.       would not be compiled under anything less.
  91.  
  92.  
  93.  
  94. 5.  Warranties and Disclaimers:
  95.     --------------------------
  96.  
  97.  
  98. Here is Bit-Bucket Software's regular statement:
  99.  
  100.                                NO WARRANTY
  101.  
  102. BECAUSE BINKLEYTERM IS LICENSED FREE OF CHARGE, WE PROVIDE ABSOLUTELY NO
  103. WARRANTY.  EXCEPT WHEN OTHERWISE STATED IN WRITING, BIT BUCKET SOFTWARE
  104. CO. AND/OR OTHER PARTIES PROVIDE BINKLEYTERM "AS IS" WITHOUT WARRANTY OF
  105. ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
  106. THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  107. PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF
  108. BINKLEYTERM, AND THE ACCURACY OF ITS ASSOCIATED DOCUMENTATION, IS WITH
  109. YOU.  SHOULD BINKLEYTERM OR ITS ASSOCIATED DOCUMENTATION PROVE
  110. DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR
  111. CORRECTION.
  112.  
  113. IN NO EVENT WILL BIT BUCKET SOFTWARE CO. BE RESPONSIBLE IN ANY WAY FOR
  114. THE BEHAVIOR OF MODIFIED VERSIONS OF BINKLEYTERM. IN NO EVENT WILL 
  115. BIT BUCKET SOFTWARE CO. AND/OR ANY OTHER PARTY WHO MAY MODIFY AND
  116. REDISTRIBUTE BINKLEYTERM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR
  117. DAMAGES, INCLUDING ANY LOST PROFITS, LOST MONIES, OR OTHER SPECIAL,
  118. INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY
  119. TO USE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED
  120. INACCURATE OR LOSSES SUSTAINED BY THIRD PARTIES OR A FAILURE OF THE
  121. PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS) BINKLEYTERM, EVEN IF YOU
  122. HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM
  123. BY ANY OTHER PARTY.
  124.  
  125.  
  126. To the above, I add my own for this release:
  127.  
  128. There are no warranties of any kind, explicit or implied, on the
  129. BT/2-MT software.  The executables and code are provided on an "AS
  130. IS" basis.  What this means is that if you decide to use BT/2-MT,
  131. it is at your own risk.  In plain English, this means that if you
  132. use Simplex and your machine blows up, the developers and
  133. distributors of Simplex are not responsible in any fashion.  If
  134. you use Simplex and it loses all of the files on your disk, once
  135. again the developers and distributors of Simplex are not to be
  136. held accountable.  While these scenarios are rather extreme in
  137. nature, they serve to indicate that Chris Laforet Software and/or
  138. Christopher Laforet do not warrant, guarantee, or make any
  139. other representations regarding the use, or results of use, of
  140. BT/2-MT or its documentation in terms of accuracy, reliability,
  141. correctness, currentness, or otherwise.
  142.  
  143.  
  144. 6.  Contacting Me:
  145.     -------------
  146.  
  147.  
  148.    You may send me mail through any of the following:
  149.  
  150.    Programmer's Oasis BBS, USA .... 919/226-6984
  151.    Programmer's Oasis 2 BBS, USA .. 919/226-7136
  152.    Fidonet Email .................. Chris Laforet @ 1:3644/1 or 1:3644/2
  153.    Compuserve Email ............... User ID: 76120,110
  154.    US Mail ........................ Chris Laforet Software
  155.                                     511-D Poplar St
  156.                                     Graham, NC  27253
  157.  
  158.    These I check occassionally:
  159.  
  160.    BIX Email....................... User ID: laforet
  161.  
  162.  
  163. 7. What's New?
  164.    ----------
  165.  
  166.  Changes made on Binkley for 2.40.03:
  167.  
  168.  - Added LimitBaud command.  This sets a limiting baudrate below which NOT to
  169.    send files if we are the caller (Not on my NICKEL, chump!!!).
  170.  - Cleaned up code to send Janus flag.
  171.  - Cleaned up problem with Get and Send file.
  172.  - Activated Janus correctly.  Code was slightly incorrect and didn't support
  173.    locked baudrate connections.
  174.  - Cleaned up nodelist handling.  Made new nodelist searching use file rather
  175.    than allocating memory to hold index (64K problem).
  176.