FIX: The SNA Manage Agent service logs Event 5166 and Event 5167 when you change the configuration of an active connection in SNA Manager (906105)

SYMPTOMS

When you are an administrator for Microsoft Host Integration Server, and you change the configuration of an active connection in SNA Manager, the SNA Manage Agent (Mngagent.exe) service logs the following event messages: Event ID: 5167
Source: SNA Manage Agent
Type: Error
Description: An internal error has occurred in the mngsna module - Dynamic update for 3270 LU failed.

Event ID: 5166
Source: SNA Manage Agent
Type: Error
Description: An internal error has occurred in the snaadmin module - Received an error in dynamic update response - update failed. Although the SNA Manage Agent service logs these event messages, SNA Manager correctly saves the configuration changes and updates the SNA Server service to "Out of Date" status. Additionally, when you restart the SNA Server service, the changes are correctly implemented.

CAUSE

SNA Manager sends dynamic updates to the SNA Server service (Snaservr.exe) when you make configuration changes. However, the SNA Server service cannot dynamically update an active connection. Therefore, the SNA Server service returns error messages to the Host Integration Server management components. These error messages indicate that the dynamic updates have failed.

The SNA Manage Agent service also returns an incorrect string for the Event 5167 description. The string always reports that a dynamic update for a 3270 logical Unit (LU) has failed, regardless of whether the configuration change affects a 3270 LU.

RESOLUTION

Hotfix information

A supported hotfix is now available from Microsoft, but it is only intended to correct the problem that is described in this article. Only apply it to systems that are experiencing this specific problem. This hotfix may receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next Host Integration Server 2000 service pack that contains this hotfix.

To resolve this problem immediately, contact Microsoft Product Support Services to obtain the hotfix. For a complete list of Microsoft Product Support Services telephone numbers and information about support costs, visit the following Microsoft Web site:

http://support.microsoft.com/contactus/?ws=support

Note In special cases, charges that are ordinarily incurred for support calls may be canceled if a Microsoft Support Professional determines that a specific update will resolve your problem. The usual support costs will apply to additional support questions and issues that do not qualify for the specific update in question.

File information

The English version of this hotfix has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time tool in Control Panel.

   Date         Time   Version     Size     File name
   -----------------------------------------------------
   20-Sep-2005  23:06  5.0.0.2079  114,960  Mngsna.dll
   20-Sep-2005  23:06  5.0.0.2079  340,240  Snaadmin.dll

Note Because of file dependencies, the most recent hotfix that contains these files may contain additional files.

MORE INFORMATION

After you apply the hotfix, the SNA Manage Agent will log one Event 5167 message that is similar to the following when you change the configuration of an active connection: Event ID: 5167
Source: SNA Manage Agent
Type: Information
Description: An internal error has occurred in the mngsna module - Dynamic update for connection failed because the connection is active...The severity of the message Type has been changed from Error to Information to better reflect the actual severity of the event. Additionally, the description of the event has been updated to correctly indicate that a dynamic update failed because the connection is active.

For more information about software update terminology, click the following article number to view the article in the Microsoft Knowledge Base:

824684 Description of the standard terminology that is used to describe Microsoft software updates