SNAX/HLS Application Programming Manual

HLS RESPOND Verb
SNAX/HLS Verbs
104707 Tandem Computers Incorporated 5–45
MESSAGE–TAG
contains the message tag that identifies which original request is being answered.
The original reply with which your application received the data bore two tag
values in the RECOVERY–TAGS field. Although any value contained between the
BOM and EOM values identifies the request, SNAX/HLS converts your value to
the EOM value, which is the conventional way to identify messages. However, if
the response is negative, no such conversion takes place.
SENSE–TEXT
contains the 4 sense bytes to be transmitted. Note that the field is defined to allow
any binary values to be placed in the field. The field is meaningful only on
negative responses. You can also name the field SENSE–DATA and thereby store
binary zeros.
Reply Details
VERB–CODE
identifies the reply by an integer constant (of value 18), named as follows:
VERB–HLS–RESPOND (in SCOBOL)
VERB^HLS^RESPOND (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 REQUEST–FORMAT field. For example,
a value of 1 indicates that the first field following the REQUEST–FORMAT 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.