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