              NETWARE CLIENT KIT README (10/31/94)


To print this file to a local printer, do the following:

  1. Insert the workstation diskette containing this file into
     drive A: (or B:).
  2. At the DOS prompt, type "A:" (or "B:") and press <Enter>.
  3. At the DOS prompt, type "COPY README.TXT PRN" and press
     <Enter>.

     NOTE: If you have a PostScript printer, import this file into
     a word processing application and print from the application.
------------------------------------------------------------------
Contents

This document contains the following topics about the NetWare
Client for DOS and MS Windows:


1.0 General Information

     1.01 Avoiding Loss of Fake Root Mapping

          Do not use the DR DOS MOVE command. The MOVE.EXE file in
          DOS causes the loss of the fake root mapping, because
          MOVE obtains the current path and attempts to perform a
          CD command on that path.


     1.02 Resolving the NDIR Error in COMPAQ DOS 5.0 and DR DOS 6.0

          In COMPAQ DOS 5.0 and DR DOS 6.0, the following commands
          produce an error:

               NDIR servername/volume:
               DIR servername/volume:
               CD servername/volume:

          This is because DOS treats a slash (/) as an option
          specifier when it does its preprocessing. You can map a
          drive and use drive letters instead of the
          servername/volume syntax.


     1.03 Supporting Current NetWare Client File Versions

          To support the Packet Burst ODI functionality, the SFT
          III checksums, and the NetWare management responder, the
          IPXNCP.VLM file requires the IPXODI.COM file version 2.0
          or later to be loaded.

          Support for checksums and GNMA must also be enabled (the
          version and the API support level are treated separately
          in IPXODI).     1.04 Logging In to a Personal NetWare Server

          The PNW.VLM file needs to be loaded before connecting to
          a Personal NetWare server.  Use the "NETWARE PROTOCOL"
          line in your NET.CFG file to load the PNW software.  For
          example:

               NetWare DOS Requester
                    NETWARE PROTOCOL = NDS BIND PNW

          --Using MS Windows

          Use the NetWare User Tools for Windows to log in to a
          Personal NetWare server.

          Ensure that the "Personal" checkbox is marked in the
          "Resource Display Option" box under "NetWare Settings"
          in the NetWare User Tools. If the "Personal" checkbox is
          not marked, Personal NetWare resources are not
          accessible.

          Ensure that the PNW.DLL file is copied to the MS Windows
          SYSTEM directory.

          --Using DOS

          Use the NET.EXE utility provided with Personal NetWare to
          log in and access Personal NetWare resources in DOS.

          Ensure that the NET.EXE, NETU.OVL, and NETA.OVL files are
          copied to your NetWare client directory (default is
          C:\NWCLIENT) and the NETC.MSG file is copied to the
          NLS\ENGLISH directory under the NetWare client directory.

          NOTE: Currently, support for simultaneous login to a
          Personal NetWare and NetWare Directory Services
          network is not available on 80286-based workstations.


     1.05 Using the Receive Monitor Utility (RXMONSTK.COM) with
          Monitor Type Applications (Such as Lanalyzer)

          If the monitor type applications you are using seems to
          stop receiving network packets when you install a new LAN
          driver on your workstation, load the RXMONSTK.COM file.

          The application you are using probably requires the
          network card to operate in promiscuous mode, and the LAN
          driver you are using was developed to a new specification
          that does not support this mode (Oct. 1994 or later).

          Load the RXMONSTK.COM file after the LSL.COM driver but
          before the LAN driver. The RXMONSTK.COM operates as a TSR
          and requires 2684 bytes of memory. You can load only one
          LAN driver when using the RxMonStk.  2.0 Information Specific to Using the NetWare DOS Requester


     2.01 Mapping Roots within Paths over 64 Characters in Length

          DOS limits the number of characters that the NetWare DOS
          Requester software can support in a path name. To use
          longer paths, map a root within the path at a point where
          fewer than 64 characters remain in the path.

          DR DOS 6 and Novell DOS 7 allow paths longer than 64
          characters on local drives only. To use paths longer than
          64 characters on network drives, follow the root mapping
          instructions in the previous paragraph.


     2.02 Search Mode Now Uses the DOS ENVIRONMENT Variable

          The "SEARCH MODE" function uses the "PATH" DOS
          ENVIRONMENT variable rather than the public search mode
          table provided in the NETX.VLM file. You should
          experience no change unless users corrupt their
          workstation environment.

          If you exceed the PATH limitation, your search drive
          mappings are not included in the PATH.


     2.03 Difference in Diagnostic Information Reported in the
          NETX.VLM File Compared to the NETX.COM and Related Files

          Some of the current diagnostic information supported
          in the NETX.COM file appear to be invalid in the
          NETX.VLM file. This is because the NetWare DOS Requester
          is responsible for much of the diagnostics information
          previously maintained in the NetWare Shell for DOS.

          Some of the information maintained in the diagnostics
          responder is not provided in the current client software.
          Such information includes the following:

                    Bad reply header (InvalidReplyHeaderCount)
                    Bad slot (InvalidSlotCount)
                    Bad sequence number
