L'exécution de la fonction d’'aide à la migration est obligatoire
lors de la migration du code d'un Programme, Ecran ou Serveur
généré depuis Pacbase.
Cette fonction copie le COBOL Pacbase dans votre espace
de travail et le regénère en local. Le COBOL obtenu après la génération
locale est alors comparé au COBOL d'origine. La fonction d’aide à
la migration positionne des avertissements sur les lignes où elle
détecte des différences autres que des différences de formatage ou
de commentaires.
Elle vous permet de vous assurer que la génération Pacbase et la génération
locale ont été lancées de manière identique (même Bibliothèque/projet,
à partir de la même instance, avec toutes les Macros appelées, par
exemple). Elle attire votre attention sur des différences significatives
(si vous avez modifié le design d’une instance en local, par exemple,
avant de lancer l’aide à la migration) ou non significatives (différence
dans la date et l’heure de génération par exemple). C’est à vous de
gérer les avertissements.
Actions effectuées par l'aide à la migration
La
fonction d'aide à la migration effectue les actions suivantes
:
- Elle copie le fichier .cbl généré dans Pacbase dans votre espace
de travail local, Ce fichier est copié dans la cible COBOL indiquée
dans la Définition de l'instance, sous
le nom indiqué dans la zone Code programme généré de
la Définition. Le fichier sera donc renommé
si le nom du fichier généré dans Pacbase ne correspond pas
à celui du Code programme généré.
Remarque : Si vous
développez l'instance dans la vue Explorateur de designs après
avoir lancé l'aide à la migration, vous voyez la localisation
de la cible COBOL et le nom du fichier copié.
- Elle lance la génération locale. Cette génération prend en compte
les fichiers générés par MIA1 (pour les Programmes), MIA2 (pour
les Ecrans), MIA3 (pour les clients TUI), ou MIA4 (pour
les Serveurs). Elle exécute la génération locale et effectue les post-traitements
et la réconciliation de code.
Remarque : La langue du squelette de génération
de l'instance est identique à celle de Pacbase car cette information
est reprise lors de l'extraction des modèles Pacbase et de l'import.
Le résultat de la génération locale est enregistré dans
un bac à sable. Son contenu ne remplacera pas le contenu du fichier .cbl déjà
copié dans votre espace de travail sans demande explicite de votre
part.
- Elle compare le fichier .cbl généré dans Pacbase avec le fichier
généré en local. Si des différences autres qu’un formatage ou un commentaire
sont détectées, elle positionne des avertissements. Elle vous informe
que vous devez gérer ces avertissements et les supprimer avant de
pouvoir travailler sur l’instance.
Remarque : Les avertissements sont stockés
dans le fichier .cblpdp. Donc, si vous les conservez
et distribuez l'instance générée sur le serveur, les utilisateurs
qui chargeront cette instance dans leur propre espace de travail verront
aussi ces avertissements.
- Elle génère trois rapports si elle a été lancée en mode batch.
Ces rapports sont générés dans le répertoire indiqué dans le paramètre --reportFolder de
la ligne de commande.
Vous devez ensuite étudier les avertissements et leur
appliquer des correctifs rapides. Ils restent visibles et sont recalculés
lors de chaque nouvelle génération jusqu'à ce que vous les corrigiez
et les supprimiez tous. Tous les avertissements doivent être gérés
pour que le fichier local remplace le fichier .cbl déjà
copié dans votre espace de travail.
Un message d'information
apparaît si vous ouvrez le code d'une instance dans lequel subsistent
des avertissements.
Gestion des avertissements
Les avertissements
sont affichés à deux niveaux :
- Sur les lignes COBOL de l'éditeur COBOL PDP,
- Dans la vue Erreurs. Si vous double-cliquez
sur un avertissement, les lignes correspondantes sont sélectionnées
dans l'éditeur COBOL PDP,
s’il est ouvert.
Pour appliquer un correctif rapide, faites un clic droit
sur un avertissement et sélectionnez
Correctif rapide.
Puis, dans l'assistant des
correctifs rapides,
sélectionnez le correctif approprié et cliquez sur
Terminer.
Les correctifs suivants sont disponibles :
- Supprimer l'avertissement. Si vous sélectionnez
ce correctif, l'avertissement disparaîtra et la ligne sera affichée
comme toutes les autres lignes spécifiques. Cependant, si la différence
est détectée à nouveau lors de la génération suivante, cet avertissement
sera affiché à nouveau.
- Supprimer le contrôle de la migration ainsi que tous
les avertissements. Si vous sélectionnez ce correctif
alors que l’éditeur COBOL PDP est
ouvert, l'éditeur Comparer s'ouvre. Cet éditeur
affiche en parallèle le code du fichier .cbl généré
dans Pacbase et
le code issu de la génération locale. Il met en évidence toutes les
différences détectées dans ces deux codes.
Le code issu de la génération
locale est éditable. Vous pouvez donc copier des lignes du fichier
Pacbase dans le fichier
local. Vous pouvez procéder de deux façons :
- Copier toutes les modifications non conflictuelles en appuyant
sur le bouton correspondant de la barre d’outils et gérer individuellement
les modifications restantes.
- Sélectionner une modification dans le fichier Pacbase et la copier dans
le fichier local. Vous pouvez positionner le curseur au point d’insertion
ou appuyer sur le bouton de la barre d’outils qui vous permet de copier
la modification courante.
Remarque : Si vous ne voulez pas conserver vos modifications,
vous pouvez fermer l’éditeur COBOL PDP sans sauvegarder
A
l’issue de cette validation manuelle, lancez une nouvelle génération
locale. La fonction d’aide à la migration étant désactivée, les avertissements
ne sont plus calculés. Vous devrez ensuite sauvegarder le code généré
localement pour qu’il remplace le code généré dans Pacbase. Vous pourrez alors
travailler sur l’instance.
Remarque : Si vous sélectionnez ce correctif
alors que l’éditeur COBOL PDP est
fermé, la sauvegarde du code local est implicite. Le code local remplace
automatiquement le code généré dans Pacbase et les avertissements
disparaissent.
- Montrer les différences. Si vous sélectionnez
ce correctif, l'éditeur Comparer s'ouvre.
Cet éditeur affiche en parallèle, de façon fragmentée, le code du
fichier .cbl généré dans Pacbase et le code issu
de la génération locale. Le comparateur met en évidence toutes les
différences détectées dans ces deux codes.
Le code issu de la génération
locale n’est pas éditable dans le comparateur ouvert avec ce correctif
rapide.
- Montrer les différences sur tout le fichier.
Ce correctif est identique au correctif précédent mais l'éditeur Comparer affiche
le contenu des deux fichiers de façon continue.
Le code issu de
la génération locale n’est pas éditable dans le comparateur ouvert
avec ce correctif rapide.