SNAX/HLS Application Programming Manual

Procedure Specifications
Customization
104707 Tandem Computers Incorporated 7–25
stsn^rq
points to the STSN RU received by SNAX/HLS.
appl^send^seq^no
defines the sequence number maintained in the half-session control block, if the
VERIFY-SEQUENCE-NUMBERS-IND on the OPEN-SESSION or the HLS-OPEN
verb is sent to N, or the RCV_SEQUENCE_NUMBER passed on the OPEN-
SESSION or HLS-OPEN verb if it is set to Y.
stsn^rsp
points to the positive STSN response built by SNAX/HLS.
stsn^rsp^len
defines the length (in bytes) of the positive STSN response built by SNAX/HLS.
Note that this excludes the SNAX header, and thus can either be 1 byte or 6 bytes.
An STSN template is provided in TAL definitions file, HLSDDT, to ease the parsing of
the STSN request and response.
The profile name can be used as a means to identify the type of session. The routine
can select the criteria for changing the result code or the sequence number fields in the
response, based on the profile name.
The routine can be used to modify the positive response built by SNAX/HLS, and the
length of the response. However, care must be taken to prevent any wrong
modification as it could cause unpredictable results in protocol handling. SNAX/HLS
will not validate the response or alter its internal tables based on the changes made by
the routine. The following points should be noted while using this customization
routine:
The valid values for the response length is 1 byte or 6 bytes.
The first byte of the STSN response RU must be %HA2.
The routine can modify only the STSN response RU and the STSN response RU
length.