:INCLUDE

Utilisez l'instruction de script :INCLUDE pour appeler un objet Include à partir d'un autre objet. Dès qu'un objet contenant cette instruction de script est activé, le script stocké dans l'objet Include est inséré.

De nombreux objets requièrent la même procédure dans leurs scripts. Les objets Include vous permettent d'écrire des blocs de script réutilisables pour que vous n'ayez pas à réécrire les mêmes scripts. Pour plus d'informations, voir Objets Include (JOBI).

Conseils :

• L'appel d'un objet :INCLUDE dans votre script est une façon de réutiliser des scripts. Pour plus d'informations, voir Réutiliser des composants de script.
• Vous pouvez afficher et copier le contenu d'un objet Include dans l'éditeur de script. Pour plus d'informations, voir Utiliser des objets Include dans les scripts.

Syntaxe

:INC[LUDE] Include object [oldString = newString][,NOFOUND=IGNORE][,EXT_REPORT=OFF]

Paramètres

• :INCLUDE
  Appelle un objet Include
  
• Include object
  Nom de l'objet Include à appeler
  Saisissez le nom complet de l'objet Include. Vous ne pouvez pas utiliser de variables de script.
• oldString = newString
  (Optionnel) Remplace une chaîne de caractères dans le script de l'objet Include par une nouvelle chaîne de caractères
  Remarque : Les remplacements ne sont valides que pour la génération actuelle et ne modifient pas l'objet Include lui-même.
  Format : littéral de script
  Longueur maximale : 50 caractères
• NOFOUND=IGNORE
  (Optionnel) Aucune erreur ne se produit si l'objet Include spécifié est introuvable.
• EXT_REPORT_OFF
  (Optionnel) Supprime le contenu de l'objet Include du journal des rapports étendus et écrit la ligne de commande à la place

Exemples

L'instruction suivante appelle un objet Include appelé MM.FILEASSIGNMENTS.

:INC MM.FILEASSIGNMENTS

L'instruction suivante appelle le même objet et spécifie un nouveau nom.

:INC MM.FILEASSIGNMENTS "$MM." = "$MMTEST."  

L'exemple suivant illustre l'appel d'un Include utilisateur. Si l'objet est introuvable, aucune erreur ne se produit.

:INCLUDE HEADER.WINDOWS.USER.HEAD ,NOFOUND=IGNORE

L'instruction suivante supprime le journal du contenu de l'objet Include dans les rapports étendus. 

:INC MM.FILEASSIGNMENTS ,EXT_REPORT=OFF

Voir aussi :