Syntaxe des traces RAS1

Cette syntaxe est utilisée pour spécifier une trace RAS1 dans le fichier KppENV. Après avoir ajouté cette commande au fichier KppENV, vous devez arrêter et redémarrer l'espace adresse afin que la trace prenne effet. Cette dernière reste en vigueur pendant toute la durée de vie de l'espace adresse. Pour arrêter cette trace RAS1, vous devez modifier à nouveau le fichier KppENV et redéfinir le niveau de trace, et arrêter puis démarrer l'espace adresse.

La syntaxe de base des commandes de trace RAS1 pour le traçage d'erreur est la suivante :


>>-KBB_RAS1=classe_globale-+----------------------+-+----------------------+-->
                           '-(COMP:type_composant-' '-(ENTRY:point_entrée)-'   

>--+--------------------------+--------------------------------><
   '-(UNIT:nom_unité, classe)-'

où :

Paramètre	Description
`classe_globale`	Les messages qui affichent les données collectées via la méthode TakeSample peuvent être consultés en ajoutant la trace RAS1 (`UNIT:KRA OUTPUT`) ou (`UNIT:KRA ALL`) à l'instruction de trace de l'agent. `ERROR` : renvoie uniquement les messages d'erreur grave (valeur par défaut pour la plupart des applications). `STATE` (ST) : enregistre la condition ou le réglage en cours des indicateurs et des variables dans le processus. Si le traçage d'état est activé, vous pouvez visualiser l'état en cours des variables ou des indicateurs particuliers lors de l'exécution du processus. `FLOW` (FL) : entraîne la génération d'un message à un point d'entrée ou de sortie d'une fonction. `DETAIL` (DE) : génère un niveau de trace détaillé et prolixe. `INPUT` (IN) : enregistre les données créées au cours de l'exécution d'une API, fonction ou processus particulier. `ALL` : lorsque cette option est activée, tous les messages disponibles sont enregistrés, ce qui constitue une combinaison de toutes les autres formes de traçage.
COMP	Mot clé indiquant que cette trace doit inclure un type de composant. Le mot clé COMP permet de tracer des groupes de sous-programmes liés par fonction (ou composant). N'utilisez ce paramètre que si vous êtes invité à le faire par le service de support logiciel IBM®.
`type_composant`	Identificateur d'un type de composant. Si un représentant du service de support logiciel IBM vous invite à tracer un composant, le code de ce dernier vous sera fourni. N'utilisez ce paramètre que si vous êtes invité à le faire par le service de support logiciel IBM.
ENTRY	Mot clé utilisé pour restreindre un sous-programme de filtrage à un POINT D'ENTREE spécifique. Etant donné qu'un sous-programme peut avoir plusieurs points d'entrée, ce mot clé n'est pas destiné à être utilisé fréquemment, mais uniquement dans le cadre d'une demande explicite d'un représentant du service de support logiciel IBM.
`point_d'entrée`	Variable représentant le nom du point d'entrée. Si vous êtes invité à spécifier une valeur pour le mot clé ENTRY, un représentant du service de support logiciel IBM vous indiquera la valeur à spécifier pour `point_d'entrée`.
UNIT	Mot clé indiquant que cette trace doit inclure la collecte d'informations en utilisant l'unité de compilation entièrement ou partiellement qualifiée. Une correspondance est établie entre l'unité de compilation distribuée et l'unité de compilation spécifiée dans l'instruction RAS1. Lorsqu'une correspondance est trouvée, une entrée de trace est générée.
`nom_unité`	Variable représentant le nom de l'unité de compilation. Ce nom peut correspondre à tout élément lié au nom du fichier d'objet ou de l'unité de compilation. Dans la plupart des cas, ce nom définit le composant tracé. Cette valeur peut correspondre à l'un des composants définis dans le tableau 5, mais dans la plupart des cas elle correspond à l'identificateur de composant de l'agent de surveillance comportant trois caractères (ks3 pour OMEGAMON for Storage on z/OS, par exemple).
`classe`	Une des valeurs spécifiées pour la classe globale, mais comme elle est placée entre parenthèses, sa portée est réduite au nom_unité spécifié. Les valeurs admises sont les suivantes. Les abréviations valides sont indiquées entre parenthèses. `ERROR` (ER) : renvoie uniquement les messages d'erreur grave (valeur par défaut pour la plupart des applications). `STATE` (ST) : enregistre la condition ou le réglage en cours des indicateurs et des variables dans le processus. Si le traçage d'état est activé, vous pouvez visualiser l'état en cours des variables ou des indicateurs particuliers lors de l'exécution du processus. `FLOW` (FL) : entraîne la génération d'un message à un point d'entrée ou de sortie d'une fonction. `DETAIL` (DE) : génère un niveau de trace détaillé et prolixe. `INPUT` (IN) : enregistre les données créées au cours de l'exécution d'une API, fonction ou processus particulier. `ALL` : lorsque cette option est activée, tous les messages disponibles sont enregistrés, ce qui constitue une combinaison de toutes les autres formes de traçage.

Remarque :

La valeur par défaut pour tous les composants est KBB_RAS1=ERROR, ce qui signifie que seul le traçage d'erreur est activé.
Vous pouvez spécifier n'importe quelle combinaison de mots clés UNIT, COMP et ENTRY. Aucun d'entre eux n'est requis. Toutefois, la valeur RAS1 définie avec la classe globale s'applique à tous les composants.

Certains exemples de syntaxe de trace RAS1 sont présentés ci-dessous.

Exemple 1 : Traçage des demandes et des réponses dans Tivoli Enterprise Monitoring Server :

Pour afficher les demandes et les réponses émanant de Tivoli Enterprise Monitoring Server, spécifiez la trace suivante :

KBB_RAS1=ERROR (UNIT:KRA ST ERR)

Les valeurs d'unité ST et ERR indiquent que vous allez collecter les informations d'état et d'erreur pour le composant de structure d'agent (KRA).

Ce type de trace d'agent est utilisé uniquement si vous tentez de déboguer un problème spécifique car il augmente sensiblement le nombre de messages générés par l'agent. Avec ce type de trace, les messages comprennent un vidage détaillé de toutes les lignes de données de l'agent qui ont été filtrées, ce qui inclut les noms et les valeurs d'attribut, les noms de demande, les noms de table et l'intervalle de collecte. N'oubliez pas de désactiver cette forme de traçage qui consomme une grande quantité de ressources dès que vous avez fini d'exécuter la fonction de trace.

Exemple 2 : Traçage des incidents liés au contrôleur proxy et à l'agent distribué :

Depuis Tivoli Enterprise Monitoring Server, émettez les commandes suivantes pour tracer le contrôleur proxy et les incidents d'agent distribué de Tivoli Enterprise Monitoring Server :

KBB_RAS1=ERROR (COMP:KUX ST ER) (UNIT:KRA ALL) (UNIT:KDS FL)

Dans cet exemple :

KUX est un identificateur de composant qui vous est fourni par un représentant du service de support logiciel IBM afin de vous permettre de collecter les informations d'état et d'erreur relatives à ce composant.
KRA est le nom d'unité du composant de structure de l'agent. Toutes les informations de trace concernant ce composant sont en cours de capture.
KDS est le composant Tivoli Enterprise Monitoring Server et le flux (FL) de points d'entrée et de sortie qui transitent par ce composant est décrit sous la forme d'enregistrements écrits dans le journal RKLVLOG.

Les messages qui affichent les données collectées via la méthode TakeSample peuvent être consultés en ajoutant la trace RAS1 (UNIT:KRA OUTPUT) ou (UNIT:KRA ALL) à l'instruction de trace de l'agent.