SNAX/HLS Application Programming Manual

HLSCLOSE Verb
SNAX/HLS Verbs
5–20 104707 Tandem Computers Incorporated
RETURN–CODE
is a 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. Its interpretation depends upon the completion
code, as follows:
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 RC–SEND–CHECK, RC–SESSION–FAILURE, or RC–
REQUEST–REJECT, then this field contains the first two bytes of the SNA
sense data. The next two bytes are 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.