Cette fonction est utile lors de la migration du code d'un
Programme, Ecran ou Serveur généré depuis Pacbase. Elle positionne
des avertissements sur les lignes générées à partir du design de l'instance
dès qu'elle détecte des différences entre le code généré depuis Pacbase et le code généré
en local.
L'éditeur COBOL PDP,
dans lequel vous ouvrez le fichier .cbl de l'instance,
différencie le code généré (à partir du design) du code spécifique.
Quand l'instance a été générée à la fois dans Pacbase et dans le générateur
local, l'éditeur PDP met
aussi en évidence les différences qu'il détecte dans les deux
versions du code.
La fonction d'aide à la migration positionne des avertissements
sur les lignes où de telles différences ont été détectées. Cela vous
permet de vous assurer que les deux générations (Pacbase et Rational Programming
Patterns) 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...) et
attire votre attention sur des différences qui pourraient être dues
à un changement de générateur.
Différences dues à un changement de générateur
Les
lignes COBOL correspondant aux constantes
Pacbase et à la date de
générations ne sont pas identiques dans le code généré dans
Pacbase et celui généré
localement. La fonction d'aide à la migration vous permet alors
de :
- Remplacer les constantes et la date générées dans Pacbase par celles du générateur
local (choix par défaut). Ces lignes ne seront donc pas affichées
comme des lignes spécifiques.
- Conserver les constantes et la date générées dans Pacbase sans afficher d'avertissement.
Ces lignes seront affichées comme des lignes spécifiques.
D'autres différences, dues à un changement de générateur,
peuvent aussi être détectées par l'éditeur PDP (par exemple parce
que la ventilation des Macros n'est pas identique dans Pacbase et en local...).
L'aide à la migration positionne alors aussi des avertissements
sur de telles lignes.
Principe de fonctionnement de l'aide à la migration
Pour
pouvoir utiliser la fonction d'aide à la migration, vous devez
d'abord générer l'instance dans
Pacbase:
- Si l'instance appelle des Macros, vous devez les générer
dans Pacbase et
importer les fichiers .cblmsp correspondants
dans votre espace de travail.
- Vous devez générer deux fichiers .cbl :
- Le premier fichier contient le code généré à partir du design
et le code spécifique. Il est généré avec la procédure de génération Pacbase.
- Le second fichier ne contient que le code généré à partir du design.
Ce fichier, appelé 'fichier de contrôle', est généré avec
la procédure batch Pacbase MIA1
(pour les Programmes), MIA2 (pour les Ecrans), MIA3 (pour les Clients
TUI), ou MIA4 (pour les Serveurs).
Vous lancez ensuite saisir l'aide à la migration
depuis un des deux modes suivants :
- Mode batch en indiquant une ligne
de commande batch d'aide à la migration à partir de l'invite
de commande ou d'un fichier de commandes. Ce mode permet le lancement
d'un grand nombre de comparaisons. Il permet de bénéficier de
toutes les options disponibles pour l'aide à la migration. Trois
rapports sont générés à la fin de l'exécution.
- Mode interactif en utilisant l'assistant d'aide à la
migration. Cette utilisation est réservée à l'aide à la migration
d'un petit nombre d'instances. Aucun rapport d'exécution
n'est généré.
La fonction d'aide à la migration effectue les actions
suivantes :
- Copie le fichier .cbl généré dans Pacbase dans votre espace
de travail, 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é.
- Lance la génération locale, dont le code est généré à partir du
design de l'instance.
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'importation.
.
- Compare le fichier de contrôle Pacbase avec le fichier
généré en local. Un avertissement est positionné chaque fois qu'une
différence est détectée.
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.
- Copie le fichier de contrôle dans le fichier .cblpdp produit
par la génération locale.
- Génère trois rapports si l'aide à la migration a été lancée
en mode batch. Ces fichiers 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.
Les avertissements sont recalculés
lors de chaque nouvelle génération, à moins que vous n'appliquiez
le correctif qui les supprime définitivement tous.
Un message
d'information apparaît si vous ouvrez le code d'une instance
dans lequel subsistent des avertissements.
Comment gérer les avertissements
Pour voir
les avertissements, vous devez ouvrir le fichier
.cbl dans
l'éditeur COBOL
PDP.
Chaque avertissement est associé à un noeud du généré. Les avertissements
sont affichés :
- Directement sur les lignes COBOL de l'éditeur PDP,
- Dans la vue Problèmes. Si vous double-cliquez
sur un avertissement, les lignes correspondantes sont sélectionnées
dans l'éditeur PDP.
Remarque : Un message d'information indique si aucune différence
n'a été détectée.
Vous pouvez utiliser des correctifs
rapides pour gérer les avertissements. Pour ce faire, double-cliquez
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 le contrôle de la migration.
Ce correctif n'est disponible que si aucune différence n'a
été détectée. Il supprime, dans le fichier .cblpdp,
toutes les informations relatives à l'aide à la migration.
- 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,
tous les avertissements disparaîtront définitivement et les lignes
seront affichées comme toutes les autres lignes spécifiques. Lors
de la génération suivante, les avertissements ne seront pas recalculés.
- Restaurer le code généré. Si vous sélectionnez
ce correctif, le contenu de la ligne, provenant de la génération Pacbase, sera remplacé par
le contenu de la ligne généré localement. Les lignes correspondantes
ne seront plus affichées comme des lignes spécifiques et l'avertissement
ne sera donc plus affiché.
- Montrer les différences. Si vous sélectionnez
ce correctif, l'éditeur Comparer s'ouvre.
Cet éditeur affiche le code du fichier de contrôle généré dans Pacbase et le code généré
en local, en mettant en évidence toutes les différences. Le contenu
des fichiers est affiché de façon fragmentée. Si vous cliquez, dans
la barre d'outils, sur le bouton Afficher la sous-fenêtre
ancêtre, vous verrez dans cette sous-fenêtre le code complet
de l'instance générée dans Pacbase (incluant le code
généré à partir du design et le code spécifique).
- Montrer les différences sur tout le fichier.
Ce correctif est identique au correctif précédent mais l'éditeur
de comparaison affiche le contenu des deux fichiers de façon continue.