SLI_STSN_ROUTINE

This verb tells an SLI application program that an SNA STSN request arrived from the host and allows the application program to examine the STSN RU and prepare a response. TheSLI_STSN_ROUTINE is passed to a programmer-supplied DLL that is specified in the SLI_OPEN extension list bind routine field.

Supplied Parameters

The following parameters for SLI_STSN_ROUTINE are supplied by the SLI:

lua_verb: LUA_VERB_SLI
The verb-code indicator for the LUA verbs.
lua_verb_length: The length of the verb control block.
lua_opcode: LUA_OPCODE_SLI_STSN_ROUTINE
The operation code for the routine.
lua_luname: The local LU name in ASCII.
lua_sid: The session ID returned by SLI_OPEN that identifies the session to be used.
lua_data_length: The length of the STSN RU.
lua_data_ptr: A pointer to the STSN RU.
lua_th: The STSN TH.
lua_rh: The STSN RH.

Returned Parameters

If the verb executes successfully, LUA returns the following parameters:

lua_prim_rc: LUA_OK
lua_data_length: The length of the STSN response being sent.

lua_prim_rc: The primary return code, set by the verb function. For details, see LUA Verb Return Codes.

Usage Notes

The verb control block is built in the storage that is allocated by the SLI. The contents of the lua_th and lua_rh parameters are placed in the SLI_STSN_ROUTINE verb control block. The lua_data_ptr parameter contains the address of the STSN RU, and the lua_data_length parameter contains the length of the RU.

The SLI_STSN_ROUTINE is completed when the extension routine returns with the lua_prim_rc and the lua_data_length parameters set in the SLI_STSN_ROUTINE verb control block. Overwrite the STSN RU with the STSN response. A primary return code of OK indicates that the STSN was accepted. If the routine rejects the STSN, set the primary return code to NEGATIVE_RSP and put the negative sense code in the STSN buffer. Do not modify the lua_data_ptr parameter.

Note: A negative response from this routine cancels the SLI_OPEN verb. The SLI returns a primary return code of SESSION_FAILURE, and a secondary return code of NEG_RSP_FROM_STSN_ROUTINE.