Définition et exécution d'une génération à l'aide de Rational Build Agent

Avant de commencer
Vous devez avoir créé une zone de projet dans Rational Team Concert for System z.
A propos de cette tâche
Cette tâche est pertinente si vous ajoutez une définition de génération à votre zone de projet et souhaitez utiliser Rational Build Agent. Vérifiez que vous avez créé une zone de projet et souhaitez ajouter une définition de génération qui utilise Rational Build Agent.
  1. Si vous n'avez pas encore démarré Rational Build Agent, démarrez-le maintenant à l'aide de la commande bfagent -s, comme indiqué dans la section relative à la configuration de Rational Build Agent.
    Important : Les commandes que vous exécutez via Rational Build Agent s'exécutent avec les droits de l'utilisateur qui démarre l'agent.
  2. Localisez le membre BLZCSAMP dans hlq.SBLZSAMP, où hlq correspond au qualificatif de haut niveau utilisé lors de l'installation SMP/E de Rational Team Concert for System z. Notez que ce membre est installé au cours de l'installation de FMID HAHB200. Le membre BLZCSAMP fournit un exemple d'exécutable REXX permettant d'effectuer une compilation COBOL. Consultez les commentaires de cet exemple de membre pour comprendre les paramètres et les éventuelles personnalisations nécessaires à votre environnement.

Configuration et exécution d'une définition de génération

  1. Dans la vue Artefacts de l'équipe, développez le dossier de la zone de projet dans laquelle vous souhaitez créer une définition de génération.
  2. Cliquez sur avec le bouton droit de la souris sur Générations > Nouvelle définition de génération.
  3. Dans la fenêtre Nouvelle définition de génération, désélectionnez Ligne de commande antérieure à la génération et Ligne de commande postérieure à la génération, sélectionnez Créer une génération, puis cliquez sur Suivant.
  4. Dans la fenêtre Informations générales, entrez un ID de définition de génération et une brève description de la définition de génération.
    Important : Sélectionnez Rational Build Agent dans le menu Modèles disponibles.
    Cliquez sur Suivant.
  5. Dans la fenêtre Configuration supplémentaire, sélectionnez Général, Propriétés et Rational Build Agent, puis cliquez sur Terminer. La définition de génération que vous venez de créer s'ouvre dans l'éditeur correspondant.

Test d'une connexion avec Rational Build Agent

  1. Cliquez sur l'onglet Build Agent créé au cours des étapes précédentes.
  2. Entrez les informations suivantes pour vous connecter à Rational Build Agent :
    Nom d'hôte
    Nom du système qui utilise Rational Build Agent.
    Port
    Port qui communique avec Rational Build Agent. Le port par défaut est 5555.
    Nom d'utilisateur
    Nom de l'utilisateur qui se connecte à Rational Build Agent.
    Remarque : Ce nom est utilisé pour authentifier la connexion au système. Il peut être différent du nom d'utilisateur ayant démarré l'agent.
    Mot de passe
    Mot de passe de l'utilisateur donné.
    Confirmation de mot de passe
    Entrez à nouveau le mot de passe de l'utilisateur donné.
  3. Cliquez sur Tester la connexion. Les résultats du test de connexion s'affichent dans la boîte Résultats du test de connexion de Rational Build Agent.

Définition d'un bloc de commande à exécuter par Rational Build Agent

  1. Cliquez sur l'onglet Ligne de commande de génération.
  2. Dans la zone Commande, entrez une commande de processus à envoyer à Rational Build Agent.
  3. Dans la zone Répertoire de travail, entrez le répertoire de travail à utiliser par le processus invoqué.
  4. Cliquez sur Sauvegarder pour sauvegarder la définition de génération.
    Conseil : La première fois que vous sauvegardez une définition de génération, un nouveau moteur de génération appelé RationalBuildAgent est défini pour la zone de projet. Vérifiez que RationalBuildAgent est le moteur de génération sélectionné dans l'onglet Général de la définition de génération.
task_example
Pour exécuter l'exemple donné, vous pouvez définir un bloc de commande dans la zone Commande semblable à ceci :
tso "EXEC 'BGREEN.BETA.SBLZSAMP(BLZCSAMP)''/tmp/RTCZSYSPRINT COBOL.V4R1M0.SIGYSAMP"
cat /tmp/RTCZSYSPRINT
rm /tmp/RTCZSYSPRINT

Demande de génération

  1. Dans la vue Artefacts de l'équipe, cliquez avec le bouton droit de la souris sur la définition de génération, puis sélectionnez Demander une génération. Vous pouvez également cliquer sur l'icône Demander une génération dans le coin supérieur droit de la fenêtre Définition de génération. La fenêtre Demander une génération s'ouvre.
  2. Cliquez sur Soumettre. La fenêtre Générations s'ouvre.
    Conseil : Pour contrôler l'avancement de la génération, cliquez sur Actualiser.

Vérification des résultats de la génération

  1. Une fois la génération terminée, cliquez deux fois sur votre génération dans l'onglet Générations pour afficher les résultats de génération.
  2. Dans la section Récapitulatif des contributions, cliquez sur le journal pour afficher l'onglet Journaux.
  3. Sélectionnez le journal et cliquez sur Ouvrir pour afficher les résultats détaillés de la génération, les informations sur Rational Build Agent et les résultats du bloc de commande que vous avez entré.

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