Rational Programming Patterns for System z

Modification du code d'une Macro

Grâce à l'éditeur PDP de Macro, vous avez la possibilité de modifier facilement le code COBOL d'une Macro en utilisant les choix du menu contextuel de la vue Arbre des tags de la Macro. Vous pouvez ainsi repérer les différentes parties du code dans une Macro. Vous pouvez créer à partir de cette vue des fonctions balisées, des sous-fonctions qui permettent d'identifier le code. L'arbre des tags peut s'afficher dans le squelette d'un programme propre au modèle (batch, dialogue, serveur, ..) choisi lors de l'ouverture de la Macro dans l'éditeur. Certains choix du menu sont spécifiques et ne s'affichent que pour certains modèles. Pour y accéder vous devez ouvrir les Macros dans un modèle spécifique serveur, dialogue ou écran par exemple.

Avant de commencer

Pour pouvoir ouvrir une Macro dans un éditeiur PDP, vous devez disposer d'un fichier ..cblmsp et d'une Macro dans votre référentiel.

Pourquoi et quand exécuter cette tâche

Procédure

  1. Pour afficher l'Arbre des tags de la Macro, vous devez ouvrir un fichier .cblmsp dans la vue Explorateur de designs de la perspective Programmation pilotée par pattern avec le choix Ouvrir avec du 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) par exemple.
  2. Si l'arbre des tags de la Macro est vide, un message vous demande de créer un tag afin de pouvoir commencer la saisie. Un menu contextuel disponible à partir de la vue sert de point de départ à toutes les actions que vous pourrez effectuer dans l'arbre. Vous avez la possibilité de créer des actions standard communes indépendamment du type de modèle sélectionné, telles que la création de fonctions, de lignes détail de procedure division, des sections ou linkage, et d'organiser la hiérarchie des étiquettes (tags)... Vous pouvez également effectuer des actions plus spécifiques à certains modèles comme la création de fonction de type dialogue, la mise à jour des paramètres, ou l'insertion de code spécifique dans une Macro.
    1. Création d'une sous-fonction spécifique dialogue ou client: ce choix est disponible dans l'éditeur PDP pour le modèle dialogue ou client 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. Dans la boîte de dialogue création d'une sous-fonction qui s'ouvre, 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, cliquez sur OK . 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.
    1. Mise à jour des paramètres (spécifique dialogue ou client et spécifique serveur): Ce choix est disponible dans l'éditeur PDP pour le modèle dialogue, client ou serveur. 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 paramètres (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.
    1. Insertion de code spécifique dans une Macro (modèle serveur) : Vous pouvez insérer du code spécifique à différents niveaux dans une Macro appelée dans un Composant applicatif de type serveur : au niveau d'un traitement général, d'une Vue Logique, d'un accès logique ou d'un accès physique. Tous ces choix sont disponibles dans le menu contextuel d'une vue des tags dans un éditeur de modèle serveur uniquement.
  3. Quand les tags sont créés, vous pouvez facilement saisir du code dans la Macro au niveau de la vue éditeur PDP, la fenêtre au-dessus de la vue des tags. Vous pouvez identifier rapidement dans cette fenêtre, grâce aux tags, les différentes parties du code de la Macro.
  4. Vous pouvez insérer des lignes de commentaires formatés correspondant à des micro-patterns. Lors de la génération de l'instance appelant la Macro, ces lignes seront reconnues et automatiquement complétées. Vous pouvez ainsi facilement gérer les itérations dans un Programme, Ecran ou Serveur.

Résultats

Les 'tags' (balises, ou étiquettes) sont très importants pour la structure d'un programme. Ils sont utilisés pour la fusion des Macros, et la fusion d'une Macro avec un programme. C'est pourquoi, si les paramètres d'une Macro ont été modifiés, il est indispensable de regénérer le programme.

Que faire ensuite

Remarque : Toutes les options disponibles dans l'arbre des tags de la Macro sont détaillées dans les pages de référence associées à cette page d'aide.