Partager via

Scripts préenregistrés avec l’intégrateur de sessions

  • Article

La classe SessionDisplayScript permet aux utilisateurs d’utiliser un script créé dans le client Host Integration Server 3270 et de le lire par programmation.

Le script peut implémenter des variables à l’aide d’un signe double pour cent à chaque extrémité du nom, par exemple, %%MYVARIABLE%%. Ces variables sont résolues à l’aide de la classe SessionDisplayVariableCollection fournie dans cette classe. En outre, le fichier de script peut contenir des variables d’environnement à l’aide de la notation standard que cette classe traduit.

SessionDisplayScript, classe

Le script d’entrée doit être un fichier texte normal avec une commande par ligne. Le fichier script prend en charge les commandes suivantes :

Commande Description
SETTIMEOUT {timeout},{label} Définit le délai d’expiration par défaut pour toutes les commandes et l’étiquette où le traitement doit se poursuivre. Si aucune valeur par défaut n’est définie, 30 secondes sont supposées.
WAITSESSION {wait} Attend que la session soit dans l’état d’attente d’entrée avant de revenir. Les valeurs acceptées sont : SSCP ; LULU; UNOWNED
WAIT {seconds} Attend le nombre de secondes d’entrée, puis passe à la commande suivante. La commande WAIT peut être remplacée par la commande WAITSTRING pour attendre une chaîne spécifique à l’écran.
SETCURSOR {ROW},{COLUMN} Déplace le curseur à la position souhaitée à l’écran. Si la position est introuvable à l’écran, le script est abandonné et une exception ScriptError est retournée avec une InnerException de l’exception réelle lors de l’exécution du script.
SEND {string}, {%environmentvariable%}, {%%sessiondisplayvariable%%} Provoque l’envoi de la chaîne à l’écran à l’aide de la méthode SendKeys. Les variables peuvent être des entrées qui sont mises en correspondance avec sessionDisplayVariablesCollection passées dans la classe . Si une variable ne se trouve pas dans le script, le script est abandonné et une exception ScriptError est retournée avec une InnerException de variable {name} qui ne se trouve pas dans la collection.
GOTO {label} Permet aux scripts d’accéder aux étiquettes sous la ligne actuelle. Si l’étiquette est introuvable, le script abandonne avec une exception ScriptError et une InnerException de « Étiquette {name} introuvable ». {label} = Moyen de définir une étiquette de forme libre dans le script qui peut être utilisée dans des scénarios de création de branchement.