Aktualisieren von Anwendungen

Wenn Sie an den CICS-Bundles für die Komponenten einer Anwendung Änderungen vornehmen, aktualisieren Sie die Version der CICS-Bundles, des Anwendungsbundles und der Anwendungsbindung und implementieren Sie die neuen Versionen auf der Plattform.

Vorbereitende Schritte

Wenn Sie eine Anwendung aktualisieren, die auf einer Plattform implementiert ist, ist die Anwendung von dem Zeitpunkt, zu dem Sie die installierte APPLCTN-Ressource im CICSplex für die Vorgängerversion der Anwendung inaktivieren und verwerfen, bis zu dem Zeitpunkt, zu dem Sie die neue APPLDEF-Ressourcendefinition installieren und die neue Version der Anwendung aktivieren, für Benutzer nicht verfügbar. Planen Sie eine geeignete Zeit für die sichere Ausführung der Aktualisierung oder planen Sie für die betreffende Zeit eine Alternativlösung für Anwendungsbenutzer.

Um eine Anwendung zu aktualisieren, müssen Sie das Anwendungsprojekt und das Anwendungsbindungsprojekt bearbeiten. Falls Sie nicht über ein versionsgesteuertes Sicherungssystem verfügen, mit dem Sie Ihre Projekte auf eine Vorgängerversion zurücksetzen können, statt die bestehenden Projekte direkt gemäß dieser Anweisung zu bearbeiten, können Sie sie auch in ein anderes Projekt kopieren und anschließend die neuen Kopien bearbeiten.

Informationen zu diesem Vorgang

Änderungen an Anwendungen werden mithilfe einer Versionssteuerung verwaltet. Alle CICS-Bundles, Anwendungsbundles und Anwendungsbindungen besitzen eine ID und eine Versionsnummer zur eindeutigen Identifizierung. Die Version enthält eine übergeordnete ID, eine untergeordnete ID und eine Mikro-ID, sodass Sie die Signifikanz einer Änderung angeben und die Abhängigkeiten zwischen Bundles verwalten können. Dieses Konzept wird semantische Versionierung genannt und ist von der Open Service Gateway-Initiative (OSGi Alliance) übernommen worden. Auch wenn es primär auf Java™-Pakete ausgerichtet ist, können Sie dieselben Prinzipien auf Bundles im Allgemeinen anwenden.

Semantische Versionierung ermöglicht die Inkrementierung des übergeordneten, des untergeordneten oder des Mikroanteils einer Version, um die Kompatibilität oder Inkompatibilität mit Vorgängerversionen eines Bundles anzugeben. So könnte bei Fehlerkorrekturen der Mikroanteil, bei kompatiblen Änderungen der untergeordnete Anteil und bei inkompatiblen Änderungen der übergeordnete Anteil der Version erhöht werden. Weitere Informationen zu semantischer Versionierung finden Sie im Abschnitt Technisches White Paper zu semantischer Versionierung.

Sie müssen auf Ihre CICS-Bundles und Verwaltungsbundles eine Versionssteuerungsrichtlinie anwenden, um Aktualisierungen in der CICS-Umgebung zu implementieren und zu verwalten. Es ist nicht möglich, eine bisherige Version eines Anwendungsbundles für die Installation neuer Versionen der CICS-Bundles für die Anwendung zu verwenden oder eine bisherige Version einer Anwendungsbindung mit einer neuen Version eines Anwendungsbundles zu verwenden. Das Anwendungsbundle und die Anwendungsbindung müssen bei jeder Aktualisierung der CICS-Bundles für die Anwendung aktualisiert werden.

Wenn Sie die Version eines Verwaltungsbundles ändern, sollte nach den Prinzipien der semantischen Versionierung die neue Version die größte Änderung in einem CICS-Bundle widerspiegeln, die in dem Verwaltungsbundle enthalten ist. Angenommen, Sie ändern ein CICS-Bundle für eine Anwendung von Version 1.0.1 in Version 1.0.2, was eine Änderung der Mikroversion darstellt, und ändern ein anderes CICS-Bundle für die Anwendung von Version 1.2.0 in Version 1.3.0, was eine Änderung der untergeordneten Version darstellt. Dann sollte bei dem Anwendungsbundle, das diese beiden CICS-Bundles enthält, die untergeordnete Version geändert werden. Falls es also zuvor die Version 2.5.1 aufwies, sollte diese in Version 2.6.0 geändert werden.

