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.
- 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.
- 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.
- 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.
- Sélectionnez les spécifications d'événement à exporter.
- Pour exporter des spécifications d'événement, indiquez un répertoire
dans la zone Vers le répertoire.
- 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 .
- 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.
- 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.
- 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.
- 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.
- 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.
- 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 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 transactionID 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 HTTPID 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.
- 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.