Manuel des Scripts Automation Engine > Organisation fonctionnelle > Elaboration et traitement des Scripts > :SET

:SET

Instruction de script : Attribue une valeur à une variable de script.

Syntaxe

:S[ET] Script variable = Value

Syntaxe	Description/format
Variable de script	Nom de la variable de script qui doit recevoir une valeur. Le nom des variables de script est limité à 32 caractères alphanumériques, incluant les caractères spéciaux "$", "_", "@", "§" et "#". Les signes diacritiques ne sont pas autorisés. Le premier caractère du nom ne peut pas être un chiffre. Dans le script, les variables sont toujours indiquées avec le signe "&" précédant le nom ! Format : variable de script
Valeur	Valeur qui est attribuée à la variable de script. Format : littéral de script, variable de script ou fonction de script

Syntaxe

Description/format

Variable de script

Nom de la variable de script qui doit recevoir une valeur.

Le nom des variables de script est limité à 32 caractères alphanumériques, incluant les caractères spéciaux "$", "_", "@", "§" et "#". Les signes diacritiques ne sont pas autorisés. Le premier caractère du nom ne peut pas être un chiffre. Dans le script, les variables sont toujours indiquées avec le signe "&" précédant le nom !

Format : variable de script

Valeur

Valeur qui est attribuée à la variable de script.
Format : littéral de script, variable de script ou fonction de script

Remarques

Reportez-vous au document qui décrit les particularités et les spécificités d'utilisation des variables de script.

Si la variable indiquée n'existe pas encore, elle est créée. Dans ce cas, la variable ne possède pas de type de donnée spécifique.

Vous pouvez aussi utiliser cet élément de script pour résoudre des expressions arithmétiques. Pour plus d'information, reportez-vous à la section Calcul.

Si des variables prédéfinies indiquées entre parenthèses ( ) sont utilisées comme valeurs et fournissent des valeurs numériques (par ex. &$CLIENT#), elles sont automatiquement converties selon le format par défaut à 16 caractères.

Lorsque vous attribuez aux instructions :SET et :RSET la même variable de script avec des valeurs différentes, leurs valeurs seront définies par ces instructions lors de l'exécution du job. Cependant, en cas de reprise du job, les valeurs des deux variables seront définies par l'instruction :SET. Ceci car les instructions :RSET créent automatiquement des valeurs d'objets et les instructions :SET enregistrent automatiquement la valeur pour une reprise. C'est un changement de comportement de v8, où les instructions :RSET ne créaient pas de valeurs d'objets.

C'est un changement de comportement depuis la version 8, où les instructions :RSET ne créaient pas de valeurs d'objets.

Exemples

L'exemple attribue un nom de fichier à la variable de script "&FICHIER#".

:SET &FILE# = "L.LST.FILE"

Dans l'exemple suivant, la date actuelle - retournée par une fonction de script - est affectée à la variable de script "&TODAY".

:SET &TODAY# = SYS_DATE(YYMMDD)

Une variable de script peut aussi contenir des nombres.

:SET &NUMBER# = 1

On peut également attribuer une valeur d'une autre variable de script.

:SET &NR# = &NUMBER#

Rubriques connexes :

Elément de script	Description
:DEFINE	Déclare une variable de script avec un type spécifique de données.
:PSET	Attribue une valeur à une variable d'objet.
:RSET	Attribue une valeur à une variable de script et l'enregistre dans le rapport d'activation.
:SET_SCRIPT_VAR	Définit les valeurs des variables de script par accès indirect.

Eléments de script - Structure et traitement des scripts

Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle