L'instruction :PSET vous permet d'affecter une valeur à une variable d'objet. Les variables d'objet sont enregistrées dans la page Variables de la définition de l'objet. Ces variables peuvent être transmises dans l'object ou à d'autres tâches du workflow utilisant l'objet. La valeur modifiée ne s'applique qu'à l'exécution actuelle de la tâche et n'est pas enregistrée de façon permanente dans l'objet lui-même.
L'instruction :PSET remplace d'abord ou ajoute la variable d'objet à la tâche actuelle. :PSET remplace ou ajoute également la variable d'objet dans l'objet parent. Cette instruction ne peut transmettre des valeurs qu'à un niveau supérieur, à l'objet parent, également désigné comme processeur. L'instruction ne transmettant pas les valeurs à plus d'un niveau, vous ne pouvez transmettre des variables d'objets aux grand-parents ou arrière grand-parents de la tâche. :PSET permet à d'autres tâches enfants d'un workflow d'hériter des variables définies par une autre tâche enfant.
Syntaxe
:PSET Object variable = Value
Paramètres
- :PSET
Affecte une valeur à la variable d'objet et la transmet à l'objet parent - Object variable
Nom de la variable d'objet.
Format : variable de script
Respectez les règles de noms de variables. Pour plus d'informations, voir Noms des variables. - value
Valeur à affecter à la variable d'objet
Format : littéral de script, variable de script ou fonction de script
Important !
- Aucune valeur de variable de script définie avec l'instruction :PSET n'est jamais transmise aux objets Schedule ou Période.
- L'instruction :PSET ne transmet pas de variables d'objets dans des workflows imbriqués. Dans des workflows imbriqués, les variables d'objet sont uniquement remplacées ou ajoutées au workflow contenant la tâche qui exécute l'instruction :PSET.
Remarques :
- Les tâches individuelles n'héritent des variables d'objets que si elles sont configurées pour le faire. Définissez le paramètre Hériter du parent dans la page Variables des définitions d'objet de la tâche enfant pour hériter des variables d'objets du workflow parent.
- Les variables d'objet héritées qui n'ont pas été définies dans la tâche elle-même, ne sont disponibles que si la tâche se trouve encore dans la perspective Surveillance des processus. Si vous relancez le job, ces variables d'objets ne sont disponibles que si la tâche et le workflow s'affichent encore dans la perspective Surveillance des processus.
- Si l'objet est généré à l'activation, les modifications ultérieures de variables d'objets n'ont pas d'effet sur le script. Sélectionnez l'option Générer la tâche à l'exécution dans la définition de l'objet pour vous assurer que les modifications ultérieures sont appliquées.
Pour plus d'informations :
Exemple
Un workflow contient deux objets. L'un est l'objet Transfert de fichiers nommé MM.GET.FILES, l'autre est un objet Job nommé MM.END.PROCESSING. Le paramètre Générer la tâche à l'exécution est configuré dans ces deux objets. Supposons que l'objet Transfert de fichiers vérifie l'environnement pour sélectionner l'agent approprié. À l'exécution du job, la vérification détermine que l'agent UNIX est requis.
L'instruction de script suivante change la variable d'objet &HOST# pour l'agent UNIX :
:PSET &HOST# = "unix01"
Voir aussi :