DEACTIVATE_SESSION Returns Parameter_Check If No Sessions Are Active (282461)



The information in this article applies to:

  • Microsoft SNA Server 4.0 SP2
  • Microsoft SNA Server 4.0 SP3
  • Microsoft SNA Server 4.0 SP4
  • Microsoft Host Integration Server 2000

This article was previously published under Q282461

SUMMARY

The DEACTIVATE_SESSION verb requests SNA Server or Host Integration Server (HIS) 2000 to deactivate a particular Advanced Program-to-Program Communications (APPC) session between the local APPC Logical Unit (LU) and a specified partner APPC LU, or all active sessions on a particular mode. To indicate that all of the active sessions for a specified partner APPC LU and APPC mode should be deactivated, the session_id parameter should be set to 8 binary zeros (00000000) in the DEACTIVATE_SESSION verb.

If an APPC application issues a DEACTIVATE_SESSION verb to deactivate all of the active sessions when there are no active sessions, the verb completes with the following error message:
Primary Return Code: AP_PARAMETER_CHECK
Secondary Return Code: AP_INVALID_SESSION_ID
This behavior is by design because the session_id is invalid if there are no active sessions to deactivate.

Other SNA platforms don't return an error when a DEACTIVATE_SESSION verb is issued under the same scenario; the other SNA platforms return a primary return code of OK in this situation.

This behavior of SNA Server has been modified so that the DEACTIVATE_SESSION verb returns with a primary return code of OK when it tries to deactivate all active sessions for a given partner LU/mode even if there are no active sessions at the time.

Please refer to the APPC Programmer's Guide in the SNA Server 4.0 Service Pack 2 (SP2) (or later) or Host Integration Server 2000 Software Development Kit (SDK) for more information on the DEACTIVATE_SESSION verb.

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

MORE INFORMATION

A supported feature that modifies the product's default behavior is now available from Microsoft, but it is only intended to modify the behavior that this article describes. Apply it only to systems that specifically require it. This feature may receive additional testing. Therefore, if the system is not severely affected by the lack of this feature, we recommend that you wait for the next Microsoft SNA Server version 4.0 service pack that contains this feature.

To obtain this feature immediately, contact Microsoft Product Support Services. For a complete list of Microsoft Product Support Services telephone numbers and information about support costs, visit the following Microsoft Web site: The English version of this feature should have the following file attributes or later:

File nameDateTime
Snaservr.exe12/18/200009:00AM

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


Modification Type:MajorLast Reviewed:10/21/2005
Keywords:kbhis2000fix kbHostIntegServ2000preSP1fix kbHostIntegServ2000SP1fix kbinfo KB282461