rpp --import
Cette commande est utilisée pour importer les instances dans l’espace de travail local. Seul l'import à partir d’un fichier .ta2 est possible. L'import d'instances est lancé automatiquement par la commande rpp --automaticMigration. Vous pouvez cependant aussi lancer cette commande à part.
Syntaxe
rpp.bat --import [options]Paramètres
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. |
Non | trace.log |
--importType | Type d'import | Oui | ta2 |
--fromFile | Nom du fichier en entrée | Oui | |
--location | Localisation de la cible (référentiel) | Oui | |
--overwrite | Ecrasement des fichiers existants | Non | false |
--generatedDataFile | Emplacement et nom du fichier technique .xml à générer lors de l'import | Non | imported_data_refer.xml dans le répertoire .metadata (refer correspondant au code du référentiel) |
--report | Fichier de rapport d'erreurs de l'import | Non | .pacmigration.log du répertoire .metadata de l'espace de travail |
--overwriteReport | Ecrasement du fichier de rapport d'erreur | Non | false - par défaut, ajout au fichier existant |
--multisession | Import, dans le même espace de travail, de données
issues de plusieurs sessions Pacbase. Ce paramètre est généré automatiquement si le paramètre--previousSessionFolder est indiqué dans la commande de migration automatique. |
Non | |
--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. |
Non | |
--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. |
Non |
- 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 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.