Erstellen einer Richtlinie in einem CICS-Bundleprojekt

Eine Richtlinie ist eine XML-Definition, die eine oder mehrere Richtlinienregeln enthält. Die Richtlinienregeln beschreiben die Kontrollmechanismen oder Aktionen, die auf eine oder mehrere Tasks angewendet werden können. Eine Richtlinie wird in einem CICS-Bundleprojekt erstellt; in einem CICS-Bundleprojekt können eine oder mehrere Richtlinien definiert werden. Wenn Sie Ihre Richtlinien auf diese Weise paketieren, können Sie sie als einzelne Entität in CICS implementieren und so die Aktualisierung und Verwaltung der Richtlinien in CICS vereinfachen.

Informationen zu diesem Vorgang

Eine Richtlinie überwacht und steuert Benutzertasks. Die Richtlinienregeln definieren einen Regeltyp, durch den Grenzwerte festgelegt werden, bei deren Überschreitung in der CICS-Region, in der die Task ausgeführt wird, eine automatische Aktion ausgelöst wird.Jede Richtlinie kann eine oder mehrere Regeln definieren und für eine bestimmte Benutzertask können eine oder mehrere Richtlinien gelten. Für die Erstellung einer Richtlinie benötigen Sie ein bestehendes CICS-Bundleprojekt.

Richtlinien, die auf Plattformebene implementiert werden, gelten für alle Anwendungen, die auf der betreffenden Plattform implementiert sind. Richtlinien, die auf Anwendungsebene implementiert werden, gelten nur für die betreffende Anwendung und nicht für andere Anwendungen, die auf derselben Plattform ausgeführt werden.

Zur Ausführungszeit bestimmt CICS alle Regeln, die für eine Benutzertask gelten. Bei Ausführung der Task wendet CICS die Regeln in der Reihenfolge vom niedrigsten zum höchsten Schwellenwert an. Wenn für denselben Schwellenwert mehrere Regeln gelten, werden von CICS zuerst Nachrichtentypregeln, dann Ereignisregeln und schließlich Abbruchregeln angewendet. Durch diese Reihenfolge wird sichergestellt, dass Nachrichten und Ereignisse ausgegeben werden, bevor eine Task abgebrochen wird.

Wenn Sie zum Erstellen einer Richtlinie in einem CICS-Bundleprojekt den Assistenten verwenden, können Sie nur eine Regel erstellen. Um einer vorhandenen Richtlinie weitere Regeln hinzuzufügen, können Sie mit dem Assistenten eine andere Richtlinie erstellen und die zusätzlichen Regeln zur vorhandenen Richtliniendatei hinzufügen.

Vorgehensweise

  1. Wählen Sie im Projektexplorer den Stammordner eines CICS-Bundleprojekts aus.
  2. Klicken Sie im Hauptmenü der Workbench auf Datei > Neu > Andere, um den Assistenten für neue Projekte zu öffnen.
  3. Erweitern Sie den Ordner CICS-Ressourcen, wählen Sie Richtliniendefinition aus und klicken Sie anschließend auf Weiter.
  4. Geben Sie im Abschnitt "Richtlinieninformationen" im Feld Name einen Namen und, optional, im Feld Beschreibung eine Beschreibung ein. Mit diesem Namen wird der Name der Richtliniendatei angegeben, z. B. Name.policy.
  5. Geben Sie im Abschnitt "Regelinformationen" im Feld Name für die erste Richtlinienregel einen Namen und, optional, im Feld Beschreibung eine Beschreibung ein.
  6. Legen Sie die Bedingung fest, mit der die Regel ausgelöst wird:
    1. Wählen Sie aus der Liste Typ den erforderlichen Richtlinienregeltyp aus.
    2. Wählen Sie aus der Liste Element das erforderliche Element aus.
    3. Geben Sie im Feld Wert die ganze Zahl ohne Vorzeichen ein und klicken Sie auf die erforderliche Einheit.
    Wenn Sie den Richtlinienregeltyp und das Element für die Richtlinienbedingung auswählen, wird das CICS-Release angezeigt, das die erforderliche Version des Richtlinienschemas unterstützt. Weitere Informationen zu Richtlinienregeltypen und Richtliniengrenzwerten finden Sie unter den relevanten Links.
  7. Wählen Sie aus den folgenden Optionen die Aktion aus, die ausgeführt werden soll, wenn die Bedingung der Regel überschritten wird:
    • Nachricht ausgeben
    • Ereignis ausgeben in. Wählen Sie EP-Adapter oder EP-Adaptergruppe aus und geben Sie anschließend den Namen des erforderlichen EP-Adapters bzw. der erforderlichen EP-Adaptergruppe ein.
    • Task mit Abbruchcode AMPB abbrechen
    Weitere Informationen zu Richtlinienaktionen finden Sie unter dem relevantem Link.
  8. Wählen Sie die Option Editor öffnen ab.
  9. Klicken Sie auf Fertigstellen, um die Richtlinie zu erstellen.

