ISPF-Gateway für Build-, Implementierungs- und Hochstufungsunterstützung konfigurieren

Sie können das ISPF-Gateway für die Unterstützung von Komponenten für Build, Implementierung und Hochstufung konfigurieren, die mit einer Clientzugriffslizenz für Entwickler für IBM Unternehmensplattformen zur Verfügung stehen.

ISPF stellt eine als ISPF-Gateway bezeichnete Schnittstelle bereit, über die Clientanwendungen eine Verbindung zu einem z/OS-Host herstellen können, um TSO- und ISPF-Befehle auszuführen. Das ISPF-Gateway wird als Teil von ISPF in Form von Lademodulen und Dateien im HFS installiert. In der Regel werden diese Dateien in /usr/lpp/ispf/bin installiert. Die Komponenten für Build, Implementierung und Hochstufung werden im Zuge der SMP/E-Installation erstellt. In Ihrer Konfiguration können weitere Modifikationen der vom ISPF-Gateway bereitgestellten Scripts und Komponenten erforderlich sein. Weiter unten sind die Standardeinstellungen und die Vorgehensweise beim Modifizieren der Standardeinstellungen beschrieben.

Folgende Komponenten werden aufgenommen:

Umgebungsdatei ISPZXENV des ISPF-Gateways
Umgebungsdatei des ISPF-Gateways mit anpassbaren Einstellungen für das ISPF-Gateway.
Die Datei ISPZXENV steht als Teil von z/OS zur Verfügung. Standardmäßig wird diese Datei in /usr/lpp/ispf/bin installiert. Dieses Verzeichnis ist nach der Installation allerdings generell als schreibgeschützt markiert. Das ISPF-Gateway führt diese Umgebungsdatei aus, um den Wert bestimmter Umgebungsvariablen abzurufen, die für die Ausführung des ISPF-Gateways erforderlich sind. Standardmäßig handelt es sich um folgende Variablen:
STEPLIB
Standardmäßig auf STEPLIB = 'ISP.SISPLPA:ISP.SISPLOAD' gesetzt
CGI_ISPCONF
Standardmäßig auf CGI_ISPCONF = '/etc/ispf' gesetzt
CGI_ISPWORK
Standardmäßig auf CGI_ISPWORK = '/var/ispf' gesetzt

Wenn Sie Variablen auf vom Standard abweichende Werte setzen möchten, kopieren Sie ISPZXENV in ein Konfigurationsverzeichnis, in das Sie schreiben dürfen, z. B. in /etc/ispf, und setzen Sie die Variablen auf die für Sie erforderlichen Werte. Nachdem Sie die Variablen auf die erforderlichen Werte gesetzt haben, müssen Sie Ihre Umgebungsvariable PATH in der später beschriebenen Datei startispf.sh so ändern, dass sie vor dem ISPF-Standardpfad 'bin' die neue Position liest.

Beispiel:
export PATH=/etc/ispf:$PATH  

