GET_SCRIPT_VAR

La fonction de script GET_SCRIPT_VAR vous permet de demander les valeurs de différentes variables de script sans écrire plusieurs instructions conditionnelles. Cette fonction utilise un caractère de remplacement pour renvoyer les valeurs de variables de script indirectement. Vous n'avez pas besoin de définir le nom des variables de script directement dans votre script, puisque le caractère de remplacement joue le rôle de variable. Cette fonction, qui vous permet de demander les valeurs de plusieurs variables avec une seule ligne de script, est utile dans les boucles de traitement. Le caractère de remplacement que vous définissez est une chaîne de caractères contenant le nom d'une ou plusieurs variables dont vous souhaitez obtenir les valeurs

Cette fonction de script extrait les valeurs des types d'objets suivants :

• Objets Variable
• Variables d'objet
• Variables de PromptSet

Syntaxe

GET_SCRIPT_VAR (Script variable)

Paramètres

• GET_SCRIPT_VAR
  Renvoie les valeurs de variables de script
• Script variable
  Caractère de remplacement pour le nom des variables de script à renvoyer
  
  • 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.
    
• Format : Nom AE, littéral de script ou variable de script

Important !

• Si la variable de script ne peut pas être identifiée de manière univoque, le système lit la valeur de la première variable correspondante.
• Le nom de variable est recherché à partir du caractère & ou du caractère suivant. Si la chaîne de caractères que vous spécifiez ne correspond pas aux caractères initiaux du nom de la variable, une erreur se produit.

Exemple

Cet exemple illustre l'utilisation d'un script dans un job pour extraire les noms et valeurs d'un objet Variable nommé SCRIPT_VARA. Le script écrit les noms extraits dans le rapport d'activation. Supposez que l'objet Variable contient les noms de variable de script suivants :

• End#
• Start#
• Ultimo#

Écrivez le script suivant dans le job :

:SET &END#    = "20051027"
:SET &START#  = "20051024"
:SET &ULTIMO# = "20051031"  

:SET &HANDLE# = PREP_PROCESS_VAR("SCRIPT_VARA")    

:PROCESS &HANDLE#
:   SET &VARIABLE# = GET_PROCESS_LINE(&HANDLE#,1)
:   SET &VALUE# = GET_SCRIPT_VAR(&VARIABLE#)
:   PRINT  "&VARIABLE# = &VALUE#"
:ENDPROCESS

:CLOSE_PROCESS &HANDLE#

Où :

• :SET

  Affecte une valeur à une variable de script

• PREP_PROCESS_VAR

  Extrait une liste de valeurs d'un objet Variable

  Les valeurs extraires sont fournies sous forme de séquence de données pour la poursuite du traitement interne.

• :PROCESS ... :ENDPROCESS
  Définit une boucle pour le traitement ligne par ligne d'une séquence de données

• GET_PROCESS_LINE
  Extrait le contenu de la ligne actuelle dans une séquence de données

• GET_SCRIPT_VAR
  Extrait les valeurs pour plusieurs variables de script

• :PRINT
  Ecrit les lignes dans le rapport d'activation

• :CLOSE_PROCESS
  Supprime une séquence de données dans un script

Le script lit le nom des variables de script à partir de l'objet Variable. Le nom de la variable est transmis à une variable de script appelée &VALUE#. Une instruction :PRINT utilise la variable &VALUE# pour écrire les valeurs pour END#, &START# et &ULTIMO# dans le rapport d'activation.

Les lignes suivantes sont alors écrites dans le rapport d'activation :

2005-02-03 12:51:23 - U0020408 End = 20051027
2005-02-03 12:51:23 - U0020408 Start = 20051024
2005-02-03 12:51:23 - U0020408 Ultimo = 20051031

Voir aussi :