SNAX/HLS Application Programming Manual

HLS-CALL-USER Verb
Customization
7–6 104707 Tandem Computers Incorporated
Request Details
VERB-CODE
identifies which verb is being issued. In SCOBOLX, you should issue the
statement:
MOVE VERB-HLS-CALL-USER TO verb-code
OF request-header .
In TAL, you should issue the statement:
STRUCT .rq( request^header );
...
rq.verb^code := VERB^HLS^CALL^USER;
SESSION-ID
contains 0 or a valid session ID.
COMPLETION-MODE
specifies how you want to be notified of the completion of the request. The only
option supported is:
I Immediate Response. In this form, the SNAX/HLS server tries to perform the
HLS-CALL-USER 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 HLS-CALL-USER request includes the successful response. If the
request cannot be satisfied immediately, no further attempt is made by
SNAX/HLS.
REQUEST-FORMAT
is reserved for future expansion of the verb. This field must contain a blank.
ARGUMENTS
are two integer values that are accessible to the SNAXHLS^USEREXIT^VERB^IN
routine. The values, possibly modified by that routine, are also made available to
the SNAXHLS^USEREXIT^VERB^OUT routine. Typically, these values are used
to indicate the kind of information being solicited.
USER-DATA-LENGTH
specifies the number of bytes that are being passed.