HP-UX SNAplus2 R7 LUA Programmer's Guide

SLI Verbs
SLI_OPEN
lua_open_extension.lua_module_name
Name of the DLL containing the extension module. This parameter is not used in the last array entry,
in which
lua_open_extension.lua_routine_type is set to LUA_ROUTINE_TYPE_END.
lua_open_extension.lua_procedure_name
Procedure name to call within the extension module DLL. This parameter is not used in the last array
entry, in which lua_open_extension.lua_routine_type is set to LUA_ROUTINE_TYPE_END.
LUA calls this entry point with the SLI_BIND_ROUTINE, SLI_SDT_ROUTINE, or
SLI_STSN_ROUTINE verb, according to the value of the lua_routine_type parameter.
lua_ending_delim
The SNAplus2 SLI interface does not use this parameter; it is provided for compatibility with applications
originally written for other SLI implementations.
5.3.2 Return Value from SLI Entry Point
The SLI_OPEN verb is the only verb for which the SLI entry point returns a value.
• If the verb fails LUA’s initial checks (for example because the application supplied incorrect parameters), the
SLI function call returns a value of zero to indicate this. The application should check the lua_prim_rc and
lua_sec_rc parameters to determine the cause of the failure. SNAplus2 does not call the application-supplied
callback routine.
• If the initial checks succeed, the SLI function call returns a non-zero value representing the session ID of the
new session. If lua_init_type was set to LUA_INIT_TYPE_PRIM_SSCP, the application can use this session
ID for subsequent SLI_BID or SLI_RECEIVE verbs on the SSCP normal flow (to receive the
INIT_COMPLETE
status indicator), and then for SLI_SEND and SLI_RECEIVE verbs on this flow.
SNAplus2 then uses the application-supplied callback routine in the same way as for other SLI verbs.
5.3.3 Returned Parameters
LUA always returns the following parameter:
lua_flag2.async
This flag is set to
1 if the verb completed asynchronously, or 0 (zero) if the verb completed synchronously.
Other returned parameters depend on whether the verb completed successfully; see the following sections.
Successful Execution
If the verb executes successfully, LUA returns the following parameters.
lua_prim_rc
LUA_OK
lua_sid
A session ID for the new session. This is the same as the return value from the SLI entry point for this verb,
and can be used by subsequent verbs to identify this session.
lua_luname
The name of the LU used by the new session. If the LU name in the request parameters specified an LU
pool, SNAplus2 uses this parameter to return the name of the actual LU assigned to the session. Subsequent
verbs must use this returned name (not the name specified in the request parameters) to identify the session.
120