HP-UX SNAplus2 R7 LUA Programmer's Guide

RUI Verbs
RUI_WRITE
• 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.8.3 Interaction with Other Verbs
The RUI_INIT or RUI_INIT_PRIMARY verb must be issued successfully before this verb can be issued.
While an existing RUI_WRITE is pending, you can issue a second RUI_WRITE only if it specifies a different
session flow from the pending RUI_WRITE; that is, you cannot have more than one RUI_WRITE outstanding for
the same session flow.
The RUI_WRITE verb can be issued on the SSCP normal flow at any time after a successful RUI_INIT or
RUI_INIT_PRIMARY verb. RUI_WRITE verbs on the LU expedited or LU normal flows are permitted only
after a BIND has been received, and must abide by the protocols specified on the BIND.
4.8.4 Usage and Restrictions
Successful completion of RUI_WRITE indicates that the message was queued successfully to the data link; it does
not necessarily indicate that the message was sent successfully, or that the host accepted it.
Pacing may be used on the secondary-to-primary half-session (this is specified on the BIND), in order to prevent
the LUA application from sending more data than the SNAplus2 LU or the host LU can handle. If this is the case,
an RUI_WRITE on the LU normal flow may be delayed by LUA and may take some time to complete.
104