Microsoft KB Archive/838558

From BetaArchive Wiki

Article ID: 838558

Article Last Modified on 6/5/2006



APPLIES TO

  • Microsoft Host Integration Server 2000 Standard Edition
  • Microsoft Host Integration Server 2000 Service Pack 1



SYMPTOMS

A computer that is running Microsoft Host Integration Server 2000 logs the following error message in the application event log every 6 minutes if the Systems Network Architecture (SNA) Manage Client application (Mngcli.exe) cannot be started by the Host Integration Server 2000 Windows Management Instrumentation (WMI) provider:


Event ID: 5149
Source: SNA Manage Agent
Description: Manage base error - error in accessing the domain table. The local domain name is not valid

CAUSE

This problem occurs when the Host Integration Server 2000 WMI provider runs under a user context that does not have Read, Execute, and List permissions to every folder in the path where Mngcli.exe is located (For example, C:\Program Files\Host Integration Server\System). When the WMI provider runs under this user context, Mngcli.exe cannot be started and an "Event 5149" error message is logged.

RESOLUTION

Service pack information

To resolve this problem, obtain the latest service pack for Microsoft Host Integration Server 2000. For more information, click the following article number to view the article in the Microsoft Knowledge Base:

328152 How to obtain the latest service pack for Host Integration Server 2000


Hotfix information

The English version of this hotfix has the file attributes (or later) 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
   ----------------------------------------------------
   11-Mar-2004  03:10  5.0.0.967  114,960  Mngbase.dll
   11-Mar-2004  03:10  5.0.0.967  102,672  Mngagent.exe
   11-Mar-2004  03:10  5.0.0.967  102,672  Mngcli.exe


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


WORKAROUND

To work around this problem, add the following permissions to the user account that the Host Integration Server 2000 WMI provider is running under. You must add these permissions to each folder in the path of Mngcli.exe:

  • Read & Execute
  • List Folder Contents
  • Read


STATUS

Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section.

This problem was corrected in Microsoft Host Integration Server 2000 Service Pack 2.

MORE INFORMATION

If an application sends a WMI query to a Host Integration Server 2000 system, the Host Integration Server 2000 WMI provider will try to start the SNA Manage Client application if it is not started. The SNA Manage Client application starts by calling the CreateProcess API. The first parameter that is passed to the CreateProcess API is the name of the application that will be started. The path of the SNA Manage Client application is also included in this parameter. The path of the SNA Manage Client application is read from the following registry location:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Sna Server\CurrentVersion\PathName


When the path of the SNA Manage Client application is read from the registry, the GetShortPathName Win32 API is called to obtain the short path name. If the full path to Mgcli.exe is C:\Program Files\Host Integration Server\System\Mngcli.exe, the GetShortPathName API would return the following path name as the short path name:

C:\PROGRA~1\HOSTIN~1\System\Mngcli.exe


The user account that calls the GetShortPathName API requires Read, Execute, and List permissions on every folder in the path that it receives from the calling application. For example, if the path is C:\Program Files\Host Integration Server\System\Mngcli.exe, the user account that called GetShortPathName would require the specified permissions on each of the following folders:

  • C:\
  • Program Files
  • Host Integration Server
  • System

This hotfix removes the call to the GetShortPathName API when the SNA Manage Client application starts. The CreateProcess API accepts a long path and long file names so that you do not have to use a short path and a short file name.

Keywords: kbbug kbfix kbhostintegserv2000presp2fix kbqfe kbhotfixserver KB838558