[z/OS]

Utilisation du traçage sur les adaptateurs locaux optimisés

WebSphere Application Server for z/OS propose une prise en charge du paramétrage des niveaux de trace des adaptateurs locaux optimisés pour vous assister dans l'application, la connexion ou le diagnostic de serveur. Vous pouvez définir le niveau de trace à trois niveaux pour capturer les données détaillées, brutes ou aucune donnée de trace. Ces données sont désignées comme des niveaux de trace 2, 1 et 0.

Avant de commencer

La prise en charge de trace dynamique dans les adaptateurs locaux optimisés propose plusieurs façons de définir ou de changer les niveaux de trace existants sans redémarrer le serveur. Par exemple :
  • Prédéfinir le traçage côté serveur dans les fichiers de propriétés. Cela vous permet d'avoir un ensemble de traçage défini lorsque le serveur est démarré de telle sorte que le traitement d'adaptateur local optimisé est immédiatement opérationnel avec le traçage activé. Vous pouvez utiliser WebSphere Application Server pour la console d'administration z/OS et la commande SETOLATRACEPROPS de modification du système pour désigner le fichier de propriétés et l'activer.
  • Définir le niveau de trace. Vous pouvez utiliser le fichier des propriétés de trace pour spécifier les niveaux de trace par défaut à l'échelle du serveur et les niveaux de trace individuels des connexions à enregistrer au niveau de l'adaptateur local optimisé. Le niveau de trace peut être défini sur 0, 1 ou 2 pour chaque entrée du fichier de propriétés.
  • Utiliser la commande z/OS de modification de l'opérateur SETOLATRACE afin de paramétrer un niveau de trace spécifique pour les enregistrements existants. La commande peut également définir le niveau de trace d'un nom d'enregistrement, d'un nom de travail ou d'un bloc de contrôle Registration Entry (RGE) spécifique dans l'espace de stockage contrôlé par le serveur.
  • Utiliser un astérisque (*) comme caractère générique dans le fichier de propriétés de trace et la commande de modification SETOLATRACE pour indiquer un paramétrage pour plusieurs groupes de connexion. La fonction de caractère générique peut définir plusieurs noms d'enregistrement dans le fichier de propriétés ou la valeur par défaut du système et peut définir plusieurs noms d'enregistrement et de travail dans la commande de modification SETOLATRCE.
  • Le développeur de logiciel d'une application utilisant les adaptateurs locaux optimisés peut également définir le traçage pour la durée de vie de la connexion du programme lorsque l'enregistrement est effectué en définissant les balises de traçage lors de l'appel vers BBOA1REG.

Pourquoi et quand exécuter cette tâche

