LUA_COMMON

Die folgende Struktur listet die allgemeinen Datenstrukturparameter auf, die von allen LUA-Verben (Logical Unit Application) verwendet werden.

struct LUA_COMMON {  
    unsigned short lua_verb;  
    unsigned short lua_verb_length;  
    unsigned short lua_prim_rc;  
    unsigned long  lua_sec_rc;  
    unsigned short lua_opcode;  
    unsigned long  lua_correlator;  
    unsigned char  lua_luname[8];  
    unsigned short lua_extension_list_offset;  
    unsigned short lua_cobol_offset;  
    unsigned long  lua_sid;  
    unsigned short lua_max_length;  
    unsigned short lua_data_length;  
    char FAR *     lua_data_ptr;  
    unsigned long  lua_post_handle;  
    struct LUA_TH  lua_th;  
    struct LUA_RH  lua_rh;  
    struct LUA_FLAG1 lua_flag1;  
    unsigned char  lua_message_type;  
    struct LUA_FLAG2 lua_flag2;  
    unsigned char  lua_resv56[7];  
    unsigned char  lua_encr_decr_option;  
} LUA_COMMON;  

Bemerkungen

Elemente

lua_verb
Angegebener Parameter. Enthält den Verbcode, LUA_VERB_RUI für RUI-Verben (Request Unit Interface) oder LUA_VERB_SLI für SLI-Verben (Session Level Interface). Für beide Makros ist der Wert 0x5200.

lua_verb_length
Angegebener Parameter. Gibt die Länge in Byte des LUA VCB an. Er muss die Länge des Verbdatensatzes enthalten, der ausgegeben wird.

lua_prim_rc
Primärer Rückgabecode, der von LUA nach Abschluss des Verbs festgelegt wurde. Die gültigen Rückgabecodes variieren je nach ausgestellten LUA-Verb.

lua_sec_rc
Sekundärer Rückgabecode, der von LUA beim Abschluss des Verbs festgelegt wurde. Die gültigen Rückgabecodes variieren je nach ausgestellten LUA-Verb.

lua_opcode
Angegebener Parameter. Enthält den LUA-Befehlscode (Verboperationscode) für das zu ausgestellte Verb, z. B. LUA_OPCODE_RUI_BID für das RUI_BID Verb.

lua_correlator
Angegebener Parameter. Enthält einen vom Benutzer bereitgestellten Wert, der das Verb mit anderen vom Benutzer bereitgestellten Informationen verknüpft. LUA verwendet oder ändert diese Informationen nicht. Dieser Parameter ist optional.

lua_luname
Angegebener Parameter. Gibt den ASCII-Namen der lokalen LU an, die von der Windows LUA-Sitzung verwendet wird.

SLI_OPEN und RUI_INIT erfordern diesen Parameter. Andere Windows LUA-Verben erfordern diesen Parameter nur, wenn lua_sid null ist.

Dieser Parameter ist acht Bytes lang, rechts mit Leerzeichen (0x20) aufgefüllt, wenn der Name kürzer als acht Zeichen ist.

lua_extension_list_offset
Gibt den Offset vom Anfang des VCB zur Erweiterungsliste der vom Benutzer bereitgestellten Dynamic Link Libraries (DLLs) an. Wird von RUI im Hostintegrationsserver nicht verwendet und sollte auf Null festgelegt werden.

lua_cobol_offset
Offset der COBOL-Erweiterung. Wird nicht von LUA im Hostintegrationsserver verwendet und sollte null sein.

lua_sid
Der angegebene und zurückgegebene Parameter. Gibt den Sitzungsbezeichner an und wird von SLI_OPEN und RUI_INIT zurückgegeben. Andere Verben verwenden diesen Parameter, um die für den Befehl verwendete Sitzung zu identifizieren. Wenn andere Verben den parameter lua_luname verwenden, um Sitzungen zu identifizieren, legen Sie den lua_sid Parameter auf Null fest.

lua_max_length
Gibt die Länge des empfangenen Puffers für RUI_READund SLI_RECEIVE an. Bei anderen RUI- und SLI-Verben wird sie nicht verwendet und sollte auf Null festgelegt werden.

