IcomLUO.Receive-Methode

Empfängt ausgehende Daten in einer LU0-Sitzung.

Syntax

  
void Receive(  
   int timeout,  
   ref int datasize,  
   out int indication,  
   out short seqno,  
   ref System.Array data  
)  

Parameter

Wert	BESCHREIBUNG
timeout	Der Zeitraum in Millisekunden, in dem der Thread auf das Eintreffen von Daten warten kann. Durch festlegen dataSizekönnen Sie angeben, ob die Anwendung bereit ist, nach einem Timeout Teildaten zu akzeptieren. Die Eingabe 0xffffffff in howLong bedeutet eine unendliche Zeitdauer.
datasize	Die maximale Datenmenge, die die Anwendung akzeptieren möchte. Wenn dataSize Datenbytes empfangen werden, bevor das Timeout konkurrieren wird, gibt Receive die partielle Kette zurück. Wenn diese Methode zurückgibt, enthält die Anzahl der Bytes, die im Datenpuffer vorhanden sind.
indication	Mindestens ein Flag in einem bitweisen OR mit zusätzlichen Informationen zum ausgehenden Datenstrom. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.
seqno	Wenn diese Methode zurückgibt, enthält die SNA-Sequenznummer der Kette. Wenn NEG_RESPONSE in indicationfestgelegt ist, seqno kann stattdessen die Sequenznummer der Kette enthalten, an die der Host eine Antwort gesendet hat. Der zurückgegebene seqno Wert kann in IcomLU0.SendResponse verwendet werden, um eine SNA-Antwort zu übertragen.
data	Ein Array, das die zu empfangenden Daten enthält.

Rückgabewert

Wert	BESCHREIBUNG
S_OK	Eine vollständige oder sonst der Rest einer partiellen Datenkette wurde in den Datenpuffer empfangen.
CLU0_S_PARTIAL_CHAIN	Eine partielle Datenkette wurde in den Datenpuffer empfangen.
CLU0_S_TIMEOUT	Innerhalb des angegebenen Timeouts wurden keine Daten empfangen. Sie sollten einen anderen Empfang ausgeben.
CLU0_E_SESSIONFAILURE	Fehler bei der LU0-Sitzung.
CLU0_E_SERVER_FAILURE	Die TSS-Sitzung ist nicht mehr gültig. Die Anwendung sollte das Sitzungshandle freigeben.
CLU0_E_WAITING	Ein anderer Thread hat einen Receive-Aufruf für diese Methode ausgegeben und wurde noch nicht zurückgegeben.
CLU0_E_SESSION_FAILED	Fehler bei der zugrunde liegenden SNA-Sitzung, möglicherweise aufgrund eines Verbindungsausfalls oder eines anderen vorübergehenden Fehlers. Sie müssen die Verbindung trennen und die Serversitzung freigeben. Alternativ können Sie IcomLU0.Offline aufrufen, um die Sitzung zurückzusetzen, und dann IcomLU0.Online aufrufen, um die Sitzung zu reaktivieren.
CLU0_E_NOTCONNECTED	Der comLU0-Client ist über einen Aufruf von Icom3270.Connect nicht mit einer Sitzung verbunden.
CLU0_E_BADPARAM	Einer der Parameter enthielt einen ungültigen Wert.
CLU0_E_SYSERROR	Die Methode ist aufgrund eines internen Fehlers fehlgeschlagen.

Ausnahmen

Bemerkungen

Normalerweise erhalten Sie Blöcke, bis eine vollständige Kette von SNA-Daten verfügbar ist. Die Anwendung kann den Block jedoch über howLong, maxDataund incompleteDatasteuern.

Empfangen gibt nur Daten auf Anwendungsebene zurück. Insbesondere gibt Receive die SNA-TH- und RH-Header nicht zurück.

In der folgenden Tabelle werden die möglichen Werte für indicationbeschrieben.

Wert	BESCHREIBUNG
SESSION_STARTED	Einer der folgenden: – Die SSCP-initiierte Sitzung wurde aktiviert. – Eine Sitzung, die von einer CLEAR zurückgesetzt wurde, wurde von einem SDT neu gestartet. – Eine Sitzung, die zuvor eine UNBIUND-Instanz erhalten hat, wurde von bind und SDT reaktiviert.
BEGIN_BRACKET	Der Host hat eine neue Klammer gestartet.
END_BRACKET	Der Host hat die aktuelle Klammer beendet.
SEND	Der Host hat die Berechtigung zum Senden erteilt.
DATA_COMPLETE	Die Daten stellen eine vollständige Datenkette oder das Ende einer Datenkette dar.
DATA_INCOMPLETE	Die Daten stellen eine unvollständige Datenkette dar.
CANCEL	Die letzte Kette vom Host wurde abgebrochen.
NO_RESPONSE	Die Anwendung sollte keine Antwort auf die Daten senden.
EXCEPTION_RESPONSE1/2	Der Antrag kann eine negative Antwort senden, um die Daten abzulehnen, oder eine Höflichkeitsbestätigung.
DEFINITE_RESPONSE1/2	Die Anwendung muss eine Antwort auf die Daten senden.
POS_RESPONSE	Der Host hat eine positive Antwort gesendet.
NEG_RESPONSE	Der Host hat eine negative Antwort gesendet.
EXR_REQUEST	Der SNA-Server konvertierte die Hostanforderung in eine Ausnahmeanforderung.
CHASE	Der Host fordert an, dass alle ausstehenden Antworten gesendet werden.
NORMAL_DATA	Die Daten wurden im normalen Datenfluss empfangen.
EXPEDITED_DATA	Die Daten wurden im beschleunigten Datenfluss empfangen.
APPL_DATA	Bei den Daten handelt es sich um FMD-Daten (Application).
FM_DATA	Bei den Daten handelt es sich um FMH-Daten (Function Management).
LU_DATA	Die Daten wurden in der LU-Sitzung empfangen.
SSCP_DATA	Die Daten wurden in der SSCP-Sitzung empfangen.
CLEAR	Der Host hat die Sitzung gelöscht.
STILLLEGEN	Der Host hat die Sitzung stillgehalten.
SHUTDOWN	Der Host beendet die Sitzung.
RELEASE	Der Host hat den Ruhezustand oder den Herunterfahren-Zustand abgebrochen.
BINDUNG	Der Host hebt die Bindung der LU-LU-Sitzung auf.

Weitere Informationen

IcomLU0-Methoden
Session Integrator für LU0