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 dans
le menu contextuel.
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 .
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

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 . Ces signaux
vous préviennent qu'une nouvelle génération est requise. Vous pouvez
regénérer globalement tous les fichiers déphasés par rapport au design
depuis la vue
Gestionnaire de génération.
Remarque : Tout
déphasage est également signalé dans la vue
Design de
l’instance. Le bouton permettant la génération se colorise alors (

)
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 .
Deux symboles en lien avec Rational Programming
Patterns peuvent être affichés dans la marge :
-
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.
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.