home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 4 Drivers / 04-Drivers.zip / s2kv200c.zip / MODES.TXT < prev    next >
Text File  |  2001-10-04  |  5KB  |  105 lines
  1.  
  2.  
  3.  
  4.  
  5.                                     MODES
  6.               Replacement for OS/2's MODE.COM for serial ports
  7.  
  8.  
  9.  
  10.                    Copyright (c) 2000 by Raymond L. Gwinn
  11.                               26 Tanager Place
  12.                         Beckley, West Virginia 25801
  13.                             All Rights Reserved
  14.  
  15.                              November 10, 2000
  16.  
  17.  
  18.                          InterNet: sio2k@gwinn.com
  19.                             FAX: 1-304-255-7902
  20.                           WEB http://www.gwinn.com
  21.                              FTP ftp.gwinn.com
  22.  
  23.  
  24.                                Documentation
  25. YOU CANNOT USE THIS PROGRAM WITHOUT THE PERMISSION OF THE AUTHOR.  EVEN
  26. THEN, YOU USE IT AT YOUR OWN RISK.  THERE ARE NO GUARANTEES OR SUPPORT.
  27.  
  28. The program MODE.COM (aka "the MODE command") that is supplied with OS/2
  29. has some limitations with respect to serial ports.  For example, at the
  30. date of this writing, the mode command supports only com1 to com9.  The
  31. author's SIO drivers, sio and sio2k will support more than 9 serial ports. 
  32. Over the years, I have received numerous requests for a MODE (like) program
  33. that supports more than 9 serial ports.  Not being an easy undertaking, I
  34. resisted writing the program for years.  MODES.EXE (the MODES command) is
  35. an end to resistance.
  36.  
  37. The MODES command is not unique to the sio2k drivers.  The program should
  38. work with any drivers remotely similar to com.sys.  However, some features,
  39. such as locking the bit rate, are unique to the sio2k drivers and will not
  40. work with other drivers.
  41.  
  42. I would like to make a few personal comments, or thoughts about the MODE
  43. command.  I suspect the program/command may be a test by an advanced alien
  44. civilization for intelligent life forms.  If not that, then it may be a
  45. mind control experiment by the CIA.  That is to say, if you can understand
  46. the command, then your mind may be one that should be controlled.
  47.  
  48. That being said, the syntax of the MODES command is intended to be
  49. identical to the MODE command, as far as com ports are concerned.  Things
  50. like MODES LPT1 will NOT work, but as to serial ports (ie MODE COM1) the
  51. MODES command should be a direct replacement for the MODE command.
  52.  
  53. To access IBM's OS/2 documentation for the MODE command on WARP 4, go to an
  54. OS/2 command prompt and type VIEW CMDREF.  If you insist on going the GUI
  55. way, open (double click) the "Assistance Center" on the desktop, then open
  56. the "Information" folder, then open the "Reference and Commands" folder,
  57. and finally open the "OS/2 Warp Command Reference" document.  IN THIS
  58. DOCUMENT, I WILL ONLY DOCUMENT THE DIFFERENCES BETWEEN MODE AND MODES.
  59.  
  60. There are some features of the MODES command that are not currently being
  61. documented because the drivers are not yet completely ready to implement
  62. the commands.
  63.  
  64. The intended differences between MODE and MODES are:
  65.  
  66. 1 - The displayed information is very similar, but not identical.  MODES
  67. often provides more information than MODE.
  68.  
  69. 2 - MODES DOES NOT VALIDATE THE BIT RATE, except with respect to minimum
  70. and maximum.  So, if you type 56700 instead of 57600, you will NOT get an
  71. error message, and you will get strange results.
  72.  
  73. 3 - The bit rate can be preceded by "LOCK" or "UNLOCK", without the quote
  74. marks.  If LOCK is specified without a following bit rate, then the bit
  75. rate is locked at the current bit rate.  When the bit rate is locked,
  76. application programs, are prevented from altering the bit rate.  The UNLOCK
  77. option enables application programs to again set/reset the bit rate.  Some
  78. examples are:
  79.  
  80.      modes com1:lock 115200        ;lock at 115200
  81.      modes com1 unlock 57600       ;unlock and set bit rate to 57600
  82.      modes com1 lock               ;lock at the currently set bit rate
  83.      modes com1 unlock             ;obvious
  84.  
  85.  
  86. 4 - The next difference is an experiment, and I really need feedback to
  87. sio2k@gwinn.com about success and problems this feature may cause.  THIS
  88. FEATURE HAS NOT BEEN ADDRESSES IN VSIO2K YET, so the effects on DOS/Windows
  89. sessions is unknown, and at this point is/are unpredictable.  Okay, what is
  90. this experimental feature.  Well, MODES will allow you to swap COM ports. 
  91. That is you can swap com4 with com1, or com10 with com6.  Note that
  92. sio2k.sys does not keep track of the swapping, so there is no automatic
  93. undo.  Of course, you can undo a swap by re-swapping the ports.  Multiple
  94. ports can be swapped on a single MODES command line.  Some examples are:
  95.  
  96.      modes com1=com10              ;swap com1 with com10
  97.      modes com10=com1              ;the same as the first example
  98.      modes com1=com4 com7=com2     ;swap com1 with com4, also com2 and com7
  99.  
  100. I will address and expand this feature into DOS/Windows sessions in the
  101. near future.
  102.  
  103. Have fun.
  104.  
  105.