Allgemeine Struktur von LUA-VCBs

Die folgende Datenstruktur zeigt die Parameter, die allen LUA-Verben (Logical Unit Application) von Microsoft® Windows® gemeinsam sind.

Syntax

  
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;  

Hinweise

Member

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. Für beide Makros ist der Wert 0x5200.

lua_verb_length
Angegebener Parameter. Gibt die Länge der LUA-VCB in Byte an. Sie muss die Länge des ausgestellten Verbdatensatzes enthalten.

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

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

lua_opcode
Angegebener Parameter. Enthält den LUA-Befehlscode (Verbvorgangscode) für das ausstellende Verb, z. B. LUA_OPCODE_RUI_BID für das RUI_BID Verb. Gültige Werte sind:

LUA_OPCODE_SLI_OPEN

LUA_OPCODE_SLI_CLOSE

LUA_OPCODE_SLI_RECEIVE

LUA_OPCODE_SLI_SEND

LUA_OPCODE_SLI_PURGE

LUA_OPCODE_SLI_BID

LUA_OPCODE_SLI_BIND_ROUTINE

LUA_OPCODE_SLI_STSN_ROUTINE

LUA_OPCODE_SLI_CRV_ROUTINE

LUA_OPCODE_RUI_INIT

LUA_OPCODE_RUI_TERM

LUA_OPCODE_RUI_READ

LUA_OPCODE_RUI_WRITE

LUA_OPCODE_RUI_PURGE

LUA_OPCODE_RUI_BID

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 und auf der rechten Seite 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 bis zur Erweiterungsliste der vom Benutzer bereitgestellten DlLs (Dynamic Link Libraries) an. Dieser Parameter wird von RUI in Microsoft® Host Integration Server nicht verwendet und sollte auf 0 (null) festgelegt werden. Der Wert muss der Anfang einer Wortgrenze sein, es sei denn, es gibt keine Erweiterungsliste.

lua_cobol_offset
Offset der COBOL-Erweiterung. Wird nicht von LUA in Host Integration Server verwendet und sollte 0 (null) sein.

lua_sid
Angegebener und zurückgegebener Parameter. Gibt den Sitzungsbezeichner an und wird von SLI_OPEN und RUI_INIT zurückgegeben. Andere Verben verwenden diesen Parameter, um die sitzung zu identifizieren, die für den Befehl verwendet wird. Wenn andere Verben den parameter lua_luname verwenden, um Sitzungen zu identifizieren, legen Sie den parameter lua_sid auf null fest.

lua_max_length
Gibt die Länge des empfangenen Puffers für RUI_READund SLI_RECEIVE an. Für andere RUI- und SLI-Verben wird es nicht verwendet und sollte auf 0 (null) festgelegt werden.

lua_data_length
Gibt die Länge der gesendeten oder empfangenen Daten an. Es gibt die Länge der Daten an, die in lua_peek_data für das RUI_BID Verb zurückgegeben werden.

lua_data_ptr
Zeiger auf einen von der Anwendung bereitgestellten Puffer.

Wenn SLI_RECEIVE oder RUI_READ ausgegeben wird, verweist dieser Parameter auf den Speicherort, an dem die Daten vom Host empfangen werden.

Wenn SLI_SEND oder RUI_WRITE ausgegeben wird, verweist dieser Parameter auf den Speicherort der Anwendungsdaten, die an den Host gesendet werden sollen.

Wenn SLI_PURGE oder RUI_PURGE ausgegeben wird, verweist dieser Parameter auf die Position der SLI_RECEIVE oder RUI_READ VcB RUI_READ Verbs, die abgebrochen werden soll.

Wenn SLI_OPEN ausgegeben wird, kann dieser Parameter einer der folgenden Sein:

• Die Anmeldemeldung für den normalen SSCP-Flow, wenn der Initialisierungstyp sekundär mit einer unformatierten Anmeldemeldung ist.

• Die Anforderungs-/Antworteinheit (RU) für INITSELF. Wenn der Initialisierungstyp mit INITSELF sekundär ist, werden die erforderlichen Daten für die Anwendung bereitgestellt.

