Exportation de spécifications d'événement à partir d'une politique

Si une action de règle conditionnelle doit envoyer un événement, vous pouvez exporter les spécifications d'événement pour cet événement en tant que schéma ou fichier de stockage afin de les utiliser à un autre emplacement.

Avant de commencer

Vous devez posséder une politique CICS avec son action de règle définie comme Envoyer un événement à. Pour plus d'informations, voir Création et déploiement d'une politique dans un projet de bundle CICS.

Pourquoi et quand exécuter cette tâche

Les fichiers exportés contiennent le format des données d'événement, ce qui est utile pour le traitement des données capturées avec vos programmes ou moteurs de traitement de données.

Le format de données spécifié pour l'adaptateur de traitement d'événement ou l'adaptateur de traitement d'événement faisant partie de l'ensemble d'adaptateurs de traitement d'événement choisi détermine si le fichier exporté est un schéma ou un fichier de stockage :
  • Pour un format XML tel que Common Base Event, Common Base Event REST, Decision Server Insights Event ou WebSphere Business Events, le fichier exporté est un fichier .xsd de définition de schéma XML. Les adaptateurs suivants peuvent émettre des événements dans des formats alphanumériques XML :
    • Adaptateur HTTP
    • Adaptateur de file d'attente TD
    • Adaptateur de file d'attente de serveur de transaction
    • IBM® MQ
  • Pour un format non XML, comme le format CICS Flattened Event, le fichier exporté est un fichier de stockage COBOL .cpy. Les adaptateurs suivants peuvent émettre des événements au format CICS Flattened Event :
    • Adaptateur de file d'attente TD
    • Adaptateur de file d'attente de serveur de transaction
    • IBM MQ
Remarque : Vous ne pouvez pas exporter les spécifications d'événement pour un adaptateur Début de transaction ou un adaptateur personnalisé.

Procédure

  1. Sur l'onglet Règles de l'éditeur de définition de politique, accédez à la section Action.
    Onglet Action de l'onglet Règles de l'éditeur de définition de politique
  2. Vérifiez que l'action Envoyer un événement à est sélectionnée avec un adaptateur de traitement d'événement ou qu'un jeu d'adaptateurs de traitement d'événement est défini.
  3. Cliquez sur Exporter des spécifications d'événement.
  4. Vous serez invité à choisir un adaptateur ou un jeu d'adaptateurs dans les cas de figure suivants :
    • Dans votre espace de travail, plusieurs adaptateurs de traitement d'événement ont le même nom que l'adaptateur spécifié ou qu'un adaptateur faisant partie du jeu d'adaptateurs de traitement d'événement indiqué.
      Fenêtre Choisir l'adaptateur EP
    • Dans votre espace de travail, plusieurs adaptateurs de traitement d'événement ont le nom de jeu d'adaptateurs indiqué.
      Fenêtre Choisir le jeu d'adaptateurs EP
  5. Dans la fenêtre Exporter les spécifications d'événement pour une règle, vérifiez que les informations correctes sont spécifiées dans les zones correspondantes : Fenêtre Exporter les spécifications d'événement pour une règle
    Exporter
    Règle conditionnelle pour laquelle vous voulez exporter les spécifications d'événement.
    Vers le répertoire
    Répertoire local dans lequel sauvegarder les spécifications d'événement exportées.
    Format de données

    Format de données indiqué dans votre adaptateur de traitement d'événement ou dans l'adaptateur faisant partie de votre jeu d'adaptateurs de traitement d'événement.

    Cette zone s'affiche lorsque CICS Explorer ne peut pas déterminer le format de données car l'adaptateur, le jeu d'adaptateurs de traitement d'événement ou un adaptateur faisant partie du jeu d'adaptateurs de traitement d'événement n'existe pas dans votre espace de travail.

    Remarque : vérifiez que les informations sur le format de données correspondent à celles indiquées dans vos adaptateurs de traitement d'événement pour que vous puissiez utiliser sans problème les fichiers exportés pour le traitement de données.
    Version

    Version de la région CICS qui enverra l'événement, c'est-à-dire la région dans laquelle la politique sera déployée.

    Cette zone s'affiche lorsque la règle conditionnelle s'applique à CICS TS 5.3 et antérieure.

  6. Cliquez sur OK.
  7. Si une spécification d'événement exportée ayant le même nom existe déjà dans le répertoire indiqué, vous êtes invité à remplacer le fichier existant ou à annuler l'exportation.

Résultats

Un ou plusieurs fichiers sont créés dans le répertoire indiqué pour la règle conditionnelle. Les exemples dans le tableau ci-dessous présentent les fichiers qui sont créés pour différents événements pour lesquels aucun nom d'événement n'est spécifié.

Si un nom d'événement est spécifié, il est utilisé comme préfixe du nom de fichier exporté. Par exemple, si un nom d'événement event_name est spécifié dans le premier exemple, le fichier de sortie se nomme event_name_dsie_CICS_54.xsd. Pour plus d'informations sur la définition des noms d'événement, voir Création et déploiement d'une politique dans un projet de bundle CICS.
Tableau 1. Fichiers de spécification d'événement exportés pour différents événements
Adaptateurs ou jeux d'adaptateurs de traitement d'événement Règle conditionnelle Version Format de données Spécifications d'événement exportées
IBM MQ Règle système de statut d'ouverture du fichier V54 Format Decision Server Insights Event (XML) Fichier de schéma XML fileEnable_rule_dsie_CICS_54.xsd que vous pouvez utiliser dans l'outil IBM Operational Decision Manager Insight Designer afin de définir un événement.
Adaptateur de file d'attente de serveur de transaction et de file d'attente Règle de tâche de demande de stockage V51 - 53 Format Evénement de base commun REST (XML) Fichier de schéma XML cics_policy_event_payload_cbe_CICS_51-53.xsd que vous pouvez importer dans IBM Business Monitor pour définir un événement entrant.
V54 Fichier de schéma XML task_rules_payload_cbe_CICS_54.xsd que vous pouvez importer dans IBM Business Monitor pour définir un événement entrant.
IBM MQ Règle système de statut d'ouverture du fichier V54 Format CICS Flattened Event Fichier de stockage COBOL DFHMPFEO_CICS_54.cpy que vous pouvez utiliser pour traiter les données dans vos propres programmes de consommation d'événements.
Jeu d'adaptateurs de traitement d'événement comportant :
  • un adaptateur de file d'attente de serveur de transaction ou de file d'attente (format CICS Flattened Event)
  • un adaptateur de file d'attente IBM MQ (Format WebSphere Business Events (XML))
Règle système de statut d'ouverture du fichier V54

Format CICS Flattened Event Format WebSphere Business Events (XML)

Deux fichiers DFHMPFEO_CICS_54.cpy et fileEnable_rule_wbe_CICS_54.xsd que vous pouvez utiliser dans vos programmes et dans l'outil IBM Operational Decision Manager Event Designer.