HP-UX SNAplus2 R7 LUA Programmer's Guide

SLI Verbs
SLI_RECEIVE
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_flag1 parameters
Set the lua_flag1.nowait parameter to 1 if you want the SLI_RECEIVE verb to return as soon as possible
whether or not data is available to be read, or set it to 0 (zero) if you want the verb to wait for data before
returning.
Notes
1. Setting the lua_flag1.nowait parameter to 1 does not mean that the verb will
complete synchronously. The LUA library needs to communicate with the local
node to determine whether or not any data is available, and this requires an
asynchronous verb return to avoid blocking the application. The parameter means
that, if there is no data available immediately, the asynchronous verb return will
occur as soon as possible to indicate this.
2. If the first RU of a multiple-RU chain is available when the application issues
SLI_RECEIVE, the lua_flag1.nowait parameter is ignored; SLI_RECEIVE waits
until the complete chain of data has arrived before returning.
Set the lua_flag1.bid_enable parameter to 1 to re-enable the most recent SLI_BID verb (equivalent to issuing
SLI_BID again with exactly the same parameters as before), or set it to 0 (zero) if you do not want to
re-enable SLI_BID. Re-enabling the previous SLI_BID re-uses the VCB originally allocated for it, so this
VCB must not have been freed or modified. (For more information, see Section 5.5.3, Interaction with Other
Verbs.)
Set one or more of the following flags to 1 to indicate which message flow to read data from:
lua_flag1.sscp_exp
lua_flag1.lu_exp
lua_flag1.sscp_norm
lua_flag1.lu_norm
If more than one flag is set, the highest-priority data available will be returned. The order of priorities (highest
first) is: SSCP expedited, LU expedited, SSCP normal, LU normal. The equivalent flag in the lua_flag2 group
will be set to indicate which flow the data was read from (see Section 5.5.2, Returned Parameters).
The SNAplus2 implementation of LUA does not return data on the SSCP expedited flow. The application
can set the sscp_exp flag, for compatibility with other LUA implementations, but data will never be returned
on this flow.
5.5.2 Returned Parameters
LUA always returns the following parameters:
lua_flag2.async
This flag is set to
1 if the verb completed asynchronously, or 0 (zero) if the verb completed synchronously.
lua_flag2.bid_enable
This parameter is set to
1 if an SLI_BID was successfully re-enabled, or to 0 if it was not re-enabled.
Other returned parameters depend on whether the verb completed successfully; see the following sections.
130