rpp --importJournal

Cette commande est utilisée pour importer, dans Rational Programming Patterns, des mises à jour extraites du journal Pacbase ou du fichier produit par la procédure MIBU de personnalisation de la migration. Le fichier à importer doit avoir une extension .ta2 mais son nom ne doit pas être MIBR. L'import des mises à jour du journal est lancé automatiquement par la commande rpp --automaticMigration dans le cadre d'une migration progressive. Vous pouvez cependant aussi lancer cette commande à part.

Remarque : Le numéro de version de Pacbase est inclus dans le fichier .ta2. Si la version incluse dans ce fichier n'est pas compatible avec la version courante de Rational Programming Patterns, l'import n'est pas exécuté et une erreur est générée. Le contrôle ne descend pas jusqu'au niveau sous-version (Y09A par exemple).

Syntaxe

rpp.bat --importJournal [options]

Paramètres

Tableau 1. Liste des paramètres disponibles
Options Commentaires Obligatoire Valeurs par défaut
--data Chemin d'accès à l'espace de travail utilisé. Oui  
--log Nom du fichier journal

Le début de ce fichier rappelle les paramètres saisis lors du lancement des procédures de migration Pacbase.

trace.log
--fromFile Nom du fichier .ta2 en entrée. Ce fichier ne doit pas se nommer MIBR.ta2. Oui  
--fromDataFile Emplacement et nom du fichier technique .xml à prendre en compte lors de l'import Oui  
--location Référentiel cible Oui  
--generatedDataFile Emplacement et nom du fichier technique .xml à générer lors de l'import   imported_data_refer.xml dans le répertoire .metadata, refer correspondant au référentiel cible
--report Fichier de rapport d'erreurs de l'import   pacmigration.log du répertoire .metadata de l'espace de travail
--overwriteReport Ecrasement du fichier de rapport d'erreurs   false - par défaut, ajout au fichier existant
--librariesFilterFile Filtrage des résultats de l'extraction pour n'importer que les données de certaines Bibliothèques.

Ces Bibliothèques doivent être indiquées dans le fichier librariesFilter.txt qui doit être présent dans le répertoire d'import. Ce fichier doit contenir une Bibliothèque par ligne.

   
--noMigratedFile Chemin complet du fichier contenant la liste des Programmes, Ecrans ou Serveurs dont les fichiers COBOL ne doivent pas être migrés dans le cadre d'une migration multi-sessions (procédure MIBR) ou progressive (procédure MIBJ). A chaque nouvelle exécution d'une de ces procédures, la liste mise à jour est réexportée. Vous pouvez la prendre en compte lors de chaque import d'une session ou du journal en indiquant l'option --noMigratedFile. Les fichiers COBOL des nouvelles instances intégrées dans la liste mise à jour sont alors automatiquement supprimés de l'espace de travail lors de l'import s'ils avaient été précédemment importés.

Le fichier contenant la liste des instances a dû être préalablement copié dans le répertoire de migration, éventuellement renommé (userNMig par exemple), et complété par une extension .txt. Vous pouvez indiquer l'option --noMigratedFile dans la commande de migration automatique. Si vous n'utilisez pas cette commande, vous pouvez indiquer l'option dans la commande d'import ou d'import du journal.

   
Pour son utilisation ultérieure, le fichier script créé contenant les commandes SCM doit être complété avec les informations suivantes :
  • Code de l'utilisateur sous Rational Team Concert
  • Nom du flux dans lequel les projets seront remontés
  • Adresse du serveur Rational Team Concert
  • Chemin du répertoire où se trouvent les exécutables lscm

Le fichier technique .xml créé à la fin de l'import est nécessaire en cas d'import ultérieur. Ce fichier rassemble des informations qui n'ont pas été reprises dans le métamodèle Rational Programming Patterns ainsi que la liste des instances préalablement importées.

Le fichier de rapport d'erreurs de l'import synthétise le contenu du fichier .ta2 importé en affichant les informations suivantes :
  • Le contexte de l'import comme la base, l'utilisateur, la session, la Bibliothèque et la date.
  • Le remplacement des caractères spéciaux.
  • Les statistiques des instances présentes dans le fichier .ta2. Ces chiffres incluent les instances dupliquées par les procédures de migration.
  • Les erreurs détectées lors de l'import.
  • Les Structures de Données et les Dialogues dupliqués par l'import. Une Structure de Données est dupliquée si certains de ses Segments existent dans une Bibliothèque Pacbase inférieure ; la Structure de Données est alors dupliquée dans le sous-projet Rational Programming Patterns correspondant. Un Dialogue est dupliqué si le type de certains de ses composants (Ecrans, Serveurs ou Dossiers par exemple) n'est pas compatible avec son propre type. Par exemple, dans Pacbase, un Dialogue Serveur rassemble des Serveurs et des Ecrans Clients. Lors de l'import, un Dialogue Client sera créé dans Rational Programming Patterns pour rassembler ces Ecrans Clients.
  • Le nombre d'instances réellement importées et le nombre d'instances présentes dans le fichier .ta2. Le nombre d'instances réellement importées peut être inférieur au nombre d'instance présentes dans le fichier .ta2 dans le cas de l'import d'une nouvelle session Pacbase dans le même espace de travail. Dans ce cas, les instances qui n'ont pas été modifiées ne sont pas comptabilisées dans les instances importées.
  • Le nombre d'entités de design modifiées, créées ou supprimées.

Exemple

rpp.bat --import --fromFile C:/import/IMPORT1.ta2 --location IMPORT --importType ta2 --overwrite --data C:/workspaces/batchWks --log C:/import/out/trace.log --generatedDataFile C:/import/out/genData.xml --librariesFilterFile C:/Rpp/Input/librariesFilter.txt C:/MIGRK1001J1/userNMig.txt
rpp.bat --importJournal --fromFile C:/import/Journal_IMPORT2.ta2 --fromDataFile C:/import/out/genData.xml --location IMPORT --data C:/workspaces/batchWks --log C:/import/out/traceJournal.log --generatedDataFile C:/import/out/genData.xml --librariesFilterFile C:/Rpp/Input/librariesFilter.txt C:/MIGRK1001J1/userNMig.txt

Vos commentaires