Rational Programming Patterns

Résultats de l'aide à la migration

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 :
  1. 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é.
  2. 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.

  3. 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.
  4. 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.


Conditions d'utilisation | Commentaires en retour

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