SNAX/HLS Application Programming Manual

RECEIVE DATA Verb
SNAX/HLS Verbs
104707 Tandem Computers Incorporated 5–85
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 or 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 retrieve
more elements of the session partner’s message. This field is meaningful only
when partner data is being returned.
DEFINITE–RESPONSE–IND
is a single–character numeric field that indicates the kind of response the partner is
expecting for this request. For those who know SNA, it reflects the setting of the
DR1I and DR2I indicators at the end of the incoming request (that is, end of chain).
If the PROFILE attribute, ENCODE–ERI, is set to TRUE, the setting of the ERI
indicator is also indicated.
A returned value of 0 indicates that no response is needed for the data being
delivered to your program. SNAX/HLS automatically takes care of all responses
for messages other than normal partner data. Thus, a value of 0 indicates that
responses, if needed, have been taken care of.
A returned value of other than 0 can occur only when the
DATA–TYPE–RECEIVED field indicates DT–PARTNER–DATA or FM–header
data. The actual value returned is derived from the DR and ER bits in one of two
ways depending upon whether the ENCODE–ERI attribute has been enabled or
disabled. The particular value has significance only as defined by the application.
It indicates what type of response was requested with the message. If your
PROFILE indicates that SNAX/HLS is handling responses (
USER–RESPONSES is NO), this field is for information only. On the other hand, if
USER–RESPONSES is YES, a value other than 0 in DEFINITE–RESPONSE–IND
indicates that SNAX/HLS expects your application to issue an HLS–RESPOND
verb. If the original request was an exception–response request and your
application is controlling responses, you have to issue the HLS–RESPOND verb
even though no response flows to the partner.