Vous pouvez extraire et migrer les utilisateurs et les bases de développement Pacbase. Jazz peut s'interconnecter avec un LDAP ou un système de sécurité tel que RACF. Dans ce cas, il n'y aura pas de migration des utilisateurs 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é sous 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.
Vous devez analyser les résultats de cette procédure et effectuer toutes les actions indiquées dans le guide d'installation Pacbase avant de procéder à l’extraction. Vous devez, par exemple, gérer les caractères spéciaux et les instances ayant le même nom externe. Si la base contient des Blocs Bases de Données de type DB, vous devez exécuter la procédure TRDQ pour transformer leur type en Q2 avant la migration.
Mettez en entrée deux fichiers issus de la procédure MIAM : le fichier PM des Programmes à transformer en Macros et le fichier NR des instances à ne pas reprendre.
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 MIA1, MIA2, MIA3 et MIA4. Pensez à indiquer le code des cartes de contrôle optionnelles pour insérer des séparateurs dans les procédures MIAn.
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. |
quote site notrailingblanks | Paramètre de suppression des caractères à blanc en fin d'enregistrement |
get 'NomFichierSurz' c:\NomFichierLocal | Encadrez le nom du fichier System z par des guillemets simples (par défaut, il se positionne sur tsouid). |
quit |
Exécutez d’abord la commande de migration automatique rpp --automaticMigration. Cette commande crée le fichier de commandes qui permet d’enchaîner l’import, la répartition des Macros, la modification de la cible de génération (si elle est demandée) et l’aide à la migration. Elle crée les répertoires des sources de migration en éclatant les différents programmes. Vous devez respecter la structure du répertoire contenant les fichiers transférés. Voir le paragraphe Transfert des fichiers.
Veillez à bien utiliser les paramètres pour la création des projets contenant les sources COBOL. Ces projets peuvent être de type zComponent ou standard.
Des informations détaillées sont disponibles sur la Migration progressive et la Migration multi-sessions.
La migration automatique produit un fichier location.txt (où location représente le nom du référentiel).
Exemple d’une commande de migration automatique qui crée un projet de type zComponent et sépare les fichiers de source COBOL et les fichiers de métadonnées Rational Programming Patterns. Les fichiers de métadonnées seront stockés dans le répertoire design :
rpp.bat --automaticMigration --data "C:\Migration\Workspace" --log "C:\Migration\automatic.log" --from "C:\Migration\Input" --location XXXX --separateCobolProject --cobolProjectType Z --separateMetadataFiles --pdpRootPath design
L'espace de travail créé par la commande de migration automatique peut être utilisé tel quel à des fins de consultation. Pour pouvoir faire des mises à jour ou de l'analyse d'impact, par exemple, vous devez l'indexer. Pour cela, faites un clic droit dans la vue Explorateur de designs et sélectionnez Reconstruire l'espace de travail local puis Reconstruire les liens entre les modèles et les fichiers générés.
A l'issue de la migration automatique, vous devez lancer Rational Programming Patterns en mode graphique (Démarrer > Tous les programmes > IBM Software Delivery Platform > IBM Rational Programming Patterns par défaut). Indiquez le nom de l'espace de travail qui sera utilisé pour la migration.
Exécution du 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.
Cette étape initialise un espace de travail local contenant une hiérarchie de projets. Chaque projet contient les instances d'une Bibliothèque Pacbase.
Cette étape prend en entrée le fichier issu de la procédure MIMA et répartit les sources des Macros dans les Macros correspondantes des différents projets de votre espace de travail.
Si des erreurs sont apparues au cours de la répartition, vous pouvez consulter le rapport d'erreurs .pacdispatchmacro.log dans le dossier .metadata de l'espace de travail. Ce fichier affiche également le nombre de Macros dont le code source a été modifié/créé.
Cette étape, facultative, modifie la cible de génération par défaut de l'instance avant sa migration.
Cette étape prend en compte les sources générés par MIAn et migre les fichiers COBOL des Programmes, Ecrans et Serveurs dans l'espace de travail.