HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_TEST_RTS and TEST_RTS
primary_rc
New state
AP_ALLOCATION_ERROR
Reset
AP_CONV_FAILURE_RETRY
AP_CONV_FAILURE_NO_RETRY
AP_CONVERSATION_ENDED
Reset
AP_DEALLOC_ABEND
AP_DEALLOC_ABEND_PROG
AP_DEALLOC_ABEND_SVC
AP_DEALLOC_ABEND_TIMER
Reset
4.18.7 Waiting for Partner TP
In the same way as for [MC_]SEND_DATA, the [MC_]SEND_EXPEDITED_DATA verb may wait indefinitely
because the partner TP has not issued an [MC_]RECEIVE_EXPEDITED_DATA verb. This is because the send-
expedited buffer may fill up and APPC cannot transmit its contents to the partner LU because the partner LU has
no buffers to receive the data.
4.19 MC_TEST_RTS and TEST_RTS
The MC_TEST_RTS or TEST_RTS verb determines whether a REQUEST_TO_SEND notification has been received
from the partner TP.
Note
This verb can be used only in a half-duplex conversation; it is not valid in a full-duplex
conversation.
Normally, if the partner TP issues an [MC_]REQUEST_TO_SEND verb, the local TP will be notified of this by the
rts_rcvd parameter on a subsequent verb (this is a received parameter on a number of verbs). This is only reported
on the first subsequent verb which can return this parameter, and not on any later verb. The [MC_]TEST_RTS verb
enables the local TP to check if a request-to-send notification has been received at any time since the local TP was
last in Receive state.
Instead of repeatedly issuing [MC_]TEST_RTS, the application can use [MC_]TEST_RTS_AND_POST, which is
described in Section 4.20, MC_TEST_RTS_AND_POST and TEST_RTS_AND_POST. This verb returns asynchro-
nously when a REQUEST_TO_SEND notification is received from the partner TP. [MC_]TEST_RTS_AND_POST
operates asynchronously in the same way as [MC_]RECEIVE_AND_POST, so that the application can issue other
APPC verbs while it is outstanding.
WINDOWS
[MC_]TEST_RTS_AND_POST is supported on Win32 systems, but not on Win16 systems.
4.19.1 VCB Structure: MC_TEST_RTS
UNIX
The definition of the VCB structure for the MC_TEST_RTS verb is as follows:
238