
              NOVELL TECHNICAL INFORMATION DOCUMENT

TITLE:              Windows Update Kit Number Eight
DOCUMENT ID:        TID013922
DOCUMENT REVISION:  A
DATE:               04NOV93
ALERT STATUS:       Yellow
INFORMATION TYPE:   Symptom Solution
README FOR:         WINUP8.EXE

NOVELL PRODUCT and VERSION:
NetWare Client for DOS/Windows

ABSTRACT:

This file contains updated Windows client files.  This file includes the
NetWare Driver Set v2.02 for Windows 3.0 and 3.1 and related files. Update
VIPX.386 v1.17, used with LSL.COM v2.05 and IPXODI.COM v2.12 from DOSUP8.EXE,
solves "Black Screen of Death" and other Windows hang symptoms.  Includes
support for IPX/SPX under Windows 3.0 and 3.1 as well as VPICDA.386 for
Windows 3.0 interrupt conflicts.


DISCLAIMER
THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL.  NOVELL
MAKES EVERY EFFORT WITHIN ITS MEANS TO VERIFY THIS INFORMATION.  HOWEVER, THE
INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY.  NOVELL
MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION.


SYMPTOM

     When entering a DOS-prompt under Windows, the workstation hangs with a
     blinking cursor in the upper-left-hand corner of the monitor (commonly
     referred to as the "Black Screen of Death").

SYMPTOM

     When working in Windows, the workstation hangs.

SYMPTOM

     Under Windows, SPX slows down.

