HP-UX SNAplus2 R7 LUA Programmer's Guide

SLI Verbs
SLI_PURGE
5.4 SLI_PURGE
The SLI_PURGE verb cancels a previous SLI_RECEIVE. An SLI_RECEIVE may wait indefinitely if it is sent
without using the lua_flag1.nowait (immediate return) option, and no data is available on the specified flow;
SLI_PURGE forces the waiting verb to return (with the primary return code
LUA_CANCELLED).
5.4.1 Supplied Parameters
The application supplies the following parameters:
lua_verb
LUA_VERB_SLI
lua_verb_length
The length in bytes of the LUA verb record.
Set this to sizeof(LUA_VERB_RECORD).
lua_opcode
LUA_OPCODE_SLI_PURGE
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 SLI_OPEN 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 SLI_OPEN 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_ptr
A pointer to the SLI_RECEIVE VCB that is to be purged.
lua_post_handle
UNIX
A pointer to a callback routine that LUA will call to indicate completion if the verb completes asynchronously.
WINDOWS
If the VCB is used in an SLI function call, set this field to an event handle. If the VCB is used in a WinSLI
function call, this field is reserved.
For more information, see Chapter 2, Designing and Writing LUA Applications.
125