Ajout d'un artefact à Rational Team Concert

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.)

  1. 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.
    Menu de RSE (Remote System Explorer) affichant "Créer un membre PDS"
  2. 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.
    Panneau Créer un membre PDS affichant le nom du nouveau programme COBOL "Goodbye" dans la zone Nom de membre.
    Votre nouveau programme COBOL apparaît dans le même fichier que votre programme HELLO.cbl.
    Remote System Explorer affichant le nouveau "GOODBYE.cbl" dans le même fichier que "HELLO.cbl"
  3. 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.
    Vue Projets z/OS affichant le nouveau "GOODBYE.cbl" dans le même sous-projet MVS que "HELLO.cbl." Le nouveau programme n'affiche pas le même décorateur que le programme existant car il ne se trouve pas encore sous le contrôle des sources Rational Team Concert.
    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 :
  1. 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.
    Vue Projet z/OS affichant le menu contextuel permettant de sélectionner "Partager les membres en tant qu'éléments zFiles"
  2. 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.
  3. 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.
    Panneau "Choix d'un projet zComponent" affichant le projet zComponent existant et l'option permettant de créer un projet zComponent
  4. 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.
    Panneau "Partage d'un projet zComponent dans un référentiel Jazz" illustrant le composant et le référentiel Jazz dans un espace de travail de référentiel existant
  5. 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.
    Panneau "Sélectionner la définition de génération" affichant la définition de génération nommée "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.
  6. 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.
  7. 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.
    Panneau "Sélectionner le type de propriété" affichant la liste des options de type de nouvelle propriété
  8. 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.)
    Panneau "Modifier une propriété de demande de génération" affichant la valeur modifiée en 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.
  9. 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).

Panneau "Association de définitions d'ensemble de données" affichant la définition de fichier de référentiel incorrecte "BMS"

Effectuez les étapes suivantes pour modifier l'association :
  1. Dans le panneau Association de définitions d'ensemble de données, cliquez sur le bouton <...> sous le titre Parcourir.
  2. Sélectionnez la définition de fichier COBOL et cliquez sur OK.
    Panneau "Sélectionner une définition d'ensemble de données" affichant "COBOL" sélectionné comme option de définition de fichier
  3. 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.
  4. 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.
    Panneau "Association de définitions d'ensemble de données" affichant la définition de fichier de référentiel correcte "COBOL"
  5. 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.
  6. 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.
Vue "Explorateur de projets" affichant "GOODBYE.cbl" dans le 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.

Commentaires