SLI_BIND_ROUTINE

This verb tells an SLI application program that an SNA BIND request arrived from the host and allows the application program to examine the session protocols. The SLI_BIND_ROUTINE is passed to a programmer-supplied DLL specified in the SLI_OPEN extension list bind routine field.

Supplied Parameters

The following parameters for SLI_BIND_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_BIND_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 BIND RU.
lua_data_ptr
A pointer to the BIND RU. The BIND RU might contain EBCDIC characters such as the PLU name.
lua_th
The BIND TH.
lua_rh
The BIND RH.

Returned Parameters

If the verb completes successfully, LUA returns the following parameters:
lua_prim_rc
LUA_OK
lua_data_length
The length of the BIND 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_BIND_ROUTINE verb control block. The lua_data_ptr parameter contains the address of the BIND RU, and the lua_data_length parameter contains the length of the RU.

The SLI_BIND_ROUTINE is completed when the extension routine returns with the lua_prim_rc and the lua_data_length parameters set in the SLI_BIND_ROUTINE verb control block. Overwrite the BIND RU with the BIND response. A primary return code of OK indicates that the BIND was accepted. If the routine rejects the BIND, set the primary return code to NEGATIVE_RSP and put the negative sense code in the BIND 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_BIND_ROUTINE.