Rational Developer for System z, Version 7.6

Modifier une Macrostructure (affichage sans squelette)

La mise à jour du code d'une macrostructure s'effectue dans la vue Arbre des tags de la Macrostructure view. Dans cette vue, vous pouvez effectuer des actions comme la création de tags, de nouvelles fonctions et sous-fonctions, la création de sections working... . Une fonction permet la visualisation de la macrostructure intégrée dans le squelette d'un programme propre au modèle choisi lors de l'ouverture de la macro dans l'éditeur PDP. L'affichage par défaut est sans édition du squelette, cette page présente les actions possibles depuis une macrostructure dans cette configuration (sans édition du squelette du programme).

Pour afficher l'Arbre des tags de la Macrostructure, vous devez ouvrir un fichier .cblgen dans la vue Navigation de la perspective Design via le choix Ouvrir avec dans le menu contextuel. Ensuite vous devez sélectionner l'éditeur de macro correspondant au modèle avec lequel vous travaillez Editeur PDP de macro (modèle batch ou modèle dialogue).
La vue Arbre des tags de la Macrostructure présente une arborescence des tags de la macro. Vous pouvez déplier la liste en cliquant sur Déplier ou la replier en cliquant sur Replie. Vous pouvez filtrer les éléments qui composent l'arbre pour n'afficher que les éléments pertinents pour vos mises à jour (le filtrage se fait via la zone text 'Entrer le titre du filtre' , voir dans l'image ci-après). Cette fonctionnalité est très utile quand la liste des tags est longue.

L'éditeur de macros, affiché juste au-dessus de la vue Arbre des tags de la Macrostructure dans l'image ci-après, permet de visualiser dynamiquement les mises à jour que vous effectuez dans la vue.

Créer un tag fils

Pour créer un tag dans l'Arbre des tags de la Macrostructure,

  1. Positionnez votre curseur sur la ligne d'une sous-fonction par exemple, faîtes un clic droit et choisissez Créer un tag fils.
    Exemple : sur la ligne d'une sous-fonction, vous pouvez créer une ligne détail.
  2. Ensuite, dans la boîte de dialogue qui s'ouvre, entrez un numéro de ligne

Numéro de ligne
Dans la zone numéro de ligne, la valeur doit contenir 3 caractères numériques.

Lorsque vous créez une nouvelle ligne , elle est associée à la ligne de niveau supérieure comportant un tag.

Supprimer le tag

Pour supprimer un tag, faîtes un clic droit sur un tag dans l'arbre des tags de la macrostructure et sélectionnez Supprimer le tag. La ligne contennat le tag est supprimée, elle n'est plus visible dans l'arbre et dans l'éditeur de la macro.

Regrouper les tags

Vous pouvez regrouper des lignes détails de la macro. Les lignes sélectionnées sont regroupées sur le premier tag de la sélection.

  1. Sélectionnez les lignes dans une fonction, utilisez la touche MAJ pour une multi-sélection, suivi d'un clic droit sur la sélection et choisissez Regrouper les tags. Dans l'exemple ci-dessous, les ce sont les lignes 100, 200 et 250 qui vont être regroupées :
  2. Dans l'arbre des tags, on obtient une ligne 100 qui regroupe les autres tags sélectionnés :

Mise à jour du niveau

Vous pouvez modifier le niveau d'une fonction/sous-fonction dans l'arbre des tags de la Macrostructure, pour ce faire : :
  1. Faîtes un clic-droit sur une fonction/sous-fonction et sélectionnez Mise à jour du niveau.
  2. Dans la boîte de dialogue qui s'ouvre, saisir une valeur du niveau :

Après validation, les fonctions et sous-fonctions sont replacées selon les niveaux dépendants

Créer une working

Pour créer une working :
  1. Faîtes un clic droit sur une branche de l'arbre, et sélectionnez le choix Créer une working.
  2. IDans la boîte de dialogue qui s'ouvre, saisissez une valeur pour le début de ligne et le numéro de ligne :
Début de ligne
Dans la zoneDébut de ligne la valeur doit contenir deux caractères.
Numéro de ligne
Dans la zone Numéro de ligne la valeur doit contenir 3 caractères.

Selon la valeur définie de début de ligne, le tag se placera au bon endroit, ce qui signifie qu'il peut s'agir d'un 'linkage' dans le cas où le tag 'Linkage' existe déjà et que l'emplacement saisi (début de ligne + n° de ligne) est supérieur à celui de la linkage.

Créer une fontion/sous-fonction

Vous pouvez créer une fonction et une sous-fonction. Sélectionnez une ligne dans l'arbre des tags de la Macrostructure et dans le menu contextuel sélectionnez Créer une fontion/sous-fonction. une boîte de dialogue s'ouvre permettant la saisie d'un code fonction, d'un code sous-fonction et du niveau :
Code fonction
Le code fonction est obligatoire, il doit avoir une longueur de 2 caractères.
Code sous-fonction
Le code sous-fonction est facultatif, sauf si vous voulez créer une sous-fonction. Sa longueur est de 2 caractères.
Niveau
Le niveau est facultatif, il a une longueur de 2 caractères. Les caractères numériques sont obligatoires seulement si le niveau débute par la valeur $. Si aucune valeur n'est indiquée dans cette zone, la valeur 05 est attribuée automatiquement pour une fonction, et la valeur 10 est attribuée automatiquement pour une sous-fonction.
Autres valeurs possibles pour une sous-fonction : de 06 à 98.
Dans une fonction donnée, une sous-fonction de niveau 15 fait partie des sous-fonctions de niveau 06 à 14 qui la précède. Une sous-fonction dépendante ne sera exécutée que si la fonction ou sous-fonction de niveau supérieur est elle mêmeexécutée. 99 est utilisée pour écrire une condition sans changer le code de la sous-fonction. Cette condition s'applique jusqu'au niveau 99 ou à la fin de la sous-fonction. Une procédure de niveau 99 est limitée à 75 lignes. Une sous-fonction peut contenir 98 à 99 niveaux maximum.

Création d'une sous-fonction spécifique dialogue

Ce choix est disponible dans l'éditeur PDP pour le modèle dialogue uniquement. Vous pouvez créer une sous-fonction à partir de l'arbre des tags de la macro avec affichage ou non du squelette du programme. Sélectionnez Création d'une sous-fonction spécifique dialogue dans le menu contextuel, une boîte de dialogue création d'une sous-fonction dans laquelle vous devez indiquer les caractéristiques de la sous-fonction. Le type de paramètres à mettre à jour dépend du type de sous-fonction sélectionné dans la zone option Choix de la fonction. Une fois tous les paramètres indiqués, clquez sur OK et l'arbre des tags affiche la nouvelle fonction avant, après ou à la place de la fonction initialement sélectionnée, selon le choix indiqué dans la boîte de dialogue. Une nouvelle ligne apparaît dans l'éditeur de la macro indiquant la nouvelle sous-fonction.

Mise à jour des parametres (spécifique dialogue)

Ce choix est disponible dans l'éditeur PDP pour le modèle dialogue uniquement. Vous pouvez mettre à jour les paramètres d'une sous-fonction à partir de l'arbre des tags avec affichage ou non du squelette du programme. Dans le menu contextuel, sélectionnez Mise à jour des parametres (spécifique dialogue) après sélection d'une sous-fonction. Une boîte de dialogue Mise à jour des paramètres s'ouvre, vous pouvez modifier les paramètres de la sous-fonction sélectionnée.
Important :
Les tags fait partie d'une notion très importante dans la gestion des macros. Ce sont eux qui permettent les fusions des macros entre elles, qui permettent le mixage d'une macro avec un programme et qui déterminent l'arborescence d'un programme.

Conditions d'utilisation | Commentaires en retour

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