Ajout d'une spécification de capture

Vous pouvez ajouter des spécifications de capture à une spécification d'événement pour créer des points de capture dans CICS.

Pourquoi et quand exécuter cette tâche

L'Editeur de liaisons d'événements CICS vous guide dans la création d'une ou de plusieurs spécifications de capture. Ces dernières identifient les éléments suivants :

Par exemple, vous pouvez spécifier qu'une commande de stockage temporaire READQ (stockage temporaire READ) est un événement potentiel. Précisez ensuite les conditions sous lesquelles l'événement se déclenche en ajoutant des prédicats des types disponibles pour la commande à intercepter.

Vous pouvez définir trois types de prédicats :
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.

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.

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.

Les informations de base sur la liaison d'événement, saisies par le gestionnaire métier au cours de la définition de haut niveau de la liaison d'événement, contiennent une spécification d'événement. Ces informations de liaison d'événement ont identifié les données requises pour un traitement plus approfondi, mais n'ont fourni aucun détail sur leur emplacement. Spécifiez des sources d'informations afin de pouvoir fournir ces détails.

L'Editeur de liaisons d'événements CICS permet d'afficher dans l'onglet Sources d'informations un tableau contenant les informations requises pour satisfaire la spécification métier. Ce tableau répertorie les informations métier relatives à la spécification d'événement. Pour chaque élément du tableau, vous devez définir la source d'informations pour la spécification de capture.

Procédure

  1. Dans l'onglet Spécification, cliquez sur une spécification d'événement. La sous-fenêtre de droite affiche les détails de la spécification d'événement mise en évidence.
  2. Cliquez sur Ajouter une spécification de capture. La fenêtre Ajouter une spécification de capture apparaît.
  3. Entrez un nom pour la nouvelle spécification de capture. Les caractères acceptables sont A-Z, a-z, 0-9, et _. Les interlignes et blancs imbriqués ne sont pas autorisés. La chaîne ne doit pas commencer par 0-9, _ ou par la chaîne "xml", que cette chaîne soit en minuscules, majuscules ou casse mixte, par exemple : "Xml" ou "xMl".
  4. Facultatif : Entrez ensuite une description pour cette spécification de capture.
  5. Cliquez sur OK. Une nouvelle spécification de capture est créée. et trois onglets s'ouvrent dans la sous-fenêtre de droite de l'éditeur : Point de capture, Filtrage et Sources d'informations. Chaque onglet permet de fournir des informations sur la nouvelle spécification de capture.
  6. Cliquez sur l'onglet Point de capture. Procédez comme suit pour ajouter des informations sur le point de capture :
    1. Sélectionnez la commande EXEC CICS à laquelle vous souhaitez ajouter un point de capture ou une initiation logicielle à partir de la liste Point de capture. Une initiation logicielle est un point de capture associé au démarrage d'un programme CICS.
    2. Cliquez sur Capturer avant ou Capturer après. Vous pouvez préciser si le point de capture doit être effectué avant ou après l'exécution des commandes EXEC CICS. Cette option est désactivée pour un sous-ensemble de ces commandes EXEC CICS.
  7. Cliquez sur l'onglet Filtrage. Procédez comme suit pour ajouter des informations sur le prédicat de la capture :
    1. Facultatif : Définissez le contexte d'application pour la spécification de capture. Les prédicats du contexte d'application disponibles s'affichent pour le point de capture que vous avez choisi. Sélectionnez une option pour l'opérateur, puis indiquez une valeur pour spécifier les prédicats. Un opérateur Tous indique qu'il n'existe aucun filtrage pour le prédicat associé. Entrez des valeurs pour ID de transaction, Programme en cours et ID utilisateur en majuscules.
    2. Facultatif : Définissez les options d'application pour la spécification de capture. Les options d'application disponibles pour le point de capture sélectionné s'affichent. Sélectionnez une option pour l'opérateur, puis indiquez une valeur pour spécifier les prédicats. Un opérateur Tous indique qu'il n'existe aucun filtrage pour le prédicat associé.

      Les options d'application pouvant servir de prédicats primaires sont indiquées par un astérisque (*). Vous devez sélectionner l'opérateur Egal et spécifier une valeur pour le prédicat primaire afin de maintenir les performances CICS. Par exemple, pour un point de capture PUT CONTAINER, vous devez spécifier une valeur pour l'option d'application CONTAINER* disponible.

    3. Facultatif : Définissez les données d'application pour la spécification de capture. Pour ajouter un prédicat aux données d'application, cliquez sur Ajouter. La fenêtre Prédicat des données d'application apparaît.

      Sélectionnez une option pour l'opérateur, puis indiquez une valeur pour le prédicat. Un opérateur Tous indique qu'il n'existe aucun filtrage pour le prédicat associé.

      Définissez la variable que vous souhaitez tester à l'aide du prédicat. Vous pouvez cliquer sur Sélectionner à partir d'une structure de langue importée et suivre les instructions dans Sélection de variables dans le code source importé, ou sélectionner un emplacement et un type et détailler la définition de la variable à l'aide des zones actives de l'écran. Seules ces zones obligatoires seront actives pour le type sélectionné. Par exemple, si vous sélectionnez le type Caractère, seules les zones Décalage, Longueur et Page de code sont actives.

  8. Cliquez sur l'onglet Sources d'informations. Procédez comme suit pour chacune des sources d'informations de la table afin de mapper la source d'information vers un élément de données disponible. Si aucune donnée métier ne doit être capturée dans l'événement, la table risque de ne contenir aucune source d'information.

    Vous n'avez pas à capturer de données, si ce n'est pas obligatoire.

    1. Cliquez deux fois sur une source d'information, ou sélectionnez-en une et cliquez sur Modifier. La fenêtre Source d'information d'un événement apparaît.
    2. Sélectionnez un élément de données disponible dans Contexte, Valeurs des données ou Données à longueur variable. Si vous sélectionnez un élément de données à longueur variable, vous pouvez cliquer sur Sélectionner à partir d'une structure de langue importée et suivre les instructions dans Sélection de variables dans le code source importé, ou sélectionner un emplacement et un type et détailler la définition de la variable à l'aide des zones actives de l'écran. Seules ces zones obligatoires seront actives pour le type sélectionné. Par exemple, si vous sélectionnez le type Caractère, seules les zones Décalage, Longueur et Page de code sont actives.

      La longueur de la source d'information peut être différente de celle de l'élément d'information métier émis. CICS renseigne ou tronque la valeur, le cas échéant.

Résultats

Vous venez de créer une spécification de capture. Vous pouvez également supprimer des spécifications de capture en cliquant sur Supprimer une spécification de capture dans l'onglet Point de capture, cliquez ensuite sur Oui pour confirmer.