L'ajout d'un artefact à Rational Team Concert implique de prendre un artefact
créé à l'aide de Rational Developer for System z et de
le rendre accessible à la gestion de contrôle de source de Rational Team Concert.
Pour cet exemple, vous créez un programme COBOL à l'aide de Rational Developer for
System z et l'ajoutez à votre référentiel
Rational Team Concert dédié au contrôle des sources. Vous pouvez ajouter
des membres de sous-projet MVS de
Rational Developer
for System z à Rational Team Concert à l'aide
de l'assistant Partager les membres en tant qu'éléments zFiles.
Exécutez les étapes suivantes. (Elles utilisent des exemples du tutoriel à titre d'illustrations.)
- Dans la vue Systèmes distants, sélectionnez le programme COBOL créé lors de l'étape
de chargement de l'exemple, cliquez à l'aide du bouton droit de la souris et sélectionnez
Créer un membre PDS.
- Entrez un nom pour votre nouveau programme COBOL dans la zone Nom de
membre du panneau Nouveau membre PDS, puis cliquez sur
Terminer. Pour cet exemple, nous avons nommé le nouveau programme
Goodbye. Votre
nouveau programme COBOL apparaît dans le même fichier que votre programme HELLO.cbl.
- Ajoutez le nouveau programme à votre sous-projet MVS en le faisant glisser de la vue Systèmes distants dans le sous-projet de la vue Projets z/OS.
Remarque : Le nouveau
programme BGREEN.BLD.COBOL(GOODBYE.cbl) ne possède pas le décorateur
de fichier final de BGREEN.BLD.COBOL(HELLO.cbl) car il ne se trouve pas
encore sous le contrôle des sources Rational
Team Concert.
Procédez comme suit pour ajouter le programme au contrôle des sources Rational Team Concert :
- Dans le sous-projet MVS de la vue Projets z/OS, cliquez sur
BGREEN.BLD.COBOL(GOODBYE.cbl) à l'aide du bouton droit de la
souris puis sélectionnez zComponent > Partager les membres en tant qu'éléments zFiles.
- Par défaut, le nom du programme ajouté est présélectionné dans le premier panneau de l'assistant
Partager les membres en tant qu'éléments zFiles.
Cliquez sur Suivant.
- Sélectionnez le projet zComponent avec lequel vous souhaitez partager le nouveau
programme et cliquez sur Suivant. Vous pouvez également créer un projet
zComponent, toutefois pour cet exemple, nous utilisons le projet créé dans Utilisation de Rational Build Agent et d'Ant avec extensions Enterprise pour compiler une application COBOL.
- Dans le panneau Partage d'un projet zComponent dans un référentiel Jazz,
sélectionnez le composant qui contient le programme HELLO.cbl.
Cliquez sur Suivant.
- Dans le panneau Spécification du contexte de génération, cliquez sur
Parcourir et sélectionnez une définition de génération. Pour cet
exemple, sélectionnez Mortgage Team Build. Cliquez sur OK
> Suivant. La définition de génération est associée à l'espace de travail
de référentiel de Rational Team Concert.
Remarque : Une fois que vous avez
exécuté l'assistant Charger zFiles dans z/OS ou
Partager les membres en tant qu'éléments zFiles et que vous
avez choisi une définition de génération pour un espace de travail de référentiel,
cette définition de génération sera associée à cet espace de travail
de référentiel.
Les exécutions ultérieures des assistants affichent les détails de la définition
de génération associée mais vous ne pouvez pas les modifier. Pour effacer le contexte de génération, déconnectez tous les membres.
- Une définition de génération spécifie généralement le préfixe utilisé
par la génération d'équipe. Pour être certain de pouvoir travailler sur vos artefacts de manière
isolée, remplacez le préfixe spécifié dans la définition de génération par votre propre
préfixe. Pour modifier le préfixe, sélectionnez teamz.scm.dataset.prefix
dans la liste Propriétés de la génération et cliquez sur
Editer.
- Dans le panneau Sélectionner le type de propriété,
sélectionnez Chaîne dans la liste des nouveaux types de propriété
et cliquez sur OK.
- Dans le panneau Modifier une propriété de demande de
génération, remplacez la valeur MASAO.BLD par votre
préfixe et cliquez sur OK. (Pour cet exemple, nous avons remplacé
la valeur par BGREEN.BLD.)
Important : Vérifiez
que les droits d'accès que vous avez utilisés pour établir la connexion RSE
avec l'hôte permettent de créer et de modifier un fichier avec le préfixe que vous avez
défini dans la zone de valeur.
- Cliquez sur Suivant.
Lorsque le nouveau programme est ajouté au projet zComponent, il est placé
dans un élément zFolder. Cet élément zFolder doit être associé à une définition de fichier.
Vous pouvez modifier des associations de définitions de fichier. Le panneau utilisé pour cet
exemple affiche le nom de fichier correct (BGREEN.BLD.COBOL),
mais une définition de fichier de référentiel incorrecte (BMS).

Effectuez les étapes suivantes pour modifier l'association :
- Dans le panneau Association de définitions d'ensemble de données,
cliquez sur le bouton <...> sous le titre
Parcourir.
- Sélectionnez la définition de fichier COBOL et cliquez
sur OK.
- Vous pouvez aussi associer des définitions de langage lorsque vous associez des définitions de fichiers. Si vous n'associez pas de définitions de langage à ce stade, vous devez alors associer des définitions de langage pour tous les fichiers que vous souhaitez générer avant de demander une génération.
- Dans le panneau Association de définitions d'ensemble de données mis à jour,
vérifiez que la définition de fichier de référentiel est correcte. Pour cet
exemple, il s'agit de COBOL.
- La dernière page de l'assistant Partager les membres en tant qu'éléments zFiles vous permet de copier ou de déplacer des membres. Si vous
choisissez copier, le membre reste dans son fichier
d'origine et une copie est placée dans le nouvel emplacement spécifié par le préfixe
et la définition de fichier.
Si vous choisissez déplacer, le membre est déplacé
et supprimé du fichier d'origine.
- Cliquez sur Terminer.
Vérification de la réussite du partage
Dans la vue
Explorateur de projets, confirmez que le programme
GOODBYE.cbl a été ajouté au projet zComponent.
Conseil : Si l'assistant Partager
les membres en tant qu'éléments zFiles se termine par une erreur, ouvrez le fichier .log du dossier metadata de votre espace de
travail Eclipse pour obtenir des informations supplémentaires.