Onglet Sources d'information

L'onglet Sources d'informations permet de définir l'emplacement d'obtention des informations métier émises à l'aide de la spécification de capture.

Cet onglet contient un tableau répertoriant les informations métier définies précédemment dans l'onglet Liaison d'événement. Vous devez indiquer les sources d'informations pour chaque information métier émise.

Avec cet onglet, mappez les éléments des informations métier associés à la spécification d'événement vers les éléments de données disponibles pour ce point de capture.

Onglet Sources d'informations

Les zones du tableau Sources d'informations récapitulent les options modifiées dans la sous-fenêtre Editer la source d'informations.

Boîte de dialogue Sources d'informations pour un point de capture d'application

Pour ouvrir la boîte de dialogue Sources d'informations relative à une source d'information, sélectionnez une source d'informations dans la table et cliquez sur Editer ou cliquez deux fois sur la source d'information.

L'exemple suivant présente la boîte de dialogue Sources d'informations si REWRITE est sélectionné pour un point de capture d'application.

Figure 1. Boîte de dialogue Sources d'informations pour un point de capture d'application
Boîte de dialogue Sources d'informations pour un point de capture d'application.

Zones de Données disponibles

La section Données disponibles contient les zones suivantes :
Contexte
Les zones de contexte permettent de capturer les données relatives au contexte de l'application. Les valeurs de contexte possibles sont les suivantes :
PROGRAM
TRANSID
USERID
Options d'événement
Les options d'événement permettent de capturer les valeurs des options d'une commande CICS. Ces options varient en fonction du point de capture spécifié.
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. Ces données varient en fonction du point de capture spécifié. Les options de formatage et d'importation de fichier de stockage ne sont disponibles dans la boîte de dialogue que lorsqu'un élément de données d'application est sélectionné dans la section Données disponibles.
En fonction des options sélectionnées dans la section Données disponibles, les zones suivantes sont disponibles dans la boîte de dialogue Sources d'informations :
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.

Cliquez sur Sélectionner dans la structure de langage importée si vous voulez importer une structure de langage. Vous pouvez ensuite sélectionner la zone à capturer à partir de la structure de langage. Avec cette méthode, le système renseigne automatiquement les zones Type, Décalage et Longueur. Vous pouvez également spécifier manuellement des valeurs pour ces zones Type, Décalage et Longueur.

Type
Indique le type de données du prédicat des données d'application. Les types de données disponibles sont les suivants :
  • Virgule flottante binaire
  • Caractère
  • Caractère à terminaison NULL
  • Virgule flottante décimale
  • Hexadécimal
  • Hexadécimal à terminaison NULL
  • Virgule flottante hexadécimale
  • Décimal condensé
  • Demi-mot signé
  • Mot entier signé
  • Demi-mot non signé
  • Mot entier non signé
  • Décimal non condensé
Décalage
Indique la distance à partir du début des données. Le décalage 0 correspond au début de la zone.
Longueur
Indique la longueur de la zone à capturer. La valeur 0 correspond à la capture de l'ensemble des données de la zone ou du conteneur. L'indication d'une longueur de valeur 0 a les effets suivants :
  • Pour les commandes API dans lesquelles la longueur de données est spécifiée (ou définie par défaut par le traducteur) dans un argument distinct de la commande API, l'ensemble du contenu de la zone de données ou du conteneur est capturé quelle que soit la longueur. Par exemple, si COMMAREA et LENGTH sont spécifiés dans une commande LINK, toutes les données sont capturées.
  • Pour les commandes API de capture des données sans argument de longueur, aucune donnée n'est capturée. Par exemple, si RIDFLD est spécifié dans une commande READ ou INTO dans une commande RECEIVE MAP, aucun argument de longueur n'est associé, par conséquent aucun octet de données n'est capturé.
Précision
Indiquez la précision des informations métier numériques et scientifiques. Cette zone n'est pas disponible pour les autres informations métier.
Page de code
Sélectionnez une page de code. Cette zone n'est pas disponible pour certaines informations métier, telles que les données d'application provenant d'une autre source. Pour plus d'informations sur les pages de code, voir Matériel de référence concernant le jeu de caractères codés.
Données statiques
Pour transmettre des données non modifiables au consommateur d'événement, vous pouvez spécifier des données statiques à associer à un événement. Vous pouvez définir des valeurs statiques pouvant comporter jusqu'à 255 caractères, espaces compris. Le jeu de caractères valide est le suivant :

