L'onglet Filtrage de
l'Editeur de liaisons d'événements CICS permet de
définir des critères, des prédicats nommés pour capturer des événements.
Si vous
n'indiquez aucun prédicat, des événements sont émis chaque fois que le point de
capture choisi s'exécute sur le système
CICS cible.
Chaque prédicat contient des informations identifiant le prédicat, un opérateur et une valeur. Vous pouvez spécifier autant de
prédicats que nécessaire pour identifier la situation dans laquelle vous voulez que le point de capture
émette un événement. Les trois types de prédicat pouvant être spécifiés sont
Contexte, Options d'événement et
Données d'application.
Certains points de capture disposent d'un prédicat primaire. Un prédicat primaire est un prédicat pour lequel vous sélectionnez
Egal comme paramètre Opérateur et
fournit une valeur afin d'éviter tout impact sur les performances lors de
l'ajout de spécifications de capture supplémentaires à un point de capture.
Remarque : Les noms des modules CICS pouvant changer,
n'incluez pas de filtres contenant des noms de module DFH* dans les spécifications de
capture. L'éditeur de liaison d'événements CICS valide les entrées
utilisateur lors du codage de la plupart des modules DFH* sur le filtre de
programme en cours. Les utilisateurs peuvent coder uniquement DFH£*, DFH0*,
DFHW2FI, DFHW2TS, DFHMQBP0 ou DFHECID. De plus, DFHMIRR et DFHMIRS peuvent être codés
pour l'événement d'application LINK PROGRAM.
Contexte
Les prédicats de la spécification de capture permettent de
filtrer les données d'après le contexte du point de capture.
Chaque point de capture dispose d'éléments de contexte pour lesquels vous pouvez spécifier des prédicats, L'ID transaction en est un exemple. Tous les
prédicats de contexte disponibles sont affichés dans l'onglet Filtrage.
Les prédicats de contexte sont facultatifs. Cependant, l'ID de transaction ou le
programme en cours est généralement spécifié pour émettre des événements à partir
d'une application spécifique.
La zone Contexte permet de définir
des options de filtrage pour les événements. En fonction des autres informations
fournies dans l'Editeur de liaisons d'événements CICS,
toutes les zones ne s'appliquent pas. Les prédicats de contexte disponibles dépendent
du point de capture. Les prédicats susceptibles d'être spécifiés sont les suivants :
ID de transaction, programme en cours et ID utilisateur.
- ID transaction
- Options d'opérateur pour l'ensemble des points de capture :
- Tous
- Egal
- N'est pas égal
- Ne commence pas par
- Commence par
Autres options pour les points de capture d'application :
- Inférieur à
- Pas moins de
- Supérieur à
- Non supérieur à
- Programme en cours
- Options d'opérateur pour l'ensemble des points de capture :
- Tous
- Egal
- N'est pas égal
- Ne commence pas par
- Commence par
- Inférieur à
- Pas moins de
- Supérieur à
- Non supérieur à
- ID utilisateur
- Options d'opérateur pour l'ensemble des points de capture :
- Tous
- Egal
- N'est pas égal
- Ne commence pas par
- Commence par
Autres options pour les points de capture d'application :
- Inférieur à
- Pas moins de
- Supérieur à
- Non supérieur à
- Code réponse
- Options d'opérateur :
- Valeurs possibles pour l'opérateur Egal :
Options d'événement
Les prédicats de la spécification de capture permettent de filtrer les valeurs
des options d'événement pour une commande CICS ou un événement système.
Chaque point de capture peut avoir
des options d'événement pour lesquelles vous pouvez spécifier des prédicats. Certaines commandes ne disposent d'aucune option d'événement. Les
options d'événement correspondent aux options d'une commande EXEC ou d'un système d'événement CICS, par exemple, le nom MAP pour la commande SEND MAP. Le statut FROM_CONNECTST
est un exemple d'événement de statut de connexion DB2.
Toutes les valeurs des données
fixes disponibles pour le point de capture sont affichées dans l'onglet Filtrage. CICS connaît le format des options d'événement.
- Nom
- Nom de la spécification de capture.
- Opérateur
- Options d'opérateur pour l'ensemble des points de capture :
- Tous
- Egal
- N'est pas égal
- Ne commence pas par
- Commence par
Autres options pour les points de capture d'application :
- Tous
- Egal
- N'est pas égal
- Ne commence pas par
- Commence par
Autres options pour les points de capture système :
- Devient supérieur à
- Devient inférieur à
- Valeur
- Valeur que vous indiquez pour le prédicat.
- Les limites du prédicat d'options de commande d'application varient
en fonction de l'API CICS. Par exemple, TRANSID comprend 4 caractères, et CHANNEL
16. L'Editeur de liaisons d'événements CICS procède à
l'ajustement dynamique pour chaque type et affiche un message lorsque la valeur de
prédicat est trop longue ou trop courte.
Pour plus d'informations sur les options d'événement relatives aux appels
d'API CICS, voir Evénements d'application dans le centre de documentation CICS TS 5.1.
Pour plus
d'informations sur les options d'événement relatives aux événements système,
voir Evénements système dans le centre de documentation CICS TS 5.1 et
Onglet Sources d'information dans le centre de documentation CICS TS 5.1.
Données d'application
Les prédicats de la spécification de capture permettent
de filtrer les données d'application spécifiées dans une commande CICS.
Remarque : Vous ne pouvez pas ajouter de données d'application lorsqu'un point de capture DELETEQ TD ou DELETEQ TS est défini pour une spécification
de capture.
Les points de capture d'application peuvent avoir des valeurs de données de longueur variables
pour lesquelles vous pouvez spécifier des prédicats. Les données d'application correspondent aux options d'une commande EXEC CICS spécifique : par exemple, la zone FROM pour la commande SEND MAP. Toutes les valeurs des données variables disponibles pour la commande EXEC CICS de ce point de capture sont affichées dans l'onglet Filtrage.
Les prédicats de données d'application sont traités par CICS
dans l'ordre indiqué (d'abord le premier prédicat, puis le second, etc.).
Les données d'application sont utilisées pour les zones de stockage, telles que les COMMAREA ou les conteneurs,
transmis comme options de commandes CICS. CICS ne reconnaît pas
le format de ces zones, contrairement au programme d'application. Vous disposez probablement d'une description du langage source que vous pouvez importer pour décrire ce format.
Remarque : Les événements système n'utilisent
pas de données d'application.
- Emplacement
- Cette valeur dépend de l'appel d'API CICS.
- Exemples :
- Pour la commande EXEC CICS WRITE FILE(EXMPCAT), les valeurs possibles
pour l'emplacement sont FROM et RIDFLD.
- Pour la commande EXEC CICS INVOKE SERVICE(nom), les
valeurs possibles pour sont CHANNEL et SCOPE.
- Conteneur
- Permet d'indiquer un conteneur de canal CICS. Cette zone ne peut être
sélectionnée que lorsqu'un canal est spécifié pour les données d'application. Dans
le cas contraire, cette zone est désactivée.
- Décalage
- Indique la distance à partir du début des données.
Le décalage 0 correspond au début de la zone.
- Longueur
- Longueur de la zone, en octets. La valeur 0 correspond au filtrage de
l'ensemble des données de la zone ou du conteneur. Ceci s'avère utile, par exemple,
pour filtrer le contenu d'un conteneur, quelle que soit sa longueur.
- Opérateur
- Options d'opérateur :
- Tous
- Existe
- Egal
- N'est pas égal
- N'existe pas
- Commence par
- Ne commence pas par
- Inférieur à
- Pas moins de
- Supérieur à
- Non supérieur à
- Valeur
- Valeur que vous indiquez pour le prédicat.
- La longueur dépend du type de données ; par exemple, la longueur
maximale pour le type character est 255 caractères, tandis
que la longueur maximale pour le type unsigned halfword est de
5 avec une valeur comprise entre 0 et 65535.