HP-UX SNAplus2 R7 LUA Programmer's Guide

RUI Verbs
RUI_READ
LUA_RUI_LOGIC_ERROR
This return code indicates one of the following:
• The host system has violated SNA protocols
• An internal error was detected within LUA
Attempt to reproduce the problem with SNA tracing active (contact your System Administrator if
necessary), and check that the host is sending correct data. If this does not solve the problem, contact
your SNAplus2 support personnel.
lua_prim_rc
LUA_INVALID_VERB
Either the lua_verb parameter or the lua_opcode parameter was not valid. The verb did not execute.
WINDOWS
lua_prim_rc
LUA_STACK_TOO_SMALL
The stack size of the application is too small for LUA to complete the request. Increase the stack size
of your application.
lua_prim_rc
LUA_UNEXPECTED_DOS_ERROR
An operating system error occurred.
lua_sec_rc
This value is the operating system return code. Check your operating system documentation for the meaning
of this return code.
lua_prim_rc
LUA_COMM_SUBSYSTEM_NOT_LOADED
The node was either not started or not configured properly for LUA applications. Check the SNAplus2 LUA
configuration parameters and start the node before running your application.
4.5.3 Interaction with Other Verbs
The RUI_INIT or RUI_INIT_PRIMARY verb must have completed successfully before this verb can be issued.
While an existing RUI_READ is pending, you can issue another RUI_READ only if it specifies a different session
flow or flows from pending RUI_READs; you cannot have more than one RUI_READ outstanding for the same
session flow.
The lua_flag1.bid_enable parameter can only be used if the following are true:
• RUI_BID has already been issued successfully and has completed
• The storage allocated for the RUI_BID verb has not been freed or modified
• No other RUI_BID is pending
If you use this parameter to re-enable a previous RUI_BID, at least one of the message flow flags on RUI_READ
must still be set, to indicate the flow or flows on which the application will accept data. If the first data to be
received is on a flow accepted by the RUI_READ verb, RUI_READ will return with this data, and RUI_BID will not
return. Otherwise, RUI_BID will return to indicate that there is data to be read (since RUI_BID accepts data on all
90