Editeur COBOL PDP

L'éditeur COBOL PDP fournit des fonctions supplémentaires par rapport à celles déjà implémentées par l'éditeur COBOL standard. Il vous permet de modifier le COBOL tout en voyant clairement l'origine des lignes de code (lignes générées, lignes de Macro ou lignes de code spécifique), les lignes supprimées ou écrasées et les éventuels problèmes détectés par la réconciliation.

Pour voir le contenu de cet éditeur, vous devez avoir généré une instance. Dans la vue Explorateur de designs, vous pouvez alors faire un clic droit sur le fichier .cbl correspondant (ce fichier contient le COBOL généré) et sélectionner Ouvrir avec > Editeur COBOL PDP dans le menu contextuel.
Conseil : Vous devez connaître les concepts expliqués dans Les étapes pour générer le COBOL d'un Programme, Ecran ou Serveur avant de lire cette page.

Modification du code généré

Vous pouvez modifier le code généré pour l'adapter à vos besoins.

Important : Le contrôle syntaxique du COBOL est désactivé pour toutes les instances dont la variante de génération (indiquée dans l'onglet Définition) n'est pas une variante IBM.
Conseil : Pour les lignes qui ont des caractères au delà de la colonne 72, si vous souhaitez que ces caractères conservent leur position initiale (pas de décalage vers la droite) lorsque vous insérez du code/texte avant la colonne 72, cochez le choix Gérer les numéros de séquence dans le menu Fenêtre > Préférences > COBOL > Editeur > Numéros de séquence.

Des facilités d'insertion de code sont disponibles sous forme de micro-patterns et fragments. Il est fortement recommandé de ne pas modifier le code généré par un micro-pattern. Des avertissements dans la marge de gauche vous signalent les cas où l’insertion du code spécifique peut perturber la réconciliation. Ceci est le cas si vous écrasez une ligne générée par un micro-pattern et ajoutez un appel de micro-pattern dans le code généré par micro-pattern.

Vous pouvez insérer des fonctions ou sous-fonctions dans la PROCEDURE DIVISION à partir d’un assistant de création. Pour l’ouvrir, faites un clic droit dans l’éditeur et sélectionnez Créer une fonction ou sous-fonction. La position du curseur lors de l’ouverture de l’assistant est sans importance. La fonction ou sous-fonction créée est insérée correctement selon le numéro que vous lui donnez dans l’assistant.

Il existe deux modes d’insertion :
  • Insertion en mode absolu dans les Programmes, Ecrans et Serveurs,
  • Insertion en mode relatif par rapport aux fonctions automatiques du modèle Dialogue standard ou client ou Composant Applicatif.
L’assistant de création de fonctions et sous-fonction insère les éléments suivants dans le code :
  • Un titre pour une fonction ou un commentaire pour une sous-fonction,
  • Les étiquettes de début et de fin,
  • Le niveau,
  • Le commentaire *<insert code for Fffnn here> (avec Fffnn le code de la fonction ou sous-fonction) pour indiquer le début d’une insertion possible de code spécifique,
  • Des informations variables selon l’insertion :
    • Pour une insertion en mode absolu : la condition d’exécution si elle a été indiquée dans l’assistant.
    • Pour une insertion en mode relatif : le placement par rapport aux fonctions automatiques. Les indications *@BEFORE, *@AFTER ou *@REPLACE s’affichent au début de l’insertion, suivies de la catégorie, du Segment ou de la Rubrique par rapport auxquels l’insertion s’effectue. Pour une insertion dans la fonction F80, l’accès personnalisé est indiqué.

Vous pouvez modifier le niveau d’une sous-fonction spécifique depuis l’assistant de création d’une sous-fonction. Pour ce faire, placez le curseur à l’intérieur de cette sous-fonction, faites un clic droit et sélectionnez Changer le niveau d’une sous-fonction.

L’éditeur COBOL PDP inclut de nombreuses fonctions. Vous pouvez, par exemple, couper, copier, coller, filtrer les lignes, déboguer, comparer, afficher l’aide à la saisie en appuyant sur les touches Ctrl et espace.
Limite : Les fonctions Annuler et Répéter de l’éditeur sont désactivées après une génération. La pile de modifications pour Annuler/Répéter est vide après chaque génération. Les modifications faites avant une génération ne peuvent donc pas être défaites par la fonction Annuler. Pour supprimer les modifications (génération comprise) effectuées avant la génération, il est toujours possible de sortir de l’éditeur sans sauvegarder ou d’utiliser la fonction Rétablir le fichier.

L'éditeur COBOL PDP signale un état modifié avec l'apparition d'un * dans l'onglet de l'éditeur lorsque le fichier .cbl est directement modifié ou que l'un ou plusieurs des fichiers de design qu'il référence est modifié. Ainsi lorsque vous modifiez une instance référencée dans un fichier COBOL en cours d'édition, l'éditeur COBOL PDP passe en état modifié. Pour annuler les modifications de l'éditeur et des instances du modèle, faites un clic droit dans l'éditeur et sélectionnez Rétablir le fichier.

Déphasage entre le design et le code généré

Lorsque le design de l’instance générée est modifié, il peut y avoir un déphasage entre le design et le COBOL généré. Dans ce cas, l’icône Déphasage entre design et COBOL généré apparaît, suivi d’un caractère spécial dans le titre de l’onglet de l’éditeur COBOL PDP. Le caractère spécial par défaut est > mais vous pouvez le modifier en sélectionnant Fenêtre > Préférences > Programmation pilotée par pattern > Infrastructure PDP > Caractère à utiliser pour mieux visualiser le besoin de regénération dans l’éditeur PDP. Ces signaux vous préviennent qu'une nouvelle génération est requise.
Remarque : Tout déphasage est également signalé dans la vue Design de l’instance. Le bouton permettant la génération se colorise alors (Générer est recommandé suite à des modifications dans le design) pour signifier que Générer est recommandé suite à des modifications dans le design. Une fois la génération effectuée, le déphasage disparaît et le bouton reprend son aspect initial.

Spécificités de l’affichage dans l’éditeur COBOL PDP

La coloration PDP, en plus de celle de l'éditeur COBOL standard, vous permet de connaître l'origine des lignes. Par défaut, les lignes provenant des Macros sont kaki et les lignes de code généré sont grises.

Vous pouvez changer ces couleurs PDP par défaut en sélectionnant Fenêtre > Préférences > Programmation pilotée par pattern > Patterns Pacbase.

Deux symboles en lien avec Rational Programming Patterns peuvent être affichés dans la marge :
  • information est affiché à l'endroit où des lignes de code ont été effacées ou écrasées. Si vous positionnez votre souris sur ce symbole, vous pouvez voir les lignes effacées ou les lignes écrasées par les lignes courantes.
  • avertissement est affiché dans les cas suivants :
    • Sur les lignes où la réconciliation (synchronisation) détecte un problème éventuel. La réconciliation est le processus qui intègre, après une génération, le nouveau design d'une instance avec les changements spécifiques utilisateur. Un avertissement est affiché, par exemple, si la réconciliation n'est pas sûre de l'endroit où le code spécifique doit être placé car plusieurs endroits sont possibles, ou si le code généré écrasé a été modifié.
    • Sur les lignes où une différence entre la génération Pacbase et la génération locale est détectée. Le libellé de ce type d'avertissement est clairement identifiable dans la vue Erreurs.
Vous pouvez modifier l'affichage dans l'éditeur COBOL PDP avec des filtres depuis la vue Structure du Code Généré. Vous pouvez également effectuer les actions suivantes à partir du menu contextuel de l'éditeur :
  • Développer tous les blocs en faisant un clic droit et en sélectionnant Développer tous les blocs.
  • Réduire tous les blocs en faisant un clic droit et en sélectionnant Réduire tous les blocs.

Vos commentaires