0-9 A-Z a-z `¬¦!"£$%^&*()_+-={}:@~;'#<>?,./|

Boîte de dialogue Sources d'informations pour un point de capture système

Pour ouvrir la boîte de dialogue Sources d'informations relative à une source d'information, sélectionnez une source d'informations dans la table et cliquez sur Editer ou cliquez deux fois sur la source d'information. CICS reconnaît le format de l'ensemble des sources d'informations.

L'exemple suivant présente la boîte de dialogue Sources d'informations si FILE ENABLE est sélectionné pour un point de capture système.

Figure 2. Boîte de dialogue Sources d'informations pour un point de capture système
Boîte de dialogue Sources d'informations pour un point de capture système
La section Données disponibles contient les zones suivantes :
Contexte
Les zones de contexte permettent de capturer les données relatives au contexte du système. Les valeurs de contexte possibles sont les suivantes :
TRANSID
USERID
Données d'événement système
Les zones de données d'événement système permettent de capturer les données relatives à l'événement système. Ces données varient en fonction du point de capture spécifié.
Données statiques
Pour transmettre des données non modifiables au consommateur d'événement, vous pouvez spécifier des données statiques à associer à un événement. Vous pouvez définir des valeurs statiques pouvant comporter jusqu'à 255 caractères, espaces compris. Le jeu de caractères valide est le suivant :

0-9 A-Z a-z `¬¦!"£$%^&*()_+-={}:@~;'#<>?,./|

Les tables suivantes répertorient les zones disponibles dans la boîte de dialogue Sources d'informations en fonction du point de capture système sélectionné dans la sous-fenêtre Point de capture système de l'onglet Point de capture.

Sources d'informations pour DB2 CONNECTION STATUS

Tableau 1. Sources d'informations pour DB2 CONNECTION STATUS
Option Description
DB2ID

Si vous n'utilisez pas l'association de groupes, cette option renvoie le nom du sous-système DB2 auquel l'association CICS DB2 est connectée ou, si l'association CICS DB2 n'est pas connectée, le nom du sous-système DB2 précédemment spécifié auquel CICS doit se connecter.

Pour plus d'informations, voir DB2ID sous INQUIRE DB2CONN.

DB2GROUPID

Si vous utilisez l'association de groupes, cette option renvoie le nom d'un groupe de partage de données, ou d'un sous-groupe, des sous-systèmes DB2 spécifiés.

Pour plus d'informations, voir DB2GROUPID sous INQUIRE DB2CONN.

DB2RELEASE

Renvoie une valeur à 4 caractères indiquant la version et l'édition du sous-système DB2 auquel CICS est connecté.

Pour plus d'informations, voir DB2RELEASE sous INQUIRE DB2CONN.

FROM_CONNECTST
Chaîne de caractères représentant le statut de la connexion CICS DB2. Les valeurs possibles sont les suivantes :
  • CONNECTED
  • NOTCONNECTED
  • CONNECTING
  • DISCONNING

Pour plus d'informations, voir CONNECTST sous INQUIRE DB2CONN.

TO_CONNECTST
Chaîne de caractères représentant le statut de la connexion CICS DB2. Les valeurs possibles sont les suivantes :
  • CONNECTED
  • NOTCONNECTED
  • CONNECTING
  • DISCONNING

Pour plus d'informations, voir CONNECTST sous INQUIRE DB2CONN.

Sources d'informations pour FILE ENABLE STATUS

Tableau 2. Sources d'informations pour FILE ENABLE STATUS
Option Description
FILE

Indique le nom à 8 caractères du fichier faisant l'objet de la demande.

Pour plus d'informations, voir FILE sous INQUIRE FILE.

DSNAME

Renvoie le nom à 44 caractères de l'ensemble de données BDAM ou de l'objet VSAM associé à la définition FILE.

Pour plus d'informations, voir DSNAME sous INQUIRE FILE.

FROM_ENABLESTATUS
Chaîne de caractères indiquant si les programmes d'application peuvent accéder au fichier. Les valeurs possibles sont les suivantes :
  • DISABLED
  • DISABLING
  • ENABLED
  • UNENABLED
  • UNENABLING

Pour plus d'informations, voir ENABLESTATUS sous INQUIRE FILE.

TO_ENABLESTATUS
Chaîne de caractères indiquant si les programmes d'application peuvent accéder au fichier. Les valeurs possibles sont les suivantes :
  • DISABLED
  • DISABLING
  • ENABLED
  • UNENABLED
  • UNENABLING

Pour plus d'informations, voir ENABLESTATUS sous INQUIRE FILE.

OPENSTATUS
Chaîne de caractères indiquant si le fichier est ouvert, fermé ou dans un état transitionnel. Les valeurs possibles sont les suivantes :
  • CLOSED
  • CLOSEREQUEST
  • OPEN

