HP-UX SNAplus2 R7 LUA Programmer's Guide

RUI Verbs

RUI_INIT

lua_luname

The name in ASCII of the LU or LU pool for which you want to start the session. This must match the name

of an LU of type 0–3, or of an LU pool, conﬁgured for SNAplus2. The name is used as follows:

• If the name is the name of an LU that is not in a pool, SNAplus2 attempts to start the session using this

LU. An application can start multiple sessions by using multiple RUI_INIT verbs with a different LU for

each verb; it cannot start more than one session for the same LU.

• If the name is the name of an LU pool, or the name of an LU within a pool, SNAplus2 attempts to start

the session using the named LU, if it is available, or otherwise the ﬁrst available LU from the pool. An

application can start multiple sessions using the same pool; SNAplus2 will assign a different LU from

the pool for each session. The name of the actual LU used for the session is a returned parameter on the

RUI_INIT verb.

This parameter must be eight bytes long; pad on the right with spaces,

0x20, if the name is shorter than

eight characters.

UNIX

The application can use the extended form of RUI_INIT to identify the LU by its PU name and LU number,

instead of by its LU name. To do this, set

lua_luname to eight binary zeros, and specify the PU name and

LU number in the lua_puname and lua_lunumber parameters.

lua_post_handle

UNIX

A pointer to a callback routine. If the verb completes asynchronously, LUA will call this routine to indicate

completion of the verb.

WINDOWS

If the VCB is used in an RUI function call, set this ﬁeld to an event handle. If the VCB is used in a WinRUI

function call, this ﬁeld is reserved.

For more information, see Chapter 2, Designing and Writing LUA Applications.

lua_encr_decr_option

Session-level cryptography option. SNAplus2 accepts the following two values:

Session-level cryptography is not used.

128

Encryption and decryption are performed by the application program.

Any other value will result in the return code LUA_ENCR_DECR_LOAD_ERROR. (Values in the range 1 to 127,

indicating user-deﬁned encryption and decryption routines, are supported by OS/2 Extended Edition’sLUA

implementation but not by SNAplus2.)

UNIX

The following parameters are used only if the lua_luname parameter is set to eight binary zeros (the extended

form of RUI_INIT). If lua_luname speciﬁes the LU name (the standard form of RUI_INIT), these parameters are

reserved.

lua_puname