SNAX/HLS Application Programming Manual

RECEIVE DATA Verb
SNAX/HLS Verbs
104707 Tandem Computers Incorporated 5–83
Request Details
VERB–CODE
identifies the request by an integer constant (of value 7), named as follows:
VERB–RECEIVE–DATA (in SCOBOL)
VERB^RECEIVE^DATA (in TAL)
SESSION–ID
identifies this session. SNAX/HLS generates a session ID in response to an
OPEN–SESSION or an HLS–ALLOCATE verb.
Reply Details
VERB–CODE
identifies the reply by an integer constant (of value 7), named as follows:
VERB–RECEIVE–DATA (in SCOBOL)
VERB^RECEIVE^DATA (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. If the RETURN–CODE is one of the
following, the response fields starting with RECOVERY–TAGS are undefined:
RC–INVALID–SESSION–ID RC–INVALID–VERB
RC–SESSION–FAILURE RC–INVALID–VERB–LENGTH
RC–SESSION–NOT–ALLOCATED RC–RCWT–ALREADY–QUEUED
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.