lua_data_length
Zurückgegebener Parameter. Gibt die Länge der in lua_peek_data zurückgegebenen Daten für das verb RUI_BID an.

lua_data_ptr
Zeigen Sie auf den vom Anwendung bereitgestellten Puffer, der die zu sendenden Daten für SLI_SEND und RUI_WRITE enthält oder die Daten für SLI_RECEIVE und RUI_READ empfangen. Bei anderen RUI- und SLI-Verben wird dieser Parameter nicht verwendet und sollte auf Null festgelegt werden.

lua_post_handle
Angegebener Parameter. Wird unter Windows verwendet, wenn eine asynchrone Benachrichtigung durch Ereignisse erreicht werden soll. Diese Variable enthält das Handle des Ereignisses, das signalisiert werden soll, oder ein Fensterhandle.

lua_th
Zurückgegebener Parameter. Enthält den SNA-Übertragungsheader (TH) der gesendeten oder empfangenen Nachricht. Verschiedene Unterparameter werden für Schreibfunktionen festgelegt und für Lese- und Gebotsfunktionen zurückgegeben.

lua_th.flags_fid

Formatidentifikationstyp 2, vier Bit.

lua_th.flags_mpf

Segmentierungszuordnungsfeld, zwei Bit.

lua_th.flags_odai

Absenderadressenfeld-Zieladressfeld (OAF–DAF)-Zuweisungsindikator, ein Bit.

lua_th.flags_efi

Beschleunigter Flussindikator, ein Bit.

lua_th.daf

Zieladressfeld (DAF), ein nicht signiertes Zeichen.

lua_th.oaf

Ursprungsadressfeld (OAF), ein nicht signiertes Zeichen.

lua_th.snf

Sequenznummerfeld, ein nicht signiertes Zeichen[2].

lua_rh
Zurückgegebener Parameter. Enthält den SNA-Anforderungs-/Antwortheader (RH) der gesendeten oder empfangenen Nachricht. Sie wird für die Schreibfunktion festgelegt und von den Lese- und Gebotsfunktionen zurückgegeben.

lua_rh.rri

Anforderungsantwortindikator, ein Bit.

lua_rh.ruc

RU-Kategorie, zwei Bits.

lua_rh.fi

Formatanzeige, ein Bit.

lua_rh.sdi

Sense data included indicator, one bit.

lua_rh.bci

Begin chain indicator, one bit.

lua_rh.eci

Endchainindikator, ein Bit.

lua_rh.dr1i

Eindeutige Antwort 1 Indikator, ein Bit.

lua_rh.dr2i

Eindeutige Antwort 2 Indikator, ein Bit.

lua_rh.ri

Ausnahmeantwortindikator (für eine Anforderung) oder Antworttypindikator (für eine Antwort), ein Bit.

lua_rh.qri

Warteschleifen-Antwortindikator, ein Bit.

lua_rh.pi

Pacing-Indikator, ein Bit.

lua_rh.bbi

Beginnen Sie die Klammernanzeige, ein Bit.

lua_rh.ebi

Endklammernindikator, ein Bit.

lua_rh.cdi

Änderungsrichtungsanzeige, ein Bit.

lua_rh.csi

Codeauswahlindikator, ein Bit.

lua_rh.edi

Enzipherierte Datenanzeige, ein Bit.

lua_rh.pdi

Abstands-Datenindikator, ein Bit.

lua_flag1
Angegebener Parameter. Enthält eine Datenstruktur, die Flags für nachrichten enthält, die von der Anwendung bereitgestellt werden. Dieser Parameter wird von RUI_BID, RUI_READ, RUI_WRITE, SLI_BID, SLI_RECEIVE und SLI_SEND verwendet. Bei anderen LUA-Verben wird dieser Parameter nicht verwendet und sollte auf Null festgelegt werden.

lua_flag1.bid_enable

Bid enable indicator, one bit.

lua_flag1.close_abend

Schließen Sie die Direktanzeige, ein Bit.

lua_flag1.nowait

