Rational Developer for System z, Version 7.6

Concept et principe de fonctionnement de l'aide à la migration

Cette fonction est utile lors de la migration dans RDz du code d'un Programme ou d'un Ecran généré depuis VA Pac. Elle positionne des warnings 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 VA Pac et le code généré en local.

L'éditeur LPEX 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 le Programme/ l'Ecran a été généré à la fois dans VA Pac 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 warnings 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 (VA Pac et RDz) ont été lancées de manière identique (même bibliothèque/package, à partir de la même instance avec toutes les Macros appelées...) et attire votre attention sur des différences qui pourraient être dûes à un changement de générateur.

Différences dûes à un changement de générateur

Les lignes Cobol correspondant aux constantes Pac et à la date de générations ne sont pas identiques dans le code généré dans VA Pac 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 VA Pac 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 VA Pac sans afficher de warning. Ces lignes seront affichées comme des lignes spécifiques.
  • Conserver les constantes et la date générées dans VA Pac en affichant un warning. Ces lignes seront affichées comme des lignes spécifiques, accompagnées d'un warning. A partir de ce warning, vous pourrez accéder à trois correctifs rapides qui vous permettront de gérer les différences détectées.

D'autres différences, dûes à 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 VA Pac et en local...). L'aide à la migration positionne alors aussi des warnings 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 le Programme/l'Ecran dans VA Pac:
  • Si le Programme/l'Ecran appelle des Macros, vous devez les générer dans VA Pac et importer les fichiers .cblgen 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 VA Pac.
    • 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 VA Pac MIA1.

Dans RDz, vous devez ensuite ouvrir l'assistant d'aide à la migration en double-cliquant sur un Programme/Ecran dans la vue Explorateur de designs et en sélectionnant le choix Aide à la migration dans le menu contextuel. Remplissez les zones de cet assistant et cliquer sur Terminer.

La fonction d'aide à la migration copie les deux fichiers .cbl générés dans VA Pac dans votre espace de travail, lance la génération locale RDz (dont le code est généré à partir du design de l'instance) et compare le fichier de contrôle VA Pac avec le fichier généré en local. Elle positionne un warning à chaque fois qu'elle détecte une différence.

Les warnings sont affichés jusqu'à ce que vous les corrigiez (trois correctifs rapides sont disponibles) ou ou que vous regénériez.

Comment gérer les warnings

Pour voir les warnings, vous devez ouvrir le fichier .cbl dans l'éditeur LPEX PDP. Chaque warning est associé à un noeud du généré. Les warnings sont affichés :
  • Directement sur les lignes Cobol de l'éditeur PDP,
  • Dans la vue Problèmes. Si vous double-cliquez sur un warning, les lignes correspondantes sont sélectionnées dans l'éditeur PDP.
Vous pouvez utiliser des correctifs rapides pour gérer les warnings. Pour ce faire, double-cliquez sur un warning et sélectionnez Correctif rapide. Puis, dans l'assistant des correctifs rapides, sélectionnez le correctif approprié et cliquez sur Terminer. Trois correctifs sont disponibles :
  • Supprimer le warning. Si vous sélectionnez ce correctif, le warning disparaîtra et la ligne sera affichée comme toutes les autres lignes spécifiques.
  • Restaurer le code généré. Si vous sélectionnez ce correctif, le contenu de la ligne, provenant de la génération VA Pac, 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 le warning ne sera donc plus affiché.
  • Montrer les differences. 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 VA Pac et le code généré en local, en mettant en évidence toutes les différences. 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 du Programme/de l'Ecran généré dans VA Pac (incluant le code généré à partir du design et le code spécifique).

Conditions d'utilisation | Commentaires en retour

Ce centre de documentation utilise la technologie Eclipse. (http://www.eclipse.org)