Spécification d'informations sur l'adaptateur de traitement d'événement et le répartiteur

Spécifiez des informations dans la liaison d'événements afin de contrôler la façon dont CICS émet les événements générés par cette liaison.

Pourquoi et quand exécuter cette tâche

Utilisez les informations du répartiteur pour définir ce que deviennent les événements créés par cette liaison. Sélectionnez l'adaptateur de traitement d'événement pour émettre des événements, puis sélectionnez les options relatives à l'adaptateur de traitement d'événement.

Procédure

  1. Cliquez sur l'onglet Adaptateur de l'Editeur de liaison d'événement et sélectionnez l'option Utiliser un adaptateur défini ici pour indiquer la configuration d'adaptateur de traitement d'événement en vue d'utiliser cette liaison d'événement, les paramètres pour l'adaptateur de traitement d'événement et les informations avancées.

    Sinon, vous pouvez choisir d'utiliser une ressource EPADAPTER ou EPADAPTERSET prédéfinie. Pour plus d'informations sur une ressource EPADAPTER prédéfinie, voir Editeur de configuration de l'adaptateur de traitement d'événement. Pour plus d'informations sur une ressource EPADAPTERSET prédéfinie, voir Editeur de jeu d'adaptateurs de traitement d'événement.

    Si vous spécifiez une ressource EPADAPTER ou EPADAPTERSET prédéfinie, entrez le nom dans la zone Nom ou cliquez sur Choisir pour sélectionner une ressource. Pour plus d'informations sur la sélection des ressources d'adaptateur, voir Choix d'une ressource d'adaptateur EP et Choix d'une ressource de jeu d'adaptateurs EP.

  2. Facultatif : Vous pouvez exporter une ou plusieurs spécification d'événement dans cette liaison d'événements.
  3. Choisissez le type d'adaptateur de traitement d'événement dans la liste Adaptateur. Vous pouvez spécifier les types d'adaptateurs de traitement d'événement suivants :
    File d'attente IBM® MQ
    Emet des événements vers une file d'attente de messages IBM MQ au format XML pour la consommation par IBM Operational Decision Manager ou IBM Business Monitor, ou au format CFE (CICS flattened event) binaire pour la consommation directe à partir d'IBM MQ.
    Dans le cadre de l'émission assurée d'événement, la livraison est assurée lorsque l'adaptateur de traitement d'événement IBM MQ est utilisé en combinaison avec des files d'attente de messages persistants IBM MQ.
    Début d'une transaction
    Emet des événements vers une transaction CICS nommée. Les données sont transmises à la transaction dans un format d'événement de conteneur. Vous pouvez spécifier le système CICS qui exécutera la transaction. Vous pouvez utiliser une transaction existante, si les données de l'événement ne sont pas requises. L'adaptateur de traitement d'événement Début de transaction ne prend pas en charge l'émission assurée d'événement.
    File d'attente TS
    Emet des événements vers une file d'attente TS CICS dans l'un des formats XML suivants : Common Base Event, Common Base Event REST, Decision Server Insights Event ou WebSphere Business Events, ou dans un format autre que XML (CFE). Utilisez cet adaptateur de traitement d'événement pour valider le fait que des événements corrects sont capturés avec des données correctes et pour émettre des événements à destination d'un consommateur qui procède à la lecture à partir d'une file d'attente TS.
    Pour l'émission assurée d'événement, les événements transactionnels synchrones ont besoin d'une file d'attente TS récupérable ; les événements synchrones non transactionnels ont besoin d'une file d'attente non récupérable. La récupérabilité des files d'attente TS dépend des paramètres du modèle TSMODEL correspondant ; les files d'attente TS ne sont récupérables que s'il existe un modèle SMODEL correspondant. Lorsque vous utilisez l'adaptateur de file d'attente TS pour des événements synchrones transactionnels, il n'est pas possible d'émettre la commande DELETEQ TS pour la file d'attente TS d'événements dans l'unité de travail qui capture l'événement.
    File d'attente TD
    Emet des événements vers une file d'attente de données transitoires CICS nommée dans l'un des formats suivants : Common Base Event, Common Base event REST, CICS Flattened Event (CFE), Decision Server Insights Event et WebSphere Business Event. Utilisez cet adaptateur de traitement d'événement lorsque vous développez et testez des spécifications d'événement pour valider le fait que des événements corrects sont capturés avec des données correctes et pour émettre des événements à destination d'un consommateur qui procède à la lecture à partir d'une file d'attente de données transitoires.
    Pour l'émission d'événement synchrone, la file d'attente de données transitoires doit être une file d'attente intrapartition récupérable pour les événements transactionnels et une file d'attente intrapartition non récupérable ou une file d'attente extrapartition pour les événements non transactionnels. Vous pouvez utiliser l'adaptateur de traitement d'événement de file d'attente de données transitoires pour le test et le débogage, ainsi que la production.
    Personnaliser (programmé par l'utilisateur)
    Emet des événements au format souhaité. Un adaptateur de traitement d'événement personnalisé est un programme CICS écrit pour indiquer une combinaison de formatage et de routage d'un événement que les adaptateurs de traitement d'événement fournis par CICS ne prennent pas en charge. L'adaptateur personnalisé de traitement d'événement ne doit exécuter aucun autre traitement, comme la consommation de l'événement.
    Pour l'émission assurée d'événement, l'adaptateur personnalisé de traitement d'événement doit être conforme aux exigences de récupérabilité de l'événement. Consultez la documentation de l'adaptateur personnalisé pour savoir s'il prend en charge les événements synchrones transactionnels ou non transactionnels.
    HTTP
    Emet des événements vers un serveur HTTP 1.1 compatible à l'aide de HTTP POST au format XML en vue de leur consommation par des produits tels que IBM Operational Decision Manager ou IBM Business Monitor. L'adaptateur HTTP de traitement d'événement ne prend pas en charge l'émission assurée d'événement transactionnel.
  4. Indiquez les options pour le type d'adaptateur de traitement d'événement que vous avez choisi :
    • Spécifiez les options suivantes pour l'adaptateur de traitement d'événement de file d'attente IBM MQ :
      • Indiquez le nom de la file d'attente IBM MQ dans laquelle sont placés les événements émis par cette liaison d'événement. Vous devez spécifier un nom de file d'attente.
      • Précisez si les messages sont permanents. Sélectionnez l'une des valeurs suivantes dans la liste Permanent.
        Non
        Les messages placés en file d'attente par l'adaptateur de traitement d'événement de file d'attente IBM MQ ne sont pas persistants.
        Oui
        Les messages placés en file d'attente par l'adaptateur de traitement d'événement de file d'attente IBM MQ sont persistants.
        File d'attente par défaut
        Les messages placés dans une file d'attente héritent du caractère permanent par défaut de la file d'attente désignée.
      • Indiquez la priorité du message. Vous pouvez sélectionner File d'attente par défaut ou entrer une valeur dans la zone Priorité pour la priorité des messages IBM MQ, comprise entre 0 et 9.
      • Précisez le délai d'expiration. Vous pouvez sélectionner N'expire jamais ou saisir une valeur pour l'expiration du message IBM MQ dans la zone Délai d'expiration. Ce délai est défini en dixièmes de seconde. Un message peut être annulé s'il n'a pas été supprimé de la file d'attente de destination avant la fin de ce délai.
      • Spécifiez un format de données pour l'événement. Sélectionnez l'une des valeurs suivantes dans la liste Format de données :
        CICS Flattened Event (binaire)
        Les données d'un événement sont dans un format non XML.
        Common Base Event (XML)
        Les messages sont placés dans la file d'attente au format CBE (Common Base Event) requis par IBM Business Monitor.
        WebSphere Business Events (XML)
        Les messages sont placés dans la file d'attente au format XML requis par Composant Decision Server Events de IBM Operational Decision Manager.
        Decision Server Insights Event (XML)
        Les messages sont placés dans la file d'attente au format XML requis par Composant Decision Server Insights de IBM Operational Decision Manager. Les données d'un événement sont en format XML.
    • Spécifiez les options suivantes pour l'adaptateur de traitement d'événement Début de transaction :
      • Indiquez l'ID transaction de l'application CICS exécutée suite aux événements. Vous devez indiquez un ID transaction.
      • Indiquez un ID utilisateur de transaction. La transaction initiée par l'adaptateur de traitement d'événement Début de transaction est exécutée sous cet ID utilisateur.
      • Indiquez l'ID système, disponible uniquement pour l'adaptateur de traitement d'événement de transaction. La transaction d'adaptateur de traitement d'événement s'exécute sur le système CICS avec cet ID système.
    • Spécifiez les options suivantes pour l'adaptateur de traitement d'événement de la file d'attente de serveur de transaction :
      • Indiquez le nom de la file d'attente CICS. Vous devez spécifier un nom de file d'attente.
      • Si votre file d'attente cible est distante, indiquez l'ID système.
      • Sélectionnez Utiliser le stockage temporaire auxiliaire, le cas échéant.
      • Spécifiez un format de données pour l'événement. Sélectionnez l'une des valeurs suivantes dans la liste Format de données :
        CICS Flattened Event (binaire)
        Les données d'un événement sont dans un format non XML.
        Common Base Event (XML)
        Les données d'un événement sont en format XML.
        Common Base Event REST (XML)
        Les données d'un événement sont en format XML.
        WebSphere Business Events (XML)
        Les données d'un événement sont en format XML.
        Decision Server Insights Event (XML)
        Les données d'un événement sont en format XML.
    • Spécifiez les options suivantes pour l'adaptateur de traitement d'événement de la file d'attente de données transitoires :
      • Indiquez le nom de la file d'attente CICS. Vous devez spécifier un nom de file d'attente.
      • Si votre file d'attente cible est distante, indiquez l'ID système.
      • Spécifiez un format de données pour l'événement. Sélectionnez l'une des valeurs suivantes dans la liste Format de données :
        CICS Flattened Event (binaire)
        Les données d'un événement sont dans un format non XML.
        Common Base Event (XML)
        Les données d'un événement sont en format XML.
        Common Base Event REST (XML)
        Les données d'un événement sont en format XML.
        WebSphere Business Events (XML)
        Les données d'un événement sont en format XML.
        Decision Server Insights Event (XML)
        Les données d'un événement sont en format XML.
    • Spécifiez les options suivantes pour un adaptateur de traitement d'événement personnalisé (programmé par l'utilisateur) :
      • Les valeurs possibles sont les suivantes :
        • En cas d'émission asynchrone, indiquez l'ID transaction de l'application CICS que vous avez programmée, qui permet de formater, d'acheminer et d'émettre l'événement. Vous devez indiquer un ID transaction pour l'émission asynchrone réalisée par l'adaptateur de traitement d'événement personnalisé.
        • En cas d'émission synchrone, indiquez le nom de l'application CICS que vous avez programmée, qui permet de formater, d'acheminer et d'émettre l'événement. Vous devez indiquer un ID de programme pour l'émission synchrone réalisée par l'adaptateur de traitement d'événement personnalisé.
      • Ecrivez les données à transférer vers l'adaptateur de traitement d'événement personnalisé. Votre adaptateur de traitement d'événement personnalisé traite ces données.
    • Spécifiez les options suivantes pour l'adaptateur de traitement d'événement HTTP :
      • Spécifiez la ressource URIMAP. Indiquez le nom de la ressource URIMAP qui représente la connexion au serveur HTTP 1.1.
      • Spécifiez un format de données pour l'événement. Sélectionnez l'une des valeurs suivantes dans la liste Format de données :
        Common Base Event (XML)
        Les événements sont envoyés à un serveur HTTP 1.1 au format Common Base Event, consommable par tous les produits prenant en charge l'infrastructure d'événement commune.
        Common Base Event REST (XML)
        Les événements sont envoyés à un serveur HTTP 1.1, dans le format XML requis par IBM Business Monitor.
        WebSphere Business Events (XML)
        Les événements sont envoyés à un serveur HTTP 1.1, dans le format XML requis par Composant Decision Server Events de IBM Operational Decision Manager.
        Decision Server Insights Event (XML)
        Les événements sont envoyés à un serveur HTTP 1.1, dans le format XML requis par le Composant Decision Server Insights de IBM Operational Decision Manager.
  5. Facultatif : Spécifiez toutes les options requises avancées pour le répartiteur. Ces options concernent les utilisateurs expérimentés et contrôlent l'exécution de l'adaptateur de traitement d'événement dans un système CICS.
    Remarque : Il est généralement plus efficace de laisser CICS exécuter l'adaptateur de traitement d'événement sous l'unité d'exécution du répartiteur. Vous pouvez cependant avoir besoin d'exécuter l'adaptateur de traitement d'événement en tant que transaction distincte ; par exemple, si vous devez l'exécuter sous un ID utilisateur spécifique disposant des droits d'écriture dans la file d'attente IBM MQ, ou si vous voulez définir le nombre de tâches d'adaptateur de traitement d'événement simultanées à l'aide des paramètres TRANCLASS.
    1. Indiquez le mode d'émission. Vous pouvez indiquer ASYNC ou SYNC pour indiquer comment les événements sont émis. Choisissez le mode d'émission synchrone pour une émission assurée d'événements. En mode d'émission synchrone, l'adaptateur de traitement d'événement de file d'attente IBM MQ émet les événements suivants :
      • Des événements transactionnels avec l'option MQPMO_SYNCPOINT. Les messages IBM MQ sont récupérables dans l'unité de travail de la transaction de capture.
      • Des événements non transactionnels à l'aide de l'option MQPMO_NO_SYNCPOINT.

      En mode d'émission asynchrone, l'adaptateur de traitement d'événement de file d'attente IBM MQ utilise l'option MQPMO_NO_SYNCPOINT pour émettre des événements.

      Remarques :
      • Pour les événements synchrones (émission assurée d'événements), l'application de capture d'événements doit disposer des droits d'écriture sur le transport de l'émission d'événement. Pour les événements asynchrones, l'adaptateur de traitement d'événement doit disposer des droits d'écriture.
      • L'indication de SYNC NONTRANS pour l'adaptateur de traitement d'événement HTTP transforme la transaction de capture en application Web qu'il pourra être nécessaire de reconfigurer en conséquence.
      • Définissez l'attribut DTIMOUT de la définition TRANSACTION pour toute transaction qui pourrait générer des événements synchrones à travers l'adaptateur de traitement d'événement HTTP.
    2. Indiquez la priorité de distribution. Vous pouvez spécifier la priorité Normale ou Elevée pour contrôler la façon dont le répartiteur d'événements traite les événements associés à cette liaison d'événements. Les événements affichant une priorité élevée sont émis dès leur mise à disposition en fonction du paramètre Les événements sont transactionnels. Les événements affichant une priorité normale sont émis dès leur mise à disposition en fonction du paramètre Les événements sont transactionnels, mais après les événements en attente affichant une priorité élevée.
      Remarque : Cette option ne s'applique pas au mode d'émission synchrone.
    3. Indiquez l'ID transaction et l'ID utilisateur. L'adaptateur est lancé avec l'ID transaction et l'ID utilisateur spécifiés. L'ID transaction n'est pas pertinent pour le type d'adaptateur de traitement d'événement personnalisé car il est défini dans la section Adaptateur. Selon les paramètres de l'ID transaction et de l'ID utilisateur, la tâche du répartiteur de traitement d'événement démarre ou se connecte au programme de l'adaptateur de traitement d'événement.
      Tableau 1. ID transaction et ID utilisateur pour l'adaptateur de traitement d'événement de file d'attente IBM MQ, de file d'attente de données provisoires, de file d'attente de serveur de transaction et Début de transaction
      ID transaction spécifié ID utilisateur spécifié Utiliser l'ID utilisateur de contexte L'adaptateur de traitement d'événement est L'adaptateur de traitement d'événement est exécuté avec L'ID transaction de l'adaptateur de traitement d'événement est
      x x   Connectée ID utilisateur spécifié ID transaction spécifié
      x   x Connectée ID utilisateur de contexte ID transaction spécifié
        x   Connectée ID utilisateur spécifié

      CEPQ pour l'adaptateur de traitement d'événement de file d'attente IBM MQ CEPR pour l'adaptateur de traitement d'événement de file d'attente TD
      CEPT pour l'adaptateur de traitement d'événement de file d'attente de serveur de transaction
      CEPS pour l'adaptateur de traitement d'événement Début de transaction

          x Connectée ID utilisateur de contexte

      CEPQ pour l'adaptateur de traitement d'événement IBM MQ CEPR pour l'adaptateur de traitement d'événement de file d'attente TD
      CEPT pour l'adaptateur de traitement d'événement de file d'attente de serveur de transaction
      CEPS pour l'adaptateur de traitement d'événement Début de transaction

      x     Connectée ID utilisateur par défaut CICS ID transaction spécifié
            Relié ID utilisateur de région CICS Non applicable
      Si la file d'attente IBM MQ, la file d'attente de données provisoires, la file d'attente de serveur de transaction ou la transaction que vous voulez démarrer est distante, voir la rubrique relative à la sécurité pour l'intercommunication pour des informations sur les paramètres de sécurité.
      Tableau 2. ID transaction et ID utilisateur pour l'adaptateur de traitement d'événement HTTP
      ID transaction spécifié ID utilisateur spécifié Utiliser l'ID utilisateur de contexte L'adaptateur de traitement d'événement est L'adaptateur de traitement d'événement est exécuté avec L'ID transaction de l'adaptateur de traitement d'événement est
      x x   Connectée ID utilisateur spécifié ID transaction spécifié
      x   x Connectée ID utilisateur de contexte ID transaction spécifié
        x   Connectée ID utilisateur spécifié CEPH
          x Connectée ID utilisateur de contexte CEPH
      x     Connectée ID utilisateur par défaut CICS ID transaction spécifié
            Connectée ID utilisateur par défaut CICS CEPH
      Pour l'adaptateur de traitement d'événement personnalisé (programmé par l'utilisateur) qui possède un ID transaction et un mode d'émission asynchrone, la tâche du répartiteur de traitement d'événement se connecte toujours à cet adaptateur avec l'ID utilisateur spécifié, l'ID utilisateur de contexte ou l'ID utilisateur par défaut CICS.
      Remarque : Ces deux options ne s'appliquent pas au mode d'émission synchrone.
    4. Spécifiez si les événements sont transactionnels. Cochez la case Les événements sont transactionnels si vous souhaitez que CICS capture les événements uniquement si l'unité de travail (UOW - Unit Of Work) associée à l'événement se termine correctement.
      Remarque : Etudiez avec soin la possibilité de définir ou non comme transactionnels les événements capturés à partir d'actions non récupérables. Supposons, par exemple, que vous capturiez un événement transactionnel à partir d'une commande WEB SEND et que l'unité de travail soit ensuite annulée. L'événement est annulé, mais la commande WEB SEND a pu provoquer l'envoi d'un message HTTP.

      Décochez la case Les évents sont transactionnels si vous souhaitez que CICS traite les événements associés à la liaison d'événements hors d'une transaction. Les événements sont émis au fur et à mesure de leur déroulement.

Résultats

Les informations sur l'adaptateur et le répartiteur relatives à votre liaison d'événements sont maintenant complètes.