Création et déploiement d'une politique dans un projet de bundle CICS

Une politique est une définition XML qui contient une ou plusieurs règles conditionnelles. Une règle conditionnelle décrit l'action à appliquer à un système CICS ou une tâche utilisateur individuelle lorsque la condition spécifiée est remplie. Une politique est créée dans un projet de bundle CICS, et vous pouvez définir une ou plusieurs politiques dans un projet de bundle CICS. En conditionnant vos politiques de cette manière, vous pouvez les déployer vers CICS sous la forme d'une seule entité, ce qui facilite la mise à jour et la gestion des politiques dans CICS.

Avant de commencer

Pour que vous puissiez créer et déployer une politique, un projet de bundle CICS doit exister. Pour plus d'informations, voir Création d'un projet de bundle CICS.

Pourquoi et quand exécuter cette tâche

CICS prend en charge des règles système et des règles de tâche. Une règle système surveille et contrôle la santé générale d'un système CICS et une règle de tâche surveille et contrôle une tâche utilisateur individuelle. Chaque règle conditionnelle définit les conditions à remplir pour qu'une action automatisée soit effectuée. Chaque politique peut définir une ou plusieurs règles, et une ou plusieurs politiques peuvent s'appliquer à un système CICS ou à une tâche utilisateur individuelle.
Remarque : bien que des règles système et des règles de tâche puissent être définies dans une même politique, vous devez définir les deux types de règle dans des politiques distinctes si vous souhaitez déployer une politique qui définit des règles de tâche avec une application CICS.
Niveaux de portée pour les règles de tâche
Les politiques qui définissent des règles de tâche peuvent être déployées aux niveaux de portée suivants :
Au niveau de la région
Les règles s'appliquent à toutes les tâches utilisateur qui s'exécutent dans la région spécifiée.
Au niveau de la plateforme
Les règles s'appliquent à toutes les tâches utilisateur pour toute application CICS déployée sur la plateforme indiquée.
Au niveau de l'application
Les règles s'appliquent uniquement aux tâches utilisateur pour l'application spécifiée et non aux autres tâches utilisateur pouvant s'exécuter sur la même plateforme.

Vous pouvez restreindre davantage la portée des politiques qui définissent des règles de tâche déployées au niveau de la région ou de l'application à des tâches utilisateur spécifiques en définissant des portées de règle. Pour plus d'informations, voir Définition des portées de règle.

Niveaux de portée pour les règles système
Les politiques qui définissent des règles système peuvent être déployées aux niveaux de portée suivants :
Au niveau de la région
Les règles s'appliquent à toutes les tâches (système ou utilisateur) dans la région indiquée qui apportent des modifications à l'état d'un système ou d'une ressource.
Au niveau de la plateforme
Les règles s'appliquent à toutes les tâches (système ou utilisateur) dans toutes les régions de la plateforme indiquée qui apportent des modifications à l'état d'un système ou d'une ressource.

Les politiques qui définissent des règles système ne peuvent pas être déployées au niveau de l'application.

Procédure

