Erstellen eines CICS-Plattformprojekts

Ein CICS-Plattformprojekt definiert ein Plattformbundle, einen Typ eines Verwaltungsbundles zur Beschreibung einer Plattform. Das Plattformbundle gibt die Regionstypen für die Plattform an.

Vorbereitende Schritte

Richten Sie ein Plattformausgangsverzeichnis für die Plattform im z/OS-Dateisystem ein, bevor Sie das CICS-Plattformprojekt erstellen. Ein bewährtes Verfahren besteht darin, das Standardverzeichnis /var/cicsts/CICSplex/Plattform1 als Plattformausgangsverzeichnis zu verwenden, wobei CICSplex der Name des CICSplex ist, in dem die Plattform installiert werden soll, und Plattform1 der Name Ihrer Plattform ist. Wenn Sie ein anderes Verzeichnis als Plattformausgangsverzeichnis verwenden müssen, können Sie im Plattformeditor zum alternativen Verzeichnisnamen wechseln, nachdem Sie das CICS-Plattformprojekt erstellt haben. Sie finden Anweisungen zur Erstellung eines Plattformausgangsverzeichnisses auf dem z/OS-Dateisystem unter Erstellen eines Plattform-Ausgangsverzeichnisses auf einem z/OS-Dateisystem im CICS TS 5.1 Information Center.

Wenn Sie CICS-Bundles auf der Ebene Ihrer Plattform implementieren möchten, können Sie die Bundles so erstellen, dass Sie sie beim Erstellen Ihres CICS-Plattformprojekts direkt hinzufügen können. Zum Beispiel können Sie ein CICS-Bundle implementieren, das eine Ressource enthält, die in allen CICS-Regionen in der Plattform erforderlich ist, oder das eine Richtlinie enthält, die auf mehrere auf der Plattform implementierte Anwendungen angewendet wird. Wenn Sie für Ihre Plattform noch keine Anwendungen, Ressourcen oder Richtlinien eingerichtet haben, können Sie CICS-Bundles zur Plattform hinzufügen, nachdem Sie sie erstellt oder implementiert haben. Anweisungen zum Erstellen eines CICS-Bundles finden Sie im Abschnitt Arbeiten mit Bundles.

Informationen zu diesem Vorgang

Eine Plattform enthält einen oder mehrere Regionstypen. Regionstypen werden verwendet, um CICS-Regionen entsprechend ihrem Typ zu klassifizieren und aufzunehmen. Zum Beispiel könnten alle CICS-Regionen, die Verbindungen zu DB2 verwalten, derselben Gruppe angehören. Sie können CICS-Regionen zwischen mehreren Regionstypen in derselben Plattform oder mit Regionstypen in anderen Plattformen gemeinsam nutzen.

Sie können neue Regionstypen für die Verwendung in der Plattform erstellen. Sie können alternativ bestehende CICS-Systemgruppen (CSYSGRPs) als Regionstypen in die Plattform übernehmen. Eine einzelne Plattform kann sowohl erstellte als auch übernommene Regionstypen enthalten.

