Edit

Share via

LUA Verb Summary

  • Article

Logical unit application (LUA) application programs can establish and use SNA sessions with either the Request Unit Interface (RUI) application programming interface (API) or the Session Level Interface (SLI) API. If an LUA application establishes an SNA session using RUI_INIT, it cannot issue any SLI verbs for that session. Likewise, if an LUA application establishes an SNA session using SLI_OPEN, it cannot issue any RUI verbs for that session.

Following is a brief summary of each LUA verb or user-supplied routine. Each verb supplies parameters to LUA, which performs the desired function and returns parameters to the application:

RUI_BID
Allows the application to determine when information from the host is available to be read.

RUI_INIT
Sets up the SSCP-LU session for an LUA application.

RUI_PURGE
Cancels an outstanding RUI_READ.

RUI_READ
Receives data or status information sent from the host to the LUA application's LU, on either the SSCP session or the LU session.

RUI_TERM
Ends the SSCP session for an LUA application. It also terminates the LU session if it is active.

RUI_WRITE
Sends data to the host on either the SSCP session or the LU session.

SLI_BID
Notifies the SLI application that a message is waiting to be read using SLI_RECEIVE. It also provides the current status of the session to the LUA application.

SLI_BIND_ROUTINE
An optional, user-supplied exit routine that notifies the LUA application that a BIND request has come from the host. It allows the routine to examine the request and formulate a response.

SLI_CLOSE
Ends a session opened with SLI_OPEN.

SLI_OPEN
Transfers control of the specified LU to the LUA application. It establishes a session between the SSCP and the specified LU, as well as an LU-LU session.

SLI_PURGE
Cancels SLI_RECEIVE verbs issued with a wait condition.

SLI_RECEIVE
Receives responses, SNA commands, and data into the buffer of an LUA application. It also provides the current status of the session to the LUA application.

SLI_SEND
Sends responses, SNA commands, and data from an LUA application to a host LU.

SLI_STSN_ROUTINE
An optional, user-supplied exit routine that notifies the LUA application that a set and test sequence number (STSN) command has come from the host. It allows the routine to examine the request and formulate a response.