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
Procédure
- 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.
- Facultatif : Vous pouvez exporter une ou plusieurs spécification d'événement dans cette liaison d'événements.
- 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.
- 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.
- Les valeurs possibles sont les suivantes :
- 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.
- Spécifiez les options suivantes pour l'adaptateur de traitement d'événement de file
d'attente
IBM MQ :
- 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.
- 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.
- 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.
- 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.
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 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 transactionx 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 transactionx Connectée ID utilisateur par défaut CICS ID transaction spécifié Relié ID utilisateur de région CICS Non applicable 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. - 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.
- 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 :