FIX: You receive the "The service called SNABASE is not configured in the registry as an SNA service" error message after you start an SNA Server application on a Host Integration Server 2004 Client (892936)


The information in this article applies to:

  • Microsoft Host Integration Server 2004

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:
Host Integration Server - ERROR # 1000
The service called SNABASE is not configured in the registry as an SNA service
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:
Error
ERROR - The SnaBase Service is not started.
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, 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 2004 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.

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:
  1. Create a share, and then copy the Host Integration Server 2004 Image to this share.
  2. In the following location, replace the existing HISConfig.dll file with the updated HISConfig.dll file:

    \MSI\Client\PFiles\system

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

  4. 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:
  1. Open a Command Prompt window. For example, click Start, click Run, type cmd.exe, and then click OK.
  2. Type the following command at the command prompt:

    at <time> /interactive cmd.exe

    Note This command opens a Command Prompt window that uses the LocalSystem account.
  3. 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.
Modification Type:MajorLast Reviewed:10/18/2005
Keywords:kbQFE kbfix kbbug KB892936 kbAudITPRO kbAudDeveloper
©2004 Microsoft Corporation. All rights reserved.