SNAX/HLS Application Programming Manual

RECEIVE-CONTROL Verb
SNAX/HLS Verbs
5–60 104707 Tandem Computers Incorporated
Reply Details
VERB–CODE
identifies the reply by an integer constant (of value 4), named as follows:
VERB–RECEIVE–CONTROL (in SCOBOL)
VERB^RECEIVE^CONTROL (in TAL)
SESSION–ID
identifies the session.
RETURN–CODE
is a computational (that is, binary) field that indicates the success or failure of the
operation requested. The return condition of RC–OK indicates success. The
possible error responses are explained below. See Appendix A of the SNAX/HLS
Diagnosis and Support Manual for more information on error codes.
SYSTEM–ERROR–CODE
is a modifier to RETURN–CODE:
If RETURN–CODE specifies RC–SYNTAX–ERROR, this identifies the field in error
by counting each field following the SESSION–ID field. For example, a value
of 1 indicates that the first field following the SESSION–ID field is in error.
If RETURN–CODE contains either RC–SEND–CHECK, RC–SESSION–FAILURE,
or RC–REQUEST–REJECT, then this field contains the first 2 bytes of the SNA
sense data. The next two follow in the USER–ERROR–CODE field.
If RETURN–CODE contains any value other than those listed above, this field is
undefined and should not be analyzed.
USER–ERROR–CODE
contains the second two bytes of SNA sense data if the SYSTEM-ERROR-CODE
contains the first two bytes of SNA sense data.
RETRY–ACTION–CODE
is a summary indicator that indicates whether an unsuccessful request should be
retried. The value returned here can be installation–defined.