RUI_TERM Fails to Return When lua_resv56[2] Is Set in RUI_INIT

• Microsoft SNA Server, versions 3.0, 3.0 SP1, 3.0 SP2, 4.0

SYMPTOMS

An RUI (LUA)-based application may not be able to establish a session between SSCP and a specified LU using RUI_INIT after previously issuing an RUI_TERM on the same LU. The RUI_INIT request may return with a STATE_CHECK_DUPLICATE-RUI_INIT message, which can be observed in an SNA LUA API trace. The symptoms described here may occur when you use either the 16- bit or 32-bit version of the WINRUI libraries.

CAUSE

The RUI_TERM does not work correctly when the lua_resv56[2] option is set in the RUI_INIT. Setting lua_resv56[2] to a non-zero value means that the RUI library will not drop the LU-SSCP connection to the node unless the application specifically asks it to do so by issuing an RUI_TERM.

WORKAROUND

The RUI application should set all reserved bits in the verb control block to NULL prior to calling the RUI interface, unless specific bits are purposely being set in the lua_resv56 byte when calling RUI_INIT.

STATUS

Microsoft has confirmed this to be a problem in SNA Server versions 3.0, 3.0 Service Pack 1, 3.0 Service Pack 2, and 4.0. A supported fix is now available, but has not been fully regression-tested and should be applied only to systems experiencing this specific problem. Unless you are severely impacted by this specific problem, Microsoft recommends that you wait for the next Service Pack that contains this fix. Contact Microsoft Product Support Services for more information.

Keywords          : kbbug3.00 kbbug3.00.sp1 prodsna snalua snaprog kbbug3.00.sp2 kbbug4.00
Version           : WINDOWS:3.0,3.0SP1,3.0SP2,4.0
Platform          : WINDOWS
Issue type        : kbbug
Solution Type     : kbfix