Metodo IcomLUO.Send
Invia una catena completa di dati in ingresso in una sessione LU0.
Sintassi
void Send(
int hint,
ref System.Array data,
out short seqno)
Parametri
| Parametro | Descrizione |
|---|---|
hint |
Suggerimento dell'applicazione per quanto riguarda il modo in cui i dati devono essere elaborati. Per altre informazioni, vedere la sezione osservazioni. |
data |
I dati da inviare. |
seqno |
Quando questo metodo restituisce, contiene il numero di sequenza SNA della catena. È possibile usare il valore restituito da seqno per correlare qualsiasi risposta che l'host può inviare in un secondo momento. |
Valore restituito
| valore | Descrizione |
|---|---|
| S_OK | I dati sono stati inviati correttamente. Se pertinente, è stata ricevuta anche una risposta positiva. |
| CLU0_S_MULTI_CHIIN | La sessione non supporta catene multi-UR, ma i dati sono maggiori delle dimensioni delle UR. comLU0 ha inviato i dati come sequenza di singole catene di UR. |
| CLU0_S_DEFINITE_RSP_MODE | comLU0 ha inviato i dati usando la modalità DEFINITE_RESPONSE quando è stata richiesta EXCEPTION_RESPONSE o NO_RESPONSE. |
| CLU0_S_EXCEPTION_RSP_MODE | comLU0 invia i dati usando la modalità EXCEPTION_RESPONSE quando è stato richiesto DEFINITE_RESPONSE o NO_RESPONSE. |
| CLU0_S_NO_RSP_MODE | comLU0 ha inviato i dati usando la modalità NO_RESPONSE quando è stata richiesta DEFINITE_RESPONSE o EXCEPTION_RESPONSE. |
| CLU0_E_NEG_RESPONSE | L'host o il server SNA hanno inviato una risposta negativa al DEFINITE_RESPONSE. |
| CLU0_E_NO_RSP_REQUESTED | Nessuna risposta ricevuta dall'host a una richiesta RQD. Si dovrebbe chiamare IcomLU0.Receive per determinare il motivo per cui non è stata ricevuta la risposta. Ad esempio, un CLEAR potrebbe essere stato ricevuto o la sessione ha riscontrato un'interruzione. |
| CLU0_E_BRACKED_NOT_ALLOWED | La sessione era tra parentesi quadre, ma comLU0 non era consentito avviare una nuova parentesi quadre. Questo problema si è verificato a causa della ricezione di una SBI dall'host. |
| CLU0_E_SESSION_FAILED | La sessione SNA sottostante non è riuscita, possibilmente eseguire un'interruzione del collegamento o un altro errore temporaneo. È necessario disconnettere e rilasciare la sessione del server. Facoltativamente, è possibile chiamare IcomLU0.Offline per reimpostare la sessione e quindi chiamare IcomLU0.Online per reattiva la sessione. |
| CLU0_E_RECEIVE_IN_PROGRESS | L'applicazione non ha completato la ricezione dell'ultima catena inviata dall'host. Questo è probabilmente indicato dalla ricezione che restituisce il messaggio di DATA_INCOMPLETE. È consigliabile rimettere la chiamata IcomLU0.Receive per raccogliere i dati rimanenti e quindi chiamare di nuovo Invia. |
| CLU0_E_SERVER_FAILURE | La sessione TSS non è più valida. È consigliabile rilasciare l'handle di sessione. |
| CLU0_E_WAITING | Un altro thread ha rilasciato una chiamata di ricezione per questo metodo, che non è ancora stato restituito. |
| CLU0_E_SESSIONFAILURE | La sessione LU0 non è riuscita. |
| CLU0_E_NOTCONNECTED | Il client comLU0 non è connesso a una sessione tramite una chiamata a Icom3270.Connect. |
| CLU0_E_SYSERROR | L'invio non è riuscito a causa di un errore di sistema. |
Eccezioni
Osservazioni
Il SNA TH e RH vengono forniti da comLU0 e non devono essere presenti nei dati presentati dall'applicazione.
Nella tabella seguente vengono descritti i valori possibili per hint.
| Valore | Descrizione |
|---|---|
| END_BRACKET | comLU0 deve terminare la parentesi quadre corrente. |
| PREPARE_TO_RECEIVE | L'applicazione sta per immettere lo stato di ricezione. |
| NO_RESPONSE | L'applicazione non richiede una risposta dall'host. |
| EXCEPTION_RESPONSE1/2 | L'applicazione richiede che l'host invii solo una risposta negativa. |
| DEFINITIE_RESPONSE1/2 | L'applicazione richiede che l'host invii una risposta ai dati. |
| NORMAL_DATA | L'applicazione invia l'oggetto nel normale flusso di dati. |
| EXPEDITED_DATA | L'applicazione invia i dati 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 | L'applicazione invia i dati nella sessione LU. |
| SCP_DATA | L'applicazione invia i dati nella sessione SSCP. |