SNAX/HLS Application Programming Manual

SEND-STATUS Verb
SNAX/HLS Verbs
5–108 104707 Tandem Computers Incorporated
preface for the interpretation of these bytes. A value of %H0000 always means
that USER–ERROR–CODE contains session–partner–specific data.
USER–ERROR–CODE
Place the second 2 bytes of the LUSTAT to be sent to the session partner in this
field. The field is not inspected in any way and is not translated regardless of
the PROFILE TRANSLATE attribute.
Reply Details
VERB–CODE
identifies the reply by an integer constant (of value 8), named as follows:
VERB–SEND–STATUS (in SCOBOL)
VERB^SEND^STATUS (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 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.