HP-UX SNAplus2 R7 LUA Programmer's Guide

SLI Verbs
SLI_RECEIVE
lua_flag2.lu_norm
The SNAplus2 implementation of LUA does not return data on the SSCP expedited flow, and so the sscp_exp
flag will never be set (although it may be set by other LUA implementations).
Successful Execution: Status Information
Note
SLI_RECEIVE can return status information only if there is no SLI_BID verb outstanding.
If both verbs are in progress when status information becomes available, the status is
returned on the SLI_BID verb, and the SLI_RECEIVE remains in progress.
If the verb returned LUA status information instead of data, LUA returns the following parameters:
lua_prim_rc
LUA_STATUS
lua_sec_rc
LUA_READY
The SLI session is now ready to process additional commands. This status is used after a previous
LUA_NOT_READY
status was reported, or after an SLI_CLOSE verb completed with lua_prim_rc set to
LUA_CANCELLED
and lua_sec_rc set to
RECEIVED_UNBIND_HOLD or
RECEIVED_UNBIND_NORMAL.
LUA_NOT_READY
The SLI session has been temporarily suspended for one of the following reasons:
• A CLEAR command was received. The session resumes when an SDT command is received.
• An UNBIND command type X’02’ (BIND forthcoming) was received. The session is suspended
until a BIND, optional CRV and STSN, and SDT commands are received; it resumes after the SDT.
Any user extension routines that were supplied by the original SLI_OPEN verb will be called again.
• An UNBIND command type X’01’ (normal) was received, and the SLI_OPEN verb for this session
specified lua_session_type
LUA_SESSION_TYPE_DEDICATED. The session is suspended until a
BIND, optional CRV and STSN, and SDT commands are received; it resumes after the SDT. Any
user extension routines that were supplied by the original SLI_OPEN verb will be called again.
The application should issue another SLI_BID or SLI_RECEIVE to receive the
READY
status when the
session resumes. It can continue to issue SLI_SEND and SLI_RECEIVE verbs for SSCP normal-flow
data even though the session status is
LUA_NOT_READY.
LUA_INIT_COMPLETE
The application issued SLI_OPEN with type LUA_OPEN_TYPE_PRIM_SSCP, and the underlying
RUI_INIT verb has now completed. The application can now issue SLI_SEND and SLI_RECEIVE
verbs for SSCP normal-flow data.
LUA_SESSION_END_REQUESTED
The host has sent a SHUTD command, requesting the application to shut down the session. The
application should issue SLI_CLOSE as soon as it is ready to close the session.
lua_sid
If the application specified the lua_luname parameter when issuing this verb, rather than specifying the session
ID, LUA supplies the session ID.
Unsuccessful Execution
If a verb does not complete successfully, LUA returns a primary return code to indicate the type of error and a
secondary return code to provide specific details about the reason for unsuccessful execution.
132