Rational Developer for System z

Utilisation du préprocesseur d'inclusion

Rational Developer for System z offre un préprocesseur d'inclusion local permettant d'intégrer des fichiers source externes dans vos programmes à l'aide de directives d'inclusion autres que la directive PL/I %INCLUDE ou l'instruction COBOL COPY.

Avant de commencer

Avant d'utiliser le préprocesseur d'inclusion local, vous devez créer un groupe de propriétés local et l'associer à un fichier source PL/I local ou à un projet local.

Pourquoi et quand exécuter cette tâche

Le préprocesseur d'inclusion local se trouve dans le répertoire bin du chemin de l'installation Rational Developer for System z. Sous Windows, le nom de fichier est PPINCL01.EXE. Sous Linux, le nom de fichier est PPINCL01.
Vous pouvez utiliser le préprocesseur d'inclusion local avec un programme PL/I individuel ou un projet z/OS local contenant un ou plusieurs programmes PL/I. Vous pouvez également l'utiliser seul ou dans le cadre d'une opération de génération multi-préprocesseurs.
  • Si le préprocesseur d'inclusion est le seul préprocesseur appelé avant une compilation, le fichier d'entrée est le programme COBOL ou PL/I sélectionné pour une opération Vérification de la syntaxe ou Afficher les dépendances.
  • Si le processeur d'inclusion est appelé pour une génération de projet, chaque programme COBOL ou PL/I du projet est traité, puis compilé. Dans ce cas, le fichier d'entrée est la source COBOL ou PL/I en cours de traitement.
  • Si le préprocesseur d'inclusion est appelé dans le cadre d'une opération multi-préprocesseurs après un préprocesseur précédent, le fichier d'entrée vers le préprocesseur d'inclusion est le fichier de sortie provenant du précédent préprocesseur actif. Il s'agit du fichier figurant dans la zone d'entrée Nom du fichier de sortie du préprocesseur du préprocesseur actif précédent. Voir Utilisation de plusieurs préprocesseurs locaux pour obtenir plus d'informations relatives à la configuration des opérations multi-préprocesseurs.

Pour utiliser le préprocesseur d'inclusion local, procédez comme suit :

Procédure

  1. Ouvrez l'éditeur du groupe de propriétés associé à la ressource ou au projet, puis accédez à la page PL/I.
  2. Dans la liste de gauche, cliquez sur Préprocesseur local pour ouvrir la page Préprocesseur local.
  3. Pour ajouter un nouveau préprocesseur local au groupe de propriétés, cliquez sur Nouveau.
  4. Renseignez les zones de la section Options du préprocesseur de la page Préprocesseur local.
    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
    Le préprocesseur d'inclusion peut comporter les arguments suivants :
    • TRACE(ON|OFF) Sur le poste de travail, cette option offre une sortie supplémentaire vers la console distante TPF. Sur les systèmes 390, elle offre une sortie JES supplémentaire. Cette sortie est destinée au support technique IBM®. Elle ne doit pas être utilisée dans le cadre normal du développement, puisqu'elle augmente le nombre de sorties non souhaitées et peut diminuer les performances. Si vous souhaitez prendre contact avec le représentant du support technique IBM pour déterminer l'origine des incidents, vous pouvez copier cette sortie dans votre correspondance. La valeur par défaut de cette option est TRACE(OFF). Si l'option n'est pas spécifiée, la valeur par défaut est utilisée.
    • FORMAT(ON|OFF) Sur le poste de travail et les systèmes 390, cette option permet de modifier la lisibilité du fichier XML généré pour les messages d'erreur. FORMAT(ON) permet d'écrire la table d'instructions dans 6 colonnes, améliorant la lisibilité du fichier XML. Cette option diminue de manière significative les performances d'analyse du fichier XML, ce qui rallonge la durée des opérations. La valeur par défaut de cette option est FORMAT(OFF). Si l'option n'est pas spécifiée, la valeur par défaut est utilisée.
    • NOCOPY (ON|OFF) Si votre source contient des instructions COPY REPLACE, le préprocesseur d'inclusion ne prend pas en charge le traitement de l'instruction COPY REPLACE. Le préprocesseur ne remplace pas les chaînes du fichier de copie et ne trouve pas le nom de membre spécifié dans l'instruction COPY REPLACE. Pour éviter ce problème, utilisez l'option de préprocesseur NOCOPY(ON). Cette option permet le traitement des instructions -INC et ++INCLUDE, mais les instructions COPY et %INCLUDE ne sont pas traitées par le préprocesseur d'inclusion. Le compilateur traite ces instructions après le préprocesseur.

      Si votre source contient des instructions COPY avec le nom de membre entre guillemets ou apostrophes, le préprocesseur d'inclusion ne prend pas en charge ces instructions. Pour éviter ce problème, utilisez l'option de préprocesseur NOCOPY(ON). Cette option permet le traitement des instructions -INC et ++INCLUDE, mais les instructions COPY et %INCLUDE ne sont pas traitées par le préprocesseur d'inclusion. Le compilateur traite ces instructions après le préprocesseur.

    Informations spécifiques à Linux sur les plateformes Linux, utilisez des crochets { } plutôt que des parenthèses pour spécifier les options de préprocesseur, comme TRACE{ON} et FORMAT{ON}.

    Nom du fichier de sortie du préprocesseur
    Indiquez un nom de fichier à utiliser pour la sortie du préprocesseur. Si vous ignorez cette option, un nom de fichier de sortie est généré.
    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 non qualifié du fichier XML à générer pour le retour d'erreur. Si vous ignorez cette option, un nom de fichier XML de retour d'erreur est généré.
    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. La longueur du chemin pour la variable d'environnement SYSLIB est limitée à 4K. Aucun message d'erreur n'est émis pour les longueurs supérieures à cette limite mais les instructions SYSLIB de longueur supérieure peuvent provoquer un arrêt anormal des opérations de vérification de syntaxe dans le programme de préprocesseur d'inclusion.

    Linux Sous Linux, utilisez l'instruction export pour définir les variables d'environnement, telles export SYSLIB=/root/project1/includes.


Conditions d'utilisation | Commentaires

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