home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / lan / nbtest.arj / NBTEST.DOC < prev    next >
Text File  |  1992-04-03  |  5KB  |  136 lines
  1. Documentation file for NBTEST. (5-JUL-1987)
  2. Copyright (C) 1987 Micro-Matic Research
  3.  
  4.  
  5. 1. Introduction
  6. _______________________________________________________________________________
  7.  
  8. NBTEST is a simple test program for NETBIOS implementations.
  9. 'Simple' means that only a limited set of functions are tested.
  10. Datagram tests are completely missing.
  11.  
  12. NBTEST establishes a session between two stations and then moves data
  13. from one to the other.  Thereafter the session is closed and some
  14. statistics are reported.
  15.  
  16.  
  17. 2. Operation
  18. _______________________________________________________________________________
  19.  
  20. NBTEST should be started from the MS/DOS command line after NETBIOS is
  21. installed on two stations.
  22.  
  23. The station that is started first will ADDNAME the name 'NBTEST-R'
  24. and LISTEN for a call.  The other station will also try to ADDNAME 'NBTEST-R',
  25. which will fail because it is registered already.  Then it tries to
  26. ADDNAME 'NBTEST-S'.  This should succeed so it will issue a CALL to the
  27. other station.
  28.  
  29. Now 'NBTEST-S' will SEND data, 'NBTEST-R' will RECEIVE data. When the
  30. specified number of blocks is sent both stations will HANGUP the session.
  31.  
  32. NBTEST is able to issue the RECEIVE and SEND commands in no-wait mode.
  33. In this case it is possible to set the number of commands that are issued
  34. at the same time.
  35.  
  36.  
  37. 3. Command arguments.
  38. _______________________________________________________________________________
  39.  
  40. Arguments are given to NBTEST by putting them on the command line
  41. that starts NBTEST.  They are separated from each other by one or more
  42. spaces.
  43.  
  44. The format for an argument is a dash (-) immediately followed (NO spaces)
  45. by a single letter, optionally followed by one or more spaces and a
  46. decimal number.
  47.  
  48. NBTEST recognizes the following arguments:
  49.  
  50. -i      displays the number of kilobytes transferred in real time.
  51.         This option should not be turned on if NBTEST is used to
  52.         measure NETBIOS speeds.
  53.  
  54. -w      wait for a keystroke before sending each block. This option
  55.         implies -i.
  56.  
  57. -v      verifies proper received data length and data contents.
  58.         This option should not be turned on if NBTEST is used to
  59.         measure NETBIOS speeds.
  60.  
  61. -b nnn  specifies the number of commands that are issued simultaneously
  62.         in no-wait mode.  If nnn is zero then data transfer takes place
  63.         in wait mode.
  64.         IMPORTANT: this parameter must have the same value at both
  65.         stations. !
  66.  
  67. -n nnn  specifies the number of blocks that are exchanged in the test
  68.         Higher numbers will give more accurate speed results but will
  69.         make the test take longer.
  70.         IMPORTANT: this parameter must have the same value at both
  71.         stations. !
  72.  
  73. -s nnn  specifies the block size.  In most networks blocks > 512 will
  74.         be split up by NETBIOS to fit into network packets.
  75.         IMPORTANT: this parameter must have the same value at both
  76.         stations. !
  77.  
  78. notes:
  79.         The -i -w and -v options will adversely affect the measured speeds.
  80.  
  81.         The -b -n and -s options MUST have the same value at both stations.
  82.  
  83. examples:
  84.  
  85. command string              action
  86. -------------------------   ----------------------------------------------
  87.  
  88. NBTEST                      starts NBTEST in default mode
  89.  
  90. NBTEST -b 5 -i              uses 5 NCBS simultaneously, displays the
  91.                             number of kilobytes transferred in real time
  92.  
  93. NBTEST -n 10000 -s 12       sends 10000 blocks of 12 bytes
  94.  
  95.  
  96. 4. Suggestions:
  97. _______________________________________________________________________________
  98.  
  99. 4.1. Measuring speed:
  100.  
  101. Speed will be maximal when large blocks (-s 10000) are used and data transfer
  102. is in background (-b 4).
  103.  
  104. It is interesting to test the speed with small blocks (-s 50) to check the
  105. overhead of the protocols used.
  106.  
  107. The value of the background parameter will also influence speed; setting it
  108. on at one side and off at the other may produce slow speeds.
  109.  
  110.  
  111. 4.2. no-wait option:
  112.  
  113. It has been noticed that many NETBIOS implementations have difficulties
  114. handling the no-wait option.  To assure good performance NETBIOS
  115. should continue to work with large values of the b-parameter (up to 10).
  116. Any error encountered during data transfer will cause problems later on.
  117.  
  118.  
  119.  
  120. 5. Program Assembly:
  121. _______________________________________________________________________________
  122.  
  123. NBTEST is provided as .EXE file.  To allow for experiments the full source
  124. code is included.  It consists of 2 files:
  125.  
  126. NBTEST.C        the main program
  127. NB.H            include file containing definitions for NBTEST.C
  128.  
  129. To make NBTEST.EXE you need Microsoft C V5.0 or above and Microsoft LINK.
  130.  
  131. The following commands must be entered:
  132.  
  133. cl nbtest.c
  134.  
  135.                             ---oooOOOooo---
  136.