rpp --automaticMigration

Cette commande produit un fichier de commandes permettant de déclencher une migration dans son intégralité : import, répartition des Macros 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.

Syntaxe

rpp.bat --automaticMigration [options]

Paramètres

Tableau 1. Liste des paramètres disponibles
Options Commentaires Obligatoire Valeurs par défaut
--data Chemin complet vers 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 MIA1.txt, MIA2.txt, MIA3.txt, MIA4.txt, MIBR.ta2 et MIMA.cblgen nécessaires à la migration. Les noms de ces fichiers sont figés. 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 non que le projet de son instance du modèle, avec un suffixe _COB.

non  
--cobolProjectType Type du projet qui contiendra les sources COBOL :
  • G pour les projets généraux
  • Z pour les projets z/OS
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
--scmtoolsEntriesFile Emplacement et nom du fichier script contenant les commandes SCM, pour la remontée des données sur le serveur Rational Team Concert non scmtools_entries.bat dans le dossier .metadata de l'espace de travail
Remarques :
Pour le paramètre --from, la structure du répertoire doit être la suivante :
  • MIBR.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).

    D'autres fichiers d'extension .ta2 mais de nom différent peuvent être présents dans ce répertoire. Ceci est le cas, par exemple, si vous avez personnalisé la migration avec la procédure MIBU. Tous les fichiers .ta2 sont alors pris en compte par la procédure de migration automatique.

  • 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.
La migration automatique crée les éléments suivants :
  • 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.

Exemple

rpp.bat --automaticMigration --data C:/usr/WKSFD2 --from C:/usr/Tests/WorkItemRTC/WI6382bis/ --location TESTON --separateCobolProject --separateMapFolder --separateMetadataFiles --scmtoolEntriesFile

Vos commentaires