home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / networks / tcpv21cc.zip / READ.ME < prev    next >
Text File  |  1993-08-30  |  9KB  |  152 lines
  1. IBM TCP/IP for DOS.
  2. RFC NetBIOS 2.1.0.1
  3.  
  4. I. General Description
  5.    NetBIOS is a protocol that allows both connection oriented and packet
  6. oriented communication.  The original NetBIOS (referred to as native NetBIOS)
  7. is only available between machines on the same local area network.  RFC NetBIOS
  8. is a standard (defined by RFCs 1001 and 1002) that implements the NetBIOS
  9. interface while taking advantage of TCP/IP protocols.  The advantage is that
  10. it allows programs that use NetBIOS to communicate across any internet.
  11.  
  12. II. Executable Descriptions
  13. NBTCP.EXE      -- the executable that installs the RFC NetBIOS in memory.
  14.                   It takes about 35K of DOS memory and approximately 1.5M
  15.                   of protected mode memory.  Because of its protected memory
  16.                   requirement, it may be necessary to increase the
  17.                   VCPI_reserve value.  Allocate at least 1,500,000 for NBTCP
  18.                   alone.  More will be required by other programs.
  19.                   NBTCP can be run either by TCPSTART (configurable in
  20.                   the CUSTOM.EXE program with the TCP/IP for DOS base kit)
  21.                   or just typing NBTCP.EXE from the DOS prompt.  NBTCP must
  22.                   be run before you start additional windowing operating
  23.                   systems from DOS.
  24.  
  25. NBDOWN.EXE     -- this executable removes RCF NetBIOS from memory.
  26.                   RFC NetBIOS is limited the same way most TSRs are, in that
  27.                   any TSRs installed after it must be removed before you
  28.                   can remove the NetBIOS program.
  29.  
  30. MAPNAME.EXE    -- a utility that converts between RFC Encoded and NetBIOS
  31.                   names.  CSD 2.1.0.1 allows redirection of input and output
  32.                   to files.
  33.  
  34. III. Configuration Parameters
  35. RFC NetBIOS can be configured by adding parameters to your TCPDOS.INI
  36. file in you ETC directory.  The parameter name and value must be on
  37. the same line and be seperated by an equal sign.  Preceeding spaces do not
  38. matter.  You are not required to configure all the parameters for RFC NetBIOS
  39. to work properly, if they are not present RFC NetBIOS will use the default
  40. values.
  41.  
  42.    A. Network parameters
  43.       These parameters define what adapter RFC NetBIOS uses and which NDIS
  44.       interface.  These must be set if you wish to cohabitate with native
  45.       NetBIOS on the same machine.
  46.  
  47.       nb.adapter           This parameter determines which adapter to use
  48.                            and must be set.  It expects either the NDIS
  49.                            adapter number or the SLIP number (i.e. ND0 or SL0).
  50.                            The adapter number is mapped to a physical adapter
  51.                            inside CUSTOM.EXE
  52.  
  53.       nb.lana_num          This defines the LAN interface we will use if
  54.                            we wish to cohabitate with native NetBIOS.  It
  55.                            defaults to 0.
  56.  
  57.    B. Name parameters
  58.       Since NetBIOS names do not have any relation to IP addresses or machine
  59.       names (you may use the same names to avoid confusion, but you don't
  60.       have to), RFC NetBIOS has three methods of determining which specific
  61.       machine your NetBIOS application is referring to.  You may have a names
  62.       file which maps NetBIOS names either directly IP addresses or to IP names
  63.       that can be resolved with the domain name server.  RFC NetBIOS may also
  64.       broadcast for the name, querying everyone on its own LAN and everyone in
  65.       its broadcast file to see if they are that name.  Finally, it can access
  66.       the Domain Name Server (DNS) directly to ask for an IP address.
  67.  
  68.       nb.search_order      This defines the order in which RFC NetBIOS will
  69.                            attempt to resolv a NetBIOS name.  It may any
  70.                            of the characters N, B and D in any order or
  71.                            combination.  It makes no sense to repeat a
  72.                            letter, however.  N specifies the names file.
  73.                            B specifies broadcast (which includes the local lan
  74.                            and any entries in the broadcast file).  D specifies
  75.                            DNS.  The default is NB (NBTCP will check the names
  76.                            file and if it can't find it there, broadcast
  77.                            for it.)
  78.  
  79.       nb.names_file        This sets the file to be used as your names file.
  80.                            This maps NetBIOS names to IP addresses or IP
  81.                            machine names.  It is the fastest method for RFC
  82.                            NetBIOS to resolve NetBIOS encoded names.  If you
  83.                            only connect to one machine, or have one machine
  84.                            machine (say a file server) that is frequently
  85.                            accessed, you will probably want to put it in here
  86.                            to save time in trying to locate it.  It defaults
  87.                            to names.nb in your ETC directory.
  88.  
  89.       nb.broadcast_file    This defines what file in you ETC directory is
  90.                            your broadcast file.  When RFC NetBIOS broadcasts
  91.                            for a name, it sends queries to every machine
  92.                            on its own LAN and every machine in its broadcast
  93.                            file looking for the name.  You may specify an
  94.                            entire network by putting in that networks
  95.                            broadcast address rather than a specific machine
  96.                            name.  It defaults to broadcast.nb in your ETC
  97.                            directory.
  98.  
  99.       Broadcast Parameters
  100.       These parameters only have meaning if you use broadcasting to resolve
  101.       your NetBIOS names.  (i.e. you have a B in your nb.search_order)
  102.          nb.retries        The RFC NetBIOS standard uses UDP for names on the
  103.                            network.  Since UDP is not a guaranteed delivery
  104.                            protocol, we send each UDP packet multiple times.
  105.                            The RFC establishes 3 retries as the standard.
  106.                            It is configurable between 1 and 10.
  107.  
  108.          nb.retry_delay    RFC 1002 establishes 250 milliseconds as the
  109.                            delay between UDP sends.  This parameter is
  110.                            measured in millisecond increments.  It is
  111.                            configurable from 10 - 2000 (10ms to 2s).
  112.  
  113.          nb.conflict_delay After RFC NetBIOS receives a positive response
  114.                            to a name search, it must wait a specified amount
  115.                            of time in case another machines also claims that
  116.                            name and causes a conflict.  RFC 1002 establishes
  117.                            1 second as the standard.  This parameter is
  118.                            measured in millisecond increments and is
  119.                            configurable from 100 - 2000 (100ms to 2s).
  120.  
  121.    C. Other configuration parameters
  122.       General rule: don't play with these unless you really need to.
  123.       nb.max_sockets       This parameter determines the maximum number
  124.                            of file handles available to RFC NetBIOS.
  125.                            It may be between 8 and 50.  This parameter is
  126.                            provided for very specialized applications and
  127.                            should not be modified unless necessary.
  128.  
  129.       nb.max_recv_buffers  Sets the maximum number of receive buffers RFC
  130.                            NetBIOS should allocate at init time.  This number
  131.                            should only be changed if needed.  The acceptable
  132.                            range is 4 to 20 and defaults to 15.
  133.  
  134. IV. Common Problems
  135.    One of the common problems discovered in testing is the sensitivity of
  136. various programs to the name broadcasts of RFC NetBIOS.  (This is not
  137. a problem if you're not using broadcasting to resolve names.)  Most NetBIOS
  138. applications are expecting native NetBIOS and the fast response of a LAN.
  139. Due to its nature, and the unreliability of UDP packets, RFC NetBIOS requires
  140. a slower protocol. If your NetBIOS applications often report errors to
  141. you when trying to contact a station, you may want to try decreasing the
  142. retry_delay or the conflict_delay slightly.  On a small network with limited
  143. traffic, it may also be safe to lower the retries to 2.  These options
  144. should be handled with care however and modified only as much as absolutely
  145. necessary.  These parameters affect mostly name operations, and not session
  146. performance at all.  Changing these cannot improve session performance, only
  147. the speed in which it locates names (i.e only during an initial login, but not
  148. during subsequent transfers).
  149.    A better alternative is to put the host name directly in your names file
  150. and specify N before B in you search order.  This may not be convenient
  151. however if you contact a wide variety of machines.
  152.