Procédure

  1. Prédéfinissez les niveaux de trace. La prédéfinition des niveaux de trace vous permet de capturer les données de trace d'enregistrement et de connexion aussi rapidement que l'initialisation d'adaptateurs locaux optimisés. Vous êtes également préparé à suivre une activité pour les connexions qui ne sont pas encore enregistrées ; lorsque les enregistrements indiqués sont effectués, le traçage s'effectue automatiquement. Prédéfinissez les niveaux de trace de la manière suivante :
    1. Créez un fichier de propriétés de trace dans HFS. Ce fichier doit se trouver dans EBCDIC et doit être accessible par le démon WebSphere Application Server for z/OS.
      La syntaxe du fichier de propriétés de trace suit la syntaxe du fichier de propriétés WebSphere Application Server : <motclé>=<paramètre>. Dans ce cas, la propriété possède une syntaxe se présentant comme suit :
      <registration_name>=<trace_level>
      Où :

      <nom_enregistrement> est une chaîne alphanumérique

      <niveau_trace> est égal à 0, 1 ou 2

      Pour plus de clarté, vous pouvez utiliser une syntaxe de style guillemets simples ou doubles lors de l'indication du nom d'enregistrement, par exemple :
      MYREGNAME=1 "CICSREG"=2 'SHORTREG'=0 
      Vous pouvez également regrouper les enregistrements de même nom en une seule ligne en utilisant des astérisques comme caractères génériques, par exemple :
      REGNAME*=1 *NAME=2 "REG*NAME"=0
      Un caractère d'interlignage # indique le début d'un commentaire sauf s'il est dans une chaîne entre guillemets.
      Important :
      • Tout niveau de trace non valide est traité comme une valeur 0. Par exemple REGNAME=ALL est traité comme le niveau de trace 0.
      • Un nom d'enregistrement "*" est traité comme le niveau de trace par défaut, par exemple, si la valeur *=1 est spécifiée, la valeur par défaut pour tous les nouveaux enregistrements est un niveau de trace brut.
      • Le fichier de propriétés peut présenter un maximum de 1 024 spécifications de traçage.
      La commande SETOLATRACEPROPS émet un message de réponse qui affiche le nombre de définitions de trace traitées pour des enregistrements autres que la valeur par défaut du système.
    2. Créez une variable d'environnement WAS_DAEMON_ONLY_ola_trace_settings_file dans la console d'administration.
    3. Définissez la variable comme une chaîne pour le complet complet qualifié et le nom de fichier du fichier de propriétés de traçage dans HFS et activez la variable.
      Si cette variable d'environnement est définie et enregistrée dans la configuration WebSphere Application Server, le fichier de propriétés est traité lors de l'initialisation du serveur. Vous pouvez mettre à jour le fichier de propriétés de trace et activer les nouvelles définitions en exécutant la commande SETOLATRACEPROPS. Les nouvelles propriétés de traçage affectent alors les nouveaux enregistrements. La syntaxe est la suivante :
      F daemonname,SETOLATRACEPROPS 
      Avertissement : L'activation d'un fichier de propriétés des paramètres de traçage désactive toutes les propriétés de traçage actuellement actives.
  2. Modifiez les paramètres de traçage des connexions existantes. Pour les connexions actuelles utilisant les adaptateurs locaux optimisés, vous pouvez activer ou désactiver le traçage à l'aide de la commande de modification SETOLATRACE. Cette commande prend les formes suivantes :
    F servername,SETOLATRACE=tracelevel,REGNAME=namestring
    F servername,SETOLATRACE=tracelevel,JOBNAME=namestring
    F servername,SETOLATRACE=tracelevel,RGE=hexaddress
    Le niveau de trace peut être de 0, 1 ou 2 pour, dans l'ordre : aucun traçage, niveau brut de traçage et traçage détaillé.
    La chaîne nom indique le nom d'enregistrement ou de travail de l'enregistrement existant à modifier. Vous pouvez délimiter la chaîne nom à l'aide des guillemets simples ou doubles correspondants. De la même manière, vous pouvez utiliser un astérisque comme caractère générique pour modifier plusieurs travaux ou enregistrements de même nom. Un astérisque seul affecte chaque enregistrement existant. Vous pouvez désactiver tout le traçage des enregistrements actuels en utilisant l'une de ces commandes :
    F servername,SETOLATRACE=0,REGNAME=*
    F servername,SETOLATRACE=0,JOBNAME=*

    Dans les cas de figure où vous souhaitez cibler un enregistrement spécifique par l'adresse de l'entrée RGE dans l'espace de stockage contrôlé du serveur, vous pouvez utiliser la forme RGE=hexaddress de la commande. L'adresse hexadécimale est une chaîne sans guillemet de chiffres hexadécimaux. Cette approche est probablement une approche que l'équipe d'assistance d'IBM® vous conseille d'utiliser.

    La commande SETOLATRACE affiche un message de réponse indiquant combien d'enregistrements ont été affectés.

  3. Indiquez les paramètres de trace lors de l'enregistrement. Vous pouvez demander le traçage sous forme de code appelant l'API BBOA1REG à créer l'enregistrement dans l'adaptateur local optimisé. L'interface de BBOA1REG contient un paramètre appelé registerflags. Les paramètres de niveau de trace d'un enregistrement peuvent être modifiés en définissant une ou plusieurs des valeurs suivantes dans le paramètre registerflags :
    reg_flag_trcmod    EQU X'80000000' modify trace level 
    reg_flag_trcmore   EQU X'40000000' trace level=2        
    reg_flag_trcsome   EQU X'20000000' trace level=1 

    Paramétrez reg_flag_trcmod si vous souhaitez modifier les paramètres de traçage pour l'enregistrement. Si vous ne paramétrez pas cette balise, aucun changement apporté au paramètre de traçage n'est effectué et les valeurs par défaut du système ou les paramètres de traçage prédéfinis qui s'appliquent au nom d'enregistrement ou de travail sont utilisés.

    Paramétrez reg_flag_trcmore ou reg_flag_trcsome si vous souhaitez avoir un traçage détaillé ou un traçage de niveau brut. Le fait de laisser les deux valeurs paramétrées sur "off" implique aucun traçage, quel que soit le paramétrage des pré-définitions ou des valeurs par défaut.


Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tdat_usetraceinfoola
Nom du fichier : tdat_usetraceinfoola.html