home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / info / ntkb / ntkb.exe / Q99 / 7 / 45.TXT < prev    next >
Encoding:
Text File  |  1993-11-16  |  16.8 KB  |  397 lines
  1. DOCUMENT:Q99745  02-NOV-1993  [W_NT]
  2. TITLE   :Tuning NWLINK Registry Parameters
  3. PRODUCT :Windows NT
  4. PROD/VER:3.10
  5. OPER/SYS:WINDOWS
  6. KEYWORDS:
  7.  
  8. --------------------------------------------------------------------
  9. The information in this article applies to:
  10.  
  11.  - Microsoft Windows NT operating system version 3.1
  12. --------------------------------------------------------------------
  13.  
  14. NWLink is an implementation of the IPX/SPX protocols popular in Novell
  15. NetWare networks. An additional module, NWNBLink, provides support for
  16. the Novell implementation of the NetBIOS protocol. This article is
  17. divided into the following sections:
  18.  
  19.  - NWNBLink Parameters (Microsoft Extensions to Novell NetBIOS)
  20.  - NWNBLink Parameters (Novell NetBIOS or Microsoft Extensions)
  21.  - IPX/SPX Parameters (Network Interface Cards/Token Ring)
  22.  - IPX/SPX Parameters (Global)
  23.  
  24. CAUTION: Although you can modify all the parameters listed here in
  25. Registry Editor, the default values should rarely need to be changed.
  26. Any changes you make to these parameters can easily affect the
  27. performance of NWLink.
  28.  
  29. Note: All parameters are listed in the following format:
  30.  
  31.    <name> : <data type> : <default value> (valid range, units)
  32.  
  33. In Registry Editor, if no value is present, assume the default is
  34. being used. If you cannot find the parameter, you need to manually add
  35. it (choose Add Value from the Edit menu).
  36.  
  37.  
  38. NWNBLink Parameters (Microsoft Extensions to Novell NetBIOS)
  39. ============================================================
  40.  
  41. Registry path: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services
  42.                \NWNBLink\Parameters
  43.  
  44. The Microsoft Extensions to Novell NetBIOS are provided to enhance the
  45. performance of the traditional Novell NetBIOS protocol. NWNBLink can
  46. automatically detect whether or not it is talking to a Novell NetBIOS
  47. implementation that does not understand these extensions; if it is
  48. being misunderstood, NWNBLink falls back to the standard Novell
  49. NetBIOS protocol currently in use in Novell networks. Significant
  50. performance gains can be realized if the extensions are used (for
  51. example, if the NetBIOS conversation occurs between two Windows NT
  52. computers).
  53.  
  54. AckDelayTime : REG_DWORD : 250 (50-65535, milliseconds)
  55. -------------------------------------------------------
  56.  
  57. Determines the value of the delayed acknowledgment timer.
  58.  
  59. AckWindow : REG_DWORD : 2 (0-65535, frames)
  60. -------------------------------------------
  61.  
  62. Specifies the number of frames to receive before sending an
  63. acknowledgment. AckWindow is used as a clocking mechanism on networks
  64. in which the sender is networked on a fast LAN, but the receiver is
  65. networked on the other side using a slower link. By automatically
  66. forcing acknowledgments, the sender can keep sending frames
  67. continually. If both the sender and receiver are located on a fast
  68. link, you can set AckWindow to 0 to turn off sending an acknowledgment
  69. to the sender. Alternatively, NWNBLink can be set to dynamically
  70. determine whether to use the AckWindow parameter based on the setting
  71. of AckWindowThreshold.
  72.  
  73. AckWindowThreshold : REG_DWORD : 500 (0-65535, milliseconds)
  74. ------------------------------------------------------------
  75.  
  76. Specifies the threshold value for the round trip time that defines
  77. when AckWindow is ignored. The round trip time is an estimate of how
  78. long it takes for a frame to be sent and received from a workstation.
  79. NWNBLink determines this estimate and uses it as a basis for
  80. determining whether it is necessary to send automatic acknowledgments.
  81. If AckWindowThreshold is set to 0,  NWNBLink relies on the AckWindow
  82. entry.
  83.  
  84. EnablePiggyBackAck : REG_DWORD : 1 (0 - False or 1 - True)
  85. ----------------------------------------------------------
  86.  
  87. Allows the receiver to piggyback acknowledgments. Piggybacking
  88. acknowledgments can occur when the receiver has detected the end of a
  89. NetBIOS message. When the sender and receiver are not participating in
  90. two-way NetBIOS traffic, you should set EnablePiggyBackAck to false.
  91. An example of one-way traffic is a stock update application, where a
  92. server constantly sends NetBIOS messages to clients, but the client
  93. does not need to respond.
  94.  
  95. If EnablePiggyBackAck is true but there is no back traffic, NWNBLink
  96. will wait the number of milliseconds determined by AckDelayTime before
  97. sending the acknowledgment, then it will turn off support for
  98. piggybacking acknowledgments. If the workstation at some point starts
  99. sending as well as receiving data, NWNBLink will turn support back on
  100. for piggybacking acknowledgments.
  101.  
  102. Extensions : REG_DWORD : 1 (0 - false or 1 - true)
  103. --------------------------------------------------
  104.  
  105. Specifies whether to use NWNBLink extensions discussed in this
  106. section.
  107.  
  108. RcvWindowMax : REG_DWORD : 4 (1-49152, frames)
  109. ----------------------------------------------
  110.  
  111. Specifies the maximum number of frames the receiver can receive at one
  112. time. The value specified by RcvWindowMax is sent to the sender during
  113. session initialization to give the sender an upper bound on the number
  114. of frames that can be sent at one time. (Related parameters:
  115. AckDelayTime, AckWindow, AckWindowThreshold, EnablePiggyBackAck, and
  116. RcvWindowMax.)
  117.  
  118. NWNBLink Parameters (Novell NetBIOS or Microsoft Extensions)
  119. ============================================================
  120.  
  121. Registry path: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services
  122.                \NWNBLink\Parameters
  123.  
  124. The following parameters can be used to configure Novell NetBIOS or
  125. Microsoft extensions.
  126.  
  127. BroadcastTimeout : REG_DWORD : 1 (1-65535, half-seconds)
  128. --------------------------------------------------------
  129.  
  130. Specifies the time between sending find-name requests. This value is
  131. not affected if Internet is set to 1. (Related parameter:
  132. BroadcastCount.)
  133.  
  134. BroadcastCount : REG_DWORD : 3 (1-65535, times)
  135. -----------------------------------------------
  136.  
  137. Specifies the number of times to send a broadcast. This value is not
  138. affected if Internet is set to 1. (Related parameter:
  139. BroadcastTimeout.)
  140.  
  141. ConnectionCount : REG_DWORD : 5 (1-65535, times)
  142. ------------------------------------------------
  143.  
  144. Specifies the number of times to send a connection probe. A connection
  145. probe is sent by the initiator of a session if a connection could not
  146. be made to the remote computer. (Related parameter:
  147. ConnectionTimeout.)
  148.  
  149. ConnectionTimeout : REG_DWORD : 2 (1-65535, half-seconds)
  150. ---------------------------------------------------------
  151.  
  152. Specifies the time between sending connection probes when initiating a
  153. session.
  154.  
  155. InitialRetransmissionTime : REG_DWORD : 500 (1-65535, milliseconds)
  156. -------------------------------------------------------------------
  157.  
  158. Specifies the initial value for the retransmission time. (Related
  159. parameter: RetransmitMax.)
  160.  
  161. Internet : REG_DWORD : 1 (0 - False or 1 - True)
  162. ------------------------------------------------
  163.  
  164. Specifies whether to change the packet type from 0x04 to 0x14 (Novell
  165. WAN broadcast).
  166.  
  167. KeepAliveCount : REG_DWORD : 8 (1-65535, times)
  168. -----------------------------------------------
  169.  
  170. Specifies the number of times to send a session-alive frame before
  171. timing out if there is no response. (Related parameter:
  172. KeepAliveTimeout.)
  173.  
  174. KeepAliveTimeout : REG_DWORD : 60 (1-65535, half-seconds)
  175. ---------------------------------------------------------
  176.  
  177. Specifies the time between sending session-alive frames. (Related
  178. parameter: KeepAliveCount.)
  179.  
  180. RetransmitMax : REG_DWORD : 8 (1-65535, times)
  181. ----------------------------------------------
  182.  
  183. Specifies the maximum number of times the sender should retransmit
  184. before assuming that something is wrong with the link. (Related
  185. parameter: InitialRetransmissionTime.)
  186.  
  187. IPX/SPX Parameters (Network Interface Cards)
  188. ============================================
  189.  
  190. Registry path: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services
  191.                \NWLink\NetConfig\Driver01
  192.  
  193. These parameters are specific for each binding of NWLink to each
  194. network adapter. Currently, only one card is supported.
  195.  
  196. AdapterName : REG_DWORD : <Adapter name>
  197. ----------------------------------------
  198.  
  199. Specifies the name of the adapter NWLink will use. This parameter is
  200. set when you choose a network adapter to bind NWLink using the Network
  201. icon in Control Panel.
  202.  
  203. BindSap : REG_DWORD : 8137 (hex)
  204. --------------------------------
  205.  
  206. Specifies the Ethertype if the frame format is Ethernet II. The
  207. Ethertype field is only relevant if Ethernet II frames are to be sent
  208. or received. You can choose the frame type using the Network icon in
  209. Control Panel. For more information, see the PktType parameter.
  210.  
  211. EnableFuncaddr : REG_DWORD : 1 (0 - False or 1 - True)
  212. ------------------------------------------------------
  213.  
  214. When true, this parameter specifies that the IPX functional address is
  215. enabled if the adapter is a Token Ring card. If false, the IPX
  216. functional address is not added. The IPX functional address is
  217. C00000800000 (hex). Novell has been phasing out the use of this
  218. address, but it is still used in some places. It is up to the
  219. application to take advantage of the IPX functional address. In most
  220. instances, the broadcast address (FFFFFFFFFFFF hex) is used.
  221.  
  222. MaxPktSize : REG_DWORD : 0 (0-65535)
  223. ------------------------------------
  224.  
  225. Specifies the maximum frame size the network adapter should be allowed
  226. to transmit. If this number is 0, NWLink will get this information
  227. from the adapter driver. This parameter allows the administrator to
  228. make the maximum transmit size smaller than the driver allows. A
  229. scenario in which you might want to change this entry is in an
  230. environment in which the network adapter on one side of a conversation
  231. is on a link that has a larger frame size than the link on the other
  232. side. For example, if the sending station is linked to a 16 MBPS Token
  233. Ring and the receiving station is linked to an Ethernet network.
  234.  
  235. NetworkNumber : REG_DWORD : 0 (network number in hex)
  236. -----------------------------------------------------
  237.  
  238. Specifies the network number to be used for this adapter. If it is 0,
  239. NWLink gets the network number from the network as it is running. This
  240. parameter is set using the Network icon in Control Panel. IPX network
  241. numbers are 4 bytes (8 hex characters) long. An example of an IPX
  242. network number is AABBDDFF. You should not have to enter a specific
  243. value because NWLink will determine it for you. Make sure to get the
  244. network number for your IPX subnet from the network administrator if
  245. you want to enter a specific number.
  246.  
  247. PktType : REG_DWORD : 1 (0-4)
  248. -----------------------------
  249.  
  250. NWLink supports Ethernet, Token Ring, FDDI, and Arcnet topologies. The
  251. PktType parameter specifies the packet form to use. The valid values
  252. are:
  253.  
  254.    0 (Ethernet II)
  255.    1 (Ethernet 802.3)
  256.    2 (802.2)
  257.    3 (SNAP)
  258.    4 (Arcnet)
  259.  
  260. If your adapter is an Ethernet adapter, choose between 0 and 3. If the
  261. adapter is Token Ring or FDDI, choose option 2 or 3. If you are using
  262. an Arcnet adapter, choose option 4. If the adapter is a Token Ring or
  263. FDDI adapter, values 0 and 1 will work the same as value 2. (Related
  264. parameter: BindSap.)
  265.  
  266. RipAgeTime : REG_DWORD : 5 (1-65535, minutes)
  267. ---------------------------------------------
  268.  
  269. IPX maintains a routing information protocol (RIP) cache in order to
  270. locate machines on a remote network. The RipAgeTime entry informs IPX
  271. how many minutes to wait before requesting a RIP update for an entry.
  272. This timer is reset when a RIP announcement is received for an entry
  273. that is in the RIP cache.
  274.  
  275. RipUsageTime : REG_DWORD : 15 (1-65535, minutes)
  276. ------------------------------------------------
  277.  
  278. IPX maintains a RIP cache in order to locate machines on a remote
  279. network. The RipUsageTime entry informs IPX how many minutes to wait
  280. before an entry in the RIP cache will be deleted from the cache. This
  281. timer is reset when a packet is sent to the remote machine.
  282.  
  283. SourceRouteBcast : REG_DWORD : 0 (0 or 1)
  284. -----------------------------------------
  285.  
  286. Specifies the source route to be used when transmitting a packet to
  287. the broadcast MAC address (FFFFFFFFFFF hex). If this value is 0, the
  288. packet is transmitted to the single-route broadcast (0xC2, 0x70). If
  289. the value is 1, the packet is transmitted to the all-routes broadcast
  290. (0x82, 0x70). (Related parameters: SourceRouteDef, SourceRouting, and
  291. SourceRouteMCast.)
  292.  
  293. SourceRouteDef : REG_DWORD : 0 (0 or 1)
  294. ---------------------------------------
  295.  
  296. Specifies the source route to be used when transmitting a package to a
  297. unique MAC address that is not in the source routing table. If the MAC
  298. address is in the source routing table, the route in the table will be
  299. used. If this value is 0, the packet is transmitted to the single-
  300. route broadcast (0xC2, 0x70). If the value is 1, the packet is
  301. transmitted to the all-routes broadcast (0x82, 0x70). (Related
  302. parameters: SourceRouteBcast, SourceRouting, and SourceRouteMCast.)
  303.  
  304. SourceRouting : REG_DWORD : 0 (0 - False or 1 - True)
  305. -----------------------------------------------------
  306.  
  307. Specifies whether to use source routing. This parameter is only used
  308. if the adapter is Token Ring. If there are no source routing bridges
  309. on the Token Ring, disable this entry to disable all of the source
  310. routing logic. (Related parameters: SourceRouteBcast, SourceRouteDef,
  311. and SourceRouteMCast.)
  312.  
  313. SourceRouteMcast : REG_DWORD : 0 (0 - False or 1 - True)
  314. --------------------------------------------------------
  315.  
  316. Specifies the source route to be used when transmitting a packet to a
  317. multi-cast MAC address (C000xxxxxxxx). If false, the packet is
  318. transmitted to the single-route broadcast (0xC2, 0x70). If true, the
  319. packet is transmitted to the all-routes broadcast (0x82, 0x70).
  320. (Related parameters: SourceRouteBcast, SourceRouteDef, and
  321. SourceRouting.)
  322.  
  323. IPX/SPX Parameters (Global)
  324. ===========================
  325.  
  326. Registry path: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services
  327.                \NWLink\Parameters
  328.  
  329. The following parameters are global for the entire NWLink transport.
  330.  
  331. ConnectionCount : REG_DWORD : 10 (1-65535, times)
  332. -------------------------------------------------
  333.  
  334. Specifies the number of times the probe is sent when SPX is trying to
  335. connect to a remote node. If no response is received after the probes
  336. are sent, an error occurs. (Related parameter: ConnectionTimeout.)
  337.  
  338. ConnectionTimeout : REG_DWORD : 2 (1 to 65535, half-seconds)
  339. ------------------------------------------------------------
  340.  
  341. Specifies the time between connection probes when SPX is trying to
  342. connect to a remote node. (Related parameter: ConnectionCount.)
  343.  
  344. KeepAliveTimeout : REG_DWORD : 12 (1-65535, half-seconds)
  345. ---------------------------------------------------------
  346.  
  347. Specifies the amount of time the local side should wait before sending
  348. a probe to the remote side to verify that the SPX connection is still
  349. alive. (Related parameter: KeepAliveCount.)
  350.  
  351. KeepAliveCount : REG_DWORD : 8 (1-65535, times)
  352. -----------------------------------------------
  353.  
  354. Specifies how many times to send a keep-alive probe before timing out
  355. if there is no response. (Related parameter: KeepAliveTimeout.)
  356.  
  357. RipCount : REG_DWORD : 5 (1-65535, times)
  358. -----------------------------------------
  359.  
  360. When the RIP protocol layer is trying to find a route on the network,
  361. this parameter specifies how many times to send a request before
  362. giving up. (Related parameter: RipTimeout.)
  363.  
  364. RipTimeout : REG_DWORD : 1 (1-65535, half-seconds)
  365. --------------------------------------------------
  366.  
  367. Specifies the timeout between RIP request packets being sent out when
  368. the RIP protocol layer is trying to find a route on the network.
  369. (Related parameter: RipCount.)
  370.  
  371. WindowSize : REG_DWORD : 4 (1-10, SPX packets)
  372. ----------------------------------------------
  373.  
  374. Specifies the window to use in the SPX packets. SPX uses the
  375. Allocation field of the SPX packet to tell the remote node how many
  376. receives are available for receiving data. The WindowSize entry
  377. specifies what value to put in the SPX Allocation field.
  378.  
  379. Additional reference words: 3.10 
  380. KBCategory:
  381. KBSubCategory: INTROP
  382.  
  383. =============================================================================
  384.  
  385. THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS
  386. PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  MICROSOFT DISCLAIMS
  387. ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES
  388. OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  IN NO
  389. EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
  390. ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
  391. CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
  392. MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
  393. POSSIBILITY OF SUCH DAMAGES.  SOME STATES DO NOT ALLOW THE EXCLUSION
  394. OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES
  395. SO THE FOREGOING LIMITATION MAY NOT APPLY.
  396.  
  397. Copyright Microsoft Corporation 1993.