HP-UX SNAplus2 R7 LUA Programmer's Guide

RUI Verbs

RUI_WRITE

4.8 RUI_WRITE

The RUI_WRITE verb sends an SNA request or response unit from the LUA application to the host, over either

the LU session or the SSCP session.

4.8.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_WRITE

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 used by the session. This must match the LU name of an active LUA session,

as returned on the RUI_INIT or RUI_INIT_PRIMARY verb.

This parameter is required only if the

lua_sid parameter is 0 (zero). If a session ID is supplied in lua_sid,

LUA does not use this parameter.

This parameter must be eight bytes long; pad on the right with spaces, 0x20, if the name is shorter than

eight characters.

lua_sid

The session ID of the session. This must match a session ID returned on a previous RUI_INIT or

RUI_INIT_PRIMARY verb.

This parameter is optional; if you do not specify the session ID, you must specify the LU name for the session

in the lua_luname parameter.

lua_data_length

The length of the supplied data. When sending data on the LU normal ﬂow, the maximum length is as

speciﬁed in the BIND received from the host; for all other ﬂows the maximum length is 256 bytes.

When sending a positive response, this parameter is normally set to 0 (zero). LUA will complete the response

based on the supplied sequence number. In the case of a positive response to a BIND or STSN, an extended

response is allowed, so a nonzero value may be used.

When sending a negative response, set this parameter to the length of the SNA sense code (four bytes), which

is supplied in the data buffer.

lua_data_ptr

A pointer to the buffer containing the supplied data.

For a request, or a positive response that requires data, the buffer should contain the entire RU. The length

of the RU must be speciﬁed in lua_data_length.