Rational Developer for System z, Version 7.6

Modifier une macrostructure dans un squelette de programme

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 (batch ou dialogue) choisi lors de l'ouverture de la macro dans l'éditeur PDP.

Les macrostructures doivent avoir été générées et les fichiers en sortie .cblgen sauveardés dans la vue Navigateur . Léditeur PDP de macros s'ouvre via un clic droit sur le fichier généré MacroName.cblgen et par le choix Ouvrir avec > Editeur pdp de macro (modèle batch ou dialogue).

Pour afficher un squelette de programme, cliquez sur dans la barre d'outils de l'arbre des tags de la macrostructure. Dans l'exemple qui suit, n'est lééditeur PDP de Macro (modèle batch) qui a été sélectionné, ainsi la vue présente l'arborescence des tags de la macro intégrée dans un squelette de modèle batch Pacbase. Pour revenir à une vue sans édition de squelette, vous devez cliquez à nouveau sur .

Arbre des tags d'une macro dans une vue avec squelette Pacbase de modèle batch.

Cette vue permet de voir l'insertion des tags spécifiques dans un programme. Les tags de couleur verte peuvent être mis à jour. Vous pouvez effectuer cette mise à jour directement dans cette vue en sélectionnant les noeuds dans l'arbre. Les choix diu menu contextuel s'affichent en fonction de l'élément sélectionné. Par exemple, Le choix Création d'une sous-fonction spécifique dialogue n'est actif que si la fonction sélectionnée dans l'arbre est bien une fonction dialogue dans l'éditeur PDP modèle dialogue.

Vous pouvez déplier ou replier les branches de l'arbre en cliquant sur les boutons ou . Vous pouvez filtrer la liste des tags via la zone de saisie au dessus de la vue de l'arbre. Il est très utile lorsque le nombre de tags dans l'arbre est important.

L'éditeu de macro situé juste au-dessus de la vue de l'arbre, donne une vue dynamique des mises à jour effectuées dans l'arbre.

Ecraser le tag

Pour écraser un tag, sélectionnez un noeud dans l'arbre des tags et dans le menu contextuel, choissisez Ecraser le tag. Cette action est autorisé sur certains tags suivant la logique Pacbase.

Ecrasement du tag

Créer un tag fils

Sélectionnez un noeud dans l'arbre des tags, et dans le menu contextuel cliquez sur le choix Créer un tag fils. Une boîte de dialogue s'ouvre dans laquelle vous devez saisir une valeur dans la zone qui s'affiche selon le type de noeud sélectionné. Il y a trois possiilités :
  • Vous créez un tag détail :

    Si vous créez un tag fils à partir du noeud <SOURCE>, vous devez saisir un numéro de ligne. Si vous saisissez 100 dans la zone Numéro de ligne, le tag <SOURCE100> sera créé.

    Numéro de ligne à renseigner pour un tag créé à partir d'un noeud Source.
  • Si vous créez un tag fils à partir d'un tag <IOSEC-FILECTRL> ou <FILE>, vous devez saisir dans ce cas un code fichier comprenant deux caractères obligatoires.
  • Si vous créez un tag fils à partir d'un noeud <WORKING> ou <SUITE-WORKING>, vous devez saisir une ligne début et un numéro de ligne :
    Zones à renseigner pour la création d'un tag fils à partir d'un tag <WORKING> ou <SUITE-WORKING>.
    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.

Supprimer un tag

Pour supprimer un tag, faîtes un clic droit sur un tag dans l'arbre des tags 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.

Créer un linkage

Vous ne pouvez créer un linkage qu'à partir d'un tag <DATA>. Pour ce faire, sélectionnez un tag <DATA> dans l'arbre des tags et choissez Créer un linkage. Dans la boîte de dialogue qui s'ouvre, saisissez une ligne début et un numéro de ligne :

Création d'un linkage depuis le tag <DATA>

Début de ligne
Dans la zoneDébut de ligne la valeur doit contenir deux caractères obligatoirement, ils doivent être numériques si il ne commence pas par la valeur $ .
Numéro de ligne
Dans la zone Numéro de ligne la valeur doit contenir 3 caractères obligatoirement, numériques si il débute par une valeur différente de $ .

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, saisissez une valeur pour le niveau :

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)