HP-UX SNAplus2 R7 LUA Programmer's Guide

RUI Verbs
RUI_READ
LUA_BAD_SESSION_ID
The lua_sid parameter did not match the session ID of any active LUA LU session.
LUA_BID_ALREADY_ENABLED
The lua_flag1.bid_enable parameter was set to re-enable an RUI_BID verb, but the previous RUI_BID
verb was still in progress.
LUA_DUPLICATE_READ_FLOW
The flow flags in the lua_flag1 group specified one or more session flows for which an RUI_READ
verb was already outstanding. Only one RUI_READ at a time can be waiting on each session flow.
LUA_INVALID_FLOW
None of the lua_flag1 flow flags was set. At least one of these flags must be set to
1 to indicate which
flow or flows to read from.
UNIX
LUA_INVALID_POST_HANDLE
The lua_post_handle parameter was not a valid pointer to a callback routine.
LUA_NO_PREVIOUS_BID_ENABLED
The lua_flag1.bid_enable parameter was set to re-enable an RUI_BID verb, but there was no previous
RUI_BID verb that could be enabled. (For more information, see Section 4.5.3, Interaction with Other
Verbs.)
LUA_RESERVED_FIELD_NOT_ZERO
A reserved field in the verb record, or a parameter that is not used by this verb, was set to a nonzero
value.
LUA_VERB_LENGTH_INVALID
The value of the lua_verb_length parameter was less than the length of the verb record required for
this verb.
State Check
The following return codes indicate that the verb was issued in a session state in which it was not valid:
lua_prim_rc
LUA_STATE_CHECK
lua_sec_rc
LUA_NO_RUI_SESSION
An RUI_INIT or RUI_INIT_PRIMARY verb has not yet completed successfully for the LU name
specified on this verb, or the session has failed.
Negative Response Sent to Host
The following primary return code indicates one of the following two cases, which can be distinguished by the
secondary return code:
• SNAplus2 detected an error in the data received from the host. Instead of passing the received message to
the application on an RUI_READ verb, SNAplus2 discards the message (and the rest of the chain if it is in a
chain), and sends a negative response to the host. LUA informs the application on a subsequent RUI_READ or
RUI_BID verb that a negative response was sent.
• The LUA application previously sent a negative response to a message in the middle of a chain. SNAplus2 has
purged subsequent messages in this chain, and is now reporting to the application that all messages from the
chain have been received and purged.
88