(InvalidSequenceNumberCount)
                    No router found (NoRouterFoundCount)
                    Request in process (BeingProcessedCount)
                    Bad server slot (InvalidSlotFromServerCount)
                    Bad net address (NetworkGoneCount)
                    Bad local address (BadLocalAddressCount)
                    Allocate slot errors
(AllocateSlotCannotFindRoute,
                    AllocateNoSlotsAvailable, AllocateServerIsDown)

          The NetWare Management Responder (NMR.VLM) file now
          provides diagnostic information similar to the
          information provided in the NetWare Shell software.
3.0  Information Specific to Using MS Windows


     3.01 Using the NETWARE.DRV Version 3.03 with MS Windows

          The current version of NETWARE.DRV (version 3.03)
          requires the NWGDI.DLL file to be loaded when running MS
          Windows 3.1 or later.

          If you receive the following message when loading MS
          Windows with the NetWare for MS Windows client software,
          you should ensure that a copy of the NWGDI.DLL file
          exists in your MS Windows SYSTEM directory:

          Application Error: Call to Undefined Dynalink


     3.02 Using the Correct Version of the Dynamic Link Libraries
          (*.DLL) Files the NetWare Administrator Utility in
          NetWare 4

          The dynamic link library (*.DLL) files provided with
          the current version of the NetWare Client software do not
          support the NWADMIN.EXE file version 4.05 or earlier
          (NetWare 4.0 and 4.01).

          To support the NWADMIN.EXE file version 4.05 or earlier,
          download the WINDR1.EXE from NetWare or FTP.NOVELL.COM.


     3.03 Fixing the Situation in which MS Windows Hangs and
          Displays a Blinking Cursor in the Upper-Lefthand Corner
          of the Screen (Black Screen of Death)

          If you are experiencing the situation in which MS Windows
          hangs and then displays a blinking underline cursor
          in the upper-lefthand corner of the screen, you should
          perform any or all of the following:

          1.>  If you are using a third-party memory manager, do
               not load any IPX interface software (such as LSL.COM
               or IPXODI.COM) into high memory.

          2.>  Add the TimerCriticalSection=10000 command line in
               the [386Enh] section of the SYSTEM.INI file.

          3.>  Download and implement the VTDA.386 driver from
               Microsoft.

               You can obtain a copy by downloading the appropriate
               file from Microsoft Download Services or
               FTP.MICROSOFT.COM SOFTLIB Area.

          4.>  If using the IBM LAN Support system, virtualize the
               network board's IRQ in the [VIPX] section of the
               SYSTEM.INI.

               See the documentation if the next section for
               specific information about the available parameters.


          VIPX Configuration Parameters for VIPX
          --------------------------------------

               Under most circumstances, VIPX will work fine under
               the default configuration.  However, some
               applications might require custom configuration of
               the driver.

               The following sections list and discuss the
               SYSTEM.INI parameters that can be used to configure
               VIPX:

               [VIPX] Section Parameters
               -----------------

               VipxMappingPages=[number of 4K pages]
               (Default=16)

                    This is the number of pages that VIPX can use
                    to globalize requests to the global IPXODI.COM
                    driver.

                    VIPX is not absolutely guaranteed to have all
                    of these pages available at any one point,
                    because this is the requested number of pages
                    for shared global mapping that VIPX makes to
                    the Windows VMM at initialization time.

               VipxFailOverSizedPackets=[ON|OFF|TRUE|FALSE]
               (Default=OFF)

                    This parameter directs VIPX to fail any
                    requests that require more than the maximum
                    allowed globalization size. The actual maximum
                    varies according to the media the user is
                    using.

                    The absolute maximum is 8000 (decimal)
                    bytes. With media that have smaller packets
                    than 8000 bytes, the maximum allowed size is
                    the maximum packet size that can be put onto
                    the media.

               VirtualizeIrq[0-F]=[ON|OFF|TRUE|FALSE]
               (Default=OFF)

                    VIPX version 1.15 or later avoids a deadlock
                    between the machine and network board by
                    virtualizing the network board's IRQ.  With ODI
                    and dedicated IPX (IPX.OBJ) drivers, VIPX
                    automatically reads the configuration
                    of the network board from the driver and
                    virtualizes the selected IRQs.

                    However, when using the IBM LAN Support Program
                    with SLANSUP.OBJ or LANSUP.COM, the LAN IRQ is
                    not readable from the driver. Therefore, you
                    must set the IRQ for the network board in the
                    [VIPX] section of the SYSTEM.INI.

                    For example, to virtualize both IRQ 2 and
                    IRQ 3, you would add the following lines in
                    your SYSTEM.INI file:

                    [VIPX]
                    VirtualizeIrq2=TRUE
                    VirtualizeIrq3=TRUE

                    VIPX can virtualize up to four different LAN
                    IRQs.


               [386h] Section Parameters
               -------------------------

               TimerCriticalSection=number

                    As of version 1.15 of VIPX, the
                    TimerCriticalSection must be activated. The
                    recommended setting is as follows:

                    [386Enh]
                    TimerCriticalSection=10000

                    Set this parameter to avoid a deadlock with the
                    LAN IRQ Virtualization code.  See the
                    "VirtualizeIrq[0-F]" parameter in the "[VIPX]
                    Section Parameter" documentation.

     
