SNAX/HLS Application Programming Manual

RECEIVE-CONTROL-WAIT Verb
SNAX/HLS Verbs
5–74 104707 Tandem Computers Incorporated
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 when
delivered to your program on a subsequent RECEIVE–DATA request.
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, are
handled.
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 when the
data is delivered to your program on a subsequent RECEIVE–DATA request. 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. (Refer to Table 5-2 for a listing of the value
delivered to this field.)
DATA–TYPE–RECEIVED
is a computational value indicating the kind of data that was received. The codes
are as follows:
negative An FMH header is present in the data. The absolute value of
DATA–TYPE–RECEIVED is the type of the FMH header (for example,
–1 indicates FMH type 1, –2 indicates FMH type 2, and so on. The
special value of –128 indicates FMH type 0).
0 (Name is DT–PARTNER–DATA.) The message is from the session
partner.
1 (Name is DT–INTERRUPT–REQUEST.) The message is an interrupt
message, originating usually from the use of the MSG statement in
HLSCOM.
2 (Name is DT–SSCP–DATA.) The message is from the session
partner’s SSCP. This can occur only if the attribute has been
explicitly enabled in the WANT–SSCP–TEXT attribute of the
PROFILE.