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 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.
Si vous migrez plusieurs sessions Pacbase dans le même espace de travail, vous devez indiquer le paramètre --previousSessionFolder dans la commande de migration automatique pour chaque nouvelle session, dès la migration de la deuxième session. 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.
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
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.
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.