4.0 Information Specific to Using MS Windows for Workgroup


     4.01 Using LSL.COM, 3C5X9.COM, IPXODI.COM, and the NetWare DOS
          Requester with MS Windows for Workgroup NWLINK.386 and
          MSODISUP.386 files

          When copying files from a local to a network drive from
          MS Windows for Workgroups 3.11, the file might become
          corrupted or the client workstation might hang or
          lose its network connection.

          You should update your version of Microsoft's
          MSODISUP.386 file. You can obtain a copy by downloading
          the WG1004.EXE from Microsoft Download Services or
          FTP.MICROSOFT.COM SOFTLIB Area.


     4.02 Supporting DOS Named Pipes

          Novell's DOSNP.EXE file is not compatible with MS Windows
          for Workgroup (WFWG) version 3.11. WFWG does not allow
          the use of INT 21 Named Pipes requests used by the
          DOSNP.EXE file.

          Currently, there is no fix available.


5.0 Setting Up Desktop SNMP on Your Client

CONTENTS

     I.   Introduction to Desktop SNMP
     II.  Components of Desktop SNMP
     III. Enabling Desktop SNMP Services
     IV.  Sample NET.CFG File for Desktop SNMP Services
     V.   Conventional Memory Usage
     VI.  Unloading the Desktop SNMP Software
     VII. Where to Go from Here

-------------------------------------------------------------------

