SNAX/HLS Application Programming Manual
Standard Verb Formats
The Standard Verb Interface
4–6 104707 Tandem Computers Incorporated
COMPLETION-MODE
specifies how you want to be notified of the completion of the request. Not all
options are available on any particular verb.
I Immediate Response. In this form, the SNAX/HLS server tries to perform the
request without any delay. In particular, SNAX/HLS does not send any SNA
commands to your partner. If the request succeeds, the reply to the request
indicates a successful response. If the request cannot be satisfied immediately,
no further attempt is made by SNAX/HLS. This form thus corresponds to a
request that could be phrased as “Try it, but give up if you can’t do it right
away.”
Q Queued Response. In this form, the SNAX/HLS server replies to your request
immediately. The request, however, is remembered by the SNAX/HLS
server, and, when it is satisfied, a response is queued to you to be retrieved by
a receive type verb. This form thus corresponds to a request that could be
phrased as, “Try it and tell me later if it succeeds or when it completes.”
W Wait Response. In this form, the SNAX/HLS server replies to your request
only when it has completed one way or another. This form thus corresponds
to a request that could be phrased as, “Try it, and don’t tell me anything until
it is complete.”
REQUEST-FORMAT
is reserved for future expansion of the verb. This field must contain a blank.
Reply Format All SNAX/HLS replies begin with a standard reply header, as follows:
01
name-of-request
-REPLY.
02 VERB-CODE pic 9(4) comp.
02 SESSION-ID pic 9(4) comp.
02 RETURN-CODE pic 9(4) comp.
02 SYSTEM-ERROR-CODE pic S9(4) comp.
02 USER-ERROR-CODE pic S9(4) comp.
02 RETRY-ACTION-CODE pic 9(4) comp.
VERB-CODE
identifies the reply being returned and contains an integer value. In TAL
programs, this value is known as VERB^
name^of^request
, and in COBOL or
SCOBOLX programs, it is the value known as VERB-
name-of-request
.
SESSION-ID
represents the session-ID value. It is a computational value.