SNAX/HLS Application Programming Manual

SEND-DATA-Verb
SNAX/HLS Verbs
104707 Tandem Computers Incorporated 5–103
USER–DATA–S
is the text of the message to send. The message is not inspected in any way
(control characters, binary text, and so on can be sent). However, if the message is
being translated (see PROFILE TRANSLATE attribute), unexpected results might
occur if binary data is translated. Note that the Format Header portion of a
message is never translated.
The maximum (<max>) value of this field is a value you determine. It reflects the
largest number of bytes of data that your application can give to SNAX/HLS to
send in one issuance of these verbs. That is, it is the largest value you will use in
the USER–DATA–LENGTH field.
Reply Details
VERB–CODE
identifies the reply by an integer constant (of value 7), named as follows:
VERB–SEND–DATA (in SCOBOL)
VERB^SEND^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 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
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.