Microsoft KB Archive/942896

= Error message in the Host Access Management Agent Configuration Tool when you try to connect to an IBM mainframe server that supports only the TN3270 protocol: &quot;COM3270 returned an unrecognized error code: 263182&quot; =

Article ID: 942896

Article Last Modified on 10/24/2007

-

APPLIES TO


 * Microsoft Identity Integration Server 2003 Host Access Management Agent Feature Pack 1

-



SYMPTOMS
Consider the following scenario:
 * You configure a logon script to connect to an IBM mainframe server by using a TN3270 connection.
 * The IBM mainframe server supports only the TN3270 protocol.

In this scenario, the Host Access Management Agent Configuration Tool (HostConfig.exe) returns the following error message:

Error logging in: COM3270 returned an unrecognized error code: 263182

Notes
 * This problem occurs if you have Host Access Management Agent Feature Pack 3 for Microsoft Identity Integration Server 2003 installed.
 * This problem does not occur when you try to connect to an IBM mainframe server that supports the TN3270E protocol.



CAUSE
The Host Access Management Agent (HAMA) does not check for an internal return code that indicates that the connection to the IBM mainframe server is using the TN3270 protocol. The HAMA checks only for the return code that indicates that a TN3270E connection is being used.



Hotfix information
A supported hotfix is now available from Microsoft. However, it is intended to correct only the problem that is described in this article. Apply it only 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 Access Management Agent that contains this hotfix.

To resolve this problem immediately, contact Microsoft Customer Support Services to obtain the hotfix. For a complete list of Microsoft Customer 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.

Prerequisites
Before you install Host Access Management Agent Feature Pack 3, you must have Microsoft Identity Integration Server 2003 Service Pack 2 (SP2) or Microsoft Identity Lifecycle Manager 2007 installed.

Restart requirement
You do not have to restart the computer after you apply this hotfix.

Hotfix replacement information
This hotfix does not replace any other hotfixes.

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 item in Control Panel.



STATUS
Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the &quot;Applies to&quot; section.



MORE INFORMATION
After you install this hotfix, the Host Access Management Agent Configuration Tool can establish a connection to servers that use either the TN3270 protocol or the TN3270E protocol.

For more information about the TN3270E protocol, visit the following ISOC Web sites:

http://www.faqs.org/rfcs/rfc1647.html

http://www.faqs.org/rfcs/rfc2355.html

Microsoft provides third-party contact information to help you find technical support. This contact information may change without notice. Microsoft does not guarantee the accuracy of this third-party contact information.

For more information, 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

The third-party products that this article discusses are manufactured by companies that are independent of Microsoft. Microsoft makes no warranty, implied or otherwise, about the performance or reliability of these products.

Keywords: kbexpertiseinter kbexpertiseadvanced kbbug kbfix kbhotfixserver kbqfe kbpubtypekc KB942896

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.