Onglet Filtrage

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.
Image de l'onglet Filtrage.

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 :
  • Tous
  • Egal
Valeurs possibles pour l'opérateur Egal :
  • Ok
  • Pas Ok

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.