Keine Wartezeit für datenkennzeichnung, ein Bit.

lua_flag1.sscp_exp

SSCP beschleunigter Fluss, ein Bit.

lua_flag1.sscp_norm

SSCP normaler Fluss, ein Bit.

lua_flag1.lu_exp

LU beschleunigter Fluss, ein Bit.

lua_flag1.lu_norm

LU normaler Fluss, ein Bit.

lua_message_type
Gibt den Typ der eingehenden oder ausgehenden SNA-Befehle und -Daten an. Dies ist ein zurückgegebener Parameter für RUI_INIT und SLI_OPEN und einen angegebenen Parameter für SLI_SEND. Bei anderen LUA-Verben wird diese Variable nicht verwendet und sollte auf Null festgelegt werden.

Mögliche Werte:

LUA_MESSAGE_TYPE_LU_DATA

LUA_MESSAGE_TYPE_SSCP_DATA

LUA_MESSAGE_TYPE_BID

LUA_MESSAGE_TYPE_BIND

LUA_MESSAGE_TYPE_BIS

LUA_MESSAGE_TYPE_CANCEL

LUA_MESSAGE_TYPE_CHASE

LUA_MESSAGE_TYPE_CLEAR

LUA_MESSAGE_TYPE_CRV

LUA_MESSAGE_TYPE_LUSTAT_LU

LUA_MESSAGE_TYPE_LUSTAT_SSCP

LUA_MESSAGE_TYPE_QC

LUA_MESSAGE_TYPE_QEC

LUA_MESSAGE_TYPE_RELQ

LUA_MESSAGE_TYPE_RQR

LUA_MESSAGE_TYPE_RTR

LUA_MESSAGE_TYPE_SBI

LUA_MESSAGE_TYPE_SHUTD

LUA_MESSAGE_TYPE_SIGNAL

LUA_MESSAGE_TYPE_SDT

LUA_MESSAGE_TYPE_STSN

LUA_MESSAGE_TYPE_UNBIND

Die SLI empfängt und antwortet über die LUA-Schnittstellenerweiterungsroutinen auf die BIND-, CRV- und STSN-Anforderungen.

LU_DATA, LUSTAT_LU, LUSTAT_SSCP und SSCP_DATA sind keine SNA-Befehle.

lua_flag2
Zurückgegebener Parameter. Enthält Flags für nachrichten, die von LUA zurückgegeben werden. Dieser Parameter wird von RUI_BID, RUI_READ, RUI_WRITE, SLI_BID, SLI_RECEIVE und SLI_SEND zurückgegeben. Bei anderen LUA-Verben wird dieser Parameter nicht verwendet und sollte auf Null festgelegt werden.

lua_flag2.bid_enable

Gibt an, dass RUI_BID erfolgreich erneut aktiviert wurde, wenn sie auf 1 festgelegt ist.

lua_flag2.async

Gibt an, dass das LUA-Schnittstellenverb asynchron abgeschlossen wurde, wenn er auf 1 festgelegt ist.

lua_flag2.sscp_exp

Gibt den beschleunigten SSCP-Fluss an, wenn er auf 1 festgelegt ist.

lua_flag2.sscp_norm

Gibt den normalen SSCP-Fluss an, wenn er auf 1 festgelegt ist.

lua_flag2.lu_exp

Gibt den beschleunigten LU-Fluss an, wenn er auf 1 festgelegt ist.

lua_flag2.lu_norm

Gibt den normalen LU-Fluss an, wenn er auf 1 festgelegt ist.

lua_resv56
Angegebener Parameter. Reserviertes Feld, das von SLI_OPEN und RUI_INIT verwendet wird. Für alle anderen LUA-Verben ist dieser Parameter reserviert und sollte auf Null festgelegt werden.

lua_encr_decr_option
Feld für Kryptografieoptionen. Bei RUI_INIT werden nur die folgenden Optionen unterstützt:

• lua_encr_decr_option = 0

• lua_encr_decr_option = 128

  Für alle anderen LUA-Verben ist dieser Parameter reserviert und sollte auf Null festgelegt werden.