SNAX/HLS Application Programming Manual

HLS-CALL-USER Verb
Customization
7–4 104707 Tandem Computers Incorporated
HLS-CALL-USER Verb The HLS-CALL-USER verb allows an application program to send information to your
customization SNAXHLS^USEREXIT^VERB^IN routine and to get information from
your customization SNAXHLS^USEREXIT^VERB^OUT routine. The HLS-CALL-
USER request provides two integer arguments and a variable-length text string that
are presented to your SNAXHLS^USEREXIT^VERB^IN routine. The two integer
arguments are preserved and eventually passed to your
SNAXHLS^USEREXIT^VERB^OUT routine, which can append variable-length text in
the response.
If the application is to communicate global information, it should use a session ID
value of 0 in the verb request. This 0 is made visible to the
SNAXHLS^USEREXIT^VERB^IN and SNAXHLS^USEREXIT^VERB^OUT routines.
If, however, the application program is to communicate information about a particular
session, it should include the session ID in the request. Only in this way is the session
ID visible to the two user-exit routines and recreated in the HLS-CALL-USER reply.
If the session ID is invalid, the reply indicates a session ID of 0.