Definition von Bundleabhängigkeiten

Die Abhängigkeiten bzw. Importe für ein CICS-Bundle können Sie in <import>-Elementen in der Bundlemanifestdatei (cics.xml) definieren.

Informationen zu diesem Vorgang

Wenn in der CICS-Region eine CICS-Ressource verfügbar sein muss, ohne dass der Lebenszyklus dieser Ressource an den Lebenszyklus des CICS-Bundles gebunden ist, dann können Sie die Ressource als Abhängigkeit für das CICS-Bundle hinzufügen. Wenn zum Beispiel das CICS-Bundle Ressourcen für einen Web-Service enthält, dann können Sie angeben, dass die vom Web-Service verwendete PIPELINE-Ressource in der CICS-Region verfügbar sein muss. Wenn Sie das CICS-Bundle installieren, prüft CICS, ob eine Ressource des angegebenen Typs mit dem angegebenen Namen in der CICS-Region installiert und aktiviert ist.

Sie können die Aktion auswählen, die CICS ausführt, wenn eine Ressource, die in einem <import>-Element angegeben ist, in der CICS-Region nicht vorhanden ist. Die Bundleinstallation kann zum Beispiel fehlschlagen oder mit einer Warnung erfolgreich abgeschlossen werden. Sie können Importe als optional definieren, sodass die BUNDLE-Ressource immer mit aktiviertem Status installiert wird und zwar auch dann, wenn die Abhängigkeit nicht zutrifft.

In einem CICS-Bundle, das als Teil einer auf einer Plattform implementierten Anwendung paketiert ist, können öffentliche oder private Ressourcen als Abhängigkeiten definiert werden, einschließlich privater Programme, die durch eine Anwendung automatisch installiert werden. CICS prüft zuerst, ob in derselben Anwendung wie das CICS-Bundle, das das <import>-Element in der Bundlemanifestdatei enthält, eine private Ressource mit dem angegebenen Typ und Namen vorhanden ist. Wenn mehr als eine Anwendungsversion installiert wurde, bestimmt der aktuelle Anwendungskontext die Version der privaten Ressource, die importiert wird. Wenn die Ressource nicht als private Ressource für die Anwendung gefunden wurde, prüft CICS, ob in der CICS-Region eine öffentliche Ressource mit dem angegebenen Typ und Namen vorhanden ist, und importiert diese Ressource. Es ist nicht möglich, private Ressourcen aus anderen Anwendungen zu importieren.

Vorgehensweise

  1. Navigieren Sie zum Ordner META-INF des Bundles, mit dem Sie arbeiten wollen.
  2. Doppelklicken Sie auf die Manifestdatei cics.xml. Der Bundlemanifesteditor wird geöffnet und alle aktuellen Ressourcen, die für dieses Bundle erforderlich sind, und die ID und Version des Bundles werden angezeigt.
  3. Klicken Sie auf Hinzufügen. Das Dialogfenster zum Importieren von Eigenschaften wird angezeigt.
  4. Geben Sie in der CICS-Ressourcentypliste den Ressourcentyp an. Drücken Sie Strg+Leertaste, um Hilfe zum Inhalt anzuzeigen.
  5. Geben Sie den Namen der erforderlichen Ressource ein.
  6. Legen Sie fest, ob zur Aktivierung der BUNDLE-Ressource der Import erforderlich oder optional ist. Standardmäßig ist der Import erforderlich und die BUNDLE-Ressource kann nur dann aktiviert werden, wenn die Abhängigkeit erfüllt ist. Wenn Sie Optional auswählen, wird die BUNDLE-Ressource auch dann installiert, wenn die Abhängigkeit in der CICS-Region nicht erfüllt ist. Wählen Sie aus, ob eine Warnung ausgegeben werden soll, wenn die Abhängigkeit nicht erfüllt ist.
  7. Klicken Sie auf OK. Die Ressource wird der Liste importierter Ressourcen hinzugefügt, die für dieses Bundle erforderlich sind.
  8. Klicken Sie auf Speichern.

Ergebnisse

Sie haben die CICS-Ressourcen definiert, die für das CICS-Bundle erforderlich sind.

Nächste Schritte

Sie können dem Bundleprojekt CICS-Ressourcen hinzufügen. Diese Ressourcen werden bei der Installation der BUNDLE-Ressource in der CICS-Region dynamisch erstellt.