SNAX/HLS Application Programming Manual

OPEN-SESSION Verb
SNAX/HLS Verbs
104707 Tandem Computers Incorporated 5–51
SESSION–ID
contains one of the following:
Zero. There is no session ID because the SNAX/HLS server could not begin
the session. See the error response.
A nonzero value, the session ID of the new 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 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 RC–FILE–ERROR, this field contains the value of
the file–system error code.
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.