Erstellte Regionstypen können die Eigenschaften der CICS-Regionen angeben, die sie enthalten. Sie können bestimmte Regionsattributwerte für alle CICS-Regionen in einem Regionstyp klonen, indem Sie die Attribute auf der Ebene des Regionstyps angeben. In den betreffenden Regionstyp können nur CICS-Regionen aufgenommen werden, deren Definitionen dieselben Werte wie die für diese Attribute angegebenen Werte aufweisen oder in denen für diese Attribute keine Werte angegeben sind. Auf Regionstypebene können die folgenden Regionsattributwerte angegeben werden:
Als Routing-Regionen zulässig (Attribut WLMSTATUS)
Gibt an, ob diese CICS-Region an der ihr zugeordneten Workload als Routing-Region teilnehmen soll, wenn die CICS-Region gestartet wird.
Als Zielregionen zulässig (Attribut DYNROUTE)
Gibt an, ob diese CICS-Region als Zielregion aktiv sein und Arbeit für die Workload akzeptieren soll, für die sie beim CICS-Start ein Ziel ist.
BAS-Installation aktivieren (Attribut AUTOINST)
Gibt an, ob Ressourcen, die der CICS-Region über eine Ressourcenbeschreibung zugeordnet sind, automatisch installiert werden sollen, wenn das MAS (Managed Application System) eine Verbindung zum CMAS (CICSPlex SM-Adressraum) herstellt.
Fehlerbehebungsmaßnahme für BAS-Installation (Attribut AINSFAIL)
Gibt an, welche Aktion im Falle eines Fehlers bei der BAS-Installation (BAS = Business Application Services) ausgeführt werden soll.
Wenn die Architektur Ihrer Plattform erfordert, dass alle CICS-Regionen in einem Regionstyp bestimmte Leistungsmerkmale oder Einschränkungen in diesen Bereichen aufweisen müssen, können Sie die entsprechenden Werte auf Regionstypebene angeben. Wenn ein erstellter Regionstyp keine besonderen Anforderungen an Attribute stellt, geben Sie keinen Wert für dieses Attribut an, damit beliebige Einstellungen in den CICS-Regionen zugelassen sind. Wenn Sie einen Regionsattributwert auf Regionstypebene angeben, wird der betreffende Attributwert gesperrt. Er kann anschließend in einer CICS-Region, die Teil des Regionstyps ist, nicht mehr geändert werden.
Wenn Sie eine vorhandene CICSPlex SM-Topologie erneut als Plattform implementieren möchten, können Sie eine vorhandene CICS-Systemgruppe (CSYSGRP) als aufgenommenen Regionstyp übernehmen.Jede CSYSGRP, die Sie als Teil einer Plattform aufnehmen, muss die folgenden Voraussetzungen erfüllen:
  • Die Gruppe ist noch nicht von einer bereits installierten Plattform aufgenommen worden. Wenn die Gruppe bereits einer Plattform zugeordnet ist, kann sie nicht als Regionstyp verwendet werden.
  • Die Gruppe enthält keine Untergruppen.
  • Die Gruppe erfordert keine Änderungen (z. B. eine Gruppe, die in WLM oder RTA einbezogen ist). Plattformen benötigen eine Sperre auf den Gruppen, die als Regionstypen fungieren.
  • Bei allen CICS-Regionen in der Gruppe ist der CICSPlex System Manager-Systemparameter MASPLTWAIT(YES) angegeben. MASPLTWAIT(YES) ist auch für Business Application Services erforderlich. Dieser Parameter wird dafür benötigt, bei der Initialisierung der CICS-Region automatisch Ressourcen für eine Anwendung oder Plattform zu installieren.
Wenn CICS-Regionen in einer CSYSGRP vorliegen, die diese Voraussetzungen nicht erfüllt, und die CICS-Regionen als Teil der Plattform verwendet werden sollen, fügen Sie deren Systemdefinitionen (CSYSDEFs) einer neuen CSYSGRP hinzu, die Sie speziell für die Plattform erstellen.

