Rational Developer for System z, Version 7.6

Définition des options de préprocesseur local

Cette rubrique présente les options que vous pouvez définir pour les processeurs locaux.
Avant de commencer
Un groupe de propriétés doit être défini sur un système distant ou local.
Pourquoi et quand exécuter cette tâche
La prise en charge du préprocesseur local est disponible pour les opérations suivantes de compilation ou de vérification de la syntaxe :

Pour définir les options des préprocesseurs locaux, procédez comme suit :

  1. Ouvrez un groupe de propriétés dans un éditeur prévu à cet effet.
  2. Accédez à l'onglet Préprocesseurs locaux de la page Paramètres COBOL locaux ou Paramètres PLI locaux. Cette page contient deux sections : la section Préprocesseurs, qui affiche tous les préprocesseurs ajoutés au groupe de propriétés. Vous pouvez gérer cette liste de deux manières :
    • Cochez la case située en regard du nom de préprocesseur afin d'activer le préprocesseur à exécuter avant une opération de compilation ou de vérification de la syntaxe. Cette action est appelée "sélection d'un préprocesseur." Le préprocesseur est activé pour être exécuté uniquement lorsque la case est cochée.
    • Sélectionnez le nom du préprocesseur dans la liste afin d'afficher les options le concernant dans la section Options du préprocesseur. Cette action est appelée "mise en évidence d'un préprocesseur."
    La section Options du préprocesseur affiche les options du préprocesseur sélectionné.
    Description du préprocesseur
    Entrez une description ("Préprocesseur d'inclusion", par exemple)
    Nom du préprocesseur (qualifié complet)
    Entrez le chemin d'accès complet du préprocesseur d'inclusion. Vous pouvez utiliser la variable ${INSTDIR} pour accéder au répertoire d'installation Rational Developer for System z. Cette variable permet de rechercher le préprocesseur d'inclusion.
    Arguments du préprocesseur
    Entrez les arguments que vous transmettez à votre préprocesseur. Ces arguments sont entrés comme si vous les transmettiez à votre préprocesseur à partir d'une invite de commande. Ils peuvent contenir le chemin complet du fichier en cours de traitement. Si vos arguments incluent le nom qualifié complet du fichier XML ou du fichier de sortie que votre préprocesseur génère, il est indispensable de créer ces fichiers dans le dossier BuildOutput du projet local.
    Nom du fichier de sortie du préprocesseur
    Entrez le nom du fichier étendu que votre préprocesseur va générer. Ce nom de fichier ne doit pas être qualifié. Le fichier de sortie doit être généré dans le dossier BuildOutput du projet local.
    Prendre en charge le retour d'erreur
    Cochez cette case pour consigner les erreurs générées par le préprocesseur. Lorsque cette case est cochée, la zone Nom du fichier XML de retour d'erreur est activée. Cette option est activée par défaut.
    Nom du fichier XML de retour d'erreur
    Indiquez le nom du fichier XML à générer pour le retour d'erreur. Ce fichier XML ne doit pas être qualifié, puisqu'il doit être créé dans le dossier BuildOutput du projet local.
    Variables d'environnement (instructions SET)
    Spécifiez les variables d'environnement à transmettre au préprocesseur. Cette zone contient une valeur pour SYSLIB, mais vous devez modifier cette valeur pour pointer vers le dossier contenant vos fichiers d'inclusion.

    Vous pouvez également utiliser les variables suivantes dans l'une des zones d'entrée pour faciliter la généralisation des générations de projet :

    ${project_loc}
    Emplacement du projet. Elle permet d'ajouter l'emplacement sur le disque du projet. Si vous devez transmettre le nom d'un dossier du projet au préprocesseur, spécifiez cette variable sous la forme ${project_loc}\folder1. Lors de l'appel du préprocesseur, ${project_loc} est remplacé.
    ${resource_fn}
    Nom de fichier non qualifié de la ressource en cours de prétraitement. Si vous effectuez une construction de projet et que le projet contenait 3 fichiers COBOL, RED.cbl, WHITE.cbl et BLUE.cbl, pour chaque préprocesseur au cours de la construction du projet, une valeur est affectée à cette variable. La valeur doit être RED, WHITE ou BLUE. Cette variable ne comporte pas de valeur lorsque vous spécifiez des valeurs de préprocesseur dans le projet. Par exemple, lorsque ${resource_fn}_PP1.dek est défini dans la zone d'entrée Nom du fichier de sortie du préprocesseur, les fichiers de sortie RED_PP1.dek, WHITE_PP1.dek et BLUE_PP1.dek sont générés dans le dossier BuildOutput.
    ${resource_loc}
    Emplacement sur le disque de la ressource en cours de prétraitement. Si le préprocesseur requiert l'emplacement exact du fichier sur le disque pour le prétraitement, vous pouvez utiliser cette variable pour que la valeur d'emplacement de la ressource sur le disque se substitue à celle indiquée lors de l'appel de la fonction.
    ${INSTDIR}
    Répertoire d'installation de Rational Developer for System Z.

    Lorsque l'action de vérification de la syntaxe, de génération ou d'affichage des dépendances appelle le préprocesseur local, le répertoire de travail de cette action est le dossier BuildOutput du projet local. Le fichier XML et le fichier source étendu que créent votre préprocesseur doivent l'être dans ce dossier.

  3. Cliquez sur Terminer pour sauvegarder les modifications apportées.

Conditions d'utilisation | Commentaires en retour

Ce centre de documentation utilise la technologie Eclipse. (http://www.eclipse.org)