I. Introduction to Desktop SNMP

     Simple Network Management Protocol (SNMP) is an
     industry-standard protocol for communication between a network
     management console and the network devices that the console is
     to monitor. This chapter explains how to enable desktop SNMP
     services on your computer, and how to modify the NET.CFG file
     to implement additional SNMP options.

     The chapter is primarily for supervisors of networks in which
     an SNMP-based network management system is implemented.

     The Desktop SNMP agent provided with the NetWare Client
     Kit 1.1, allows you to manage your NetWare clients from
     Novell's NMS (NetWare Management System) and other
     industry-standard SNMP management consoles.


II. Components of Desktop SNMP

     The NetWare Client Kit 1.1 includes the following components
     for the Desktop SNMP agent:

     HRMIB.EXE      - the Host Resources manager, which collects
                      information about a computer that is
                      running DOS on the network.

     HRMIB.INI      - the configuration file for the HRMIB.EXE
                      file.

     WSSNMP.VLM     - Desktop SNMP module, which includes support
                      for MIB-II System and SNMP groups

     WSREG.VLM      - MIB registration module
     WSASN1.VLM     - ASN.1 translation module
     WSTRAP.VLM     - Trap module
     MIB2IF.VLM     - MIB-II interface groups support
     MIB2PROT.VLM   - MIB-II support for the TCP/IP groups
     STPUDP.COM     - Transport provider module for UDP/IP
     STPIPX.COM     - Transport provider for IPX

     These files are copied the client directory on your
     computer (default is C:\NWCLIENT.)

     NOTE: Refer to the documentation provided with the SNMP
     management software for information on specific configurations
     for the management software.


