Rational Programming Patterns for System z

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

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 for System z) 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 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.
  • Conserver les constantes et la date générées dans Pacbase en affichant un avertissement. Ces lignes seront affichées comme des lignes spécifiques, accompagnées d'un avertissement. A partir de cet avertissement, 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 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 devez ensuite saisir une ligne de commande batch d'aide à la migration à partir de l'invite de commande, ou utiliser l'assistant d'aide à la migration.

La fonction d'aide à la migration :
  1. 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é.
  2. 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. .
  3. 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.
  4. Copie le fichier de contrôle dans le fichier .cblpdp produit par la génération locale.

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.