HP-UX SNAplus2 R7 LUA Programmer's Guide

SLI Verbs
SLI_OPEN
lua_data_ptr
A pointer to the message, if any, that must be sent to the host to start the session. This depends on the
lua_init_type parameter, as follows.
• If lua_init_type is LUA_INIT_TYPE_SEC_IS, the application must provide an INITSELF request unit
containing the required user information such as the mode name and PLU name.
• If lua_init_type is LUA_INIT_TYPE_SEC_LOG, the application must provide an unformatted LOGON
message to be sent on the SSCP normal flow.
• If lua_init_type is LUA_INIT_TYPE_PRIM or LUA_INIT_TYPE_PRIM_SSCP, this parameter is not
used and the application must supply a null pointer.
lua_post_handle
UNIX
A pointer to a callback routine that LUA will call to indicate completion if the verb completes asynchronously.
(If the verb fails LUA’s initial checks and the SLI entry point returns zero, LUA will not call this routine.)
WINDOWS
If the VCB is used in an SLI function call, set this field to an event handle. If the VCB is used in a WinSLI
function call, this field is reserved.
For more information, see Chapter 2, Designing and Writing LUA Applications.
lua_encr_decr_option
This parameter is reserved and must be set to zero.
lua_init_type
Specifies how LUA should initiate the session. Possible values are:
LUA_INIT_TYPE_SEC_IS
Secondary-initiated: send the application’s INITSELF message (indicated by lua_data_ptr) to the host.
LUA_INIT_TYPE_SEC_LOG
Secondary-initiated: send the application’s unformatted LOGON message (indicated by lua_data_ptr)
to the host.
LUA_INIT_TYPE_PRIM
Primary-initiated: wait for a BIND from the host.
LUA_INIT_TYPE_PRIM_SSCP
Primary-initiated with SSCP access: allow the application to issue SLI_SEND and SLI_RECEIVE
verbs on the SSCP normal flow, so that it can provide its own INITSELF or LOGON messages and
receive their responses. After issuing SLI_OPEN, the application can issue SLI_BID or SLI_RECEIVE
to get the status indication
INIT_COMPLETE, and can then use SLI_SEND and SLI_RECEIVE to send
INITSELF or LOGON messages and receive their responses.
lua_session_type
Specifies how LUA should process an UNBIND type X’01’ (normal). Possible values are:
LUA_SESSION_TYPE_NORMAL
Send a positive response, and issue RUI_TERM so that a NOTIFY(disabled) is sent to the SSCP. The
SSCP-LU flow is disabled.
118