Metodo Icom3270.wait

Il metodo wait attende che la sessione entri in uno stato in cui l'input è consentito o la schermata viene modificata.

Sintassi

  
void Wait(  
   uint howLong,  
   int waitForUpdate  
)  

Parametri

Parametri Valore
howLong Periodo di tempo, misurato in unità di 0,5 secondi, che il thread è disposto a waif per l'ammissione dell'input o l'aggiornamento della schermata. 0xffffffff indica che il thread deve attendere per un tempo indefinito.
waitForUpdate Se false, questo metodo restituirà non appena la sessione si trova in uno stato di input consentito.

La sessione viene restituita immediatamente se la sessione è attualmente in uno stato di input consentito.

Per altre informazioni, vedere la sezione Osservazioni.

Valore restituito

valore Descrizione
S_OK La sessione è disponibile per l'input.
C3270_S_SIZECHANGED La sessione è disponibile per l'input, ma le dimensioni dello schermo sono state modificate durante la chiamata di wait. È consigliabile utilizzare getScreenSize per determinare le nuove dimensioni dello schermo.
C3270_E_SESSIONBUSY La sessione 3270 è ancora occupata, ma il periodo di timeout specificato da howLong è scaduto.

È necessario eseguire qualsiasi elaborazione necessaria prima di chiamare di nuovo wait.
C3270_E_SESSSIONLOCKED La sessione 3270 è bloccata a causa di una condizione di blocco locale.

Esaminare il buffer OIA per determinare il motivo dell'errore. È anche possibile inviare una sequenza di tasti RESET per sbloccare la tastiera prima di chiamare di nuovo wait o di eseguire qualsiasi altra azione di ripristino.
C3270_E_SESSIONFAILURE La sessione 3270 non è riuscita. La sessione PLU_SLU o SSCP è stata disattivata mentre era in corso l'attesa.

È necessario esaminare lo stato della sessione nell'OIA per la sessione ed eseguire l'azione di ripristino appropriata.
C3270_E_SYSERROR Il metodo non è riuscito a causa di un errore interno.

Commenti

La chiamata di wait consente alla sessione di elaborare i messaggi dall'host quando l'applicazione è attiva, connessa all'host e in attesa dei dati.

È necessario impostare waitForUpdate su true quando l'host sblocca la tastiera e invia gli aggiornamenti dello schermo in operazioni separate. In particolare, è necessario eseguire questa operazione nella sessione SSCP, in cui l'input è abilitato alla ricezione di una risposta SNA ai dati dal client. I dati di risposta vengono ammaccati in un messaggio successivo.