HP-UX SNAplus2 R7 LUA Programmer's Guide

RUI Verbs
RUI_INIT
• The lua_max_length parameter indicates the length of the waiting message. When issuing the RUI_READ verb
to accept the message, the application should supply a data buffer of at least this size, to ensure that the message
can be received without truncation.
• The lua_data_length parameter indicates the length of data in lua_peek_data. If this is less than 12, indicating
that the waiting message is shorter than 12 bytes, the remaining bytes in lua_peek_data are undefined and the
application should not attempt to examine them.
4.2 RUI_INIT
The RUI_INIT verb establishes the SSCP-LU session for a given LU, or establishes an SSCP-LU session for the
first available LU in a given LU pool.
UNIX
In general, the application specifies the name of an LU or an LU pool to be used for the session. SNAplus2
also provides an extended form of RUI_INIT, in which the application can identify the LU by specifying its PU
name and LU number instead of its LU name; this function is not supported by other LUA implementations. The
differences between the normal and extended versions of RUI_INIT are indicated where appropriate in the parameter
descriptions in this section.
If the RUI application acts as an SNA primary for communications with a downstream LU, it must use
RUI_INIT_PRIMARY instead of RUI_INIT.
4.2.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.
UNIX
Set this to sizeof(LUA_VERB_RECORD).
For back-compatibility with previous SNAplus2 versions, the value sizeof(LUA_COMMON) is also accepted
if you are using the standard form of RUI_INIT and not the extended form.
WINDOWS
Set this to sizeof(LUA_COMMON).
lua_opcode
LUA_OPCODE_RUI_INIT
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.
70