SNAX/HLS Application Programming Manual

Procedure Specifications
Customization
7–24 104707 Tandem Computers Incorporated
The
USEREXIT^VRFY^STSN^
RSP Routine
The SNAXHLS^USEREXIT^VRFY^STSN^RSP routine is invoked when SNAX/HLS
has just finished processing the STSN (set and test sequence number) request and is
about to send a positive response. This customization routine allows the inspection of
any field of the STSN request, and modification of the positive response that
SNAX/HLS is about to send. This would include any changes to the result code and
the send and receive sequence numbers that SNAX/HLS has set in the response RU.
The completion of the OPEN-SESSION or HLS-OPEN verb is not affected due to the
changes made by the user-exit routine to the STSN response.
The routine is as follows:
PROC SNAXHLS^USEREXIT^VRFY^BIND^RSP (wsadr, !i
sessid, !i
profile^name, !i
stsn^rq, !i
appl^send^seq^no, !i
appl^rcv^seq^no, !i
stsn^rsp, !/i
stsn^rsp^len); !/o
INT (32) wsadr;
INT sessid;
STRING .EXT profile^name;
STRING .EXT stsn^rq (stsn^templates);
INT appl^send^seq^no,
INT appl^rcv^seq^no,
STRING .EXT bind^rsp^len;
INT .EXT stsn^rsp^len;
wsadr
is the 32-bit extended address of the global storage area as requested in the
enabling routine (SNAXHLS^USEREXIT^ENABLE). It is inappropriate to use this
address if no storage was allocated and would result in SNAX/HLS abending.
sessid
is the index to the session tables in SNAX/HLS. It does not correspond to the
session ID used on the verb interface, although it is derived from it. Note that
valid session values vary from 1 to MAXLUS. The value is zero if a session has not
been allocated. The value of MAXLUS is passed in the
SNAXHLS^USEREXIT^VERB^IN^BLOCK, on a call to the
SNAXHLS^USEREXIT^ENABLE^ routine.
profile^name
points to an instance of the profile name passed in the PROFILE-NAME field of
the OPEN-SESSION or HLS-ALLOCATE verb. It is 8 bytes long and padded to
the right with spaces.