Metodo Icom3270.wait

Il metodo wait attende che la sessione immetta uno stato in cui è consentito l'input o che la schermata venga 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 rinunciare per l'input da abilitare o la schermata da aggiornare. 0xffffffff indica che il thread deve attendere in modo indefinito.
waitForUpdate	Se false, questo metodo restituirà non appena la sessione è in uno stato consentito di input. La sessione restituisce immediatamente se la sessione è attualmente in uno stato consentito di input. 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 la dimensione dello schermo è stata modificata durante la chiamata di attesa. Si dovrebbe ottenere gall getScreenSize per determinare le nuove dimensioni dello schermo.
C3270_E_SESSIONBUSY	La sessione 3270 è ancora occupato, ma il periodo di timeout specificato da howLong è scaduto. È consigliabile eseguire qualsiasi elaborazione necessaria prima di chiamare di nuovo l'attesa.
C3270_E_SESSSIONLOCKED	La sessione 3270 è bloccata a causa di una condizione di blocco locale. È necessario 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 o eseguire qualsiasi altra azione di ripristino.
C3270_E_SESSIONFAILURE	La sessione 3270 non è riuscita. La sessione PLU_SLU o SSCP è stata disattivata mentre l'attesa era in corso. È necessario esaminare lo stato della sessione nell'OIA per la sessione e intraprendere un'azione di ripristino appropriata.
C3270_E_SYSERROR	Il metodo non è riuscito a causa di un errore interno.

Commenti

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

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