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 :
- Vérification de la syntaxe en local d'un fichier local.
- Génération d'un projet local.
- Affichage des dépendances sur un projet local ou un fichier local.
Remarque : Seuls les fichiers qui n'ont pas été créés lors de l'étape de prétraitement peuvent être considérés comme
des dépendances. Si plusieurs fichiers d'inclusion sont créés dans le cadre d'une étape de prétraitement, et
qu'ils sont éventuellement transmis à une autre préprocesseur ou au compilateur, ils ne sont pas considérés comme
des dépendances.
- Vérification de la syntaxe en local d'un fichier distant.
Rational Developer
for System z ne prend pas en charge les générations
COBOL ou PL/I locales, la vérification de syntaxe ou l'affichage de dépendances sur la plateforme
Linux.
Procédure
Pour définir les options
des préprocesseurs locaux, procédez comme suit :
- Ouvrez un groupe de propriétés dans un éditeur prévu à cet effet.
- 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é.
- ${rdz_cache_home}
- Si vous utilisez un préprocesseur local avec un fichier distant, il peut
être nécessaire d'atteindre l'emplacement de la mémoire cache racine. Cet emplacement
correspond à l'emplacement de la mémoire cache de Rational Developer for System z décrit
dans l'explication de la variable ${rdz_cache_sysn}. Cette variable n'inclut pas les sous-dossiers "FttRemoteTempFiles"\RSE Connection Name.
Le dossier BuildOutput pour une vérification de la syntaxe locale
d'un fichier distant se trouve à l'emplacement ${rdz_cache_home}. Ce dossier est celui
à partir duquel le préprocesseur local est appelé.
- ${rdz_cache_sysn}
- Si vous utilisez un préprocesseur local avec un fichier distant, il peut
être nécessaire de pouvoir pointer vers votre fichier dans l'emplacement de
téléchargement de Rational Developer for System z. Cet emplacement dépend de
l'emplacement de votre espace de travail. Rational Developer for System z télécharge vos dépendances de compilation sur une vérification de la syntaxe locale d'un fichier distant. L'emplacement de téléchargement correspond à l'emplacement de la mémoire cache de Rational Developer for System z.
Lorsque vous procédez à une vérification de la syntaxe locale d'un fichier distant,
votre préprocesseur doit être exécuté sur le système distant. Une combinaison d'un
préprocessus et d'une compilation est effectuée sur le système distant et une liste de
dépendances de construction est créée. Il s'agit de la liste de fichiers affichée
lorsque vous effectuez l'opération Afficher les dépendances sur le fichier. Il s'agit de la liste de fichiers affichée si vous cliquez sur le bouton Fichiers dépendants de la boîte de dialogue Vérifier les dépendances à partir de l'action Vérification de la syntaxe > Local. Ces fichiers sont téléchargés à l'emplacement de la mémoire cache. Il se peut que vous
deviez pointer vers un fichier ou un dossier à l'aide de la variable ${rdz_cache_sysn}. Si un membre de fichier USERID.A001.COPYLIB(MEM1) correspond à l'un
de vos fichiers dépendants, par exemple, il se peut que vous deviez pointer vers
l'emplacement de la mémoire cache de ce fichier pour que votre préprocesseur local
l'utilise.
Pour cela, vous pouvez définir une variable d'environnement vers le dossier
contenant le membre téléchargé. Vous pouvez le faire dans la zone de saisie des variables
d'environnement du préprocesseur : SET SYSLIB=${rdz_cache_sysn}\USERID\USERID.A001.COPYLIB. Le
parent du dossier correspondant au fichier est le qualificatif de haut niveau du nom de
fichier contenant le membre. La variable
${rdz_cache_sysn} est substituée par l'emplacement de la mémoire cache de Rational
Developer for System z : "FttRemoteTempFiles"\RSE
Connection Name.
- ${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. Si
vous effectuez une vérification de la syntaxe locale
d'un fichier distant, la valeur de ${resource_loc} dans les options du préprocesseur
local correspond à l'emplacement du fichier dans la mémoire cache de Rational Developer
for System z.
- ${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.
- Enregistrez le groupe de propriétés afin de conserver les modifications effectuées.