SNAX/HLS Application Programming Manual

Procedure Specifications
Customization
7–22 104707 Tandem Computers Incorporated
The
USEREXIT^VRFY^BIND^
RSP Routine
The SNAX^HLS^USEREXIT^VRFY^BIND^RSP routine is invoked when SNAX/HLS
has just finished processing the BIND request and is about to send a positive response.
This customization routine allows the inspection of any field in the BIND request, and
rejection of the BIND request with user-supplied SNA sense data. Using this routine,
applications can force SNAX/HLS to send a negative response to a BIND; otherwise a
positive response would have been sent by SNAX/HLS.
The OPEN-SESSION or HLS-OPEN verb completes with the sense data returned by
the user-exit routine and the session is not established.
The routine is specified as follows:
PROC SNAXHLS^USEREXIT^VRFY^BIND^RSP (wsadr, !i
sessid, !i
profile^name, !i
bind^rq, !i
bind^rq^len, !i
bind^rsp, !i
bind^rsp^len, !i
sense;) !o
INT (32) wsadr;
INT sessid;
STRING .EXT profile^name;
STRING .EXT bind^rq (bind^templates);
INT bind^rq^len;
STRING .EXT bind^rsp^len;
INT .EXT bind^rsp^len;
INT .EXT sense;
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 the value specified by MAXLUS. If a session
has not been allocated, the value is zero. 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.