rpp --automaticMigration
Cette commande produit un fichier de commandes permettant de déclencher une migration dans son intégralité : import, répartition des Macros, modification éventuelle de la cible de génération par défaut et aide à la migration. Une option, disponible pour les projets généraux et z/OS, permet de générer les sources COBOL dans des projets différents et de séparer les fichiers de métadonnées. Par défaut, la synchronisation des codes sources par rapport à leur design est effectuée lors d'un import de journal dans tous les projets mais une option permet d'adapter cette synchronisation.
Syntaxe
rpp.bat --automaticMigration [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 |
--from | Nom du répertoire dans lequel sont enregistrés
les fichiers nécessaires à la migration :
|
Oui | |
--location | Ce paramètre permet de remplacer le nom du référentiel pour les commandes d'import par la valeur requise. Il permet aussi de nommer le fichier résultat de la commande de migration automatique : location.txt. | Oui | |
--separateCobolProject | Option disponible pour les projets généraux
et z/OS Si cette option est indiquée, les sources COBOL seront générés dans un projet séparé de même nom que le projet de son instance du modèle, avec un suffixe _COB. |
Non | |
--cobolProjectType | Type du projet qui contiendra les sources COBOL
:
|
Non | G |
--separateMapFolder | Option pour migrer les mappes d'Ecrans dans un dossier spécifique | Non | map |
--separateMetadataFiles | Option pour séparer les fichiers de métadonnées | Non | |
--pdpRootPath | Nom du répertoire de métadonnées pdp | Non | pdp |
--previousSessionFolder | Emplacement des fichiers COBOL d'une session Pacbase précédente, dans
le cadre de la migration de plusieurs sessions dans le même espace
de travail. Ce paramètre réduit le temps de migration car les fichiers COBOL identiques dans les deux sessions (hormis les constantes Pacbase et la date de génération) ne sont pas réimportés. |
Non | |
--validationFile |
Chemin complet du fichier validation.xml qui contient les types de validation. Ce fichier est automatiquement pris en compte dans les préférences de la validation de la migration. La validation de la migration s'effectue alors en même temps que l'aide à la migration pour optimiser la durée de la migration. |
Non |
|
--projectsToSynchronize | Liste des projets dont les codes sources doivent être synchronisés avec leur
design. Les projets doivent être séparés par une virgule. Cette option n'est prise en compte qu'en cas d'import d'un journal. Si vous indiquez cette option et lui affectez la valeur NONE, aucun code source n'est synchronisé. Si vous n'indiquez pas cette option, les codes sources de tous les projets sont synchronisés. |
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 |
- Un fichier d'extension .ta2 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).
Si la migration résulte de l'exécution des procédures MIBR ou MIBA, ce fichier doit se nommer MIBR.ta2.
Si la migration résulte de l'exécution des procédures MIBJ ou MIBU, le nom de ce fichier .ta2 n'est pas figé mais doit être différent de MIBR.ta2.
- MIMA.cblgen
D'autres fichiers d'extension .cblgen mais de nom différent peuvent être présents dans ce répertoire. Ceci est le cas, par exemple, si vous avez modifié manuellement le code source d'une Macro. Tous les fichiers .cblgen sont alors pris en compte par la procédure de migration automatique.
- MIA1.txt
- MIA2.txt
- MIA3.txt
- MIA4.txt
- COBOL_MIA1.txt pour les sources contenant le COBOL complet des Programmes, produits par MIA1.
- COBOL_MIA2.txt pour les sources contenant le COBOL complet des Ecrans standard, produits par MIA2.
- COBOL_MIA3.txt pour les sources contenant le COBOL complet des clients TUI, produits par MIA3.
- COBOL_MIA4.txt pour les sources contenant le COBOL complet des Serveurs, produits par MIA4.
- CONTROL_COBOL_MIA1.txt pour les sources de contrôle des Programmes, produits par MIA1.
- CONTROL_COBOL_MIA2.txt pour les sources de contrôle des Ecrans standard, produits par MIA2.
- CONTROL_COBOL_MIA3.txt pour les sources de contrôle des clients TUI, produits par MIA3.
- CONTROL_COBOL_MIA4.txt pour les sources de contrôle des Serveurs, produits par MIA4.
- transform.txt si des sources COBOL ont été générés avec une variante Microfocus (variante 3 : UNIX, Windows). Ce fichier corrige la syntaxe COBOL générée pour la rendre compatible avec le compilateur IBM®. Vous devez récupérer le fichier transform.txt dans le répertoire d'installation de votre Rational Software Delivery Platform, sous rpp/migration, et le coller dans le répertoire de migration.
- errorLabels.txt si vous voulez créer des instances de Libellés d'erreur à
partir des lignes de commandes Pacbase de génération de
libellés d'erreur. Vous devez créer ce fichier et l'ajouter dans le répertoire de migration.
Ce fichier
doit contenir autant de lignes que d'instances de Libellés d'erreur à créer, selon la syntaxe
suivante :
- La commande de génération Pacbase (GED, GEO, GEC ou GES).
- La Bibliothèque de génération.
- Après un blanc, la Structure de Données ou le Dialogue associé.
- Après un blanc, une option de génération (C1 à C4), facultative. Si cette option n'est pas indiquée, C1 sera pris en compte par défaut.
- Après un blanc, le nom qui sera donné à l'instance de Libellé d'erreur créée.
Exemple : GEDCEN DD C1 ERROR1 - specificerrorLabel.txt si vous voulez que le fichier des libellés d'erreur spécifiques Pacbase (extrait avec la procédure MILA) soit copié dans votre espace de travail afin d'être pris en compte par défaut dans les instances de l'entité Libellé d'Erreur. Pour cela, récupérez le fichier résultat de MILA, renommez-le specificerrorLabel.txt et copiez-le dans le répertoire de migration.
- inputzCompMap.txt. Ce fichier facultatif n'est pas généré automatiquement.
S'il vous est utile, vous devez le créer manuellement et l'ajouter dans ce répertoire. Il permet de
mettre en correspondance des jeux de cartes de contrôle optionnelles Pacbase avec des définitions de langage z/OS.
Ce fichier doit contenir une ligne par mise en correspondance, selon le format suivant :
XX LangageDefinition.
XX est le jeu carte avant et carte après dans Pacbase, sur 2 caractères. En l'absence de carte avant ou carte après dans Pacbase, vous devez saisir un blanc à la place.
LangageDefinition est la définition de langage ciblée dans Rational Team Concert, séparée du jeu carte avant et après par un blanc. - librariesFilter.txt si vous voulez n'importer que les données de certaines Bibliothèques. Ce fichier doit contenir une Bibliothèque par ligne. Vous pouvez l'utiliser lors d'une migration initiale (procédure MIBR) ou lors d'une migration progressive (procédure MIBJ).
- Un dossier COBOL_FOLDER et un dossier CONTROL_COBOL_FOLDER. Ces dossiers contiennent chacun quatre répertoires, correspondant aux quatre patterns (pacprogram ou MIA1, pacscreen ou MIA2 par exemple). Chacun de ces quatre répertoires contient un sous-répertoire par Bibliothèque. Les fichiers .cbl sont stockés dans le sous-répertoire correspondant à la Bibliothèque d'origine de l'instance générée.
- Un fichier de commandes location.txt (où location
représente le nom du référentiel). Vous devez ensuite lancer la commande rpp.bat
--commands en indiquant ce fichier comme option.
Les données migrées sont filtrées si un fichier librariesFilter.txt est présent dans le répertoire d'entrée de la migration. Le fichier de commandes positionne automatiquement l'option --librariesFilterFile dans les commandes d'import (rpp --import et rpp --importJournal) pour réduire le périmètre des données à importer. De plus, la commande d'aide à la migration (rpp --migrationHelp) ne porte que sur les entités générables des Bibliothèques migrées, réduisant ainsi la durée de cette phase.
- Un répertoire ORIGINAL_COBOL si des fichiers
COBOL ont été modifiés par le fichier transform.txt.
Ce nouveau répertoire contient la version originale de ces fichiers
COBOL, avant la modification.Remarque : Pour rétablir le contrôle syntaxique du code COBOL sur les fichiers modifiés, vous devez sélectionner la préférence La syntaxe COBOL pour la variante 3 (UNIX,Windows) est certifiée compatible avec la syntaxe IBM COBOL AIX après la migration. Pour accéder à cette préférence, sélectionnez .
- Un fichier specificerrorLabel.txt dans le projet .INTER du référentiel. Ce ficher est la copie du fichier de même nom situé dans le répertoire d'entrée de la migration. Ce fichier sera alors pris en compte par défaut si aucun fichier n'est indiqué dans la zone Fichier spécifique des libellés d'erreur des instances de l'entité Libellé d'Erreur du référentiel.
- Un fichier outputzCompMap.txt de mise en correspondance des jeux de cartes de contrôle optionnelles Pacbase avec des définitions de langage z/OS. Ce fichier est produit si le paramètre --cobolProjectType a la valeur Z et si le fichier inputzCompMap.txt existe dans le répertoire. Le fichier outputzCompMap.txt sera exploité durant le processus de migration pour créer autant de fichiers de mise en correspondance que de projets COBOL zOS pour la commande rpp-zcompmap. Ces fichiers seront générés par défaut dans le répertoire metadata/zCompMap de l'espace de travail de migration.
- Un fichier MIBR_modified.ta2 si vous avez indiqué, dans un fichier errorLabels.txt, que des instances de Libellé d'Erreur doivent être créées lors de l'import. Le fichier MIBR_modified.ta2 est une copie du fichier MIBR.ta2 mais il contient en plus les Libellés d'Erreur à créer. Si ce fichier existe, il est automatiquement pris en compte à la place du fichier MIBR.ta2 lors de l'exécution de la commande d'import.
A la fin du fichier de log, un compteur affiche le nombre de fichiers COBOL modifiés ou créés.