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.

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 nom 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
--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

 
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.
  • 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
    où :
    XX est le jeu carte avant et carte après dans Pacbase,
    LangageDefinition est la définition de langage ciblée dans Rational Team Concert.
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.
  • Un fichier zcompmap.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.

A la fin du fichier de log, un compteur affiche le nombre de fichiers COBOL modifiés/créés.

Exemple

rpp.bat --automaticMigration --data C:/usr/WKSFD2 --from C:/usr/Tests/WorkItemRTC/WI6382bis/ --location TESTON --separateCobolProject --separateMapFolder --separateMetadataFiles --previousSessionFolder C:\RppData\BES_PDDN\0010T\COBOL_FOLDER --validationFile C:\RppData\validation.xml

Vos commentaires