Article ID: 892936
Article Last Modified on 12/4/2007
APPLIES TO
- Microsoft Host Integration Server 2004 Standard Edition
SYMPTOMS
After you start a Microsoft SNA Server application such as the 3270 Client (Win3270.exe) on a Microsoft Host Integration Server 2004 Client, you receive the following error message:
This problem occurs when you install and configure the Host Integration Server 2004 Client by using Microsoft Systems Management Server (SMS) software distribution packages.
You may receive additional error messages when this problem occurs. For example, you receive the following error messages after you start the 3270 Client:
Note You receive these error messages when you start an SNA Server application if you did not run the Host Integration Server 2004 Configuration Wizard after you installed the Host Integration Server 2004 Client.
CAUSE
This problem occurs because the Host Integration Server 2004 Configuration Wizard incorrectly checks whether the local computer account is a member of the local Administrators group when the LocalSystem account starts the ConfigFramework.exe file.
RESOLUTION
A supported hotfix is now available from Microsoft. However, this hotfix is intended to correct only the problem that is described in this article. Apply this hotfix only to systems that are experiencing this specific problem. This hotfix might receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next service pack that contains this hotfix.
To resolve this problem, submit a request to Microsoft Online Customer Services to obtain the hotfix. To submit an online request to obtain the hotfix, visit the following Microsoft Web site:
Note If additional issues occur or any troubleshooting is required, you might have to create a separate service request. The usual support costs will apply to additional support questions and issues that do not qualify for this specific hotfix. To create a separate service request, visit the following Microsoft Web site:
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 ------------------------------------------------------ 16-Feb-2005 21:58 6.0.1937.0 163,328 Hisconfig.dll
Note Because of file dependencies, the most recent fix that contains these files may also contain additional files.
STATUS
Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section.
MORE INFORMATION
The Host Integration Server 2004 Configuration Wizard obtains the user name of the user who runs the ConfigFramework.exe file. When an SMS distribution package is used to run the ConfigFramework.exe file, the LocalSystem account starts the ConfigFramework.exe file. The user name that is returned to the Configuration Wizard when the LocalSystem account starts a process is the local computer account. The Configuration Wizard checks whether the local computer account is a member of the local Administrators group. By default, this check fails because the local computer account is not a member of the local Administrators group.
After you apply this hotfix, the Configuration Wizard can successfully configure the Host Integration Server 2004 Client when the LocalSystem account starts the ConfigFrameWork.exe file.
To apply this hotfix, follow these steps:
- Create a share, and then copy the Host Integration Server 2004 Image to this share.
- In the following location, replace the existing HISConfig.dll file with the updated HISConfig.dll file:
\MSI\Client\PFiles\system
- Create an SMS distribution package to install the Host Integration Server 2004 Client from this share.
Note To perform an unattended installation of the Host Integration Server 2004 Client, type the following command at a command prompt:setup.exe /product hisc /installplatform /l c:\hisinstall.log /s c:\ hisclientconfig.xml /installdir c:\his
- Create an SMS distribution package to configure the Host Integration Server 2004 Client.
Note To perform an unattended configuration of the Host Integration Server 2004 Client, type the following command at a command prompt:configframework.exe /l c:\configframework.log /f /s c:\hisclientconfig.xml
Steps to reproduce the problem
This problem can also be reproduced without using SMS distribution packages. To do this, follow these steps:
- Open a Command Prompt window. For example, click Start, click Run, type cmd.exe, and then click OK.
- Type the following command at the command prompt:
Note This command opens a Command Prompt window that uses the LocalSystem account.
at
- To perform an unattended configuration of a Host Integration Server 2004 Client, type a command that is similar to the following at the command prompt:
configframework.exe /l c:\configframework.log /f /s c:\hisclientconfig.xml
When the ConfigFramework.exe file runs under the LocalSystem account, the configuration log file that results contains data that is similar to the following:
The current user is: HISDOMAIN\HISCLIENT1$ computer name: HISCLIENT1 OS Version: 5.1.2600 Service Pack: 2.0 Suite: 256 Product Type: 1 [data omitted for brevity] [12:45:29 PM Info ConfigHelper] HISDOMAIN\HISCLIENT1$ is not a member of Group: Administrators. [12:45:29 PM Info ConfigHelper] HISDOMAIN\HISCLIENT1$ is not an administrator on this computer. [data omitted for brevity] [12:45:30 PM Info ConfigHelper] HISDOMAIN\HISCLIENT1$ is not a member of Group: Administrators. [12:45:30 PM Info ConfigHelper] HISDOMAIN\HISCLIENT1$ is not an administrator on this computer.
Additional query words: HIS2004 HIS unattend
Keywords: kbbug kbfix kbqfe kbhotfixserver KB892936
