HP-UX SNAplus2 R7 LUA Programmer's Guide

RUI Verbs
RUI_BID
• 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_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.
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.
4.1.3 Interaction with Other Verbs
The RUI_INIT or RUI_INIT_PRIMARY verb must complete successfully before this verb can be issued.
Only one RUI_BID for each session can be outstanding at any one time.
After the RUI_BID verb has completed successfully, it may be re-issued by setting the lua_flag1.bid_enable
parameter on a subsequent RUI_READ verb. If the verb is to be re-issued in this way, the application program
must not free or modify the storage associated with the RUI_BID verb record.
If a message arrives from the host when an RUI_READ and an RUI_BID are both outstanding, the RUI_READ
completes and the RUI_BID is left in progress.
4.1.4 Usage and Restrictions
Each message that arrives will only be bid once. Once an RUI_BID verb has indicated that data is waiting on
a particular session flow, the application should issue the RUI_READ verb to receive the data. Any subsequent
RUI_BID will not report data arriving on that session flow until the message which was bid has been accepted by
issuing an RUI_READ verb.
The following items describe the difference between the lua_max_length and lua_data_length parameters returned
on this verb:
69