HP-UX SNAplus2 R7 LUA Programmer's Guide

SLI Verbs
SLI_OPEN
In either of these cases, the SLI_CLOSE verb returns with the primary return code
CANCELLED. The session is
not closed; the application should issue SLI_BID or SLI_RECEIVE to get status information. Any user extension
routines specified by the application on the SLI_OPEN verb will be called again when the host sends the new BIND.
If the application needs to end the session quickly without waiting for the usual message sequence, or to close a
dedicated session without waiting for a new BIND after the host has send UNBIND (normal), it does this by issuing
SLI_CLOSE with
lua_flag1.close_abend set to 1. This ends the SLI session; LUA will do all the required cleanup
processing to inform the host that the session has ended.
Before issuing SLI_CLOSE (normal), with lua_flag1.close_abend set to 0 (zero), the application should ensure that
it has received all outstanding messages from the host and sent all the required responses. If a response is required
and has not been sent, LUA automatically changes the close type and performs CLOSE (abend) processing as above.
5.3 SLI_OPEN
The SLI_OPEN verb establishes the SNA session for a given LU, or for the first available LU in a given LU pool.
5.3.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_OPEN
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 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, configured 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 SLI_OPEN 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 first 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
SLI_OPEN verb.
This parameter must be eight bytes long; pad on the right with spaces, 0x20, if the name is shorter than
eight characters.
lua_data_length
The length of the unformatted LOGON or INITSELF data supplied in the lua_data_ptr parameter, or zero if
no data is to be supplied.
117