SOLUTION

     Copy the updated files to the appropriate directories, and restart
     Windows.  Files marked with an "*" are new since WINUP7.EXE.  Files
     marked with a "^" have been updated since WINUP7.EXE.

     Self-Extracting File Name:  WINUP8.EXE     Revision:  A

     Files Included    Size      Date      Time     Version

     \
       WINUP8.TXT             (This File)
      BINDFIX.EXE     63,297   02-12-91    2:10p    3.52
          BSD.TXT     17,415   10-19-93    6:12p          *
       NETAPI.DLL      7,168   06-24-91   11:05a    1.3D
      NETWARE.DRV     26,144   10-27-92    7:38a    2.02
      NETWARE.HLP     34,348   02-12-92    3:12p
      NWCALLS.DLL    146,176   05-18-93    1:00p    4.00  *
     NWIPXSPX.DLL     37,968   05-18-93    1:00p    4.00  ^
     NWLOCALE.DLL     38,800   05-18-93    1:00p    4.00  *
        NWNET.DLL    198,128   05-18-93    1:00p    4.00  *
     NWNETAPI.DLL    106,884   01-07-93    1:31p    1.30  ^
      NWPOPUP.EXE      4,560   01-14-93    2:57p    3.00  ^
      NWPSERV.DLL     20,929   01-29-92   10:50a    1.30  ^
       NWPSRV.DLL    161,302   05-14-93    5:29p    4.01  *
       TASKID.COM      7,539   01-22-93   10:47a    1.10  ^
        TBMI2.COM     24,884   06-03-93    4:36p    3.14  ^
         VIPX.386     23,855   10-08-93    3:34p    1.17  ^
         VIPX.DOC     33,132   10-19-93    2:10p          *
     VNETWARE.386     15,133   06-29-93    3:48p    2.02  ^
       VPICDA.386     11,063   01-30-91   10:58a    3.02

     Solution Specifics:

     This patch fixes symptoms associated with the "Black Screen of Death,"
     where the workstation hangs with a blinking cursor in the upper left hand
     corner of the monitor, when entering a DOS-prompt under Windows.  This
     patch also fixes other Windows hang issues similar in symptom to the
     "Black Screen of Death."  It fixes an SPX slow down under Windows.  Also
     provides the latest Windows drivers and DLLs for use with workstations
     using the NetWare shells (such as NETX.EXE, XMSNETX.EXE, or EMSNETX.EXE).

     BSD.TXT contains information on solving issues dealing with Windows hangs
     commonly known as the "Black Screen of Death."  It also covers
     suggestions for curing other Windows hangs outside of the scope of "Black
     Screen of Death."  It also contains documentation on LSL, IPXODI and
     VIPX.386 enhancements and parameters.

     VIPX.DOC is a VIPX.386 configuration, limitation, description and
     programming document.

     Installation Instructions:

     1.   Make a backup of any files currently on your workstation or file
          server that appear in the "files included" list above.

     2.   Copy the following files to your WINDOWS directory:

          NETAPI.DLL          API support for the SQL Server front end.

          NWCALLS.DLL         APIs for NCP communication between the file
                              server and workstation.

          NWIPXSPX.DLL        APIs for IPX/SPX communication.

          NWLOCALE.DLL        APIs for localization and internationalization
                              of applications.

          NWNET.DLL           Network API support for NDS.

          NWNETAPI.DLL        Same as NWCALLS.DLL.  Will be phased out.

          NWPSERV.DLL         Contains older print server services APIs.  Some
                              applications specifically call this DLL.  Will
                              be phased out.

          NWPSRV.DLL          Contains print server services APIs.

          TASKID.COM          Version Task Identification Program (for Window
                              3.0)

          TBMI2.COM           Task Switched Buffer Manager for IPX/SPX (for
                              Windows 3.0 and 3.1).

          Note:  Depending of your previous installation, your DLL files may
          be located in the WINDOWS\SYSTEM directory.  Make sure that you have
          a copy of the *.DLL file in only the WINDOWS or the WINDOWS\SYSTEM
          directory, as you may have spurious results if you different
          versions of the same DLL located in each of the directories.

          The .DLL files:

          These files are updated versions of the NetWare API dynamic link
          libraries (DLLs).  These DLLs are used by applications. 
          NWIPXSPX.DLL uses VIPX.386.  A good rule of thumb to follow is to
          check your WINDOWS and WINDOWS\SYSTEM directories to see if these
          files exist.

          If they do, and they are older than the DLLs on this diskette,
          update them with the files on this diskette.

          If not, they are not needed and do not need to be copied.

          If you do install an application that uses any of these DLLs, you
          can use these files to update the DLLs provided these DLLs are newer
          than the ones shipped from the application vendor.

     3.   Copy the following files to your WINDOWS\SYSTEM directory:

          NETWARE.DRV
          NETWARE.HLP
          NWPOPUP.EXE
          VIPX.386
          VNETWARE.386
          VPICDA.386

     4.   Copy the following files to your FILE_SERVER\SYS:SYSTEM directory:

          BINDFIX.EXE         If you are running a version of BINDFIX shipped
                              with NetWare 2.11 or below, you need to update
                              it with the BINDFIX.EXE on this diskette.  For
                              further information, see Novell Technical
                              Bulletin 255 and 256, dated October 26, 1989 and
                              November 3, 1989, respectively.

     General Information and Configuration Parameters:
     
     WINUP8.EXE/binary

     This file contains updated Windows client files.  This file includes the
     NetWare Driver Set 2.02 for Windows 3.0 and 3.1 workstations using
     NETX.EXE and related files.  (Note:  The only files listed above that are
     specific to NETX workstations are NETWARE.DRV and NETWARE.HLP.  All other
     files can be used on workstations using the VLM DOS Requester
     technology).

     Support for IPX/SPX under Windows 3.0 and 3.1 is included as well as
     VPICDA.386 for Windows 3.0 interrupt conflicts.

     NetWare Pop-Up Menu - The Windows 3.1 NetWare driver provides an optional
     pop-up menu that allows you to perform common NetWare-related operations.
     To enable the pop-up menu, add a section to the NETWARE.INI file in the
     Windows directory (you might need to create this file) with the following
     lines:

          [Options]
          NetWareHotKey=1

     This maps the pop-up menu to the F6 key.  The menu has a button that
     allows you to change the hot-key to any of the twelve F-keys.

     TBMI2.COM

     This file is for use with DOS 5.0 Task Swapper, Windows 3.0, or Windows
     3.1 (running in standard or real mode).

     For Windows 3.0, use TBMI2.COM and TASKID.COM.  In the workstation
     NET.CFG add the following parameter:

          USING WINDOWS 3.0=ON

     TBMI2 is intended for those users running programs that use the IPX or
     SPX communications protocols from the DOS prompt in Windows (standard or
     real mode).  TSRs running under DOS prompts in Windows Enhanced mode do
     not need TBMI2, because VIPX.386 will track IPX and SPX functions.  If no
     DOS applications are being run that require IPX or SPX support, then
     neither of these programs should be run.

     To determine whether your application requires TBMI2, follow these steps:

     1.   Load TBMI2.COM.
     2.   Start Windows.
     3.   Open a MS-DOS prompt.
          (for Windows 3.0, load TASKID.COM)
     4.   Start the DOS application in question.
     5.   Run the application and then exit.
     6.   Display diagnostic information by typing the following:
               TBMI2 /D
     7.   If the value in the field named Far Calls Processed is not 0, you
          need to run TBMI2.COM.

     8.   To get help with TBMI2.COM, type the following: tbmi2 /?

          The default configuration for TBMI2.COM is correct for most
          applications.  For use with the MS-DOS 5.0 task swapper, this file
          is documented in the MS-DOS 5.0 README.TXT.

     VPICDA.386

     This Microsoft patch for Windows 3.0 is an enhanced mode virtualization
     file necessary when running a network card that uses interrupt (IRQ) 2,
     IRQ 9, or higher.  This file replaced the Windows supplied VPIC driver in
     the 386 Enhanced section of the SYSTEM.INI file.  To install this driver,
     edit your SYSTEM.INI file:

     [386Enh]
     ;device=*vpicd           (a semi-colon will comment out the line)
     device=vpicda.386        (copy this driver to your Windows 3.0)
                              (subdirectory or System subdirectory)

     *** WARNING ***
     Do not use VPICDA.386 with Windows 3.1.




