ftp.microsoft.com
/bussys/winnt/sna-public/fixes/sna211/hotfixes-postsp2/appc-fix

"APPC" Update to SNA Server 2.11 Service Pack 2

Last updated: July 7, 1997

The enclosed updates to SNA Server 2.11 Service Pack 2 correct various
problems found when using different third party products over the
SNA Server APPC interface. The problem descriptions are included below,
along with the knowledgebase article number, internal SNA Server bug
number, and module name containing the fix:

Q170289  7830   DISPLAY or CNOS calls fail with UNEXPECTED_DOS_ERROR 
        Module updated:  <snaroot>\system\WAPPC32.DLL

NOTE: At this time, Microsoft has no plans to provide an SNA Server 2.11
Service Pack 3 update. The fix to the above problem has also been 
implemented in SNA Server 3.0 (in sna30/hotfixes-postsp1/appc-fix), and 
will be included in SNA Server 3.0 Service Pack 2, scheduled for late 
summer 1997. 

Modules updated (for Intel systems only):

  <snaroot>\system\WAPPC32.DLL      06/24/97  12:25p 162,336 
  <ntroot>\symbols\dll\WAPPC32.DBG  06/24/97  12:25p  71,728 (symbol file)


Applying the update:
--------------------

- Copy the APPC.EXE file to a temporary directory.  Run APPC.EXE to extract
  the compressed files.

- Stop all APPC applications running on the machine

- Rename the existing APPC DLL on the SNA Server (or Windows NT client) machine:

  rename <snaroot>\system\wappc32.dll   wappc32.sp2

- Apply the updated module

  copy WAPPC32.DLL   <snaroot>\system\wappc32.dll

- for Windows NT client machines, apply the updated WAPPC32.DLL


NOTE: Symbol files (with *.DBG extension) do not need to be applied for
the updates to function. These are only needed if further troubleshooting
is required, as directed by Microsoft support personnel.

===========================================================================

DISPLAY or CNOS calls fail with UNEXPECTED_DOS_ERROR          [sna]
ID: Q170289    CREATED: 17-JUN-1997   MODIFIED: 18-JUN-1997
PRODUCT: SNA

--------------------------------------------------------------------------
The information in this article applies to:

 - Microsoft SNA Server for Windows NT, versions 2.11, 3.0
--------------------------------------------------------------------------

SYMPTOMS
========

When calling the DISPLAY or CNOS functions on Windows NT (over the SNA
Server Windows NT client software), these functions may eventually fail 
with the following error:

primary_rc = 0xF011 (UNEXPECTED_DOS_ERROR)
secondary_rc = 593 (internal error - maximum routing procs defined)


CAUSE
=====

This problem can occur when an APPC application calls WinAPPCStartup 
and WinAPPCCleanup a number of times without being terminated.  The 
APPC library registers an internal routing procedure for each call to 
WinAPPCStartup, but fails to deregister the routing procedure when the
application calls WinAPPCCleanup.  This causes the internal routing
procedure table to fill, leading to the above error.


RESOLUTION
==========

A hotfix to SNA Server 2.11 (post SP2) and 3.0 (post SP1) is available 
to correct this problem.  The updated module is WAPPC32.DLL.


STATUS
======

Microsoft has confirmed this to be a problem in SNA Server version 
2.11 (post SP2) and 3.0 (post SP1). A supported fix is now available 
for both 2.11 and 3.0, but has not been fully regression-tested and 
should be applied only to systems experiencing this specific problem. 
Unless you are severely impacted by this specific problem, Microsoft 
recommends that you wait for the next Service Pack that contains this 
fix. Contact Microsoft Product Support Services for more information.


KBCategory: kbnetwork kbbug kbprg
KBSubcategory: prodsna winappc wincpic snaprog
Additional reference words: SAS