Ajout d'un artefact à Rational Team Concert for System z

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

  1. 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.
    Menu contextuel 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îtra 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 for System z
    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 :
  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 et 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é sera 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 la rubrique Utilisation de Rational Build Agent et des extensions de génération Antz 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 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.
  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 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.
  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 en retour

Avez-vous obtenu l'aide souhaitée ? Vous pouvez envoyer des commentaires en retour à Jazz.net (inscription nécessaire) : Commentaire dans les forums ou signaler un bogue