Pour créer une politique dans un projet de bundle CICS :

  1. Sélectionnez le dossier parent d'un projet de bundle CICS dans la vue Explorateur de projets.
  2. Ouvrez l'assistant Nouveau projet de l'une des façons suivantes :
    • Dans le menu principal du plan de travail, cliquez sur Fichier > Nouveau > Autre. Ensuite, développez le dossier Ressources CICS, sélectionnez Définition de politique et cliquez sur Suivant.
    • Cliquez avec le bouton droit de la souris sur le projet de bundle CICS, puis cliquez sur Nouveau > Définition de politique.
  3. Créez une politique qui contient la règle conditionnelle :
    Conseil : Pour créer rapidement une règle conditionnelle à partir d'un fichier local CICS ou d'une ressource de classe de transaction, accédez à la vue de ressource correspondante et cliquez avec le bouton droit de la souris sur la ressource pour laquelle vous voulez créer une politique. Sélectionnez Créer un politique, puis le type de règle à créer.
    1. Dans la zone Nom de fichier, entrez le nom du fichier de règles, par exemple règles_conditionnelles.
    2. Cliquez sur Terminer. L'éditeur de définition de politique s'ouvre. Pour plus d'informations, voir L'éditeur de définition de politique.
  4. Facultatif : Dans la section Informations générales de l'onglet Présentation, vous pouvez entrer une description dans la zone Description, un libellé défini par l'utilisateur dans la zone Libellé défini par l'utilisateur, ou les deux. Un libellé défini par l'utilisateur est un identificateur comportant de 1 à 8 caractères inclus dans un événement envoyé pour les règles définies dans une politique. Il peut s'agir d'un numéro de version, d'un code de service ou des initiales de l'auteur de la politique, soit tout ce qui vous aide à associer un événement à la politique qui demande l'événement.
  5. Créez une règle dans l'éditeur de définition de politique :
    1. Dans l'onglet Présentation, cliquez sur Nouveau.
    2. Dans la boîte de dialogue Nouvelle règle, entrez un nom de règle, sélectionnez un type de règle dans la liste et, le cas échéant, entrez une description de la règle.
    3. Cliquez sur OK. L'onglet Règles s'ouvre.
  6. Dans la section Conditions de l'onglet Règles, définissez les conditions qui déclenchent l'action automatisée lorsqu'elles sont remplies. Les règles système et les règles de tâche prennent en charge différents types de condition ; pour plus d'informations, voir Conditions de politique.
    Remarque : La version CICS la plus ancienne qui prend en charge une règle spécifique s'affiche dans l'angle inférieur droit de la section Conditions. Assurez-vous que ce niveau est égal ou inférieur à l'édition CICS dans laquelle la politique va être déployée. Pour plus d'informations, voir Régle de gestion des versions.
  7. Sélectionnez une action à effectuer lorsque les conditions définies sont remplies :
    • Emettre un message. CICS émet un message dans le journal CICS lorsque la condition spécifiée est remplie. Pour les règles de tâche, DFHMP3001 ou DFHMP3007 est émis. Pour les règles système, un message DFHMP3009 ou DFHMP3010 est émis.
    • Emettre un événement. Spécifie un adaptateur de traitement d'événement ou un jeu d'adaptateurs de traitement d'événement pour CICS afin d'envoyer un événement à un adaptateur de traitement d'événement unique ou à tous les adaptateurs d'un jeu d'adaptateurs de traitement d'événement. Les adaptateurs de traitement d'événement formatent les données d'événement dans un format de sortie adapté et achemine l'événement vers les consommateurs d'événements définis. Pour plus d'informations, voir Choix d'une ressource d'adaptateur EP et Choix d'une ressource de jeu d'adaptateurs EP.
      Onglet Action de l'onglet Règles de l'éditeur de définition de politique
      En option, pour distinguer les événements émis par des règles conditionnelles du même type, spécifiez le nom de l'événement comme suit. Si aucun nom d'événement n'est spécifié, un nom par défaut sera utilisé.
      • 1 à 32 caractères.
      • Caractères admis : 0-9 A-Z a-z _
      • Doit commencer par un caractère alphabétique et ne doit en aucun cas commencer par les caractères XML.
      En option, pour transmettre des données non modifiables au consommateur d'événement, associez les éléments de données statiques à l'événement en cliquant sur Ajouter. Une règle peut contenir un maximum de 479 éléments de données statiques. Définissez chaque élément de données statiques comme une paire nom-valeur comme suit :
      Pour les noms de données statiques :
      • 1 à 32 caractères.
      • Caractères admis : 0-9 A-Z a-z _
      • Doit commencer par un caractère alphabétique et ne doit en aucun cas commencer par les caractères EPFE, MPFE ou XML.
      • Doit être unique dans une règle.
      Pour les valeurs de données statiques :
      • 1 à 255 caractères.
      • Les caractères admis, y compris les espaces imbriqués, sont les suivants :

        0-9 A-Z a-z `¬¦!"£$%^&*()_+-={}:@~;'#<>?,./|

      Remarque : Si vous spécifiez l'action d'événement pour une règle conditionnelle, vous pouvez exporter les spécifications d'événement en tant que schéma ou fichier de stockage pour l'utiliser ailleurs. Les définitions des éléments de capture de données statiques sont inclus dans le fichier exporté ; et si un nom d'événement est spécifié, il est utilisé comme préfixe du nom de fichier exporté. Pour plus d'informations, voir Exportation de spécifications d'événement à partir d'une politique.
    • Pour les règles de tâche seulement : Fin de tâche anormale. Si vous voulez que CICS mette fin à une tâche en cours d'exécution lorsque le seuil spécifié est atteint, sélectionnez l'option Fin de tâche anormale avec code de fin anormale. CICS émet également un message (DFHMP3002 ou DFHMP3008) dans le journal CICS lorsqu'une tâche prend fin. Le code de fin anormale par défaut est AMPB, mais vous pouvez le remplacer en entrant un autre code pour la fin anormale d'une tâche.
  8. Facultatif : Ajoutez d'autres règles en suivant les étapes 5 à 7.
  9. Pour sauvegarder la politique, cliquez sur Fichier > Sauvegarder.

Pour déployer une politique dans le projet de bundle CICS :

Les politiques qui définissent des règles système peuvent être déployées sur une région CICS autonome ou avec une plateforme CICS, mais elle ne peuvent pas être déployées avec une application CICS. Les politiques qui définissent des règles de tâche peuvent être déployées dans une région CICS, avec une plateforme CICS ou une application CICS.

  1. Déployez la politique via l'une des méthodes suivantes :
    • Pour déployer la politique dans une région CICS autonome :
      1. Exportez le projet de bundle CICS qui définit la politique vers zFS. Pour plus d'informations sur le déploiement des bundles CICS vers zFS, voir Déploiement d'un bundle CICS.
      2. Définissez, installez et activez une ressource BUNDLE CICS pour le bundle CICS. Vous pouvez créer et installer une définition BUNDLE en ouvrant la vue Définitions de bundles. Pour plus d'informations relatives aux ressources de bundle, voir Ressources BUNDLE dans la documentation du produit CICS TS version 5.4.0.
    • Pour déployer la politique sur une plateforme, ajoutez le bundle CICS qui la contient à une plateforme :
      • Si la plateforme n'est pas encore déployée, ajoutez le bundle CICS qui définit la politique à la définition de plateforme, comme indiqué ci-dessous, afin qu'elle soit déployée au cours du déploiement de la plateforme :
        1. Localisez le projet de bundle de plateforme dans votre espace de travail, développez le dossier META-INF pour le projet de bundle et cliquez deux fois sur le fichier bundles.xml ou platform.xml. L'éditeur de descripteur de plateforme s'ouvre. Pour des instructions supplémentaires sur l'utilisation de l'éditeur de descripteur de plateforme, voir Editeur de descripteur de plateforme.
        2. Cliquez sur Ajouter dans la section Bundles CICS de l'onglet Présentation.
        3. Dans la liste des bundles CICS disponibles dans votre espace de travail, sélectionnez le bundle CICS qui définit la politique.
      • Si la plateforme est active, procédez comme suit :
        1. Exportez le projet de bundle CICS dans le répertoire de base de la plateforme sous zFS. Pour plus d'informations, voir Déploiement d'un bundle CICS.
        2. Ajoutez le bundle CICS qui définit la politique sur la plateforme active à l'aide de la boîte de dialogue de l'opération ADDBUNDLE de la vue Explorateur de cloud. Pour plus d'informations, voir Ajout d'un bundle CICS à une plateforme.
    • Pour déployer la politique avec une application CICS, ajoutez le bundle CICS qui définit la politique sur l'application, comme suit :
      1. Localisez le projet de bundle d'application dans votre espace de travail, développez le dossier META-INF pour le projet de bundle et cliquez deux fois sur le fichier application.xml ou bundles.xml. L'éditeur de descripteur d'application s'ouvre. Pour des instructions supplémentaires sur l'utilisation de l'éditeur de descripteur d'application, voir Editeur de descripteur d'application.
      2. Cliquez sur Ajouter dans la section Bundles CICS de l'onglet Présentation.
      3. Dans la liste des bundles CICS disponibles dans votre espace de travail, sélectionnez le bundle CICS qui définit la politique.

Résultats

Une politique est créée dans le projet de bundle CICS et déployée.