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. �