Vorgehensweise

  1. Klicken Sie in der Menüleiste von CICS Explorer auf Datei > Assistenten für neue Ressourcen > Andere, um den Assistenten für neue Projekte zu öffnen.
  2. Erweitern Sie den Ordner CICS-Ressourcen, klicken Sie auf CICS-Plattformprojekt und klicken Sie auf Weiter.
  3. Geben Sie im Feld Projektname einen Namen für das CICS-Plattformprojekt ein und geben Sie den Namen und die Beschreibung für die Plattform selbst an. Die Projektposition gibt an, wo das CICS-Plattformprojekt in Ihrem lokalen Arbeitsbereich gespeichert wird. Klicken Sie auf Weiter.
  4. Klicken Sie auf Hinzufügen, um einen Regionstyp zur Plattform hinzuzufügen. Geben Sie im Feld Name einen Namen für den Regionstyp ein. Bei dem neuen Regionstyp kann es sich um einen erstellten Regionstyp oder um einen angenommenen Regionstyp handeln. Um eine vorhandene CICS-Systemgruppe (CSYSGRP) als angenommenen Regionstyp anzunehmen, muss eine CICS SM-Verbindung bestehen.
    • Bei einem erstellten Regionstyp klicken Sie auf Definition mit eindeutiger ID erstellen. Geben Sie im ID-Feld einen Namen für die CICS-Systemgruppe (CSYSGRP) ein, die für den Regionstyp erstellt werden soll.
    • Bei einem aufgenommenen Regionstyp klicken Sie auf Vorhandene Systemgruppe verwenden. Wählen Sie die vorhandene CICS-Systemgruppe (CSYSGRP) aus dem CICSplex aus, in dem sie sich befindet.
    Klicken Sie auf OK, um den Regionstyp zur Plattform hinzuzufügen.
  5. Wiederholen Sie den Schritt, falls Sie weitere erstellte oder angenommene Regionstypen hinzufügen möchten, die Sie für Ihre Plattform benötigen. Nachdem Sie einen Regionstyp hinzugefügt haben, können Sie seine Eigenschaften bearbeiten. Dabei handelt es sich um den Namen und (nur bei erstellten Regionstypen) die ID der CSYSGRP. Sie können außerdem versehentlich hinzugefügte Regionstypen entfernen. Wenn Sie alle Regionstypen für Ihre Plattform angegeben haben, klicken Sie auf Weiter.
  6. Optional: Geben Sie die CICS-Bundles an, die Sie mit Ihrer Plattform implementieren möchten. Die Liste der CICS-Bundles wird aus Ihrem lokalen Arbeitsbereich ermittelt. Wählen Sie die gewünschten CICS-Bundles aus und klicken Sie auf Weiter. Geben Sie dann die Regionstypen an, auf denen die einzelnen CICS-Bundles implementiert werden sollen. Wenn keine CICS-Bundles vorhanden sind, die mit der Plattform implementiert werden können, dann überspringen Sie diese Phase.
  7. Klicken Sie auf Fertigstellen, um das Projekt zu erstellen. Wenn Sie CICS-Bundles mit der Plattform implementieren, müssen Sie deren Implementierungsbereich angeben, bevor Sie auf Fertigstellen klicken. Das CICS-Plattformprojekt wird erstellt und im Projektexplorer der CICS-Cloud-Perspektive angezeigt.
  8. Verwenden Sie den Plattformeditor in CICS Explorer, um für Ihr CICS-Plattformprojekt Ihre Spezifikationen für das Plattformbundle zu überprüfen und zu vervollständigen. Der Plattformeditor wird automatisch geöffnet, nachdem Sie ein Plattformprojekt erstellt haben. Um den Plattformeditor später zu öffnen, doppelklicken Sie mit Ausnahme der Datei manifest.xml auf eine der XML-Dateien für das Plattformbundle. Im Abschnitt Plattformeditor finden Sie eine Anleitung zur Verwendung des Plattformeditors.
  9. Überprüfen oder bearbeiten Sie den Namen und die Beschreibung für die Plattform auf der Registerkarte Überblick des Plattformeditors. Wenn Sie statt des Standardverzeichnisses ein anderes Verzeichnis als Plattformausgangsverzeichnis verwenden müssen, dann klicken Sie auf Durchsuchen, um das Ausgangsverzeichnis zu suchen, das Sie eingerichtet haben, und als Plattformausgangsverzeichnis auszuwählen.
  10. Überprüfen Sie auf der Registerkarte Überblick des Plattformeditors im Bereich Regionstypen die Regionstypen für die Plattform und verwenden Sie die Schaltflächen Hinzufügen und Entfernen, um erstellte oder angenommene Regionstypen nach Bedarf hinzuzufügen oder zu entfernen. Um einen angenommenen Regionstyp hinzuzufügen, muss eine CICS SM-Verbindung bestehen. Wenn eine Plattform installiert und aktiv ist, können Sie einzelne CICS-Regionen in Regionstypen hinzufügen und entfernen. Da Sie in einer installierten Plattform die Regionstypen nicht mehr ändern können, müssen Sie Ihre Regionstypen fertigstellen, bevor Sie die Plattform installieren.
  11. Überprüfen Sie auf der Registerkarte Überblick des Plattformeditors im Bereich CICS-Bundles die CICS-Bundles, die mit der Plattform implementiert werden, und verwenden Sie die Schaltflächen Hinzufügen und Entfernen, um Bundles nach Bedarf hinzuzufügen oder zu entfernen. Wenn Sie eines der CICS-Bundles bearbeiten möchten, doppelklicken Sie auf den Namen des Bundles, um es im Bundlemanifesteditor zu öffnen. Nachdem Sie die Plattform installiert haben, können Sie im Laufe der Entwicklung Ihrer Anwendungen und Richtlinien weitere CICS-Bundles auf der Ebene der Plattform implementieren.
  12. Wählen Sie auf der Registerkarte Regionstypen des Plattformeditors jeden der erstellten Regionstypen in Ihrer Plattform aus, um die Eigenschaften des Regionstyps anzuzeigen. Geben Sie im Bereich Eigenschaften des Regionstyps alle erforderlichen Einstellungen an, die in allen CICS-Regionen im Regionstyp erforderlich sind. Nur CICS-Regionen, die die erforderlichen Einstellungen akzeptieren können, können Teil eines Regionstyps sein. Wenn Ihr erstellter Regionstyp keine besonderen Anforderungen an Attribute stellt, geben Sie keinen Wert für dieses Attribut an, damit beliebige Einstellungen in den CICS-Regionen zugelassen sind.
  13. Wählen Sie auf der Registerkarte Regionstypen des Plattformeditors jeden der erstellten Regionstypen in Ihrer Plattform aus und klicken Sie auf Region hinzufügen, um eine oder mehrere CICS-Regionsdefinitionen für CICS-Regionen hinzuzufügen, die Teil des Regionstyps sein sollen. Bei erstellten Regionstypen, die Sie beim erstmaligen Erstellen des CICS-Plattformprojekts im Assistenten hinzugefügt haben, wird eine Standarddefinition als CICS-Regionsdefinition bereitgestellt, die Sie durch die eigentliche Definition für eine CICS-Region im Regionstyp ersetzen müssen. Im Bereich Eigenschaften der Region können Sie die CICS-Standardregionsdefinition auswählen und die Standardattribute durch Ihre eigenen Attribute ersetzen. Sie können aber auch neue CICS-Regionsdefinitionen im erstellten Regionstyp erstellen und dann die CICS-Standardregionsdefinition löschen.
    1. Geben Sie im Bereich Regionseigenschaften für die CICS-Systemdefinition (CSYSDEF) für die neue CICS-Region einen Namen (bis zu acht Zeichen) an. Der CSYSDEF-Name muss im CICSplex eindeutig sein.
    2. CICS Explorer stellt für die neue CICS-Region eine Anwendungs-ID bereit, die mit dem angegebenen Namen übereinstimmt. Die Anwendungs-ID ist der Netzname, unter dem die CICS-Region im Netz für übergreifende Kommunikation bekannt ist. Ändern Sie gegebenenfalls die Anwendungs-ID, um die Anforderungen in Ihrem Netz zu erfüllen.
    3. Geben Sie für die neue CICS-Region eine SYSID an. Die SYSID (auch SYSIDNT genannt) ist ein aus 1 bis 4 Zeichen bestehender Name, unter dem die CICS-Region bei anderen CICS-Regionen bekannt ist.
    4. Geben Sie eine oder mehrere erstellte Regionstypen in Ihrer Plattform an, in die die neue CICS-Region eingeschlossen werden soll. Wenn Sie die CICS-Region zwischen mehreren Regionstypen gemeinsam nutzen, müssen die erforderlichen Einstellungen, die Sie für diese Regionstypen eingerichtet haben, übereinstimmen und dürfen nicht miteinander in Konflikt stehen.
    5. Optional: Wenn die CICS-Region IPIC-Systemlinks (SYSLINKs) für die Verbindung mit anderen CICS-Regionen verwenden soll, geben Sie einen aus Zeichen bestehenden Hostnamen oder die IPv4- bzw. IPv6-Adresse für die CICS-Region, eine Netz-ID und eine Portnummer für abgehende Anforderungen an. Die Netz-ID ist die z/OS Communications Server-NETID.
    Den Plattformeditor können Sie nicht verwenden, um CICS-Regionen in übernommenen Regionstypen hinzuzufügen, zu entfernen oder gemeinsam zu nutzen. Sie können nur mit CICS-Regionsdefinitionen in erstellten Regionstypen arbeiten.
  14. Überprüfen oder bearbeiten Sie auf der Registerkarte Implementierung des Plattformeditors die Regionstypen, bei denen jedes CICS-Bundle mit der Plattform implementiert werden soll.
  15. Speichern Sie Ihr CICS-Plattformprojekt.
    Anmerkung: Nach der Erstellung des CICS-Plattformprojekts müssen Sie für eine ordnungsgemäße Verwaltung des in Ihrem Arbeitsbereich erstellten Projektordners sorgen. Da das CICS-Plattformprojekt 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.

