Issuing RUI Verbs

RUI Verb Conditions shows the valid conditions under which an RUI application program can issue verbs to the RUI API for a given LU. The entries in the leftmost column represent incoming verbs. The entries in the first row represent verbs that are in progress. If an entry in the table is OK, the combination of verbs represents a valid condition. If an entry in the table is Error, the combination of verbs represents an incorrect condition and an error code is returned to the LUA application program.

Table 1. RUI Verb Conditions
In-Progress Commands
Incoming

Commands

 No Current Session RUI_INIT RUI_TERM RUI_WRITE RUI_READ RUI_PURGE RUI_BID
RUI_INIT OK Error Error Error Error Error Error
RUI_TERM Error OK Error OK OK OK OK
RUI_WRITE Error Error Error OK

(See Note 1)

 OK OK OK
RUI_READ Error Error Error OK OK

(See Note 2)

 OK OK
RUI_PURGE Error Error Error OK OK Error OK
RUI_BID Error Error Error OK OK OK Error
Note:
  1. The RUI permits a maximum of two active RUI_WRITE verbs per session at the same time. The active RUI_WRITE verbs must be for different session flows. Four session flows are possible:
    • SSCP-LU expedited
    • SSCP-LU normal
    • LU-LU expedited
    • LU-LU normal
  2. The RUI permits a maximum of four active RUI_READ verbs per session at the same time. The active RUI_READ verbs must be for different session flows.
Table 2. Session Events under RUI
RU from Host RU from Application RUI Verb
ACTLU RSP(ACTLU) RUI_INIT
NOTIFY
INITSELF RUI_WRITE
RSP(INITSELF) RUI_READ
BIND RUI_READ
RSP(BIND) RUI_WRITE
STSN RUI_READ
RSP(STSN) RUI_WRITE
SDT RUI_READ
RSP(SDT) RUI_WRITE
Data (begin chain) RUI_WRITE
Data (end chain) RUI_WRITE
RSP(data) RUI_READ
Data (begin chain) RUI_READ
Data (end chain) RUI_READ
RSP(data) RUI_WRITE
SHUTD RUI_READ
RSP(SHUTD) RUI_WRITE
CHASE RUI_WRITE
RSP(CHASE) RUI_READ
SHUTC RUI_WRITE
RSP(SHUTC) RUI_READ
CLEAR RUI_READ
RSP(CLEAR) RUI_WRITE
UNBIND RUI_READ
RSP(UNBIND) RUI_WRITE
NOTIFY RUI_TERM