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 peuvent 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.
Vous pouvez utiliser les procédures MIBR et MIBJ pour reprendre les verrous Pacbase sur les instances migrées. Si l'option de migration des verrous est indiquée, des fichiers de script sont automatiquement créés dans le répertoire .metadata de l'espace de travail de migration. Ces fichiers se nomment scmUnLock.bat pour déverrouiller les instances après l'import du journal et scmLock.bat pour verrouiller ou réverrouiller les instances sur le serveur.
Si vous avez exécuté les procédures MIBJ ou MIBU, transférez les mouvements dans un fichier d'extension .ta2 mais de nom différent de MIBR.
Transférez aussi les listes d'entités générées dans les fichiers MIA1.txt, MIA2.txt, MIA3.txt et MIA4.txt.
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 |
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.
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
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.
Si un fichier errorLabels.txt est présent dans le répertoire d'entrée de la migration, des instances de Libellés d'erreur sont créées.
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.
Si plusieurs instances de la même entité ont le même nom externe dans une Bibliothèque Pacbase, les doublons sont gérés lors de la migration. Pour des détails sur cette gestion, reportez-vous à Gestion des fichiers générés en double.
L'espace de travail issu de la commande rpp --commands 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.