HP-UX SNAplus2 R7 LUA Programmer's Guide

RUI Verbs

RUI_TERM

Once the RUI_REINIT 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 secondary return code is not

LUA_RUI_LOGIC_ERROR, then this LU can be reinitialized using an RUI_REINIT.

If it is not reinitialized, then an RUI_TERM must be issued before an RUI_INIT can be issued for the same LU.

The session ID of the restarted session is the same as the session ID before the failure. Unlike RUI_INIT,

RUI_REINIT does not return this session ID; the application should either use the session ID that was returned to

the original RUI_INIT verb, or access the session using its LU name.

4.7 RUI_TERM

The RUI_TERM verb ends both the LU session and the SSCP session for a given LU.

4.7.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_TERM

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 (or the LU name that was speciﬁed on

an outstanding RUI_INIT, RUI_INIT_PRIMARY, or RUI_REINIT 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_post_handle