Rational Programming Patterns for System z

Extraction et migration des données Pacbase

Vous devez extraire et migrer les utilisateurs et les bases de développement Pacbase.

Pourquoi et quand exécuter cette tâche

Voici le schéma général des actions d'extraction et de migration des données Pacbase.
Figure 1. Schéma général de la migration
Ce schéma montre l'extraction des utilisateurs et des instances depuis Pacbase, la génération des Macros et des Programmes et leur transfert vers l'espace de travail local. Il montre aussi la génération locale et le transfert des utilisateurs et des instances (modèles et fichiers générés) dans Rational Team Concert

Procédure

  1. Migration des utilisateurs
    1. Extraction

      Extrayez et transférez, depuis la base d'administration, tous les utilisateurs avec la procédure Pacbase MIUS.

      Cette procédure permet d'extraire les identifiants, noms et adresses de courrier électronique des utilisateurs.
      Remarque : Cette procédure est détaillée dans le guide d'installation Pacbase spécifique à votre plateforme.

      Les administrateurs Pacbase auront le droit JazzAdmins, tous les autres auront le droit JazzUsers.

    2. Chargement dans Rational Team Concert

      Importez les utilisateurs dans Rational Team Concert. Le serveur Jazz Team Server doit être ouvert.

      Vous devez transférer le fichier des utilisateurs extraits avec la procédure MIUS vers la machine sur laquelle est installé le serveur Jazz..

      Vous devez tout d'abord transformer le fichier ASCII, issu de l'extraction Pacbase, au format UTF-8. Pour ce faire, vous devez exécuter le fichier AsciiToUTF8.bat, situé sour la racine rpp de la Software Delivery Platform,. Saisissez la ligne de commande suivante :

      AsciiToUTF8 AsciiInputFile Utf8OutputFile

      où :
      • AsciiInputFile est le chemin complet du fichier issu de la procédure MIUS. Ce fichier est au format ASCII.
      • Utf8OutputFile est le chemin complet du fichier qui sera utilisé en entrée de -createUsers, la commande standard de création des utilisateurs de Rational Team Concert. Ce fichier est au format UTF-8.
      Remarque : Le fichier AsciiToUTF8.bat a été conçu pour fonctionner à l'emplacement où il est livré. Il est donc souhaitable de le conserver à cet endroit. Si vous le déplacez, vous devez le modifier.
      Pour charger les utilisateurs, vous devez ensuite saisir la commande -createUsers de la façon suivante :
      Figure 2. Lignes de commande de création des utilisateurs
      C:\...\IBM\JazzTeamServer\server\repotools-ccm -createUsers 
      	fromFile=C:\...\MIUSFILE (après conversion au format UTF-8)
       	repositoryURL=https://…:9443/ccm 
      	adminUserId=xxxx 
      	adminPassword=xxxx
      Remarque : Consultez l'aide Rational Team Concert pour des explications sur la commande -createUsers.

      Le journal repotools-ccm_createUsers.log permet de voir les erreurs éventuelles.

      Un utilisateur déjà créé est modifié.
      Avertissement : La tentative de mise à jour de l'utilisateur ADMIN peut entraîner l'erreur de mise à jour CRJAZ1350E. Ce code ne peut être réutilisé.
  2. Migration d'une base de développement
    1. Analyse préalable de base Pacbase
      La procédure MIAM reprend et complète certaines fonctionnalités de l'analyse du référentiel :
      • Recherche des codes d'instances contenant des caractères spéciaux ou correspondant à un mot réservé Windows® (LPT1 par exemple) : Alimentation du fichier CS.
      • Recherche des Programme (P) qui sont à transformer en Macros : Alimentation du fichier PM.
      • Recherche des instances à ne pas reprendre (exemple : Etats pour maquette GDP) : Alimentation du fichier NR.
      • Alimentation du fichier RQ avec le détail des différentes recherches (exemple : liste des entités contenant un caractère spécial).
    2. Extraction de Pacbase
      1. Extraction des modèles Pacbase

        Extrayez les données avec une des procédures d'extraction de Pacbase MIBA ou MIBR.
        MIBA permet une extraction chevelue d'une liste d'instances tandis que MIBR extrait toutes les instances du réseau ou sous-réseau sélectionné dans un contexte (une fois pas session).
        Vous pouvez utiliser par la suite la procédure MIBJ pour extraire des mouvements du journal archivé Pacbase.

        Mettez en entrée le fichier des Programmes à transformer en Macros, issu de la procédure MIAM.

        Ces procédures permettent également de transformer les caractères spéciaux non reconnus dans un code instance par un autre caractère. Pour cela, utilisez le fichier des caractères spéciaux issu de la procédure MIAM et complétez-le.

        Ces procédures fournissent la liste des Macros à générer par la procédure MIMA et les entrées des procédures GPRT, MIA1, MIA2, MIA3 et MIA4.

        Remarque : Ces procédures sont détaillées dans le guide d'installation Pacbase spécifique à votre plateforme.
      2. Extraction des Macros

        Utilisez la procédure MIMA pour générer les Macros dans un format COBOL tagué.

        Cette procédure permet également de transformer les caractères spéciaux non reconnus dans un code Macro par un autre caractère. Pour cela, utilisez le fichier des caractères spéciaux issus de la procédure MIAM et complétez-le. Vous devez utiliser le même fichier des caractères spéciaux que pour l'extraction des données (procédures MIBA, MIBR ou MIBJ).

        Remarque : Cette procédure est détaillée dans le guide d'installation Pacbase spécifique à votre plateforme.
      3. Génération des Programmes, Ecrans et entités C/S

        Utilisez la procédure GPRT en option C9 pour générer des sources COBOL destinés à la migration. Ces sources incluent le code généré à partir du design de l'instance et le code spécifique.

        Les entrées de cette procédure peuvent être récupérées des procédures MIBA ou MIBR.

        Cette procédure :
        • Supprime les numéros de ligne,
        • Supprime les informations des colonnes 73 à 80,
        • Ajoute le niveau de fonction et sous-fonction,
        • Ne prend pas en compte le formatage COBOL,
        • Génère avec les commentaires,
        • Ajoute les annotations pour la prise en compte des micro-patterns.
        Remarque : Cette procédure est détaillée dans le manuel Les Procédures du Développeur spécifique à votre plateforme.
      4. Génération des sources de contrôle pour les Programmes, Ecrans et entités C/S

        Utilisez la procédure MIA1 (pour les Programmes), MIA2 (pour les Ecrans), MIA3 (pour les clients TUI), ou MIA4 (pour les Serveurs) pour générer des sources COBOL destinés à la migration. Ces sources ne contiennent que le code généré à partir du design de l'instance.

        Les entrées de cette procédure peuvent être récupérées des procédures MIBA ou MIBR.

        Remarque : Ces procédures sont détaillées dans le guide d'installation Pacbase spécifique à votre plateforme.
    3. Transfert des fichiers
      Transférez les fichiers vers le poste sur lequel sont installées les parties clientes de Rational Developer for System z, Rational Team Concert et Rational Programming Patterns for System z.
      Vous devez transférer les fichiers issus des procédures :
      • MIBA, MIBR ou MIBJ dans un répertoire dédié $DIRsrc. Ces fichiers ont une extension ta2.
      • MIMA dans le répertoire $DIRsrc. Ces fichiers ont une extension cblmsp.
      • GPRT dans le répertoire $DIRsrc. Ces fichiers ont une extension cbl et leur nom est le nom externe de l'instance générée.
      • MIA1, MIA2, MIA3 et MIA4 dans un répertoire dédié $DIRctrl. Ces fichiers ont une extension .cbl et leur nom est le nom externe de l'instance générée.
      Important : Vous devez faire attention aux pages de code utilisées lors du transfert.
      Pour transférer, par FTP, un fichier d'un environnement System z (EBCDIC français) vers le poste, vous devez saisir les informations suivantes dans un fichier file.scr :
      Tableau 1. Commandes de transfert FTP à saisir
      Commandes à saisir Explications
      open hostname Changez hostname par l'adresse de l'hôte origine.
      tsouid Changez tsouid par l'utilisateur TSO.
      tsopwd Changez tsopwd par le mot de passe TSO.
      quote site sbdataconn=(IBM-1147,ISO8859-1) Paramètres du transfert EBCDIC français vers ASCII.
      get 'NomFichierSurz' c:\NomFichierLocal Encadrez le nom du fichier System z par des guillemets simples (par défaut, il se positionne sur 'tsouid').
      quit  
      Vous lancez le transfert avec la commande : ftp -s:file.scr.
    4. Alimentation de l'espace de travail local
      1. Conversion des fichiers de design

        Utilisez la commande rpp --import, ou l'assistant d'importation accessible par un clic droit à partir d'un référentiel de la vue Explorateur de designs.
        Cette étape initialise un espace de travail local contenant une hiérarchie de projets. Chaque projet contient les instances d'une Bibliothèque Pacbase.

        La commande rpp --importJournal vous permet d'importer des mises à jour extraites du journal Pacbase avec la procédure MIBJ. Cette commande ne peut être exécutée que si vous avez au préalable fait un import classique (suite à une extraction MIBA/MIBR) au cours duquel est créé un fichier technique obliagtoire pour effectuer un import du journal.

        Ces deux types d'import créent un fichier script pour les commandes SCM. Ce fichier scmtools_entries.bat se trouve par défaut dans le répertoire .metadata de l'espace de travail.

        Pour valider l'import, vous pouvez analyser les erreurs contenues dans le fichier .pacmigration.log du répertoire .metadata de l'espace de travail.

      2. Répartition des fichiers sources des Macros

        Cette étape extrait tous les sources des Macros (codemacro.cblmsp au format XML) du fichier issu de la procédure MIMA. Elle place ensuite ce fichier dans le même répertoire que le modèle de la Macro (codemacro.pacmacro).

        Vous pouvez utiliser la commande rpp --dispatchMacro, ou l'assistant de répartition de Macros accessible par un clic droit à partir d'un référentiel de la vue Explorateur de designs.

        A l'issue de cette étape, les Macros sont réparties dans les différents projets de votre espace de travail local.

      3. Aide à la migration

        Exécutez la fonction d'aide à la migration en utilisant la commande rpp --migrationHelp, ou l'assistant d'aide à la migration accessible par un clic droit à partir d'un Programme, Ecran ou Serveur dans la vue Explorateur de designs.

        Cette étape prend en compte les différents sources générés (GPRT, MIAn, ...) et alimente l'espace de travail.

        Si vous utilisez les générations de Rational Team Concert, cette étape doit être précédée par une étape de création de zComponent project et de zFolder. Dans ce cas, vous devrez indiquer où seront stockés les sources résultat de l'aide à la migration.

      4. Utilitaires pour faciliter l'alimentation de l'espace de travail
        1. Lancer le processus batch comme un démon
          Pour ce faire vous devez lancer le démon avec la commande rpp -–daemon et utiliser le script lrpp.bat pour communiquer directement avec le démon.
          Remarque : Le démon n'accepte qu'une seule commande à la fois.
          Figure 3. Syntaxe de lrpp.bat
          Syntaxe: lrpp.bat [options] [subcmd]
             --generate  - Commande de génération COBOL.
             --import 	- Commande d'importation.
             --importJournal  - Commande d'importation du journal.
             --dispatchMacro  - Commande de répartition des macros.
             --migrationHelp  - Commande d'aide à la migration.
             --automaticMigration  - Commande d'automatisation de la migration.
             --compare  - Commande de comparaison de fichiers COBOL.
             --generateErrorMsgs  - Commande de génération des libellés d'erreurs.
             --generateDataBlockBase  - Commande de génération des blocs de base de données.
             --generateCopyBook  - Commande de génération des copybooks.
             --copy 	 - Commande de copie de fichiers.
             --zCompCreation  - Commande de création de composants z/OS.
             --refresh 	- Commande de rafraîchissement de l'espace de travail.
             --commands  - Commande pour l'exécution d'une liste de commande.
             --help  - Affiche ce message.
                 Pour obtenir l'aide pour une commande particulière entrer son nom.
             --port  - Numéro de port (Doit être la dernière option). (obligatoire)
        2. Lancer plusieurs commandes batch à la fois

          Vous pouvez utiliser la commande rpp.bat --commands qui permet de lancer plusieurs commandes batch listées dans un fichier de commandes.

          Figure 4. Syntaxe de rpp.bat
          Syntaxe: rpp.bat --commands [options]
                  --data - Espace de travail. (obligatoire)
                  --log - Nom du fichier de consignes. (défaut trace.log)
                  --file - Fichier contenant la liste des commandes batch. (obligatoire)
                  --exitOnError - Sortie en cas d'erreur d'une commande.

Conditions d'utilisation | Commentaires en retour

Ce centre de documentation utilise la technologie Eclipse. (http://www.eclipse.org)