Metodo IcomLUO.Online
Imposta di nuovo la sessione LU0 in uno stato on-line dopo una chiamata a Offline.
Sintassi
void Online(
short initType,
ref System.Array data,
int timeout)
Parametri
| Parametro | Descrizione |
|---|---|
initType |
Descrive il tipo di avvio della sessione. Per altre informazioni, vedere la sezione Osservazioni. |
data |
Contiene il messaggio di accesso INITSELF o SSCP, se necessario. |
timeout |
Periodo di tempo in millisecondi di attesa per l'arrivo di BIND e SDT. Se il timeout scade prima dell'arrivo di SDT, l'lu del server SNA verrà rilasciato e verrà restituito un errore. 0xffffffff indica un timeout infinito. |
Valore restituito
| valore | Descrizione |
|---|---|
| S_OK | La sessione LU0 è stata riattivata correttamente e la sessione lu è attiva e pronta per ricevere l'input. |
| CLU0_S_SSCP_ACTIVE | La sessione LU0 è stata riattivata correttamente e la sessione SSCP è attiva e pronta per ricevere l'input. Valido solo quando initType è impostato su INIT_SSCP. |
| CLU0_E_NEG_RESPONSE | L'host o il server SNA hanno inviato una risposta negativa al comando DIITSELF o di accesso non formattato. Valido solo se initType è impostato su INIT_INITSELF o INIT_LOGON |
| CLU0_E_BADPARAM | connectionStr contiene un'impostazione di proprietà non valida. |
| CLU0_E_NOFREELU | luname specificato un pool di unità logiche del server SNA e nessunA unità di archiviazione sono gratuite in tale pool. |
| CLU0_E_LUINUSE | luname specificato un'unità lu del server SNA e l'lu è attualmente in uso da un'altra applicazione. |
| CLU0_E_LUNOTFOUND | Il nome lu o pool non esiste. |
| CLU0_E_TIMEDOUT | La sessione non è stata avviata entro il timeout specificato. |
| 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. Facoltativamente, è possibile eseguire una chiamata a Icom3270.Offline per reimpostare il server e quindi riattivare la sessione usando una chiamata a Icom3270.Online. |
| CLU0_E_SERVER_FAILURE | La sessione TSS non è più valida. È consigliabile rilasciare l'handle di sessione. |
| CLU_E_WAITING | Un altro thread ha emesso una chiamata Receive per questo metodo, che non ha ancora restituito. |
| CLU_E_SYSERROR | Questo metodo non è riuscito a causa di un errore interno. |
Eccezioni
Osservazioni
Online tenterà di acquisire lo stesso lu server SNA e quindi lo stesso server SNA, usato quando la sessione è stata l'ultima on-line.
Nella tabella seguente vengono descritti i valori possibili per initType.
| Nome | Valore | Descrizione |
|---|---|---|
| INIT_BIND | 0 | Attendere bind e SDT non richiesti dalla PLU. |
| INIT_SSCP | 1 | Attendere l'arrivo di bind e SDT, ma consentire all'applicazione di accedere alla sessione SSCP per inviare dati e comandi SSCP. |
| INIT_INITSELF | 2 | Attendere l'arrivo di bind e SDT dopo l'invio del comando INITSELF specificato in data. |
| INIT_LOGON | 3 | Attendere l'arrivo di BIND e SDT dopo l'invio del messaggio di accesso SSCP UNFORMATTED specificato in data. |