SNAX/HLS Application Programming Manual

RECEIVE-CONTROL-WAIT Verb
SNAX/HLS Verbs
104707 Tandem Computers Incorporated 5–73
RECOVERY–TAGS
are returned to allow the requester to correlate requests, responses, and/or replies.
BOM is the SNA sequence number of the first element of the data message, and
EOM is the SNA sequence number of the last element of the data message. These
values are meaningful only when the DATA–TYPE–RECEIVED field contains a
negative value (FM header received) or one of the following values:
1 DT–PARTNER–DATA
4 DT–LU–STATUS
7 DT–MESSAGE–CANCELLED
10 DT–FLOW–CONTROL (only for QM and RT messages)
RECEIVE–DATA–QUEUED–IND
A value of Y indicates that more data is available for the user. RECEIVE–DATA
verbs complete immediately (that is, with no internal queuing) until the indicator
is N.
ENTER–SEND–STATE–IND
A value of Y indicates that the message bears the change–direction indicator. In
HDX–FF protocols, you are expected to send data after receiving this indicator.
Your partner has stopped sending and is in receive mode. If your session is using
transactions (brackets), this signal is meaningful only when
TRANSACTION–IN–PROGRESS is Y. If your session is using the large message
option (LMO), the ENTER–SEND–STATE–IND is only meaningful when
MESSAGE–COMPLETE–IND is Y.
TRANSACTION–IN–PROGRESS–IND
A value of Y indicates that you are in a transaction. If the current session PROFILE
does not support transactions (SNA brackets), the value is N. It reflects the
conditions following the receipt of the message in question. If you have just
received a partner–data message, you can use this indication to detect whether the
end–bracket flag was set on the message you just received.
When delivered along with partner–data messages, this indicator properly tracks
the transaction status of the session. When delivered as a result of
RECEIVE–CONTROL–WAIT, it should be interpreted only if
RECEIVE–DATA–QUEUED is N. In other situations, the indicator is undefined.
MESSAGE–COMPLETE–IND
A value of Y indicates that the current message in the user buffer is a complete
user message (although the message could be truncated if
RC–DATA–TRUNCATED is returned). A value of N can be returned only when using
the LMO feature and indicates that subsequent RECEIVE–DATA verbs retrieves
more elements of the session partner’s message. This field is meaningful only
when your partner’s data is being returned.