Sie müssen im Arbeitsverzeichnis des ISPF-Gateways (standardmäßig /var/ispf) ein Verzeichnis WORKAREA erstellt haben, für das alle Benutzer schreib- und leseberechtigt sind. Wenn das ISPF-Gateway verwendet wird, werden temporäre Verzeichnis im Format /var/ispf/WORKAREA/<Benutzer-ID>/* angelegt. Wenn Sie die ISPF-Standardinstallation für das ISPF-Gateway verwenden, gibt es dieses Verzeichnis in der Regel unter /var/ispf/WORKAREA. Ist das nicht der Fall, befolgen Sie die Anweisungen im Kapitel Installing and customizing the gateway der Veröffentlichung ISPF Planning and Customizing (IBM Form GC34-4814).

Start-Script startispf.sh des ISPF-Gateways
Shell-Script zum Starten des ISPF-Gateways für Implementierung und Hochstufung
Rational Team Concert stellt für den Start des ISPF-Gateways ein Shell-Script bereit, das von den Ant-Tasks für Implementierung und Hochstufung aufgerufen wird. Dieses Script wird in /usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/ispfgateway installiert. Im Rahmen der standardmäßigen Anpassung wird dieses Script vom Job BLZCPBTK in das Konfigurationsverzeichnis von Rational Team Concert kopiert, in der Regel in das Verzeichnis /etc/jazz40/ccm. Möglicherweise müssen Sie dieses Shell-Script in Ihrer Konfiguration modifizieren, um einige Umgebungsvariablen festzulegen.
PATH
Die Variable PATH muss wie folgt auf das Ausgangsverzeichnis des ISPF-Gateways zeigen:
export PATH=$PATH:/usr/lpp/ispf/bin             
Falls Sie ISPZXENV modifiziert haben, könnten Sie PATH wie folgt definieren:
export PATH=$PATH:/etc/ispf:/usr/lpp/ispf/bin

Wenn Sie in ISPF.conf andere Bibliotheksverkettungen verwenden müssen, konfigurieren Sie Ihre Installation für die Unterstützung mehrerer Projekte und Datenströme. Erstellen Sie dazu mehrere Kopien des Scripts startispf.sh, der Datei ISPF.conf und der Datei ISPZXENV. Setzen Sie die Variable CGI_ISPFCONF in jeder Kopie der Datei ISPZXENV so, dass sie auf die Position der zugehörigen Datei ISPF.conf zeigt. Setzen Sie dann in jeder Kopie des Scripts startispf.sh die Variable PATH so, dass sie auf die entsprechende Kopie der Datei ISPF.conf zeigt. Arbeiten Sie dann mit dem Script startispf.sh für die Umgebung, die Sie für ein bestimmtes Projekt benötigen.

Start-Script startbfa.sh für Enterprise-Extensions-Builds
Shell-Script zum Starten des Rational Build Agent im Rahmen eines Enterprise-Extensions-Builds.
Bei Enterprise-Extensions-Builds gibt es einen Startmechanismus für Builds, bei dem nach dem Start des Builds der Build selbst ein Programm, einen ISPF-Befehl oder eine ausführbare ISPF-Datei bzw. einen TSO-Befehl oder eine ausführbare TSO-Datei aufruft. Wenn das vom Build gestartete Objekt eine von ISPF angelegte Bibliothek ist, müssen Sie den Build so konfigurieren, dass der Zugriff auf das erforderliche Objekt möglich ist. In startbfa.sh müssen Sie die Position der von ISPF bereitgestellten Dateien angeben, damit der Rational Build Agent das ISPF-Gateway starten kann. Diese Dateien befinden sich Standardmäßig in /usr/lpp/ispf und sind in startbfa.sh mit der Variablen _CMDSERV_BASE_HOME angegeben. Falls Sie Binärdateien des ISPF-Gateways an einer anderen Position installiert haben, müssen Sie diese Variable ändern. Beispiel:
#                                                  
# Ausgangsverzeichnis des ISPF-Programms angeben
#                                                  
export _CMDSERV_BASE_HOME=/usr/lpp/ispf                   

ISPF-Programme und ausführbare ISPF-Dateien müssen wie weiter unten beschrieben in der Konfigurationsdatei des ISPF-Gateways (ISPF.conf) zugeordnet sein. Rational Build Agent muss auf ISPF.conf zugreifen können. Der Zugriff wird in der Umgebungsdatei des ISPF-Gateways (ISPZXENV) festgelegt. Wenn Sie die ISPF-Funktionen für Builds nutzen und nicht die Standardposition /usr/lpp/ispf/bin verwenden möchten, müssen Sie in einem Konfigurationsverzeichnis, für das Sie die Schreibberechtigung haben, eine Kopie von ISPZXENV erstellen und Rational Build Agent auf diese Position verweisen. Setzen Sie die Build-Eigenschaft teamz.build.ant.myISPFBinPath auf die Verzeichnisposition, an der sich die Datei ISPZXENV befindet. Sie können den Wert bearbeiten oder die Eigenschaft auf der Registerseite Eigenschaften Ihrer Build-Definition hinzufügen. Weitere Informationen enthält der Artikel z/OS-Builds verwalten.

Konfigurationsdatei ISPF.conf des ISPF-Gateways
Konfigurationsdatei des ISPF-Gateways mit anpassbaren Einstellungen für das ISPF-Gateway.
Die Datei ISPF.conf steht als Teil von z/OS zur Verfügung. Die Konfigurationsdatei des ISPF-Gateways stellt die Zuordnungen bereit, die für den Start einer ISPF-Sitzung in einer erstellten Task erforderlich sind. In den ISPF-Verkettungen müssen bestimmte Module für die Ausführung spezifischer Tasks verfügbar gemacht werden, damit die Build-, Implementierungs- und Hochstufungsfunktionen diese Module starten können. Diese Zuordnungen sind standardmäßig wie folgt konfiguriert:
sysproc=ISP.SISPCLIB 
sysexec=ISP.SISPEXEC 
ispmlib=ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=ISP.SISPLOAD
Fügen Sie die Ladebibliothek des Produkts Rational Team Concert (HLQ.SBLZLOAD) und die Nachrichtenbibliothek des Produkts (HLQ.SBLZMENU) zur ISPLLIB- und ISPMLIB-Verkettung hinzu, um Implementierungen und Hochstufungen zu ermöglichen. Die modifizierten Zuordnungen können wie im folgenden Beispiel aussehen:
sysproc=ISP.SISPCLIB 
sysexec=ISP.SISPEXEC 
ispmlib=BLZ.SBLZMENU,ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=BLZ.SBLZLOAD,ISP.SISPLOAD

Interpretierende Implementierungsmodule ausführen

Falls Sie eigene Implementierungsprozesse oder -funktionen einfügen möchten, können Sie interpretierende Versionen der Implementierungsmodule ausführen. Die Implementierungskomponente führt die folgenden Programme aus:
Tabelle 1. Von der Implementierungskomponente ausgeführte Programme
Programm Funktion Beschreibung
BLZPKGZP Erstellung von Implementierungspaketen Mit der Manifestdatei wird eine ZIP-Datei mit den angegebenen Inhalten erstellt.
BLZBKPZP Sicherung für Implementierung Unter Verwendung der Paketdatei werden Sicherungskopien der Module erstellt, die bei der Implementierung überschrieben werden.
BLZDEPZP Implementierung Mit der Implementierungsmanifestdatei wird der Inhalt der angegebenen ZIP-Datei implementiert.
Die Implementierungsaufgaben von Rational Team Concert rufen diese Programme auf, um die beschriebene Funktion auszuführen. Wenn Sie diese Programme modifizieren möchten, ändern Sie die angegebenen Beispiele in der Bibliothek HLQ.SBLZSAMP und verweisen Sie in ISPF.conf auf die modifizierte Version. Wenn Sie die Modifikationen direkt in HLQ.SBLZSAMP vornehmen, müssten Ihre Zuordnungen in ISPF.conf in etwa wie folgt aussehen:
sysproc=ISP.SISPCLIB,BLZ.SBLZSAMP 
sysexec=ISP.SISPEXEC 
ispmlib=BLZ.SBLZMENU,ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=BLZ.SBLZLOAD,ISP.SISPLOAD
ISPF überprüft zuerst die ISPLLIB-Verkettung, sofern der Befehl kein Prozentzeichen % als Präfix verwendet. Sie müssen daher die Module, die Sie geändert haben, in der Dateigruppe HLQ.SBLZLOAD umbenennen oder entfernen.

Eigene EXEC-Bibliotheken zur Konfigurationsdatei des ISPF-Gateways hinzufügen

Wenn Sie für Enterprise-Extensions-Builds die ISPF-Aufrufmethode verwenden, müssen Sie Ihre eigene EXEC-Bibliothek zur SYSEXEC- oder SYSPROC-Verkettung in ISPF.conf hinzufügen. Sollten Sie einen EXEC-Namen oder SELECT CMD(exec) angegeben haben, muss ISPF auf die erforderliche EXEC in der entsprechenden Verkettung zugreifen können. Sie müssen ISPF.conf so modifizieren, dass die Datei alle erforderlichen EXEC-Bibliotheken enthält. Beispiel:
sysproc=ISP.SISPCLIB 
sysexec=ISP.SISPEXEC,MY.PROJECT.EXEC 
ispmlib=BLZ.SBLZMENU,ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=BLZ.SBLZLOAD,ISP.SISPLOAD

Weitere Informationen zum ISPF-Gateway enthält das Kapitel TSO/ISPF client gateway in ISPF Planning and Customizing der Veröffentlichung ISPF Planning and Customizing (IBM Form GC34-4814).

Fehlerbehebung für die ISPF-Gateway-Konfiguration

Stellen Sie sicher, dass das ISPF-Gateway ordnungsgemäß konfiguriert ist. Benutzer-IDs, die in Rational Team Concert Funktionen ausführen, die auf das ISPF-Gateway zugreifen, müssen über die erforderlichen Berechtigungen verfügen, wie sie in der Veröffentlichung ISPF Planning and Customizing (IBM Form GC34-4814) unter http://publibfp.dhe.ibm.com/epubs/pdf/ispzpc80.pdf beschrieben sind.

Im Script startispf.sh von Rational Team Concert wird mit USS-Befehlen (UNIX System Services) auf das Verzeichnis /tmp zugegriffen. Die Build-Benutzer-ID, mit der das Script startispf.sh gestartet wird, muss Zugriff auf das Verzeichnis /tmp haben. Sie können die Verwendung von /tmp als temporärem Verzeichnis außer Kraft setzen und ein anderes Verzeichnis wählen. Fügen Sie dazu die folgende Zeile zu /etc/jazz40/ccm/startispf.sh hinzu:
export TMPDIR=/Ihr_temporäres_Verzeichnis
Hier steht Ihr_temporäres_Verzeichnis für ein Verzeichnis, auf das Build-Benutzer Schreibzugriff haben.

Feedback