HP-UX SNAplus2 R7 LUA Programmer's Guide

SLI Verbs
SLI_CLOSE
lua_prim_rc
LUA_INVALID_VERB
Either the lua_verb parameter or the lua_opcode parameter was not valid. The verb did not execute.
5.2.3 Interaction with Other Verbs
This verb may be issued at any time after the SLI_OPEN verb has been issued. If SLI_OPEN has not yet completed
and the application wants to cancel it, it should do so by issuing SLI_CLOSE with lua_flag1.close_abend set to
1
(indicating an abnormal close).
While an SLI_CLOSE (normal) is pending, the application can issue an SLI_CLOSE (abend) if it determines that
it needs to end the session quickly without waiting for normal close processing.
If any other LUA verb is pending when SLI_CLOSE is issued, no further processing on the pending verb will take
place, and it will return with a primary return code of
LUA_CANCELLED.
After this verb has completed, no other LUA verb can be issued for this session. The application can issue
SLI_OPEN for the same LU or a different LU, to start a new session.
5.2.4 Usage and Restrictions
Session close processing may be initiated either by the host (primary-initiated close) or by the LUA application
(secondary-initiated close), as follows. In both cases the application normally sets lua_flag1.close_abend to 0 (zero),
indicating a normal close in which LUA and the host exchange the usual sequence of messages to end the session.
Primary-initiated close
The host initiates close processing by sending a SHUTD command, which is returned to the application as a
status value of
LUA_SESSION_END_REQUESTED on an SLI_BID or SLI_RECEIVE verb.
When the application is ready to close the session, it responds by issuing SLI_CLOSE. This results in the
following sequence of messages between LUA and the host.
• LUA sends CHASE to the host and receives the response.
• LUA sends Shutdown Complete (SHUTC) to the host and receives the response.
• Optionally, the host sends CLEAR; LUA receives this and sends the response.
• The host sends UNBIND; LUA receives this and sends the response.
• LUA stops the RUI session, and the SLI_CLOSE verb returns.
Secondary-initiated close
The application initiates close processing by issuing SLI_CLOSE. This results in the following sequence of
messages between LUA and the host.
• LUA sends RSHUTD to the host and receives the response.
• Optionally, the host sends CLEAR; LUA receives this and sends the response.
• The host sends UNBIND; LUA receives this and sends the response.
• LUA stops the RUI session, and the SLI_CLOSE verb returns.
While an SLI_CLOSE (normal) is in progress, the host may interrupt it by sending one of the following messages:
• UNBIND type 0x02 (UNBIND with BIND forthcoming)
• UNBIND type 0x01 (normal UNBIND), if the lua_session_type parameter on the SLI_OPEN that started the
session was set to LUA_SESSION_TYPE_DEDICATED
116