HP-UX SNAplus2 R7 LUA Programmer's Guide

RUI Verbs
RUI_READ
lua_data_ptr
A pointer to the buffer supplied to receive the data.
lua_post_handle
UNIX
A pointer to a callback routine that LUA will call to indicate completion if the verb completes asynchronously.
WINDOWS
If the VCB is used in an RUI function call, set this field to an event handle. If the VCB is used in a WinRUI
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 RUI_READ 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.
Note
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 normally 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.
Set the lua_flag1.bid_enable parameter to 1 to re-enable the most recent RUI_BID verb (equivalent to issu-
ing RUI_BID again with exactly the same parameters as before), or set it to 0 (zero) if you do not want to
re-enable RUI_BID. Re-enabling the previous RUI_BID re-uses the VCB originally allocated for it, so this
VCB must not have been freed or modified. (For more information, see Section 4.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 4.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.
4.5.2 Returned Parameters
LUA always returns the following parameters:
lua_flag2.async
85