Sie können das CICS-Bundleprojekt verwenden, das mit jedem Servlet-Beispiel bereitgestellt wird, um die Anwendung in einem Liberty-JVM-Server zu implementieren, der in CICS ausgeführt wird.
Vorbereitende Schritte
Sie müssen eine Beispielwebanwendung erstellen (siehe Abschnitt
Erste Schritte mit Servlet-Beispielen). Darüber hinaus müssen Sie zur Erstellung und Installation der CICS-Ressourcen in der Region berechtigt sein. Sie sollten auch die Tools der OSGi-Anwendungsentwicklungsfunktion von Websphere Developer Version 8.5.5 installieren (siehe
Einrichten der Entwicklungsumgebung).
Für die Implementierung des CICS JDBC-Beispiels (Java™ Database Connectivity) ist ein zusätzlicher Schritt erforderlich:
- Erstellen und installieren Sie eine CICS-Ressourcendefinition DB2CONN und stellen Sie sicher, dass der Status verbunden ist. Der in der CICS-Definition DB2CONN angegebene DB2-Plan muss mit einer wie folgt angegebenen Paketliste gebunden werden:
PKLIST(NULLID.*)
Informationen zu diesem Vorgang
Da CICS die Java-Anwendungen aus dem z/OS-Dateisystem lädt und ausführt, müssen Sie Ihre kompilierten Anwendungen in einem geeigneten Verzeichnis im z/OS-Dateisystem implementieren, auf das die CICS-Region zugreifen kann. Für das DB2-Beispiel muss außerdem eine DB2-Beispieldatenbank verfügbar sein.
Es wird empfohlen, für die Implementierung und Installation der Anwendungen ein CICS-Bundleprojekt zu verwenden. Wenn Sie diese Methode verwenden, können Sie die betreffenden Anwendungsressourcen des Bundleprojekts anschließend mit den CICS-Funktionen verwalten. In ein CICS-Bundleprojekt werden mehrere Plug-in-Projekte, dynamische Webprojekte und CICS-Ressourcen gepackt, die logisch als einzelne Einheit implementiert und verwaltet werden. Diese Methode kann für einfache Webanwendungen (beispielsweise für das Beispiel "Hello World") sowie für komplexere Webanwendungen wie die übrigen Servlet-Beispiele verwendet werden.
Alternativ können Sie zur Implementierung und Installation der Anwendungen den Liberty-Implementierungsmechanismus verwenden, um WAR- oder EBA-Dateien zu implementieren. Sie können das Projekt als WAR- oder EBA-Datei exportieren und die Datei mit FTP in das Verzeichnis dropins eines Liberty-JVM-Servers kopieren. Diese Methode kann für einfache Webanwendungen wie das Beispiel "Hello World" verwendet werden.
Vorgehensweise
- Wenn Sie ein Beispiel mithilfe eines CICS-Bundleprojekts implementieren möchten, können Sie das CICS Explorer SDK verwenden.
- Klicken Sie mit der rechten Maustaste auf das Bundleprojekt und dann auf Bundleprojekt in UNIX-Dateisystem unter z/OS exportieren.
- Führen Sie den Assistenten aus, um das Bundle an einer Position im z/OS-Dateisystem zu implementieren, die für die CICS-Region zugänglich ist. Wenn Sie die BUNDLE-Beispielressourcendefinitionen in der Beispielgruppe DFH$WLP verwenden möchten, verwenden Sie /tmp/cicsts52 als übergeordnetes Verzeichnis im z/OS-Dateisystem. Das CICS Explorer SDK implementiert das CICS-Bundle und die zugehörigen Projekte im z/OS-Dateisystem. Wenn das CICS-Bundle Artefakte des Typs .osgibundle oder .warbundle enthält, werden die zugehörigen Projekte in Übereinstimmung mit ihren Projekterstellungseigenschaften erstellt und ebenfalls exportiert.
- Beim Beispiel "CICS JDBC (Java Database Connectivity)" muss ein Bundleprojekt implementiert werden. Führen Sie für dieses Bundleprojekt die Schritte 1 und 2 aus.
- Bearbeiten Sie das Beispiel "DFHWLP.jvmprofile", um die automatische Konfigurationsoption mit der Systemeigenschaft -Dcom.ibm.cics.jvmserver.wlp.autoconfigure=true zu aktivieren. Die Datei server.xml wird automatisch generiert und kann im Verzeichnis WLP_USER_DIR/servers/server_name gefunden werden.
In der Ansicht "z/OS UNIX-Dateien" können Sie die Verzeichnisstruktur zum Bearbeiten der Datei durchsuchen. Sie sollten entsprechend Ihrer eigenen Umgebung Werte für -Dcom.ibm.cics.jvmserver.wlp.server.host und -Dcom.ibm.cics.jvmserver.wlp.server.http.port oder -Dcom.ibm.cics.jvmserver.wlp.server.https.port angeben. Setzen Sie beim JDBC-Beispiel die Eigenschaft Dcom.ibm.cics.jvmserver.wlp.jdbc.driver.location auf die Position des DB2-JDBC-Treibers. Weitere Informationen finden Sie im Abschnitt Manuelle Konfiguration einer Datenquelle mit CICS-DB2-JDBC-Treiber vom Typ 2 für Liberty.
- Wählen Sie in der Ansicht "CICSplex Explorer" die CICS-Region aus, in der die Servlet-Beispiele ausgeführt werden sollen.
- Installieren Sie die JVMSERVER-Ressource DFHWLP, die sich in der Beispielgruppe DFH$WLP befindet. Die Beispielressource erstellt einen Liberty-JVM-Server in der CICS-Region.
Der Liberty-JVM-Server erstellt eine Verzeichnisstruktur im z/OS-Dateisystem. Dies umfasst auch die Datei server.xml und ein dropins-Verzeichnis für Webanwendungen. Den Status des JVM-Servers können Sie überprüfen, indem Sie auf klicken.
- Öffnen Sie die Ansicht "Bundledefinitionen", indem Sie auf klicken. Diese Ansicht enthält eine Liste aller Bundledefinitionen für die CICS-Region.
- Installieren Sie die Ressourcendefinitionen des Beispielbundles in der Beispielgruppe DFH$WLP. Die Ressourcendefinition WLPHELLO des Beispielbundles ist für das Beispiel "CICS Hello
World" erforderlich. WLPTSQ wird für das Beispiel "CICS TSQ (Warteschlange für temporären Speicher)" benötigt. WLPJDBC ist für das JDBC-Beispiel erforderlich. Die Beispieldefinitionen geben /tmp/cicsts52 als die Position an, an der die CICS-Bundles implementiert werden.
- Wenn Sie die Funktion cicsts:security-1.0 konfiguriert haben oder die automatische Konfiguration verwenden, stellen Sie sicher, dass Sie auch die erforderlichen Sicherheitsregeln konfiguriert haben. Siehe Konfigurieren von Sicherheit für einen Liberty-JVM-Server.
- Optional: Sie können ein bereitgestelltes Beispiel bei Bedarf auch ändern. Wenn Sie dasselbe Beispiel zuvor implementiert haben und nun erneut implementieren möchten, müssen Sie das Bundle für die neue Version des auszuführenden Beispiels inaktivieren und erneut aktivieren.
Die WAR- oder EBA-Datei (je nach Beispiel) wird in den Liberty-Profilserver geladen und alle OSGi-Bundles werden im OSGi-Framework registriert.
- Um ein einfaches Beispiel zu implementieren, das dem Liberty-Implementierungsmodell entspricht, müssen Sie einen JVM-Server in CICS konfigurieren und aktivieren. Bei der Aktivierung des JVM-Servers wird das Verzeichnis dropins erstellt.
- Bearbeiten Sie "DFHWLP.jvmprofile", um die automatische Konfiguration mit der Systemeigenschaft -Dcom.ibm.cics.jvmserver.wlp.autoconfigure=true zu aktivieren.
- Wählen Sie in der Ansicht "CICSplex Explorer" die CICS-Region aus, in der das Servlet-Beispiel ausgeführt werden soll.
- Installieren Sie die JVMSERVER-Ressource DFHWLP, die sich in der Beispielgruppe DFH$WLP befindet. Die Beispielressource erstellt einen Liberty-JVM-Server in der CICS-Region.
Der Liberty-JVM-Server erstellt eine Verzeichnisstruktur im z/OS-Dateisystem. Dies umfasst auch die Datei server.xml und ein dropins-Verzeichnis für Webanwendungen. Den Status des JVM-Servers können Sie überprüfen, indem Sie auf klicken.
- Klicken Sie in der Perspektive "Ressource" mit der rechten Maustaste auf das dynamische Webprojekt und exportieren es als WAR- oder EBA-Datei an Ihre lokale Workstation.
- Kopieren Sie mit dem File Transfer Protocol (FTP) die WAR- oder EBA-Datei im Binärmodus in das Verzeichnis dropins.
- Sie können die Datei server.xml bearbeiten, um den Hostnamen und die Portnummer zu ändern.
Ergebnisse
Sie haben eine Webanwendung, die Servlets und eine JSP-Seite enthält, auf einem Liberty-JVM-Server implementiert, der in CICS ausgeführt wird. Außerdem haben Sie den Liberty-JVM-Server für die Verwendung eines Hostnamens und einer Portnummer konfiguriert.
Nächste Schritte
Sie können über einen Web-Browser auf die Webanwendung zugreifen, um die Konfiguration des Liberty-JVM-Servers zu prüfen (siehe Abschnitt
Ausführen der Servlet-Beispiele).