SNAX/HLS Application Programming Manual

RECEIVE-CONTROL-WAIT Verb
SNAX/HLS Verbs
104707 Tandem Computers Incorporated 5–75
3 (Name is DT–PREPARED–TO–CLOSE.) The session partner is
prepared for session termination.
4 (Name is DT–LU–STATUS.) LUSTAT has been received from the
session partner. This might indicate SNA information or session–
partner unique information.
5 (Name is DT–SIGNAL.) The session partner has sent an SNA SIG
message. This normally indicates that the session partner wishes to
enter send state (you are expected to set
PREPARE–TO–RECEIVE–IND on a subsequent send verb when
convenient).
6 (Name is DT–REQUEST–CLOSE.) The session partner demands that
you issue a CLOSE–SESSION verb.
7 (Name is DT–MESSAGE–CANCELLED.) The session partner has
canceled the current message. This value can be delivered only
under the LMO is Y condition. The current message is to be
disregarded.
8 (Name is DT–BIND–CINIT–DATA.) The session has just been
established. This message is delivered only if you specify the
WANT–BIND–DATA attribute as USER–DATA or ALL in the PROFILE
(see Section 4 of the SNAX/HLS Configuration and Control Manual),
and either a BIND or CINIT request was received. This message is
never received by applications that are establishing primary–acquire
sessions.
If you specify WANT–BIND–DATA as USER–DATA,
USER–DATA–LENGTH indicates the size of the user–data area on the
BIND or CINIT message; a value of 0 is possible.
If you specify WANT–BIND–DATA as ALL, the USER–DATA–LENGTH
indicates the length of the user text, requester–ID, and password
fields plus the three bytes. The minimum value is 3.
The USER–DATA–S field contains the following:
Length of requester–ID field (1 byte, value in binary)
Requester–ID field (in ASCII)
Length of password field (1 byte, value in binary)
Password field (in ASCII)
Length of user–text field (1 byte, value in binary)
User text (in ASCII)
This message is, in general, the first message your program receives.
It even precedes a response to HLS–OPEN in queued completion
mode. The only messages that might precede it are interrupt
messages.