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.