Vorgehensweise

  1. Klicken Sie auf Fenster > > Projektexplorer anzeigen, um den Projektexplorer zu öffnen.
  2. Lokalisieren Sie das Anwendungsprojekt, erweitern Sie den META-INF-Ordner für das Anwendungsprojekt und doppelklicken Sie auf die Datei application.xml oder bundles.xml. Der Anwendungseditor wird geöffnet. Im Abschnitt Anwendungseditor finden Sie eine Anleitung zur Verwendung des Anwendungseditors.
    Tipp: Falls CICS Explorer in den XML-Dateien für das Anwendungsbundle einen Fehler oder ein sonstiges wichtiges Problem findet, werden in der Ansicht 'Probleme' Informationen zu dem Fehler oder Problem angezeigt.
  3. Wenn Sie weitere CICS-Bundles in das Anwendungsbundle aufnehmen möchten, klicken Sie auf Hinzufügen. Wählen Sie in der Liste der CICS-Bundles, die in Ihrem Arbeitsbereich verfügbar sind, die entsprechenden CICS-Bundles aus.
  4. Wenn Sie CICS-Bundles, die gegenwärtig im Anwendungsbundle enthalten sind, entfernen möchten, wählen Sie die CICS-Bundles aus und klicken Sie auf Entfernen.
  5. Wenn Sie eines der CICS-Bundles, die im Anwendungsbundle enthalten sind, bearbeiten möchten, doppelklicken Sie in der Liste im Anwendungseditor auf den Namen des CICS-Bundles, um den Bundlemanifesteditor zu öffnen.
    1. Mit dem Bundlemanifesteditor können Sie im CICS-Bundle Abhängigkeiten hinzufügen und entfernen, neue Anwendungseintragspunkte erstellen und Richtlinienbereiche definieren.
    2. Die im CICS-Bundle definierten Ressourcen können mit den Ressourceneditoren bearbeitet werden, wie im Abschnitt Bearbeiten von in einem CICS-Bundleprojekt definierten Ressourcen beschrieben.
    3. Nachdem Sie ein CICS-Bundle aktualisiert haben, ändern Sie mit dem Bundlemanifesteditor gemäß Ihrer Versionssteuerungsrichtlinie die übergeordnete, die untergeordnete und die Mikroversion des CICS-Bundles und speichern Sie die Änderungen.
    4. Entfernen Sie die alte Version des CICS-Bundles aus dem Anwendungsbundle, indem Sie sie im Anwendungseditor auswählen und auf Entfernen klicken. Wenn Sie die Versionsnummer des CICS-Bundles aktualisieren, markiert CICS Explorer die alte Version im Anwendungseditor mit einem Fehlerhinweis.
    5. Nehmen Sie das aktualisierte CICS-Bundle in das Anwendungsbundle auf, indem Sie im Anwendungseditor auf Hinzufügen klicken und in der Liste der CICS-Bundles, die in Ihrem Arbeitsbereich verfügbar sind, die neue Version des CICS-Bundles auswählen.
  6. Wenn Sie einen der Eintragspunkte für die Anwendung bearbeiten möchten, doppelklicken Sie in der Liste im Anwendungseditor auf den Namen des Anwendungseintragspunkts, um den Bundlemanifesteditor zu öffnen. Nachdem Sie den Anwendungseintragspunkt aktualisiert haben, ändern Sie mit dem Bundlemanifesteditor gemäß Ihrer Versionssteuerungsrichtlinie die übergeordnete, die untergeordnete und die Mikroversion des CICS-Bundles und speichern Sie die Änderungen. Nehmen Sie das aktualisierte CICS-Bundle, das den Anwendungseintragspunkt enthält, in das Anwendungsbundle auf und entfernen Sie die alte Version.
  7. Nachdem Sie die Aktualisierungen der Anwendung abgeschlossen haben, ändern Sie im Feld Version des Anwendungseditors gemäß Ihrer Versionssteuerungsrichtlinie die übergeordnete, die untergeordnete und die Mikroversion der Anwendung und speichern Sie die Änderungen.
  8. Anschließend können Sie entweder die bestehende Anwendungsbindung durch Angabe der neuen Anwendungsversion aktualisieren oder für die neue Anwendungsversion eine neue Anwendungsbindung erstellen.
    • Wenn Sie für die neue Anwendungsversion eine neue Anwendungsbindung erstellen möchten, klicken Sie im Anwendungseditor auf Anwendungsbindung erstellen, um den Anwendungsbindungsassistenten zu öffnen, und führen Sie die Schritte im Assistenten aus.
    • Wenn Sie die bestehende Anwendungsbindung aktualisieren möchten, lokalisieren Sie im Projektexplorer die bestehende Anwendungsbindung für die Anwendung, erweitern Sie den META-INF-Ordner für das Anwendungsbindungsprojekt und doppelklicken Sie auf die Datei application.xml, bundles.xml oder deployment.xml. Der Anwendungsbindungseditor wird geöffnet. Im Abschnitt Anwendungsbindungseditor finden Sie eine Anleitung zur Verwendung des Anwendungsbindungseditors.
  9. Klicken Sie im Anwendungsbindungseditor auf Durchsuchen, um nach dem Anwendungsnamen zu suchen, und wählen Sie die neue Version der Anwendung aus.
  10. Nehmen Sie an den CICS-Bundles, die mit der Anwendungsbindung implementiert werden, die erforderlichen Änderungen vor.
    1. Klicken Sie auf Hinzufügen oder Entfernen, um die Auswahl der CICS-Bundles zu ändern, die mit der Anwendungsbindung implementiert werden.
    2. Doppelklicken Sie auf die CICS-Bundles, die Sie bearbeiten möchten. Wenn Sie die CICS-Bundles aktualisieren bzw. zurücksetzen und die neuen Versionen in die Anwendungsbindung aufnehmen, können Sie der Beschreibung im Abschnitt 5 für die CICS-Bundles der Anwendung folgen.
  11. Wenn Sie eine der Richtlinien bearbeiten möchten, die mit der Anwendungsbindung implementiert werden, doppelklicken Sie in der Liste im Anwendungseditor auf den Namen der Richtlinie, um den Bundlemanifesteditor zu öffnen. Nachdem Sie die Richtlinie aktualisiert haben, ändern Sie mit dem Bundlemanifesteditor gemäß Ihrer Versionssteuerungsrichtlinie die übergeordnete, die untergeordnete und die Mikroversion des CICS-Bundles und speichern Sie die Änderungen. Nehmen Sie das aktualisierte CICS-Bundle, das die Richtlinie enthält, in die Anwendungsbindung auf und entfernen Sie die alte Version.
  12. Rufen Sie im Anwendungsbindungseditor die Registerkarte Implementierung auf und vergewissern Sie sich, dass jedes der CICS-Bundles für die Anwendung und jedes der CICS-Bundles, die mit der Anwendungsbindung implementiert werden, an einen geeigneten Regionstyp gebunden ist. Über die Schaltfläche zum Umschalten Die Schaltfläche zum Umschalten können Sie zwischen der Bearbeitung der Regionstypen und der Bearbeitung der CICS-Bundles umschalten.
    1. CICS-Bundles, die noch nicht an einen Regionstyp gebunden sind, sind durch den Buchstaben X gekennzeichnet. Wenn Sie die CICS-Bundles bearbeiten, wählen Sie jedes der neuen CICS-Bundles aus und geben Sie mithilfe der Kontrollkästchen die Regionstypen an, in denen es implementiert werden soll.
    2. Falls in der Anwendungsbindung Regionstypen angegeben sind, die in der aktuellen Version des Plattformprojekts, das der Anwendungsbindung zugeordnet ist, nicht gefunden werden, sind sie durch ein Ausrufezeichen gekennzeichnet. Vergewissern Sie sich, dass Sie mit der richtigen Version des Plattformprojekts arbeiten. Wenn Sie den Regionstyp von der Plattform entfernt haben oder zu einer Plattform gewechselt sind, die den Regionstyp nicht enthält, bereinigen Sie das Anwendungsbindungsprojekt. Wenn Sie die Regionstypen bearbeiten, wählen Sie jeden der nicht benötigten Regionstypen aus und wählen Sie alle CICS-Bundles ab, die für diesen Regionstyp angegeben sind.
  13. Nachdem Sie die Aktualisierungen der Anwendungsbindung abgeschlossen haben, ändern Sie im Feld Version des Anwendungsbindungseditors gemäß Ihrer Versionssteuerungsrichtlinie die übergeordnete, die untergeordnete und die Mikroversion der Anwendungsbindung und speichern Sie die Änderungen.
    Tipp: Die Versionsnummer der Anwendungsbindung muss nicht mit der Versionsnummer der Anwendung übereinstimmen. Nach den Prinzipien der semantischen Versionierung sollten Sie jedoch die Versionsnummer der Anwendungsbindung so aktualisieren, dass sie die größte Änderung in der Anwendung oder den CICS-Bundles, die mit der Anwendungsbindung implementiert werden, widerspiegelt.
  14. Klicken Sie im Anwendungseditor bzw. im Anwendungsbindungseditor auf Exportassistent, um die aktualisierte Anwendung bzw. Anwendungsbindung im Plattformausgangsverzeichnis des z/OS UNIX-Dateisystems zu implementieren. Die neue Versionsnummer wird als Teil des Verzeichnisnamens verwendet. Somit bleiben die Vorgängerversionen der Anwendung und des Anwendungsbundles im Plattformausgangsverzeichnis erhalten.
  15. Erstellen Sie eine neue APPLDEF-Ressourcendefinition, die auf das aktualisierte Anwendungsverzeichnis verweist. Wählen Sie das Kontrollkästchen im Exportassistenten aus, damit während des Exportprozesses eine APPLDEF-Ressourcendefinition erstellt wird.
  16. Inaktivieren und verwerfen Sie die installierte APPLCTN-Ressource, die die Vorgängerversion der Anwendung darstellt.
  17. Installieren Sie die neue APPLDEF-Ressourcendefinition.

Ergebnisse

Die neue Version der Anwendung wird auf der Plattform implementiert. Die CICS-Bundles, die in der neuen Version des Anwendungsbundles enthalten sind, werden in den entsprechenden CICS-Regionen installiert. Die innerhalb der CICS-Bundles definierten Ressourcen werden dynamisch in den CICS-Regionen erstellt.