Erstellen eines CICS-Anwendungsprojekts

Ein CICS-Anwendungsprojekt definiert ein Anwendungsbundle. Ein Anwendungsbundle ist ein Typ eines Management-Bundles, der eine CICS-Anwendung beschreibt und deren Namen, Beschreibung und Version enthält. Das Anwendungsbundle verweist auf die CICS-Bundles, die die Anwendungsressourcen, Anwendungseingangspunkte, Abhängigkeiten und CICS-Richtlinien enthalten, die sich auf die Anwendung beziehen.

Vorbereitende Schritte

CICS-Bundleprojekte müssen eine ID und eine Versionsnummer aufweisen, um in ein Anwendungsbundle aufgenommen werden zu können. CICS-Bundleprojekte, die für Releases vor CICS Transaction Server Version 5 Release 1 erstellt worden sind, verfügen nicht über eine ID und eine Versionsnummer. Wenn Sie derartige CICS-Bundleprojekte aufnehmen möchten, können Sie den Projekten mithilfe des Bundlemanifesteditors in CICS Explorer eine ID und eine Versionsnummer hinzufügen.

Informationen zu diesem Vorgang

Sie können in einem Anwendungsbundle ein oder mehrere CICS-Bundles referenzieren. Wenn Sie Ihre Anwendung auf diese Weise paketieren, können Sie sie mit den zugehörigen Bundles als einzelne Entität in CICS implementieren und so die Aktualisierung und Verwaltung der Anwendung in CICS vereinfachen. Wenn ein CICS-Bundle nur Ressourcen enthält, die für die Multiversionssteuerung geeignet sind, kann es auch durch mehrere Anwendungen in CICS-Regionen installiert werden.

Auf Plattformen implementierte Anwendungen, die die CICS-Ressourcen, die als private Ressourcen unterstützt werden, in Kombination mit weiteren Ressourcen für Anwendungen und mit importierten Ressourcen verwenden, können für die Multiversionssteuerung verwendet werden. Die folgenden Ressourcen werden als Teil von Anwendungen mit Multiversionssteuerung unterstützt:
  • In CICS-Bundles definierte PROGRAM-Ressourcen, die Teil der Anwendung sind
  • In CICS-Bundles definierte LIBRARY-Ressourcen, die Teil der Anwendung sind
  • Richtlinien
  • Deklarationen von Anwendungseingangspunkten
  • Jede Ressource, die für die Anwendung als Abhängigkeit bzw. Import definiert wurde

Ein CICS-Bundle, das Ressourcen anderer Typen enthält, kann nicht in andere Anwendungen, die in denselben CICS-Regionen auf der Plattform installiert sind, aufgenommen werden und kann auch nicht zu einer Plattform hinzugefügt werden, wenn es bereits für eine Anwendung installiert worden ist. Wenn Ihre Anwendung eine Ressource erfordert, die nicht für die Multiversionssteuerung unterstützt wird und bereits in einem CICS-Bundle, das in dem Zielregionstyp auf der Plattform installiert worden ist, verwendet wurde, müssen Sie ein neues CICS-Bundleprojekt erstellen. Deklarieren Sie die Ressource als Abhängigkeit für das neue CICS-Bundle, indem Sie in der Manifestdatei einen Import angeben. Nehmen Sie dann das neue CICS-Bundleprojekt in Ihr Anwendungsprojekt auf. Wie eine Ressource als Abhängigkeit deklariert wird, erfahren Sie im Abschnitt Definieren von Bundleabhängigkeiten.

Wenn Sie eine TRANSACTION-Ressource in einem CICS-Bundle definieren und das CICS-Bundle als Teil einer Anwendung implementieren oder das CICS-Bundle zu einer Plattform hinzufügen, wird die automatische Installation des Startprogramms für die Transaktion nicht unterstützt. Bei einer in einem CICS-Bundle definierten TRANSACTION-Ressource, die als Teil einer Anwendung implementiert wird, müssen Sie die PROGRAM-Ressource für das Startprogramm der Transaktion als Teil derselben Anwendung definieren und implementieren.

Vorgehensweise

  1. Öffnen Sie die Perspektive "CICS Cloud". Prüfen Sie im Projektexplorer, ob das CICS-Plattformprojekt für die Zielplattform in Ihrem lokalen Arbeitsbereich vorhanden ist. CICS Explorer benötigt dieses Projekt, um Ihre Anwendungen und Anwendungsbindungen zu validieren.
  2. Klicken Sie im Projektexplorer mit der rechten Maustaste in das Fenster und klicken Sie auf Neu > Projekt, um den Assistenten für neue Projekte zu öffnen.
  3. Erweitern Sie den Ordner CICS-Ressourcen, klicken Sie auf CICS-Anwendungsprojekt und klicken Sie auf Weiter.
  4. Geben Sie im Feld Projektname einen Namen für das Projekt ein. Der Abschnitt Anwendungseigenschaften des Assistenten wird automatisch ausgefüllt. Sie können jedoch bei Bedarf Namen, Beschreibung und Version bearbeiten.
  5. Klicken Sie auf Weiter.
  6. Wählen Sie die CICS-Bundleprojekte aus, die Sie in die Anwendung aufnehmen möchten. Stellen Sie sicher, dass Sie die CICS-Bundleprojekte einschließen, die die Deklarationen von Anwendungseingangspunkten, die Ressourcendefinitionen für die Anwendungsressourcen, und die Deklarationen von Abhängigkeiten von anderen von der Anwendung benötigten Ressourcen enthalten. Schließen Sie auch alle CICS-Bundleprojekte ein, die Richtlinien enthalten, die Sie auf der Anwendungsebene implementieren möchten. Mit dem Anwendungseditor können Sie nach der Erstellung des Anwendungsprojekts weitere CICS-Bundles hinzufügen.
  7. Klicken Sie auf Fertigstellen, um das Projekt zu erstellen.

Ergebnisse

Das Anwendungsprojekt wird erstellt. Das Projekt enthält einen META-INF-Ordner mit drei XML-Dateien:

Um das Anwendungsprojekt zu bearbeiten, erweitern Sie den META-INF-Ordner für die Anwendung und doppelklicken Sie auf die Datei application.xml oder bundles.xml. Mit dem Anwendungseditor können Sie die Anwendungseigenschaften ändern und CICS-Bundles einem Anwendungsprojekt hinzufügen oder aus diesem entfernen. Im Abschnitt Anwendungseditor finden Sie eine Anleitung zur Verwendung des Anwendungseditors.

Anmerkung: Wenn Sie Ihr Anwendungsprojekt mit CICS Explorer erstellt und implementiert haben, müssen Sie das ordnungsgemäße Management der Projektquelle sicherstellen. Da das Anwendungsprojekt nicht aus den exportierten Daten im z/OS-Dateisystem wiederhergestellt werden kann, können bei einem Fehler auf Ihrer Workstation die Daten verloren gehen. Stellen Sie sicher, dass Ihr Projekt bei einem Quellcode-Managementsystem registriert wurde. Wenn Sie ein Quellcode-Managementsystem verwenden, das in Eclipse eingebunden ist, können Sie das Projekt während der Arbeit in CICS Explorer dort registrieren und deregistrieren.

Nächste Schritte

Erstellen Sie ein Anwendungsbindungsprojekt, um zu definieren, wie das Anwendungsbundle auf der Plattform implementiert wird.