III. Enabling Desktop SNMP Services

     A. You can set up Desktop SNMP on your client to act as an
     SNMP agent for any SNMP-based management consoles.

     To set up Desktop SNMP Agent services on your client, you will
     need to perform the following tasks:

     þ    Install the NetWare Client 1.1 on your client computer.

     þ    Modify the NET.CFG file to reflect the presence of
          Desktop SNMP .VLM files, and then set the required .VLM
          file options in the NET.CFG file. See section "IV,"
          "Sample NET.CFG File for Desktop SNMP Services" in this
          file.

     þ    Set the "TRAP TARGET" address of the NetWare Services
          Management (NSM) consoles or other SNMP-based managers in
          the NET.CFG file. See section "IV," "Sample NET.CFG File
          for Desktop SNMP Services" in this file.

     þ    Modify the STARTNET.BAT file to load either STPIPX.COM or
          STPUDP.COM.

     þ    Load the NetWare client software by running the
          STARTNET.BAT file in the client directory.

          NOTE: You must have either IPX or IP transport installed
          on your system. IPX transport (IPXODI) is provided by the
          NetWare DOS requester provided in the NetWare Client
          Kit 1.1. IP transport for UDP/IP is provided by LAN
          Workplace for DOS 4.1 (LAN Workplace). You can use both
          types of transport on a single client.

     By default, desktop SNMP services are not enabled when you
     install the NetWare client. To enable desktop SNMP services,
     do the following:

          1. Ensure that the Desktop SNMP files are copied to the
          client directory (default is C:\NWCLIENT).


          2. Modify the NET.CFG file to load the Desktop SNMP .VLM
          file suite.

          IMPORTANT: When the Desktop SNMP .VLM file suite is
          loaded, the WSSNMP.VLM must be loaded first. The
          WSTRAP.VLM and WSREG.VLM files must be loaded prior to
          loading the WSASN1.VLM file.

          To load the Desktop SNMP .VLM file suite, modify the
          NET.CFG file on your client in either of the following
          two ways:

               a. To load Desktop SNMP in addition to the NetWare
               DOS Requester software, add the following lines to
               the NET.CFG file under the "NetWare DOS Requester"
               section:

                    VLM = WSSNMP.VLM
                    VLM = WSTRAP.VLM
                    VLM = WSREG.VLM
                    VLM = WSASN1.VLM

               b. To load only Desktop SNMP, without the NetWare
               DOS Requester modules, add the following lines to
               the NET.CFG file under the "NetWare DOS Requester"
               section:

                    USE DEFAULTS = OFF
                    VLM = WSSNMP.VLM
                    VLM = WSTRAP.VLM
                    VLM = WSREG.VLM
                    VLM = WSASN1.VLM


          3. Modify client configuration files for setting up
          Desktop SNMP. See "Desktop SNMP Option" in Appendix B of
          "Workstation for DOS and MS Windows" for information and
          details on how to set up and configure your client for
          the following Desktop SNMP parameters:

          þ Transport providers
          þ MIB-II support
          þ Community names
          þ Asynchronous timeout


          4. Modify the C:\NWCLIENT\STARTNET.BAT file to load the
          Desktop SNMP transport files. Add the following commands
          in the STARTNET.BAT after the line which loads the
          VLM.EXE file.

          If you are using IPX transport, add the following
          line by typing:

          STPIPX

          If you are using UDP/IP transport, add the following
          line by typing:

          STPUDP

          NOTE: You can add both commands if your client uses
          both IPX and UDP/IP transport.

          NOTE: If you are running LAN Workplace, make sure you are
          do not load the SNMP.EXE file, provided with the LAN
          Workplace package. The installation program for LAN
          Workplace creates a file called "LANWP.BAT" that loads
          the LAN Workplace software. Check this file for a line
          reading "SNMP." It should be listed directly following
          the line "TCPIP." If the SNMP line is present, delete it
          or comment it out.


          5. Use DOS SET command at the system prompt or in a batch
          file to set the correct time zone for your area, as
          follows:

               SET TZ = time_zone

          Refer to your DOS manual for the exact syntax for your
          particular time zone.

          If the time zone is not set in your computer's
          environment, traps for SNMP may report an incorrect time.

          6. Reboot your computer. The VLM manager will load the
          Desktop SNMP .VLM file suite along with any other .VLM
          files your client is configured to load.


     B. The Desktop SNMP workstation support includes the
     HRMIB.EXE and HRMIB.INI files. These files enable the console
     to view data collected at each Desktop SNMP workstation. The
     files are located in the client directory (default is
     C:\NWCLIENT).

     To enable the SNMP console to view data about a Desktop SNMP
     workstation, you will need to perform the following tasks:

     þ    Install the NetWare Client 1.1 on your client computer.

     þ    Load the HRMIB.EXE software on the client you want data
          collected from.

          1. Ensure that the HRMIB.EXE and HRMIB.INI files exist
          in your client directory (default is C:\NWCLIENT).

          2. Load the HRMIB.EXE file by typing

               HRMIB.EXE

          NOTE: Ensure that the DOS SNMP Agent softwared is set up
          and loaded on your client before loading the HRMIB.EXE
          file.


          3. Configuring the HRMIB.INI File

          The Host Resources MIB does not return information about
          devices attached to the host computers, such as printers,
          modems, and tape drives. If the network management
          console is to view details of such devices, you must
          list them in the HRMIB.INI file.

          The HRMIB.INI file is located in the directory to which
          you installed the NetWare client (C:\NWCLIENT by default)
          on your computer. Use a ASCII text editor to enter a
          short description of each device. For example:

          Sample configuration file (HRMIB.INI) for HRMIB.EXE

          # List of all printers connected to host
          [printers]
          HP LaserJet IIIp on LPT1:
          NEC P20 on LPT2:

          # List of all modems connected to host
          [modems]
          Hayes Optima 144 on COM1:

          # List of all tape drives connected to host
          [tapes]
          Colorado DJ10
          HP 35480A SCSI DAT (4-8 GB)

          # other devices obtained via DOS APIs


IV. Sample NET.CFG File for Desktop SNMP Services

     A sample of the NET.CFG for SNMP agent services is as follows:

     Link Driver NE2000
          PORT 300
          INT 3
          FRAME Ethernet_802.2
          MEM D0000

     NetWare DOS Requester
          VLM = WSSNMP.VLM
          VLM = WSTRAP.VLM
          VLM = WSREG.VLM
          VLM = WSASN1.VLM
          VLM = MIB2IF.VLM
          VLM = MIB2PROT.VLM

     Desktop SNMP
          enable monitor community = any
          monitor community = "public"
          enable control community = specific
          control community = "public"
          enable trap community = specific
          trap community = "public"
          sysName = "Suzanne Morley x893"
          sysLocation = "Building 2"
          sysContact = "suzanne@acompany.com"
          snmpEnableAuthenTraps = on

     Transport Provider IPX
          trap target = ab123456:0123456789ab
          trap target = cd654321:ba9876543210

     Transport Provider UDP
          trap target = 999.88.77.66
          trap target = 888.11.22.33


