home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1996 October / PCO_10.ISO / filesbbs / tstcom12.arj / TESTCOM.TXT < prev   
Encoding:
Text File  |  1995-02-11  |  6.6 KB  |  209 lines
  1. TESTCOM Performance Tester Version 1.2
  2. (c) 1995 Telesys GmbH, CH-8306 Brüttisellen
  3.  
  4.  
  5. This is a short manual.
  6.  
  7. Please read the file README.TXT, to see,
  8. what TESTCOM does in general.
  9.  
  10.  
  11. FEATURES:
  12.  
  13. - tests serial link throughput at up to 30'000 cps
  14.   or more in full duplex mode on a 486DX/50
  15. - up to 115'200 Baud (460'400 Baud with emulation card)
  16. - COM1 to COM4
  17. - IRQ2 to IRQ7 can be specified individually
  18. - Fully bufferd and interrupt driven receive and transmit
  19. - Full 16550 support from assembler level
  20. - Maximize mode to test maximum speed
  21. - Minimize mode to test optimum performance/speed
  22.  
  23.  
  24.  
  25. INSTALLATION:
  26.  
  27. If you have received TESTCOM in an archive, such as 
  28. a ZIP file, place the contents of the archive in
  29. a new directory.  
  30.  
  31. If you have received TESTCOM on a floppy directly
  32. from Telesys GmbH, simply copy the files into
  33. a new directory. 
  34.  
  35.  
  36.  
  37. COMMAND LINE REFERENCE:
  38.  
  39. Format: TESTCOM <Baud> [COMx [IRQx [<max.cps>]]]
  40.  
  41. You can not use the max.cps parameter, without using the
  42. COMx and IRQx parameter too.
  43.  
  44. <Baud>: 300 - 115200 (effective upto 460kBaud)
  45. [COMx]: COM1 - COM4, Default: COM3
  46. [IRQx]: IRQ2 - IRQ7 (not PCI-bus), Default depends on COMx
  47. [<max.cps>]: 0 - 50000 cps, Default 24000cps
  48.  
  49. Examples:
  50.  
  51. TESTCOM (shows help)
  52. TESTCOM 19200 (tests at COM3 IRQ4)
  53. TESTCOM 115200 COM1 IRQ4 (maximize up to 24'000cps)
  54. TESTCOM 9600 COM4 IRQ7 500 (maximize up to 500cps)
  55. TESTCOM 115200 COM2 IRQ
  56.  
  57. <Baud>:
  58.  
  59. You must make sure yourself, that the Baudrate is not too fast
  60. for your system, such as when running from Windows or OS/2 as
  61. a DOS task with limited CPU capacity. 
  62.  
  63. WARNING!
  64.  
  65. THROUGHPUT TESTS AT PERFORMANCE LIMITS CAN CAUSE OPEN FILES TO GO
  66. LOST, WHEN RUN FROM BEHIND NON TRUE MULTITASKING ENVIRONEMENTS.
  67. IF YOU DON'T KNOW WHICH FILE IS LOST, THE WHOLE APPLICATION RUNNING
  68. IN PARALLEL OR EVEN THE OPERATING SYSTEM MAY CRASH. THEREFORE
  69. YOU WILL HAVE TO USE THE TOOL CAREFULLY. IN GENERAL YOU ARE SAVE,
  70. IF YOU NEVER DO BACKGROUND TASK TESTING ON SYSTEMS, WHICH CAN NOT BE
  71. FULLY RESTORED FROM BACKUP TAPES IN AN ACCEPTABLE WAY.
  72.  
  73. COM port emulation cards, such as the Telelink TUSSI, can multiply
  74. and fully ignore the Baud rate indicated in this parameter.
  75.  
  76.  
  77. COMx:
  78.  
  79. You have to know, on which port you are testing.
  80. If you have an old serial port with an UART 8250, you can not
  81. use baud rates above 9600 baud.
  82.  
  83.  
  84. IRQx:
  85.  
  86. You will also need to know, on which hardware interrupt your
  87. com port is operating, if it is non standard.
  88.  
  89. Standard IRQs for COM1 to COM4 are:
  90.  
  91. COM1 : IRQ4    COM2 : IRQ3 
  92. COM3 : IRQ4    COM4 : IRQ3
  93.  
  94. <max.cps>:
  95.  
  96. This parameter is only needed, if you plan to test throughputs
  97. above 24'000 cps, or if you need to optimize speeds in minimize
  98. mode. See the paragraph on TEST MODES later in this chapter.
  99. Another good reason is to do decent testing, by starting
  100. at low upper boudery limits. This however will not prevent
  101. you from crashing overloaded systems, because the parameter
  102. is adaptive and does not show his effect immediately.
  103. Use the Baud parameter to limit speeds savely.
  104.  
  105.  
  106. INTERNAL OPERATION:
  107.  
  108. TESTCOM sends one byte after the other by simply
  109. counting from 0 to 255. The reception of
  110. continuous counting bytes is used to
  111. evaluate the characters per second (cps)
  112. received and the errors. 
  113.  
  114. TESTCOM is a fully ISA-interrupt driven
  115. DOS task. It can measure the top level performance.
  116. The reason for the actual bottleneck however
  117. can have many possible sources and will need
  118. many tests with different environements.
  119.  
  120.  
  121.  
  122. TEST MODES:
  123.  
  124. TESTCOM can run in two modes. In maximize mode to test for
  125. maximum performance. And in minimize mode to test for optimum
  126. error free performance. Maximize mode is the normal mode
  127. and needs no special command line parameter.
  128.  
  129. In maximize mode (max.cps > 0) the CPU delay is decreased as long
  130. as max.cps is not reached. This measures the performance of serial
  131. channels in optimal system environements.
  132.  
  133. In minimize mode (max.cps = 0) a smooth CPU delay is encreased as
  134. long as there are errors. This measures the possible performance
  135. in a practically given system environement.
  136.  
  137. You must specify all parameters to use minimize mode (see command
  138. line syntax).
  139.  
  140.  
  141.  
  142. TEST RESULTS:
  143.  
  144. TESTCOM reports the type of serial UART chip found.
  145. It will distinguish between bufferd UART (16550)
  146. and non buffered UART (8250 or 16450).
  147.  
  148. The cps values in this test is "full duplex". You
  149. might find, your serial port or modem to support two times
  150. as much, but this is only simplex, such as in a ZMODEM file
  151. transfer. You will also see any errors, that occur.
  152.  
  153. The throughput and the errors are reported for each second
  154. separately. Therefore you might find your cps rate to toggle,
  155. which is a buffer effect of regular reporting and not affecting
  156. measurement by heavy calculating and screen printing.
  157.  
  158. The final report reflects the whole measurement.
  159.  
  160.  
  161. SERIAL PORTS:
  162.  
  163. TESTCOM needs to directly operate on a true hardware
  164. compatible COM port. This can be any UART 16552, 16550,
  165. 16450, 8250 on a serial ISA or PCMCIA bus card, modem
  166. card or on serial ISDN adapter cards or on any equipement
  167. emulating such serial ports, such as the Telelink TUSSI
  168. serial card for speeds up to 460'400 Baud. Software
  169. interface com port emulation such as fossil, EBIOS or
  170. ISDN-cFOS drivers are currently not supported. Much of the
  171. power of this tool is in operating correctly together
  172. with the hardware at high speeds, and using interrupts
  173. correctly, therefore it would loose a lot of its capabilities,
  174. when running on software interfaces.
  175.  
  176.  
  177.  
  178.  
  179. CABLING AND FLOW CONTROL:
  180.  
  181. The standard method of RTS/CTS flow control is used.
  182. TESTCOM only needs the RS232 signal lines
  183. TxD, RxD, RTS, CTS and Ground and is therefore
  184. compatible with the situation given in normal
  185. highspeed communications. You can't use a
  186. normal link cable to test two PC's directly,
  187. because Link Software doesn't normally use
  188. RTS/CTS flow control. Therefore a Null Modem
  189. Cable will most likely not be good.
  190. You can order TESTCOM PACK with a link cable
  191. and a full set of adapters, if you want to make 
  192. sure, to test properly.
  193.  
  194.  
  195.  
  196. TEST ENVIRONEMENTS:
  197.  
  198. 1) PC --- RS232-Loop-Connector (Rx-Tx und RTS-CTS)
  199. 2) PC --- Link-Cabel --- PC
  200. 3) PC --- Modem- or RS232-ISDN-link --- PC
  201. 4) PC --- Modem- or RS232-ISDN-link --- Loop-Connector
  202.  
  203. 1) Test the serial card. If the CPU is slower, the CPU is tested.
  204. 2) Test a given system environement, before a communications link
  205.    is added. Can also test half duplex by clamping RTS on one side only.
  206. 3) Test a communications link in duplex or half duplex mode.
  207. 4) Test any remote communications link in duplex mode.
  208.  
  209.