Icom3270.Wait, méthode

La méthode wait attend que la session entre dans un état où l’entrée est autorisée ou où l’écran est modifié.

Syntaxe

  
void Wait(  
   uint howLong,  
   int waitForUpdate  
)  

Paramètres

Paramètres Valeur
howLong Période de temps, mesurée en unités de 0,5 seconde, pendant laquelle le thread est prêt à activer l’entrée ou à mettre à jour l’écran. 0xffffffff indique que le thread doit attendre indéfiniment.
waitForUpdate Si la valeur est false, cette méthode retourne dès que la session est dans un état d’entrée autorisé.

La session retourne immédiatement si la session est actuellement dans un état d’entrée autorisé.

Pour plus d'informations, consultez la section Notes.

Valeur de retour

Valeur Description
S_OK La session est disponible pour l’entrée.
C3270_S_SIZECHANGED La session est disponible pour l’entrée, mais la taille de l’écran a été modifiée lors de l’appel de l’attente. Vous devez obtenir getScreenSize pour déterminer la nouvelle taille d’écran.
C3270_E_SESSIONBUSY La session 3270 est toujours occupée, mais le délai d’attente spécifié par howLong a expiré.

Vous devez effectuer tout traitement nécessaire avant d’appeler à nouveau.
C3270_E_SESSSIONLOCKED La session 3270 est verrouillée en raison d’une condition de verrouillage local.

Vous devez examiner la mémoire tampon OIA pour déterminer la raison de l’erreur. Vous pouvez également envoyer une séquence de touches RÉINITIALISER pour déverrouiller le clavier avant d’appeler à nouveau ou d’effectuer toute autre action de récupération.
C3270_E_SESSIONFAILURE Échec de la session 3270. La session PLU_SLU ou SSCP a été désactivée pendant que l’attente était en cours.

Vous devez examiner la session status de session dans l’OIA pour la session et prendre les mesures de récupération appropriées.
C3270_E_SYSERROR La méthode a échoué en raison d’une erreur interne.

Remarques

L’appel d’attente permet à la session de traiter les messages de l’hôte lorsque l’application est active, connectée à l’hôte et en attente de données.

Vous devez définir waitForUpdate sur true lorsque l’hôte déverrouille le clavier et envoie des mises à jour d’écran dans des opérations distinctes. En particulier, vous devez le faire sur la session SSCP, où l’entrée est activée à la réception d’une réponse SNA aux données du client. Les données de réponse sont dente sur un message suivant.