Shell-Script für Rational Build Agent konfigurieren

Das Jazz-Build-System enthält ein Beispiel-Script mit dem Namen startbfa.sh, mit dem Rational Build Agent gestartet werden kann.

Das Beispiel-Script ist im Verzeichnis @pathPrefix@/usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/startbfa enthalten. Die Variable @pathPrefix@ ist ein Präfix, das Sie bei Installation von SMP/E festlegen. Dieses Script wird zum Starten von Rational Build Agent benötigt und muss die Berechtigungsnachweise angegeben, die der Agent benötigt, um eine Verbindung zu Jazz Team Server herzustellen und den erforderlichen Zugriff auf die Bibliotheken bereitzustellen, die für Ant mit Enterprise Extensions und für die native Kompilierung benötigt werden. Dieses Script wird vom Job BLZCPBTK in das Konfigurationsverzeichnis von Rational Team Concert kopiert, in der Regel in das Verzeichnis /etc/jazz40/ccm.
Wichtig: Das Script muss entsprechend Ihrer Umgebung konfiguriert werden. Viele erforderliche Variablen sind durch den Kopier- und Konfigurationsjob von BLZCPBTK bereits konfiguriert. Einige Variablen werden jedoch nicht automatisch gesetzt, z. B. die Benutzer-ID und das Kennwort. Prüfen und ersetzen Sie die erforderlichen Variablenzeichenfolgen wie in der folgenden Tabelle angegeben:
Tabelle 1. Variablenzeichenfolgen im Beispiel-Script
Variable Beschreibung
@pathPrefix@ Verzeichnispfad zum Präfix des Jazz-Verzeichnisses
Anmerkung: Dies ist das Präfix für das Jazz-Verzeichnis. Daher sollte hier das während der SMP/E-Installation angegebene Präfix und anschließend die Angabe /usr/lpp stehen.
@javaPathPrefix@ Verzeichnispfad zum IBM 31-Bit-SDK für z/OS Java 2 Technology Edition
@yourUserid@ Jazz-Benutzer-ID
@yourPasswordFile@ Die im Job BLZBPASS definierte Jazz-Kennwortdatei. Im Artikel Jazz-Build-Steuerkomponente für z/OS ausführen finden Sie Informationen zur Ausführung des Jobs BLZBPASS.
@stepLib@ Die STEPLIB DD (Dateigruppendefinition), die in Ihrem z/OS-Build verwendet werden soll, z. B. SYS1.LINKLIB:CEE.SCEERUN.
@bfaBinPath@ Verzeichnispfad zum Verzeichnis mit der ausführbaren Datei von Rational Build Agent
@bfaConfPath@ Pfad zum Verzeichnis der Konfigurationsdatei von Rational Build Agent
@zLang@ Die in Hostdateien verwendete Codierung, z. B. IBM-037.
@timeout@ Zeitlimitwert für die Ausführung von Build-Schritten in Sekunden. Ist dieser nicht angegeben, wird standardmäßig der Wert 300 Sekunden verwendet.
@workPath@ Verzeichnis, in dem die Metadaten für PDSEs gespeichert sind. Standardmäßig ist dies das Verzeichnis /u/jazz40/ccm/.
@yourHomeDirectory@ Ausgangsverzeichnis. Verwenden Sie diese Angabe nur dann, wenn die Umgebungsvariable HOME nicht an anderer Stelle definiert wurde.
_CMDSERV_BASE_HOME Gibt die Position der von ISPF bereitgestellten Dateien an, damit der Rational Build Agent das ISPF-Gateway starten kann. Weitere Informationen zu _CMDSERV_BASE_HOME enthält der Artikel ISPF-Gateway für Build-, Implementierungs- und Hochstufungsunterstützung konfigurieren.
Führen Sie auf einem der folgenden Wege das Build-Agent-Shell-Script 'startbfa.sh' aus, wenn Sie bereit sind, Rational Build Agent zu starten und Build-Anforderungen entgegenzunehmen:
  • Starten Sie das Script startbfa.sh manuell in OMVS.
  • Konfigurieren Sie die in der Bibliothek BLZ.SBLZSAMP bereitgestellte gestartete Beispiel-Task BLZBFA gemäß den Anweisungen im Job. Nun können Sie den Build Forge Agent beim Systemstart als gestartete Task ausführen. Für die Ausführung als gestartete Task müssen Sie diesen Job in eine vom System angelegte PROCLIB kopieren und erforderliche Sicherheitseinstellungen konfigurieren.
Anmerkung: Sofern in Ihrer Datei bfagent.conf keine andere Shell angegeben ist, wird in der vom Rational Build Agent unter z/OS gestarteten Sitzung die Standard-Shell (/bin/sh) verwendet. Die Standard-Shell unter z/OS führt immer das Script /etc/profile aus, um systemweite Konfigurationseinstellungen festzulegen, nachdem startbfa.sh ausgeführt wurde und die Möglichkeit besteht, einige im Shell-Script startbfa.sh festgelegte Umgebungsvariablen zu überschreiben.

Wenn Sie einen Build unter Verwendung von Ant mit Enterprise Extensions oder einen Abhängigkeits-Build mit dem Ant-Argument –verbose oder –debug erstellen, wird der UNIX-Exportbefehl ausgeführt, bevor Ant aufgerufen wird. Sie können sich die Ausgaben des Exportbefehls im Build-Protokoll anschauen, um sicherzugehen, dass die Umgebungsvariablen richtig gesetzt sind.

Wenn einige Umgebungsvariablen von /etc/profile überschrieben werden, bitten Sie Ihren Systemprogrammierer, /etc/profile zu ändern. Sollte das nicht möglich sein, können Sie die Bash-Shell verwenden, die mit den z/OS Ported Tools bereitgestellt wird. Geben Sie die Option –noprofile an. Fügen Sie dazu die beiden folgenden Zeilen zu Ihrer Datei bfagent.conf hinzu:
shell /bin/bash   
shellflag --noprofile 

Feedback