• Für alle anderen geöffneten Typen sollte dieses Feld auf 0 (null) festgelegt werden.

  Für andere RUI- und SLI-Verben (Session Level Interface) wird dieser Parameter nicht verwendet und sollte auf null festgelegt werden. Sowohl SNA-Befehle als auch -Daten werden in diesem Puffer platziert und können im EBCDIC-Format vorliegen.

  Diese Informationen werden von der Windows LUA-Anwendung bereitgestellt.

  lua_post_handle
  Angegebener Parameter. Wird unter Windows verwendet, wenn asynchrone Benachrichtigungen von Ereignissen ausgeführt werden sollen. Diese Variable enthält das Handle des zu signalisierenden Ereignisses 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. Die Unterparameter sind wie folgt:

  lua_th.flags_fid

  Formatidentifikationstyp 2, vier Bits.

  lua_th.flags_mpf

  Segmentierungszuordnungsfeld, zwei Bits. Definiert den Typ des Datensegments. Folgende Werte sind gültig:

• 0x00 Mittleres Segment

• 0x01 Letztes Segment

• 0x02 Erstes Segment

• nur 0x03 Segment

lua_th.flags_odai

Ursprungsadressfeld–Zieladressfeld (OAF–DAF) Assignor-Indikator, ein Bit.

lua_th.flags_efi

Beschleunigter Flussindikator, ein Bit.

lua_th.daf

Zieladressfeld (DAF), ein Zeichen ohne Vorzeichen.

lua_th.oaf

Ursprungsadressfeld (OAF), ein zeichenloses Zeichen.

lua_th.snf

Sequenznummerfeld, ein Zeichen ohne Vorzeichen[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. Die Unterparameter sind wie folgt:

lua_rh.rri

Anforderungsantwortindikator, ein Bit.

lua_rh.ruc

RU-Kategorie, zwei Bits. Folgende Werte sind gültig:

LUA_RH_FMD (0x00) FM-Datensegment-LUA_RH_NC (0x20) NetzwerksteuerungLUA_RH_DFC (0x40) DatenflusssteuerungLUA_RH_SC (0x60) Sitzungssteuerung

lua_rh.fi

Formatindikator, ein Bit.

lua_rh.sdi

Sense-Daten enthalten Indikator, ein Bit.

lua_rh.bci

Beginnen Sie den Kettenindikator, ein Bit.

lua_rh.eci

End chain indicator, ein Bit.

lua_rh.dr1i

Eindeutige Antwort 1 Indikator, ein Bit.

lua_rh.dr2i

Definitive Antwort 2 Indikator, ein Bit.

lua_rh.ri

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

lua_rh.qri

Warteschleifenantwortindikator, ein Bit.

lua_rh.pi

Geschwindigkeitsindikator, ein Bit.

lua_rh.bbi

Klammernanzeige beginnen, ein Bit.

lua_rh.ebi

Endklammerindikator, ein Bit.

lua_rh.cdi

Richtungsanzeige ändern, ein Bit.

lua_rh.csi

Codeauswahlindikator, ein Bit.

lua_rh.edi

Enchiffrierte Datenanzeige, ein Bit.

lua_rh.pdi

Indikator für gepolsterte Daten, ein Bit.

lua_flag1
Angegebener Parameter. Enthält eine Datenstruktur, die Flags für von der Anwendung bereitgestellte Nachrichten enthält. Dieser Parameter wird von RUI_BID, RUI_READ, RUI_WRITE, SLI_BID, SLI_RECEIVE und SLI_SEND verwendet. Für andere LUA-Verben wird dieser Parameter nicht verwendet und sollte auf Null festgelegt werden. Die Unterparameter sind wie folgt:

lua_flag1.bid_enable

Gebotsaktiv-Indikator, ein Bit.

lua_flag1.close_abend

Schließen Sie den Sofortindikator, ein Bit.

lua_flag1.nowait

Kein Warten auf das Datenflag, 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 sowie ein bereitgestellter Parameter für SLI_SEND. Für andere LUA-Verben wird diese Variable nicht verwendet und sollte auf 0 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

Der SLI empfängt und antwortet die ANFORDERUNGEN BIND, CRV und STSN über die LUA-Schnittstellenerweiterungsroutinen.

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

lua_flag2
Zurückgegebener Parameter. Enthält Flags für von LUA zurückgegebene Nachrichten. Dieser Parameter wird von RUI_BID, RUI_READ, RUI_WRITE, SLI_BID, SLI_RECEIVE und SLI_SEND zurückgegeben. Für andere LUA-Verben wird dieser Parameter nicht verwendet und sollte auf null festgelegt werden. Die Unterparameter sind wie folgt:

lua_flag2.bid_enable

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

lua_flag2.async

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

lua_flag2.sscp_exp

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

lua_flag2.sscp_norm

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

lua_flag2.lu_exp

Gibt lu expedited flow 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
Dieser angegebene Parameter ist ein 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
Dieser Parameter ist ein Feld für Kryptografieoptionen. Auf RUI_INIT werden nur Folgende 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.