Ergebnisse

Das CICS-Plattformprojekt enthält einen META-INF-Ordner mit folgenden XML-Dateien:
  • bundles.xml beschreibt die CICS-Bundles, die mit der Plattform implementiert werden.
  • deployment.xml beschreibt die Regeln für die Implementierung der CICS-Bundles auf der Plattform.
  • manifest.xml ist die Manifestdatei für das Plattformbundle und identifiziert es als CICS-Verwaltungsbundle.
  • platform.xml beschreibt die Plattform mit Name, Beschreibung, Regionstypen und Plattformausgangsverzeichnis.
  • regions.xml beschreibt die erstellten CICS-Regionen im Projekt.
  • regionTypes.xml enthält die Metadaten für jeden Regionstyp, einschließlich des Namens, der Beschreibung, des Regionstyps und der ID der Systemgruppe.
  • regionTypeLinks.xml beschreibt die Links von erstellten Regionen zu Regionstypen.

Nächste Schritte

Exportieren Sie das Projekt in das z/OS-Dateisystem, richten Sie CICS-Regionen entsprechend den einzelnen CICS-Regionsdefinitionen ein, die Sie in einem Regionstyp in Ihrer Plattform erstellt haben, und installieren Sie dann die Plattform im CICSplex, um sie verfügbar zu machen. Siehe Implementieren eines CICS-Plattformprojekts.