SLI_SDT_ROUTINE

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


Displays a notepad icon that denotes important information.
SLI_SDT_ROUTINE is not supported by SNA API clients.

Supplied Parameters

The following parameters for SLI_SDT_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_SDT_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 SDT RU.
lua_data_ptr
A pointer to the SDT RU.
lua_th
The SDT TH.
lua_rh
The SDT RH.

Returned Parameters

Following is a list of the parameters for SLI_SDT_ROUTINE that the extension routine must return:
lua_prim_rc
LUA_OK
lua_data_length
The length of the SDT response being sent.
lua_prim_rc
The primary return code, set by the verb function. For details, see LUA Verb Return Codes.
The following return code indicates that the verb did not complete successfully because LUA or the application sent a negative response:
lua_prim_rc
LUA_NEGATIVE_RSP

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_SDT_ROUTINE verb control block. The lua_data_ptr parameter contains the address of the SDT RU, and the lua_data_length parameter contains the length of the RU.

The SLI_SDT_ROUTINE is completed when the extension routine returns with the lua_prim_rc and the lua_data_length parameters set in the SLI_SDT_ROUTINE verb control block. Overwrite the SDT RU with the SDT response. A primary return code of OK indicates that the SDT was accepted. If the routine rejects the SDT, 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_SDT_ROUTINE.