Article ID: 167315
Article Last Modified on 6/24/2004
APPLIES TO
- Microsoft SNA Server 2.0
- Microsoft SNA Server 2.1
- Microsoft SNA Server 2.11 Service Pack 2
- Microsoft SNA Server 4.0
This article was previously published under Q167315
SYMPTOMS
LUA applications that transmit application messages with the RH's Queued Response Indicator (QRI) flag set may stop responding when communicating to a client application through SNA server. When you step through and trace the problem, the LUA application may show a message being correctly received with the QR flag = 1 in the RH header. In the response, the QR flag is set to 1 prior to calling the SNA RUI libraries, but when it is transmitted to the host, the QR flag = 0.
CAUSE
The LUA library provided with SNA Server was not designed to use the Queued Response Indicator (QRI) field. The "SNA Server LUA Programmer's Guide" contains the following design specification for the RUI libraries:
lua_rh: Returned parameter. Contains the SNA request/response header (RH) of the message sent or received. For the RH for RUI_WRITE, all fields except the queued-response indicator (lua_rh.qri) and pacing indicator (lua_rh.pi) are used.
STATUS
Microsoft has confirmed this to be a problem in SNA Server versions 2.0, 2.1, 2.11 SP2, 3.0 and 3.0 SP1.
This problem was corrected in the latest SNA Server version 3.0 U.S. Service Pack. For information on obtaining this Service Pack, query on the following word in the Microsoft Knowledge Base (without the spaces):
S E R V P A C K
A supported fix for SNA Server version 2.1, 2.1, and 2.11 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 Technical Support for more information.
MORE INFORMATION
In a response header for a normal-flow RU, the queued response indicator (QRI) denotes whether the response is to be enqueued in TC queues (QRI=QR), or whether it is to bypass these queues (QRI=[ASCII 172]QR). In a request header for a normal-flow RU, it indicates what the setting of the QRI should be on the response, if any, to this request (that is, the values on the request and response are the same).
For expedited-flow RUs, this bit is reserved. The setting of the QRI bit is the same for all RUs in a chain.
This symptom is demonstrated in the following trace:
DLC ---------------------------------------------- 12:10:29.17
DLC 01160001->03020201 DLC DATA
DLC DAF:01 OAF:01 ODAI:off Normal
DLC RQD FMD BC EC DR1 QR PI BB EB <<< QR set
DLC
DLC ---- Header at address 00D14550, 1 elements ----
DLC 02022439 00012C00 01010001 01007000 <..$9..,.......p.>
DLC
DLC ---- Element at address 0120D6C8, start 10, end 18 ----
DLC 0383C0F1 1C1C1CF2 03 <.c.1...2. >
DLC ---------------------------------------------- 12:10:29.20
DLC 03020201->01160001 DLC DATA
DLC DAF:01 OAF:01 ODAI:off Normal
DLC +RSP FMD BC EC PI
DLC
DLC ---- Header at address 00D142E0, 1 elements ----
DLC 02050201 E0002C00 01010000 01007000 <......,.......p.>
DLC
DLC ---- Element at address 0120A374, start 10, end 12 ----
DLC 830100 <c.. >
DLC ---------------------------------------------- 12:10:29.26
DLC 03020201->01160001 DLC DATA
DLC DAF:01 OAF:01 ODAI:off Normal
DLC +RSP FMD BC EC DR1 <<< QR not set
DLC
DLC ---- Header at address 00D14550, 1 elements ----
DLC 04020102 00002C00 01010001 01007000 <......,.......p.>
DLC
DLC ---- Element at address 0120D6C8, start 10, end 12 ----
DLC 838000 <c.. >
DLC ---------------------------------------------- 12:10:50.12
In the fix referenced above, SNA Server RUI libraries and SNA server service components were changed to ensure the correct setting for the QRI bit flows over SNA messages exchanged between clients and the host.
Keywords: kbbug kbfix kbnetwork KB167315
