Microsoft KB Archive/307520

From BetaArchive Wiki

Article ID: 307520

Article Last Modified on 2/22/2007



APPLIES TO

  • Microsoft Host Integration Server 2000 Standard Edition
  • Microsoft SNA Server 3.0 Service Pack 4
  • Microsoft SNA Server 4.0
  • Microsoft SNA Server 3.0 Service Pack 2
  • Microsoft SNA Server 3.0 Service Pack 3
  • Microsoft SNA Server 3.0 Service Pack 4
  • Microsoft SNA Server 4.0
  • Microsoft SNA Server 4.0 Service Pack 1
  • Microsoft SNA Server 4.0 Service Pack 2
  • Microsoft SNA Server 4.0 Service Pack 3
  • Microsoft SNA Server 4.0 Service Pack 4



This article was previously published under Q307520

SYMPTOMS

Advanced Program-to-Program Communications (APPC) or Common Programming Interface for Communications (CPI-C) applications may be unable to allocate LU 6.2 sessions. This typically occurs after the applications have been functioning normally for a long period of time.

This problem only occurs if the SNA Server or Host Integration Server (HIS) 2000 systems are using dynamic remote APPC logical units (LUs) for communications with the host system.

The exact symptoms experienced by the end users of the APPC or CPI-C applications may vary depending on the application, but the following errors are likely to be returned by the underlying SNA Server/HIS 2000 APPC and CPI-C APIs.

APPC

Primary Return Code: 0003 (AP_ALLOCATION_ERROR)

Secondary Return Code: 00000005 (AP_ALLOCATION_FAILURE_RETRY)


CPI-C

Error 20 (CM_PRODUCT_SPECIFIC_ERROR)

-or-


Error 24 (CM_PROGRAM_PARAMETER_CHECK)

CAUSE

The SNA Server service can get into a state where the internal configuration table that is used to track all APPC conversations has no more free entries. This in turn leads to the APPC or CPI-C allocation failures.

It has been determined that under certain circumstances, the SNA Server service fails to clean up entries for APPC conversations involving Dynamic Remote APPC LUs, which can eventually cause the internal configuration table to become full.

RESOLUTION

SNA Server

A supported fix is now available from Microsoft, but it is only intended to correct the problem that is described in this article. Apply it only to computers that are experiencing this specific problem. This fix may receive additional testing. Therefore, if you are not severely affected by this problem, Microsoft recommends that you wait for the next Microsoft SNA Server version 4.0 that contains this hotfix.

To resolve this problem immediately, contact Microsoft Product Support Services to obtain the fix. For a complete list of Microsoft Product Support Services phone numbers and information about support costs, visit the following Microsoft Web site:

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 typical 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 fix should have the following file attributes or later:

File name Date Time
Snaservr.exe 09/18/2001 15:04:48



NOTE: Because of file dependencies, the most recent fix that contains the preceding files may also contain additional files.

Host Integration Server 2000

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

328152 How to Obtain the Latest Host Integration Server 2000 Service Pack


STATUS

Microsoft has confirmed that this is a problem in the Microsoft products that are listed at the beginning of this article. This problem was first corrected in Host Integration Server 2000 Service Pack 1.

MORE INFORMATION

Note that the APPC and CPI-C errors noted in the "Symptoms" section of this article are common errors that can also occur for reasons other than the ones described in this article.

For additional information about other problems that can cause similar symptoms, click the article number below to view the article in the Microsoft Knowledge Base:

307601 Unable To Allocate LU 6.2 Sessions Using Dependent APPC LUs



Additional query words: HIS 2000

Keywords: kbbug kbfix kbhostintegserv2000sp1fix kbhostintegserv2000presp1fix KB307520