Metodo IcomLUO.Receive
Riceve i dati in uscita in una sessione LU0.
Sintassi
void Receive(
int timeout,
ref int datasize,
out int indication,
out short seqno,
ref System.Array data
)
Parametri
| Valore | Descrizione |
|---|---|
timeout |
Periodo di tempo in millisecondi in cui il thread può attendere l'arrivo dei dati. Impostando dataSize, è possibile indicare se l'applicazione è disposta ad accettare dati parziali dopo un timeout.L'immissione di 0xffffffff in howLong indica un periodo di tempo infinito. |
datasize |
Quantità massima di dati che l'applicazione è disposta ad accettare. Se dataSize i byte di dati vengono ricevuti prima che il timeout sia in competizione, Receive restituirà la catena parziale.Quando termina, questo metodo contiene il numero di byte presenti nel buffer dei dati. |
indication |
Uno o più flag in un OR bit per bit contenente informazioni aggiuntive sul flusso di dati in uscita. Per altre informazioni, vedere la sezione Osservazioni. |
seqno |
Quando termina, questo metodo contiene il numero di sequenza SNA della catena. Se NEG_RESPONSE è impostato in indication, seqno può invece contenere il numero di sequenza della catena a cui l'host ha inviato una risposta.Il valore restituito in seqno può essere usato in IcomLU0.SendResponse per trasmettere una risposta SNA. |
data |
Matrice contenente i dati da ricevere. |
Valore restituito
| valore | Descrizione |
|---|---|
| S_OK | Un oggetto completo oppure il resto di una catena parziale di dati è stata ricevuta nel buffer dei dati. |
| CLU0_S_PARTIAL_CHAIN | Una catena parziale di dati è stata ricevuta nel buffer dei dati. |
| CLU0_S_TIMEOUT | Nessun dato ricevuto entro il timeout specificato. È consigliabile eseguire un'altra ricezione. |
| CLU0_E_SESSIONFAILURE | La sessione LU0 non è riuscita. |
| CLU0_E_SERVER_FAILURE | La sessione TSS non è più valida. L'applicazione deve rilasciare l'handle di sessione. |
| CLU0_E_WAITING | Un altro thread ha emesso una chiamata Receive per questo metodo e non è ancora stato restituito. |
| CLU0_E_SESSION_FAILED | La sessione SNA sottostante non è riuscita, probabilmente a causa di un'interruzione del collegamento o di un altro errore temporaneo. È necessario disconnettere e rilasciare la sessione del server. In alternativa, è possibile chiamare IcomLU0.Offline per reimpostare la sessione e quindi chiamare IcomLU0.Online alla sessione reattiva. |
| CLU0_E_NOTCONNECTED | Il client comLU0 non è connesso a una sessione tramite una chiamata a Icom3270.Connect. |
| CLU0_E_BADPARAM | Uno dei parametri contiene un valore non valido. |
| CLU0_E_SYSERROR | Il metodo non è riuscito a causa di un errore interno. |
Eccezioni
Osservazioni
In genere, Receive si blocca fino a quando non è disponibile una catena completa di dati SNA. Tuttavia, l'applicazione può controllare il blocco tramite howLong, maxDatae incompleteData.
Receive restituisce solo dati a livello di applicazione. In particolare, Receive non restituirà le intestazioni SNA TH e RH.
Nella tabella seguente vengono descritti i valori possibili per indication.
| Valore | Descrizione |
|---|---|
| SESSION_STARTED | I tipi validi sono: - La sessione avviata da SSCP è stata attivata. - Una sessione reimpostata da clear è stata riavviata da un SDT. - Una sessione che in precedenza ha ricevuto un OGGETTO UNBIUND è stata riattivata da bind e SDT. |
| BEGIN_BRACKET | L'host ha avviato una nuova parentesi. |
| END_BRACKET | L'host ha terminato la parentesi quadra corrente. |
| SEND | L'host ha concesso l'autorizzazione per l'invio. |
| DATA_COMPLETE | I dati rappresentano una catena di dati completa o la fine di una catena di dati. |
| DATA_INCOMPLETE | I dati rappresentano una catena di dati incompleta. |
| ANNULLA | L'ultima catena dall'host è stata annullata. |
| NO_RESPONSE | L'applicazione non deve inviare una risposta ai dati. |
| EXCEPTION_RESPONSE1/2 | L'applicazione può inviare una risposta negativa per rifiutare i dati o un acknowledgement di cortesia. |
| DEFINITE_RESPONSE1/2 | L'applicazione deve inviare una risposta ai dati. |
| POS_RESPONSE | L'host ha inviato una risposta positiva. |
| NEG_RESPONSE | L'host ha inviato una risposta negativa. |
| EXR_REQUEST | Il server SNA ha convertito la richiesta host in una richiesta di eccezione. |
| INSEGUIRE | L'host richiede l'invio di tutte le risposte in sospeso. |
| NORMAL_DATA | I dati sono stati ricevuti nel flusso di dati normale. |
| EXPEDITED_DATA | I dati sono stati ricevuti nel flusso di dati accelerato. |
| APPL_DATA | I dati sono dati dell'applicazione (FMD). |
| FM_DATA | I dati sono dati di gestione delle funzioni (FMH). |
| LU_DATA | I dati sono stati ricevuti nella sessione lu. |
| SSCP_DATA | I dati sono stati ricevuti nella sessione SSCP. |
| CLEAR | L'host ha cancellato la sessione. |
| QUIESCE | L'host ha sospeso la sessione. |
| SHUTDOWN | L'host sta arrestando la sessione. |
| RELEASE | L'host ha annullato lo stato di disattivazione o arresto. |
| SEPARARE | Host non associato alla sessione LU-LU. |