Vous devez extraire et migrer les utilisateurs et les bases de développement Pacbase.
Extrayez et transférez, depuis la base d'administration, tous les utilisateurs avec la procédure Pacbase MIUS.
Les administrateurs Pacbase auront le droit JazzAdmins, tous les autres auront le droit JazzUsers.
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
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
Le journal repotools-ccm_createUsers.log permet de voir les erreurs éventuelles.
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.
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).
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.
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.
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 |
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.
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.
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.
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)
Vous pouvez utiliser la commande rpp.bat --commands qui permet de lancer plusieurs commandes batch listées dans un fichier de commandes.
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.