V. Conventional Memory Usage

     If you are willing to trade conventional memory for
     performance, you can load one or more Desktop SNMP .VLM files
     in conventional memory.

     To load all .VLM files in conventional memory, use the VLM /MC
     switch when running the VLM manager.

     To load a Desktop SNMP .VLM files in conventional memory,
     place lines of the following form in the NET.CFG file:

     Netware DOS Requester
          VLM = vlm_name.VLM
          LOAD LOW vlm_name = ON

     For example, to load Desktop SNMP while loading the WSASN1.VLM
     and WSREG.VLM files in conventional memory, place the
     following lines in the NET.CFG file:

     Netware DOS Requester
          VLM = WSSNMP.VLM
          VLM = WSTRAP.VLM
          VLM = WSREG.VLM
          VLM = WSASN1.VLM
          Load low WSREG = ON
          Load low WSASN1 = ON


VI. Unloading the Desktop SNMP Software


     The following commands, issued in the order given, unload
     Desktop SNMP.

     NOTE: The VLM -u command unloads all VLM files, not just
     Desktop SNMP.

          1. Unload STPUDP if UDP/IP support has been loaded:

               STPUDP -u

          2. Unload STPIPX if IPX support has been loaded:

               STPIPX -u

          3. Unload all VLM files:

               VLM -u

     IMPORTANT: Always unload the modules in reverse order from the
     order in which you loaded them. For example, if you loaded the
     VLM manager followed by STPUDP and then STPIPX, you must
     unload them as follows:

            STPIPX -u
            STPUDP -u
            VLM -u

     Unloading the modules in any order other than reverse order
     causes an error.

VII. Where to Go from Here

     After you have completed the initial configuration of the
     desktop SNMP agent, you can further modify the Desktop SNMP
     options in the NET.CFG file to meet your specific network
     requirements. Refer to"Desktop SNMP Option" in Appendix B of
     "Workstation for DOS and MS Windows" for a description of
     these modifications.


6.0 Information Specific to Documentation


     5.01 Typographical Error

          The following example in the "NetWare Client for DOS and
          MS Windows User Guide" on page 148,

          [port]
          lp1:=
          lp2:=
          lp3:=
          lp4:=
          net1:=
          record.prn=

          should appear as follows:

          [port]
          lpt1:=
          lpt2:=
          lpt3:=
          lpt4:=
          com1:=
          record.prn=


-----------------------------------------------------------------
                         DISCLAIMER

Novell, Inc., makes no representations or warranties with respect
to any NetWare software, and specifically disclaims any express or
implied warranties of merchantability, title, or fitness for a
particular purpose.

Distribution of any NetWare software is forbidden without the
express written consent of Novell, Inc. Further, Novell reserves
the right to discontinue distribution of any NetWare software.

Novell is not responsible for lost profits or revenue, loss of use
of the software, loss of data, costs of recreating lost data, the
cost of any substitute equipment or program, or claims by any party
other than you.

Novell strongly recommends a backup be made before any software is
installed. Technical support for this software may be provided at
the discretion of Novell.

-------------------------------------------------------------------
                         TRADEMARKS

Novell, NetWare, and DRDOS are registered trademarks of Novell,
Inc.
NetWare Client, NetWare DOS Requester, Novell DOS, Packet Burst,
Personal NetWare, ODI, and SFT III are trademarks of Novell, Inc.
Compaq is a registered trademark of Compaq Computer Corporation.
IBM is a registered trademark of International Business Machines
Corporation.
Microsoft is a registered trademark of Microsoft Corporation.
PostScript is a registered trademark of Adobe Systems Incorporated.


