Configuration du script de shell de Rational Build Agent

Jazz Build System contient un exemple de script intitulé startbfa.sh et que vous pouvez utiliser pour démarrer Rational Build Agent.

Vous trouverez l'exemple de script dans le répertoire @pathPrefix@/usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/startbfa, où @pathPrefix@ correspond au préfixe indiqué lorsque vous installez SMP/E. Ce script est requis pour démarrer Rational Build Agent afin d'indiquer les données d'identification pour permettre à l'agent de se connecter à Jazz Team Server et vous donner accès aux bibliothèques dont vous avez besoin pour Ant avec extensions Enterprise et la compilation native. Ce script est copié dans le répertoire de configuration Rational Team Concert, généralement /etc/jazz40/ccm par le travail BLZCPBTK.
Important : Ce script doit être configuré pour l'adapter à votre environnement. Un grand nombre des variables requises auront été configurées par le travail de configuration et de copie BLZCPBTK. Toutefois, certaines variables telles que l'ID utilisateur et le mot de passe ne seront pas définies automatiquement. Examinez et remplacez les chaînes de variable requises de l'exemple de script en procédant comme indiqué dans le tableau suivant :
Tableau 1. Exemples de chaînes de variables dans le script
Variable Description
@pathPrefix@ Chemin du répertoire en préfixe du répertoire Jazz
Remarque : Il s'agit du préfixe du répertoire Jazz ; votre préfixe doit donc inclure tout préfixe que vous avez spécifié dans le cadre de l'installation de SMP/E, puis /usr/lpp.
@javaPathPrefix@ Chemin d'accès au répertoire IBM® 31-bit SDK for z/OS Java™ 2 Technology.
@yourUserid@ ID utilisateur Jazz.
@yourPasswordFile@ Fichier de mots de passe Jazz tel qu'il est défini par le travail BLZBPASS. Voir la rubrique relative à l'exécution de Jazz Build Engine sous z/OS pour savoir comment exécuter le travail BLZBPASS.
@stepLib@ Définition de fichier STEPLIB à utiliser dans votre génération z/OS. Par exemple, SYS1.LINKLIB:CEE.SCEERUN
@bfaBinPath@ Chemin d'accès au répertoire de l'exécutable de Rational Build Agent.
@bfaConfPath@ Chemin d'accès au répertoire du fichier de configuration de Rational Build Agent.
@zLang@ Codage utilisé dans les fichiers hôte. Par exemple, IBM-037.
@timeout@ Délai d'expiration, exprimé en secondes, de l'exécution de l'étape de génération. La valeur par défaut est de 300 secondes.
@workPath@ Chemin d'accès au répertoire dans lequel les métadonnées sont stockées pour les éléments PDSE. Par défaut il s'agit de /u/jazz40/ccm/.
@yourHomeDirectory@ Votre répertoire de base. Vous ne devez utiliser cette variable que si vous n'avez pas défini ailleurs la variable d'environnement HOME.
_CMDSERV_BASE_HOME Indique l'emplacement des fichiers fournis par ISPF pour que Rational Build Agent puisse démarrer la passerelle ISPF. Pour plus d'informations sur _CMDSERV_BASE_HOME, voir Configuration de la passerelle ISPF pour prise en charge de génération, de déploiement et de promotion.
Lorsque vous êtes prêt à démarrer Rational Build Agent et à accepter des demandes de génération, vous pouvez exécutez le script startbfa.sh en procédant de l'une des façons suivantes :
  • Démarrez manuellement le script startbfa.sh à partir de OMVS
  • Configurez l'exemple de travail démarré BLZBFA fourni dans la bibliothèque BLZ.SBLZSAMP en suivant les instructions accompagnant le travail. Vous pourrez ensuite exécuter l'agent Forge en tant que tâche démarrée au démarrage du système. Vous devez copier ce travail dans une bibliothèque PROCLIB affectée par le système et configurer les paramètres de sécurité requis pour que ce travail puisse s'exécuter en tant que tâche démarrée.
Remarque : A moins qu'un autre shell ne soit spécifié dans votre fichier bfagent.conf, le shell par défaut (/bin/sh) est utilisé dans la session démarrée par Rational Build Agent sous z/OS.  Le shell par défaut sous z/OS utilise toujours le script /etc/profile pour définir des configurations au niveau du système après l'exécution de startbfa.sh et il se peut que certaines variables d'environnement définies le script de shell startbfa.sh soient écrasées.

Lorsque vous exécutez une génération Ant avec Enterprise Extensions ou une génération de dépendances avec l'option –verbose ou –debug dans les arguments Ant, la commande d'exportation UNIX s'exécute avant l'appel Ant. Vous pouvez vérifier dans la sortie de la commande d'exportation dans le journal de la génération que les variables d'environnement ont été correctement définies.

Si certaines variables d'environnement ont été remplacées par /etc/profile, demandez à votre programmeur système de changer /etc/profile. Si la modification n'est pas possible, vous pouvez utiliser le shell bash qui est disponible avec .z/OS Ported Tools. Indiquez l'option –noprofile en ajoutant les deux lignes suivantes à votre fichier bfagent.conf :
shell /bin/bash   
shellflag --noprofile 

Commentaires