Icom3270.Wait, méthode

La méthode Wait attend que la session passe à l’État dans lequel l’entrée est autorisée ou lorsque l’écran est modifié.

Syntaxe

  
void Wait(  
   uint howLong,  
   int waitForUpdate  
)  

Paramètres

Paramètres Valeur
howLong Un certain temps, mesuré en unités de 0,5 secondes, que le thread est disposé à Waif pour permettre l’activation de l’entrée ou la mise à jour de 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 est immédiatement retournée 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 d’Wait. Vous devez Gall getScreenSize pour déterminer la taille de l’é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 Wait.
C3270_E_SESSSIONLOCKED La session 3270 est verrouillée en raison d’une condition de verrouillage locale.

Vous devez examiner la mémoire tampon indicateurs pour déterminer la raison de l’erreur. Vous pouvez également envoyer une séquence de touches de réinitialisation pour déverrouiller le clavier avant d’appeler une nouvelle fois l’opération de récupération ou 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 alors que l’attente était en cours.

Vous devez examiner l’état de la session dans le indicateurs pour la session et effectuer l’action de récupération appropriée.
C3270_E_SYSERROR La méthode a échoué en raison d’une erreur interne.

Remarques

L’appel d’Wait permet à la session de traiter les messages à partir 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 de l’écran dans des opérations distinctes. En particulier, vous devez le faire dans la session SSCP, où l’entrée est activée lors de la réception d’une réponse SNA aux données du client. Les données de réponse sont en retrait négatif sur un message suivant.