home *** CD-ROM | disk | FTP | other *** search
/ Network Support Encyclopedia 96-1 / novell-nsepro-1996-1-cd2.iso / download / netware / tokws.exe / TOKWS.TXT < prev   
Text File  |  1994-03-29  |  11KB  |  283 lines
  1.  
  2.               NOVELL TECHNICAL INFORMATION DOCUMENT
  3.  
  4. TITLE:              IBM Token-Ring v2.63 Workstation Drivers
  5. DOCUMENT ID:        TID015502
  6. DOCUMENT REVISION:  A
  7. DATE:               28MAR94
  8. ALERT STATUS:       Yellow
  9. INFORMATION TYPE:   Symptom Solution
  10. README FOR:         TOKWS.EXE
  11.  
  12. NOVELL PRODUCT and VERSION:
  13. NetWare Client for DOS/MS Windows Pre 1.1
  14.  
  15. ABSTRACT:
  16.  
  17. Novell strongly recommends that ODI drivers be used instead of the drivers
  18. included with this file.  See DOSUPx.EXE where x is a alphanumeric character
  19. (0-F), such as DOSUP7.EXE for latest DOSODI drivers. (DOSUPX.EXE is a
  20. distribution file.)  TOKWS.EXE contains IBM Token-Ring v2.63 workstation
  21. drivers.
  22.  
  23. ──────────────────────────────────────────────────────────────────────────────
  24. DISCLAIMER
  25. THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL.  NOVELL
  26. MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION.  HOWEVER, THE
  27. INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY.  NOVELL
  28. MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.
  29. ──────────────────────────────────────────────────────────────────────────────
  30.  
  31. SYMPTOM
  32.  
  33.      Users need an IPX.COM generated for the IBM Token-Ring v2.63 workstation
  34.      drivers
  35.  
  36. SOLUTION
  37.  
  38.      Apply the files found in the TOKWS.EXE file.
  39.  
  40.      Two DIFFERENT IPX.COM files can be generated with the STOKEN and SLANSUP
  41.      drivers.
  42.  
  43.      These two IPX.COM files are described in CASE 1 and CASE 2:
  44.  
  45.      CASE 1:   IPX.COM   (IPX.OBJ generated and linked with SLANSUP.OBJ)
  46.  
  47.           This is the LAN Support driver.  To work properly, this driver
  48.           requires the IBM LAN Support drivers, and it will not work without
  49.           them.  This IPX.COM requires that the following IBM LAN Support
  50.           files to be specified in the workstation's CONFIG.SYS file:
  51.  
  52.           device = DXMA0MOD.SYS    (5C arbitrator)
  53.           device = DXMC0MOD.SYS    (adapter interface)
  54.           device = DXMT0MOD.SYS    (optional IBM Netbios driver)
  55.  
  56.           This IPX.COM driver also supports Remote Program Loading.
  57.  
  58.  
  59.      CASE 2:   IPX.COM   (IPX.OBJ generated and linked with STOKEN.OBJ)
  60.  
  61.      This is the NATIVE Token-Ring driver.  It communicates directly to the
  62.      Token-Ring adapter.  This IPX.COM driver works exactly opposite of the
  63.      IPX.COM file mentioned in CASE 1.  This IPX.COM file works without IBM
  64.      LAN Support drivers being specified in the workstation's CONFIG.SYS.
  65.  
  66.      When using this IPX.COM, the workstation's CONFIG.SYS must not include
  67.      IBM LAN Support driver specifications.  This IPX.COM file supports Remote
  68.      Program Loading.
  69.  
  70.      Self-Extracting File Name:  TOKWS.EXE     Revision:  A
  71.  
  72.      Files Included     Size     Date      Time
  73.  
  74.      \
  75.         TOKWS.TXT         (This File)
  76.        STOKEN.LAN        105   10-15-91   12:16p
  77.        STOKEN.OBJ       6683   08-23-91    9:12a
  78.       SLANSUP.LAN        122   02-03-92    3:33p
  79.       SLANSUP.OBJ       6080   10-18-91    6:24a
  80.  
  81.      Installation Instructions:
  82.  
  83.      *************************************************************
  84.      IMPLEMENTATION of SLANSUP.OBJ and STOKEN.OBJ
  85.      *************************************************************
  86.  
  87.      1.   Determine which IPX.COM to create, LAN Support Token-Ring or Native
  88.           Token-Ring.
  89.  
  90.      2.   Copy the corresponding .lan files to the SHGEN or WSGEN directory or
  91.           diskette and the corresponding .obj files to the LAN_DRV_001
  92.           diskette.
  93.  
  94.      3.   Generate the new IPX.COM with SHGEN or WSGEN.
  95.  
  96.      4.   Configure the IPX.COM at the command line based on your needs using
  97.           the following instructions:
  98.  
  99.      LAN SUPPORT IPX.COM  (IPX.OBJ generated and linked with SLANSUP.OBJ)
  100.      ========================================================
  101.  
  102.      IPX.COM - This is a Client IPX Driver for the IBM Token-Ring generated
  103.      with the IBM LAN Support Program.  It works with ROUTE.COM when Source
  104.      Routing is REQUIRED.  This version of IPX.COM can be configured by typing
  105.      the following parameters at the command line (or batch file) when it is
  106.      loaded:
  107.  
  108.      CONFIGURING the DOS Workstation's IPX.COM (LAN Support):
  109.      ========================================================
  110.  
  111.      IPX.com - (IPX.obj linked with SLANSUP.obj) can be configured by typing
  112.      in the following parameters when it is loaded:
  113.  
  114.      IPX o,ALT/PRI,ls=nn,mem=xx00,node=xxxxxxxx,ntb=nn,saps=nn,tbz=nnnn
  115.  
  116.           where:
  117.  
  118.           o
  119.  
  120.                (lowercase letter "o")  This letter is required to override the
  121.                SHELL.CFG file.
  122.  
  123.           ALT
  124.  
  125.                ALT configures the driver as the ALTERNATE adapter.
  126.  
  127.           PRI
  128.  
  129.                PRI configures the driver as the PRIMARY adapter -- this is the
  130.                default.
  131.  
  132.           ls=nn
  133.  
  134.                nn is a DECIMAL number specifying the number of LINK Stations
  135.                that the driver should allocated when initializing.  The
  136.                DEFAULT is 00.
  137.  
  138.           mem=xx00
  139.  
  140.                The xx00 is a HEXADECIMAL address of where shared RAM is
  141.                located.
  142.  
  143.                The default is D800 for PRIMARY and D400 for ALTERNATE.
  144.  
  145.                This setting always gets overridden by a Microchannel Reference
  146.                mem setting; microchannel machines have this ability in the
  147.                machine reference.  However, ISA bus machines must use this
  148.                driver's setting because there is no other way to specify it
  149.                except with this driver's "mem=xx00" setting.
  150.  
  151.           node=xx
  152.  
  153.                The xx is up to a 4 byte (8 hex digits) HEXADECIMAL number
  154.                specifying a LAA (locally administered node address), which
  155.                overrides the hardware's default Node Address.  The hardware's
  156.                node address is known as a universally administered address. 
  157.                4000h will be prefixed to this number to form a 6 byte NODE
  158.                address: 4000 xxxx xxxx.  If a LAA is specified in the
  159.                CONFIG.SYS as follows:
  160.  
  161.                     device=dxmc0mod.sys 4000xxxxxxxx
  162.  
  163.                device=dxmt0mod.sys o=n, The o=n means do not open adapter and
  164.                IPX.COM opens the adapter, then this node ID must also be
  165.                specified with "IPX o,pri,node=xxxxxxxx" when IPX.COM loads.
  166.  
  167.           ntb=nn
  168.  
  169.                The nn is a DECIMAL number specifying the NUMBER of TRANSMIT
  170.                BUFFERS to allocate.  The default is one.  Specifying two may
  171.                help performance on some of the new IBM Token-Ring Cards.
  172.  
  173.           saps=nn
  174.  
  175.                The nn is a DECIMAL number specifying the number of SAP
  176.                stations that the driver should allocated when initializing. 
  177.                The driver will increment nn by one, because NetWare requires 1
  178.                SAP.  The default is one.
  179.  
  180.           tbz=nnnn
  181.  
  182.                The nnnn is a DECIMAL number specifying the size of the
  183.                Transmit buffer.  It can be any number between 512 and 4202. 
  184.                The driver will adjust it to the nearest power of two plus 106
  185.                bytes of overhead.  The default is 1024 (1130).
  186.  
  187.           All these parameters are separated by commas or blanks, are
  188.           optional, are not case sensitive, and may be entered in any order.
  189.  
  190.  
  191.      NATIVE TOKEN-RING  IPX.COM  (IPX.OBJ generated and linked with
  192.      STOKEN.OBJ)
  193.      ========================================================
  194.  
  195.      IPX.COM - This is a native Token-Ring driver for the DOS workstation.  It
  196.      does not require the IBM LAN Support Program.  It is faster and smaller
  197.      than LAN Support IPX.COM.  It works with ROUTE.COM if Source Routing is
  198.      required. Its default Transmit Buffer Size is 4096 (4 KB) for the 16/4
  199.      MBps adapters, 2048 for the 8-bit, 4 MBps long card.  This version of
  200.      IPX.COM can be configured by typing the following parameters at the
  201.      command line (or batch file) when it is loaded:
  202.  
  203.      IPX.COM (IPX.OBJ generated and linked with STOKEN.OBJ) can be configured
  204.      by typing the following parameters when it is loaded:
  205.  
  206.           IPX o,ALT/PRI,mem=xx00,node=xxxxxxxx,slot=n,tbz=nnnn
  207.  
  208.           where:
  209.  
  210.           o
  211.  
  212.                (lowercase letter "o")  This letter is required to override the
  213.                SHELL.CFG file.
  214.  
  215.           ALT
  216.  
  217.                ALT configures the driver as the ALTERNATE adapter.
  218.  
  219.           PRI
  220.  
  221.                PRI configure the driver as the PRIMARY adapter.  PRI is the
  222.                default.
  223.  
  224.           mem=xx00
  225.  
  226.                The xx00 is a HEXADECIMAL address of where shared RAM is
  227.                located.  The default is D800 for PRIMARY and D400 for
  228.                ALTERNATE.  Microchannel machines already set this mem address
  229.                in the MACHINE REFERENCE, and the machine reference setting
  230.                always overrides any "IPX o,PRI/ALT,mem=xx00" driver setting. 
  231.                ISA bus adapters must be set with this driver's "mem=xx00"
  232.                setting because there is no other way.
  233.  
  234.           node=xx
  235.  
  236.                The xx is HEXADECIMAL Number up to an 4 byte that specifies the
  237.                Node Address.  4000h will be prefixed to this number to form a
  238.                6 byte NODE Address: 4000xxxxxxxx.
  239.  
  240.           slot=n
  241.  
  242.                The n is a DECIMAL number specifying the MICROCHANNEL slot
  243.                number where the board is located.  It is only valid if on a
  244.                Microchannel machine.
  245.  
  246.           tbz=nnnn
  247.  
  248.                The nnnn is a DECIMAL number specifying the size of the
  249.                Transmit buffer.  It can be any number between 512 and 4202. 
  250.                The driver will adjust it to the nearest power of two plus 106
  251.                bytes of overhead.  The default is 4096 (4202).
  252.  
  253.      All parameters are separated by commas or blanks, are optional, are not
  254.      case sensitive, and may be entered in any order.
  255.  
  256.      Patch History:
  257.  
  258.      NOTE:     Version 2.63 of SLANSUP.OBJ is the latest version that has been
  259.                through software test.  The most common problem with
  260.                SLANSUP.OBJ version 2.62 is the workstation that will
  261.                occasionally hang when loading IPX.COM especially when
  262.                broadcast traffic exists on the ring.
  263.  
  264.      04-29-91
  265.  
  266.           This version contained the initial release of TOKWS.DOC and
  267.           TOKWS.ZIP.
  268.  
  269.      11-11-91
  270.  
  271.           This version updated the STOKEN.OBJ to version 2.63.  It added a
  272.           note about SLANSUP.OBJ.
  273.  
  274.      05-27-92
  275.  
  276.           This version updated the SLANSUP.OBJ from version 2.62 to version
  277.           2.63. (revised note about SLANSUP.OBJ and explained a common problem
  278.           with 2.62 SLANSUP.OBJ.
  279.  
  280.  
  281.  
  282.  
  283.