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 liaisons d'événements CICS 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.

    Vous pouvez également choisir d'utiliser une ressource EPADAPTER prédéfinie ou une ressource EPADAPTERSET. Pour plus d'informations sur une ressource EPADAPTER prédéfinie, voir Editeur de configuration d'adaptateur de traitement d'événement (EP) dans le centre de documentation CICS TS 5.1. Pour plus d'informations sur une ressource EPADAPTERSET prédéfinie, voir Editeur de jeu d'adaptateurs de traitement d'événement (EP) dans le centre de documentation CICS TS 5.1.

    Si vous spécifiez une ressource EPADAPTER ou EPADAPTERSET prédéfinie, vous devez entrer le nom dans le champ Nom ou cliquer sur Choisir... pour sélectionner une ressource. Pour plus d'informations sur la sélection des ressources d'adaptateur, voir Sélection d'une ressource d'adaptateur de traitement d'événement dans le Centre de documentation CICS TS 5.1 et Sélection d'une ressource d'ensemble d'adaptateurs de traitement d'événement dans le Centre de documentation CICS TS 5.1.

  2. Facultatif : Vous pouvez exporter une ou plusieurs spécification d'événement dans cette liaison d'événements.
    Pour exporter une spécification d'événement, entrez le nom d'une ressource EPADAPTER prédéfinie ou sélectionnez l'adaptateur de votre choix :
    • Utilisez l'adaptateur de traitement d'événement TSQ ou WebSphere MQ et sélectionnez le format CFE afin d'émettre les événements sous forme binaire et de créer un fichier de stockage COBOL (.cpy).
    • Pour créer une définition de schéma XML (.xsd), utilisez tout autre adaptateur de traitement d'événement et tout autre format.
    Remarque : L'exportation de spécifications d'événement n'est pas prise en charge si vous utilisez un adaptateur de démarrage de transaction. Pour plus d'informations sur le format d'événement CICS basé sur conteneur, voir Formats de traitement d'événement dans le centre de documentation CICS TS 5.1.
    1. Cliquez sur Exporter des spécifications d'événement. Si vous utilisez une ressource EPADAPTER et que l'espace de travail comprend plus d'un adaptateur du même nom, vous êtes alors invité à en sélectionner un dans une liste. La fenêtre Exporter des spécifications d'événement s'affiche.
    2. Sélectionnez les spécifications d'événement à exporter.
    3. Pour exporter des spécifications d'événement, indiquez un répertoire dans la zone Vers le répertoire.
    4. Si vous utilisez une ressource EPADAPTER prédéfinie introuvable dans l'espace de travail, vous devez sélectionner une valeur appropriée dans le champ Format de données .
    5. Cliquez sur Exporter.
    Un fichier est créé dans le répertoire défini pour chaque spécification d'événement que vous avez sélectionnée.
    Voici quelques exemples de spécification d'événement :
    • Si vous spécifiez l'adaptateur de traitement d'événement WebSphere MQ et le format Common Base Event et que vous sélectionnez deux spécifications d'événement nommées exemple1 et exemple2, deux fichiers de schéma sont créés : exemple1_CBE.xsd et exemple2_CBE.xsd. Vous pouvez importer ces fichiers de schéma dans IBM® Business Monitor afin de définir un événement entrant.
    • Si vous spécifiez l'adaptateur de traitement d'événement WebSphere MQ et le format WebSphere Business Events (XML) et que vous sélectionnez une spécification d'événement nommée exemple1, un fichier de schéma XML, exemple1_WBE.xsd. Vous pouvez utiliser ce fichier de schéma dans l'outil WebSphere Business Events Design Data afin de définir un événement.
    • Si vous spécifiez l'adaptateur de traitement d'événement HTTP et le format Common Base Event REST et que vous sélectionnez deux spécifications d'événement nommées exemple1 et exemple2, deux fichiers de schéma XML sont créés : exemple1_CBER.xsd et exemple2_CBER.xsd. Vous pouvez importer ces fichiers de schéma dans IBM Business Monitor afin de définir un événement entrant.
    • Si vous spécifiez l'adaptateur de traitement d'événement HTTP et le format WebSphere Business Events (XML) et que vous sélectionnez une spécification d'événement nommée exemple1, un fichier de schéma XM exemple1_WBE.xsd. Vous pouvez utiliser ce fichier de schéma dans l'outil WebSphere Business Events Design Data afin de définir un événement entrant.
    • Si vous spécifiez l'adaptateur de traitement d'événement HTTP et le format Common Base Event REST et que vous sélectionnez deux spécifications d'événement nommées exemple1 et exemple2, deux fichiers de schéma XML sont créés : exemple1_CBE.xsd et exemple2_CBE.xsd. Vous pouvez importer ces fichiers de schéma dans n'importe quel consommateur acceptant le format CBE (Common Base Event) afin de définir un événement entrant.
    • Si vous spécifiez l'adaptateur de traitement d'événement de file d'attente TS et vous sélectionnez deux spécifications d'événement nommées exemple1 et exemple2, deux fichiers de stockage COBOL sont créés : exemple1.cpy et exemple2.cpy. Vous pouvez utiliser ces fichiers de stockage pour traiter des données dans vos propres programmes de consommation d'événements.

    Notez que si vous exportez une spécification d'événement et qu'ensuite vous exportez cette même spécification d'événement une nouvelle fois vers le même répertoire, l'Editeur de liaisons d'événements CICS vous invite à écraser le fichier existant ou à annuler l'opération d'exportation.

  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 de stockage temporaire
    Emet des événements vers une file d'attente TS CICS dans un des formats XML : Common Base Event, Common Base Event REST ou WebSphere Business Events (WBE) ; ou dans un format non 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 dont la lecture s'effectue à 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.
    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 de démarrage de transaction ne prend pas en charge l'émission assurée d'événement.
    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.
    WebSphere Message Queue
    Emet des événements vers une file d'attente de messages WebSphere au format XML pour la consommation par WebSphere Business Events, au format Common Base Event (CBE) pour IBM Business Monitor, ou dans un format non XML.
    Dans le cadre de l'émission assurée d'événement, la livraison est assurée lorsque l'adaptateur de traitement d'événement WebSphere MQ est utilisé en combinaison avec des files d'attente de messages persistants WebSphere.
    HTTP
    Emet des événements vers un serveur HTTP 1.1 à l'aide de HTTP POST au format XML pour la consommation par des produits tels que WebSphere Business Events, et 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 la file d'attente TS :
      • 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.
        WebSphere Business Events (XML)
        Les données d'un événement sont en format 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.
    • Spécifiez les options suivantes pour l'adaptateur de traitement d'événement de démarrage de transaction :
      • Indiquez l'ID de transaction de l'application CICS exécutée suite aux événements. Vous devez indiquez un ID de transaction.
      • Indiquez un ID utilisateur de transaction. La transaction initiée par l'adaptateur de traitement d'événement de démarrage 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 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 de 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 de 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 WebSphere MQ :
      • Indiquez le nom de la file d'attente de WebSphere 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 que l'adaptateur de traitement d'événement WebSphere MQ place dans la file d'attente ne sont pas permanents.
        Oui
        Les messages que l'adaptateur de traitement d'événement WebSphere MQ place dans la file d'attente sont permanents.
        Paramètres par défaut de la file d'attente
        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 WebSphere 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 WebSphere 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.
        WebSphere Business Events (XML)
        Les messages sont placés dans la file d'attente au format XML requis par WebSphere Business Events.
        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.
    • 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 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 WebSphere Business Events.
        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.
  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 WebSphere 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. Dans le cadre du mode d'émission synchrone, l'adaptateur de traitement d'événement WebSphere MQ émet les événements suivants :
      • Des événements transactionnels avec l'option MQPMO_SYNCPOINT. Les messages WebSphere 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.

      Dans le cadre du mode d'émission asynchrone, l'adaptateur de traitement d'événement WebSphere 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 EP 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 adaptateurs de traitement d'événement WebSphere MQ, de file d'attente TS et de démarrage 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 adaptateur de traitement d'événement WebSphere MQ
      CEPT pour adaptateur de traitement d'événement de file d'attente TS
      CEPS pour adaptateur de traitement d'événement démarrage de transaction

          x Connectée ID utilisateur de contexte

      CEPQ pour adaptateur de traitement d'événement WebSphere MQ
      CEPT pour adaptateur de traitement d'événement de file d'attente TS
      CEPS pour adaptateur de traitement d'événement de démarrage 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 WebSphere MQ, la file d'attente TS ou la transaction que vous souhaitez démarrer est distante, voir pour plus d'informations sur les paramètres de sécurité.
      Tableau 2. ID transaction et ID utilisateur pour adaptateur de traitement d'événement HTTP
      ID transaction spécifié ID utilisateur spécifié Utiliser l'ID utilisateur de contexte L'adaptateur EP est L'adaptateur EP est exécuté avec L'ID transaction de l'adaptateur EP 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.