:SET_SCRIPT_VAR
Utilisez l'instruction de script :SET_SCRIPT_VAR pour définir la valeur des variables de script de manière indirecte, sans avoir à spécifier explicitement le nom des variables de script. Cette instruction utilise un caractère de remplacement pour définir les valeurs. :SET_SCRIPT_VAR vous permet de définir les valeurs de plusieurs variables avec une seule ligne de script et est utile dans les boucles de traitement. Le caractère de remplacement est une chaîne de caractères contenant le nom de la variable dont vous souhaitez définir la valeur.
Syntaxe
:SET_SCRIPT_VAR Script variable = Value
Paramètres
- SET_SCRIPT_VAR
- Script Variable
Caractère de remplacement pour le nom de la variable de script dont vous souhaitez définir la valeur
Format : littéral de script ou variable de script- Ne commencez pas un caractère de remplacement par une esperluette (&), car elle est utilisée pour les noms de variables.
- Respectez les autres règles de nommage des variables. Pour plus d'informations, voir Noms des variables.
- Incluez autant de caractères initiaux que nécessaire pour identifier la variable de manière unique. :SET_SCRIPT_VAR identifie la variable et ajoute des caractères pour générer le nom complet.
- Value
Valeur attribuée à la variable de script
Terminez la valeur de script par un dièze (#).
Format : script, variable de script ou fonction de script
Remarque : Cette instruction de script ne crée pas de variable de script. Utilisez l'instruction de script :SET pour créer d'abord les variables de script et leur affecter des valeurs intiales.
Important !
- Toute tentative d'accès à une variable de script inexistante provoque une erreur.
- Si la variable de script ne peut pas être identifiée de manière univoque, aucune valeur n'est affectée.
- Cette instruction de script ne distingue pas les majuscules et les minuscules dans les noms des variables de script. Si vous utilisez des caractères de remplacement qui ne diffèrent que par leur casse, le système accèdera à la même variable de script.
Exemple
L'exemple suivant utilise un objet variable et un job. Supposons que trois variables soient stockées dans l'objet Variable avec une valeur définie pour chaque variable. Le noms de variables (End#, Start# et Ultimo#) sont définis dans la première colonne (Clé) de la page Variables de la définition d'objet et les valeurs sont conservées dans la seconde colonne (Valeur 1).
L'objet Job contient un script qui définit une boucle de traitement. Le script lit le nom des variables de script dans la première colonne de l'objet Variable et les valeurs de variables dans la seconde colonne. Le script affecte les valeurs extraires aux variables &END#, &START# et &ULTIMO#.
:SET &END# =
""
:SET &START# = ""
:SET &ULTIMO# = ""
:SET &HANDLE# = PREP_PROCESS_VAR(VARA.NEW.7)
:PROCESS &HANDLE#
:SET &VARIABLE#
= GET_PROCESS_LINE(&HANDLE#,1)
:SET &VALUE#
= GET_PROCESS_LINE(&HANDLE#,2)
:SET_SCRIPT_VAR &VARIABLE#=&VALUE#
:PRINT "&VARIABLE# = &VALUE#"
:ENDPROCESS
:CLOSE_PROCESS &HANDLE#
L'instruction :PRINT écrit une ligne pour chaque nom de variable de script extraite (Clé) et la valeur correspondante (Valeur 1) dans le rapport d'activation :
2017-02-28 13:46:59 - U0020408 End# = 20170227
2017-02-28 13:46:59 - U0020408 Start# = 20170224
2017-02-28 13:46:59 - U0020408 Ultimo# = 20170228
Voir aussi :