Error 2156 Occurs When Running COMTI Application (329669)


The information in this article applies to:

  • Microsoft Host Integration Server 2000
This article was previously published under Q329669
NOTE: This also applies to Host Integration Server 2000 Service Pack 1 (SP1).

SYMPTOMS

If you run a COM Transaction Integrator (COMTI) application in a system that is configured to use TCP/IP, and if the COMTI Remote Environment (RE) uses a Host Security Domain for Single Sign-On (SSO) support to send security information to the host through the use of a Host Account Cache, you may receive the following error message:
COMTI Automation Exception

Source: COMTI Component
Error Number: 2156 (0x86C)

Description: (2156) The TCP transport detected a Host Security request that is being made on a SNA client install which is not allowed. Set security off or use application override security and try the operation again.
When the problem occurs, the following is logged in the Application Event Log:
Event ID: 102
Source: COMTI
Description: (102) COM Transaction Integrator reported the following exception to the client:

Component: COMTI Component
Method: COMTI Method

Exception description:
(2156) The TCP transport detected a Host Security request that is being made on a SNA client install which is not allowed. Set security off or use application override security and try the operation again.

EXPLANATION
An Automation exception representing an error condition was returned to a COM Transaction Integrator client. The description shown above contains more information about the exception that was reported.

ACTION
The exception may be caused by communication problems or errors in your host application. See the exception description for corrective actions.
This problem does not occur if both of the following circumstances exist:
  • The COMTI RE is configured for Allow application to override selected authentication.
  • The client application is programmed to use Explicit Security.

CAUSE

COMTI must load the Host Security DLL (Snasii.dll) to use SSO for TCP/IP connections. COMTI loads Snasii.dll only if the SNAServiceType registry value is equal to 0x1d (Decimal 29). If SNAServiceType has any other value, you receive the errors described in "Symptoms" when you run a COMTI application.

RESOLUTION

To resolve this problem, change the SNAServiceType registry value.

WARNING: If you use Registry Editor incorrectly, you may cause serious problems that may require you to reinstall your operating system. Microsoft cannot guarantee that you can solve problems that result from using Registry Editor incorrectly. Use Registry Editor at your own risk.
  1. Start Registry Editor.
  2. Locate and then click the SNAServiceType value under the following key in the registry:

    HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\SnaBase\Parameters

  3. On the Edit menu, click DWORD, type 1d, and then click OK.
  4. Quit Registry Editor.

STATUS

Microsoft has confirmed that this is a problem in Host Integration Server 2000 and Host Integration Server 2000 SP1.

MORE INFORMATION

The COMTI runtime components can be installed only by means of the Host Integration Server 2000 server package (HiServer.msi).

Installing Only the COMTI Components

If you want to install only the COMTI components, you can do a nodeless or client install of the Host Integration Server 2000 server package. To do this, follow these steps:
  1. Install only the Application Integration feature during the installation of Host Integration Server 2000.Change all the other Host Integration Server 2000 features to Entire feature will be unavailable.
  2. Change all the other Host Integration Server 2000 features to Entire feature will be unavailable.

Running SNA Resource Location Wizard After Nodeless Install

If you run the SNA Resource Location Wizard (Hisvrcfg.exe) after you do a nodeless or client install of the HiServer.msi package, the SNAServiceType registry value is changed from (the correct value) 0x1d to 0x1c. This change results in the symptoms described earlier in this article.

SNA Application Support

Installing During a Nodeless Install

If you install the SNA Application Support feature during a nodeless or client install of the HiServer.msi package, the SNA Resource Location Wizard is run at the end of the installation process. You do not need the SNA Application Support feature when doing a nodeless or client install for COMTI support.

However, if you do install this feature, do not install the SNA Service feature (available as an option under SNA Application Support). The SNA Service feature is used to install SNA services, such as the SNA Server service, and you do not need SNA services for COMTI-only installations.

Not Installing During a Nodeless Install

If you do not install the SNA Application Support feature during a nodeless or client install of the HiServer.msi package, the SNA Resource Location Wizard does not run at the end of the installation process. You can find the SNA Resource Location Wizard on the Host Integration Server Applications and Tools menu. If you run the wizard manually, it causes the SNAServiceType registry value to be changed to 0x1c (from the correct value of 0x1d).
Modification Type:MinorLast Reviewed:4/13/2005
Keywords:kbBug kbnofix KB329669
©2004 Microsoft Corporation. All rights reserved.