HP-UX SNAplus2 R7 LUA Programmer's Guide

RUI Verbs
RUI_INIT_PRIMARY
Once the RUI_INIT verb has completed successfully, this session uses the LU for which the session was started.
No other LUA session (from this or any other application) can use the LU until the RUI_TERM verb is issued, or
until an
LUA_SESSION_FAILURE
primary return code is received.
If the RUI_INIT verb returns with an
LUA_IN_PROGRESS primary return code then the Session ID will be returned
in the
lua_sid parameter. This Session ID is the same as that returned when the verb completes successfully and
can be used with the RUI_TERM verb to terminate an outstanding RUI_INIT verb.
4.3 RUI_INIT_PRIMARY
UNIX
The RUI_INIT_PRIMARY verb establishes the SSCP-LU session for an SNA Primary application that is
communicating with a downstream LU. (If the RUI application acts as an SNA secondary and communicates
with a host LU, it must use RUI_INIT instead of RUI_INIT_PRIMARY.)
4.3.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_INIT_PRIMARY
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 for which you want to start the session. This must match the name of a
downstream LU configured for use with PU Concentration, or an LU created implicitly from a downstream
LU template.
This parameter must be eight bytes long; pad on the right with spaces, 0x20, if the name is shorter than
eight characters.
lua_max_length
The length of a buffer supplied to receive a copy of the ACTLU(+RSP) RU received from the downstream PU.
If the application does not need to receive this information, it can specify a null pointer in the lua_data_ptr
parameter, in which case it does not need to provide a data buffer.
lua_data_ptr
A pointer to the buffer supplied to receive a copy of the ACTLU(+RSP) RU received from the downstream PU.
If the application does not need to receive this information, it can specify a null pointer, and the information
will not be returned.
lua_post_handle
76