HP-UX SNAplus2 R7 LUA Programmer's Guide

RUI Verbs
RUI_BID
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 return code indicates that 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.
lua_prim_rc
LUA_NEGATIVE_RSP
lua_sec_rc
The secondary return code contains the sense code sent to the host on the negative response. See Section 2.4,
SNA Information, for information about interpreting the sense code values that can be returned.
A 0 (zero) secondary return code indicates that, following a previous RUI_WRITE of a negative response to
a message in the middle of a chain, SNAplus2 has now received and discarded all messages from this chain.
Other Conditions
The following return codes indicate that the verb record supplied was valid, but the verb did not complete
successfully:
lua_prim_rc
LUA_UNSUCCESSFUL
lua_sec_rc
LUA_INVALID_PROCESS
The operating system process that issued this verb was not the same process that issued the RUI_INIT
or RUI_INIT_PRIMARY verb for this session. Only the process that started a session can issue verbs
on that session.
The following return codes indicate that the verb did not complete successfully for other reasons:
lua_prim_rc
LUA_COMM_SUBSYSTEM_ABENDED
A required SNAplus2 software component (such as the node) has terminated. Contact your System
Administrator if necessary.
lua_prim_rc
LUA_SESSION_FAILURE
The LUA session has failed.
If the session was started using RUI_INIT (not RUI_INIT_PRIMARY) and the secondary return code
is not
LUA_RUI_LOGIC_ERROR, then this LU can be reinitialized using an RUI_REINIT. If it is not
reinitialized, then an RUI_TERM must be issued before an RUI_INIT or RUI_INIT_PRIMARY can be
issued for the same LU.
lua_sec_rc
Possible values are:
LUA_LU_COMPONENT_DISCONNECTED
This return code indicates that the LUA session has failed because of a problem with the communications
link or with the host LU.
LUA_RUI_LOGIC_ERROR
This return code indicates one of the following:
68