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
  • In CICS-definierte Richtlinienressourcen, die Teil der Anwendung sind
  • Deklarationen von Anwendungseingangspunkten
  • Jede Ressource, die für die Anwendung als Abhängigkeit bzw. Import definiert wurde
  • DB2-Paketgruppenressourcen, die in CICS-Bundles definiert sind, die Teil der Anwendung sind

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.

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 Anwendungsdeskriptoreditor 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:
  • application.xml ist der Deskriptor, der die Metadaten für die Anwendung enthält, einschließlich der Beschreibung und der Version.
  • bundles.xml enthält die Liste der CICS-Bundles, aus denen die Anwendung zusammengesetzt ist, einschließlich der Bundle-ID und der Version.
  • manifest.xml ist die Manifestdatei für das Projekt und identifiziert es als CICS-Management-Bundle.

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 Anwendungsdeskriptoreditor können Sie die Anwendungseigenschaften ändern und CICS-Bundles einem Anwendungsprojekt hinzufügen oder aus diesem entfernen. Im Abschnitt Der Anwendungsdeskriptoreditor finden Sie eine Anleitung zur Verwendung des Anwendungsdeskriptoreditors.

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.