L'ajout d'un artefact à Rational Team Concert for System z implique de prendre un artefact que vous avez 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 for System z.
Pour cet exemple, vous allez créer un programme COBOL à l'aide de Rational Developer for System z et l'ajouter à votre référentiel Rational Team Concert for System z dédié au contrôle des sources. Vous pouvez utiliser l'assistant Partager les membres en tant qu'éléments zFile pour ajouter des membres du sous-projet MVS de Rational Developer for System z à Rational Team Concert for System z.
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 que vous avez créé dans
la section de chargement de l'exemple, cliquez dessus à l'aide du bouton droit de la
souris, puis 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îtra 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 ou que le programme BGREEN.BLD.COBOL(HELLO.cbl) car il ne se trouve pas encore sous le contrôle des sources Rational Team Concert for System z.
Effectuez les étapes suivantes pour ajouter le programme au contrôle des sources de Rational Team Concert for System z :
- 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 et sélectionnez zComponent > Partager les membres en tant qu'éléments zFiles.
- Par défaut, le nom du programme ajouté sera 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 la rubrique Utilisation de Rational Build Agent et des extensions de génération Antz 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 sera associée à l'espace de travail de référentiel de Rational Team Concert for System z.
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 afficheront les détails de la
définition de génération associée, mais vous ne pourrez 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 la définition de fichier et le préfixe.
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.