Ergebnisse

Eine Richtlinie wird im CICS-Bundleprojekt erstellt.

Nächste Schritte

Fügen Sie optional weitere Regeln zur Richtlinie hinzu. Weitere Informationen finden Sie im Abschnitt Hinzufügen von Regeln zu einer Richtlinie in einem CICS-Bundleprojekt.

Implementieren Sie Ihre Richtlinie auf eine der folgenden Weisen, wenn sie vollständig ist:
  • Fügen Sie das CICS-Bundle, das die Richtlinie enthält, einem Plattform-, Anwendungs- oder Anwendungsbindungsprojekt hinzu, um es für die Implementierung zu paketieren.
  • Fügen Sie das CICS-Bundle, das die Richtlinie enthält, mithilfe des Dialogfelds für die Operation ADDBUNDLE einer installierten Plattform hinzu. Weitere Informationen finden Sie im Abschnitt Hinzufügen eines CICS-Bundles zu einer Plattform.
  • Exportieren Sie das CICS-Bundleprojekt für die Implementierung in das z/OS-Dateisystem. Definieren, installieren und aktivieren Sie anschließend eine CICS-BUNDLE-Ressource für das CICS-Bundleprojekt. Wenden Sie eines der folgenden Verfahren an, um für die BUNDLE-Ressource das Attribut BASESCOPE festzulegen:
    • Wenn Sie eine Richtlinie implementieren möchten, die für Benutzertasks gilt, die Anwendungseintragspunkte aufweisen und als Teile von Anwendungen ausgeführt werden, die auf einer bestimmten Plattform implementiert sind, definieren Sie das Attribut BASESCOPE als cicsapplication://Plattformname////.
    • Wenn Sie eine Richtlinie implementieren möchten, die für alle Benutzertasks gilt, die einer bestimmten CICS-Anwendung zugeordnet sind, die auf einer bestimmten Plattform ausgeführt wird, definieren Sie das Attribut BASESCOPE als cicsapplication://Plattformname/Anwendungsname/Hauptversion_der_Anwendung/Unterversion_der_Anwendung/Mikroversion_der_Anwendung.
    • Wenn Sie eine Richtlinie implementieren möchten, die für alle Benutzertasks in der CICS-Region gilt, lassen Sie das Attribut BASESCOPE leer.
    Anmerkung: Bei dieser Implementierungsmethode müssen Sie das CICS-Bundleprojekt auf jedem z/OS-System implementieren, auf dem es Anwendung finden soll. Wenn Ihre Richtlinie zum Beispiel für alle Benutzertasks gelten soll, die einer bestimmten CICS-Anwendung zugeordnet sind, die auf einer bestimmten Plattform ausgeführt wird, müssen Sie das CICS-Bundleprojekt auf jedem z/OS-System innerhalb der Plattform, auf der die Anwendung ausgeführt wird, implementieren. Dabei muss das Attribut BASESCOPE als cicsapplication://Plattformname/Anwendungsname/Hauptversion_der_Anwendung/Unterversion_der_Anwendung/Mikroversion_der_Anwendung definiert werden.