HP-UX SNAplus2 R7 LUA Programmer's Guide

RUI Verbs
RUI_REINIT
flows, it will always accept the data if RUI_READ does not). The application must then issue another RUI_READ
on the appropriate flow to obtain the data.
If you want to use RUI_BID to handle data on all flows, rather than having the data on a particular flow handled
by RUI_READ in preference to RUI_BID, you need to re-issue RUI_BID explicitly instead of using RUI_READ
to re-enable the previous RUI_BID.
4.5.4 Usage and Restrictions
If the data received is longer than the lua_max_length parameter, it will be truncated; only lua_max_length bytes
of data will be returned. The primary and secondary return codes
LUA_UNSUCCESSFUL and
LUA_DATA_TRUNCATED
will also be returned.
Once a message has been read using the RUI_READ verb, it is removed from the incoming message queue, and
cannot be accessed again. (The RUI_BID verb may be used as a non-destructive read; the application can use it to
check the type of data available, but the data remains on the incoming queue and need not be used immediately.)
Pacing may be used on the primary-to-secondary half-session (this is specified in the host configuration), in order
to protect the LUA application from being flooded with messages. If the LUA application is slow to read messages,
SNAplus2 delays the sending of pacing responses to the host in order to slow it down.
4.6 RUI_REINIT
UNIX
The RUI_REINIT verb re-establishes the SSCP-LU session after a session failure. It is intended for use by an
application that was using an LU from a pool, and needs to ensure that it accesses the same LU in order to continue
processing. (Normally, an application recovers from a session failure by issuing RUI_TERM followed by a second
RUI_INIT; however, if the application was using an LU from a pool, the second RUI_INIT will not necessarily get
the same LU as the original one.)
This verb cannot be used to restart a Primary RUI session (one that was started using RUI_INIT_PRIMARY).
4.6.1 Supplied Parameters
The application supplies the following parameters:
lua_verb
LUA_VERB_RUI
lua_verb_length
The length in bytes of the LUA verb record. Set this to sizeof(LUA_COMMON).
lua_opcode
LUA_OPCODE_RUI_REINIT
lua_correlator
Optional. A four-byte value that you can use to correlate this verb with other processing within your
application. LUA does not use or change this information.
lua_luname
The name in ASCII of the LU that was being used by the failed session. This must match the name returned
on the original RUI_INIT verb (not necessarily the same as the name that was supplied to the verb).
91