Pour plus d'informations, voir OPENSTATUS sous INQUIRE FILE.

Sources d'informations pour FILE OPEN STATUS

Tableau 3. Sources d'informations pour FILE OPEN STATUS
Option Description
FILE

Indique le nom à 8 caractères du fichier faisant l'objet de la demande.

Pour plus d'informations, voir FILE sous INQUIRE FILE.

DSNAME

Renvoie le nom à 44 caractères de l'ensemble de données BDAM ou de l'objet VSAM associé à la définition FILE.

Pour plus d'informations, voir DSNAME sous INQUIRE FILE.

FROM_OPENSTATUS
Chaîne de caractères indiquant si le fichier est ouvert, fermé ou dans un état transitionnel. Les valeurs possibles sont les suivantes :
  • CLOSED
  • CLOSEREQUEST
  • OPEN

Pour plus d'informations, voir OPENSTATUS sous INQUIRE FILE.

TO_OPENSTATUS
Chaîne de caractères indiquant si le fichier est ouvert, fermé ou dans un état transitionnel. Les valeurs possibles sont les suivantes :
  • CLOSED
  • CLOSEREQUEST
  • OPEN

Pour plus d'informations, voir OPENSTATUS sous INQUIRE FILE.

ENABLESTATUS
Chaîne de caractères indiquant si les programmes d'application peuvent accéder au fichier. Les valeurs possibles sont les suivantes :
  • DISABLED
  • DISABLING
  • ENABLED
  • UNENABLED
  • UNENABLING

Pour plus d'informations, voir ENABLESTATUS sous INQUIRE FILE.

Sources d'information pour MESSAGE

Tableau 4. Sources d'information pour MESSAGE
Option Description
INSERTnn Spécifie la valeur de INSERTnn pour le message faisant l'objet de la demande, où nn représente un identificateur d'insertion compris entre 1 et 30.
MESSAGE_ID Indique le numéro à 9 caractères du message faisant l'objet de la demande.
MESSAGE_TEXT Spécifie le texte entier d'un message comme zone de sortie dans un événement. Utilisez cette option si vous voulez capturer un message entier. La longueur maximale du texte de message capturée est de 1024 octets. Si la longueur du message dépasse 1024 octets, le message est tronqué.
Remarque : tous les messages sont capturés dans la langue définie par le paramètre d'initialisation de système NATLANG, sauf les messages envoyés à la console CICS, qui sont capturés en anglais.

Sources d'informations pour TASK THRESHOLD

Tableau 5. Sources d'informations pour TASK THRESHOLD
Option Description
FROM_TASKS

Indique le nombre de tâches associées avant un événement.

TO_TASKS

Indique le nombre de tâches associées après un événement.

MAXTASKS

Renvoie le nombre maximal de tâches pouvant être distribuées simultanément dans ce système CICS.

Pour plus d'informations, voir MAXTASKS sous INQUIRE SYSTEM.

PERCENT_MAXTASKS

Spécifie le seuil franchi sous forme de pourcentage du nombre maximal de tâches.

Sources d'informations pour TRANCLASS TASK THRESHOLD

Tableau 6. Sources d'informations pour TRANCLASS TASK THRESHOLD
Option Description
TRANCLASS

Indique le nom à 8 caractères de la classe de transactions faisant l'objet de la demande. Si la classe fait partie des classes numérotées utilisées dans les versions antérieures de CICS, son nom est DFHTCLnn, où nn est le numéro de classe à 2 chiffres.

Pour plus d'informations, voir TRANCLASS sous INQUIRE TRANCLASS.

FROM_ACTIVE

Renvoie le nombre de tâches actives dans la classe de transaction avant un événement.

TO_ACTIVE

Renvoie le nombre de tâches actives dans la classe de transaction après un événement.

MAXACTIVE

Renvoie le nombre maximal de tâches pouvant être exécutées simultanément dans la classe de transaction.

Pour plus d'informations, voir MAXACTIVE sous INQUIRE TRANCLASS.

PERCENT_MAXACTIVE

Spécifie le seuil franchi sous forme de pourcentage du nombre maximal de tâches actives.

Sources d'informations pour UNHANDLED TRANSACTION ABEND

Tableau 7. Sources d'informations pour UNHANDLED TRANSACTION ABEND
Option Description
TRANSACTION

Indique l'ID de la transaction à l'origine de la fin anormale de transaction non gérée.

ABCODE

Indique le code de fin anormale de cliché de transaction à 4 caractères.

Pour plus d'informations, reportez-vous à la rubrique Ajout d'une spécification de capture.