[z/OS]

Fichier de classification de charge de travail

Le document de classification de charge de travail est un fichier XML commun qui classifie HTTP entrant, IIOP, MDB (message-driven bean), SIP (Session Initiation Protocol), l'adaptateur local optimisé et le travail de médiation pour le gestionnaire de charge de travail z/OS.

Remarques d'utilisation

Cette rubrique contient des exemples de fichiers de classification de charge de travail avec et sans attributs RAS (Reliability Availability and Serviceability (RAS). Les attributs RAS permettent d'appliquer la granularité RAS au niveau des demandes HTTP, des demandes IOP, des demandes MDB et des demandes de l'adaptateur local optimisé. Vous définissez ces attributs dans les éléments http_classification_info, iiop_classification_info, classificationentry, sib_classification_info, wmqra_classification_info et ola_classification_info dans le fichier de classification de charge de travail.

Vous utilisez le fichier de classification de charge de travail lorsque vous exécutez les tâches de classification de charge de travail z/OS d'activation de la granularité RAS au niveau de la demande.

Eléments requis

<?xml version="1.0" encoding="UTF-8"?>
Indique que le document de classification de la charge de travail doit être sauvegardé au format ASCII afin d'être traité par le serveur d'applications. Cette instruction est requise.
<!DOCTYPE Classification SYSTEM "Classifications.dtd">
Donne l'analyseur syntaxique XML avec le nom du document DTD fourni par le produit et qui valide le document de classification de la charge de travail. Le document de classification de la charge de travail que vous écrivez doit respecter les règles décrites dans ce DTD. Vous devez ajouter cette instruction au document de classification de la charge de travail.
Classification
<Classification schema_version="1.0">

Indique la racine du document de classification de la charge de travail. Chaque document de classification de la charge de travail doit commencer et terminer avec cet élément. L'attribut schema_version est requis. Le seul élément version_schéma pris en charge est 1.0. L'élément de Classification contient un ou plusieurs éléments InboundClassification. Pour le travail d'intégration de service entrant, l'élément de Classification peut aussi contenir jusqu'à deux éléments SibClassification. En cas de classification des messages entrants If pour livraison à des beans gérés par message à l'aide des spécifications d'activation du fournisseur de messagerie WebSphere MQ, l'élément de classification peut contenir un ou plusieurs éléments WMQRAClassification.

InboundClassification
<InboundClassification
type="iiop"
schema_version="1.0"
default_transaction_class="iiopdflt"
default_iiop_application_name="application"
default_iiop_module_name="module"
default_iiop_component_name="component"> 
</InboundClassification>

Utilisez les règles suivantes lorsque vous utilisez l'élément InboundClassification :

  • L'attribut type est requis. La valeur doit être internal, iiop, http, mdb, sip ou ola. Une seule occurrence d'un élément InboundClassification peut se trouver dans le document pour chaque type. Il peut y avoir jusqu'à cinq éléments InboundClassification dans un document. Il n'est pas nécessaire de spécifier les types suivant un certain ordre dans le document de classification.
  • L'attribut schema_version est requis. La valeur doit être fixée à 1.0.
  • L'attribut default_transaction_class doit être spécifié ; il définit de surcroît la classe de transaction par défaut pour les flux de travaux du type spécifié. La valeur de chaîne doit être une classe de transaction WLM valide, une chaîne de type null (telle que "") ou une chaîne qui comporte au maximum huit caractères d'espacement (telle que " ").
  • Les éléments InboundClassification ne peuvent être imbriqués. Chaque élément SibClassification doit se terminer avant que le prochain élément InboundClassification ou SibClassification ne puisse commencer.
  • L'attribut default_iiop_application_name est facultatif et définit le nom d'application par défaut pour les flux de travaux IIOP qui ne possèdent pas de nom d'application, de nom de module ou de nom de composant.
  • L'attribut default_iiop_module_name est facultatif et définit le nom de module par défaut pour les flux de travaux IIOP qui ne possèdent pas de nom d'application, de nom de modèle ou de nom de composant.
  • L'attribut default_iiop_component_name est facultatif et définit le nom de composant par défaut pour les flux de travaux IIOP qui ne possèdent pas de nom d'application, de nom de module ou de nom de composant.
  • Les demandes CORBA correspondent à un flux de travaux IIOP qui ne possède pas de nom d'application, de nom de module ou de nom de composant.
SibClassification
<SibClassification type="jmsra | destinationmediation" schema_version="1.0" default_transaction_class="value">

Utilisez les règles suivantes lorsque vous utilisez l'élément SibClassification :

  • L'attribut type est requis. La valeur doit être jmsra ou destinationmediation. Il doit exister au plus un élément SibClassification dans le document pour chaque type. Il n'est pas nécessaire de spécifier les types suivant un certain ordre dans le document de classification.
  • L'attribut schema_version est requis. La valeur doit être fixée à 1.0.
  • L'attribut default_transaction_class doit être spécifié ; il définit de surcroît la classe de transaction par défaut pour les flux de travaux du type spécifié. La valeur de chaîne doit être une classe de transaction WLM valide, une chaîne de type null (telle que "") ou une chaîne qui comporte au maximum huit caractères d'espacement (telle que " ").
  • Les éléments SibClassification ne peuvent pas être imbriqués. Chaque élément SibClassification doit s'achever avant que le prochain élément InboundClassification ou SibClassification puisse commencer.
WMQRAClassification
<WMQRAClassification schema_version=”1.0” default_transaction_class=”value”>
Les règles suivantes s'appliquent à l'élément de classification WMQRAClassification :
  • L'attribut schema_version est requis. La valeur doit être fixée à 1.0.
  • L'attribut default_transaction_class doit être spécifié ; il définit de surcroît la classe de transaction par défaut pour les flux de travaux du type spécifié. La valeur de chaîne doit être une classe de transaction WLM valide.
  • Les éléments WMQRAClassification ne peuvent pas être imbriqués. Tous les éléments WMQRAClassification doivent être terminés avant que d'autres éléments de classification puissent commencer.
Les règles et les instructions XML de classification des différents types de travaux sont similaires, mais la syntaxe diffère légèrement pour chacune des types. Pour plus d'informations sur la syntaxe de chaque type de travail, voir les sections suivantes :
InboundClassification
SibClassification
WMQRAClassification

Classification interne

L'élément InboundClassification ayant pour type d'attribut="internal" définit la section du document qui s'applique au travail interne, comme, par exemple, les demandes qui sont distribuées dans un servant et qui proviennent du contrôleur propriétaire. Vous trouverez ci-dessous un exemple de cet élément :

<InboundClassification 	type="internal" schema_version="1.0" 
                         default_transaction_class="value1">

Si un élément InboundClassification dont le type="internal" d'attribut n'est pas spécifié, le travail interne sera classifié à l'aide des règles spécifiées pour le travail IIOP.

Classification IIOP

L'élément InboundClassification ayant pour type d'attribut="iiop" définit la section du document qui s'applique à la classification IIOP. Vous trouverez ci-dessous un exemple de cet élément :

<InboundClassification 	type="iiop" schema_version="1.0" 
                         default_transaction_class="value1">
Vous pouvez classifier le travail IIOP dans les artefacts d'application Java™ Platform, Enterprise Edition (Java EE) suivants :
  • Nom de l'application

    Nom de l'application qui contient les beans enterprise. Il s'agit du nom d'affichage de l'application, qui peut ne pas être identique au nom du fichier .ear qui contient tous les artefacts.

  • Nom du module

    Nom du fichier Enterprise JavaBeans(EJB) .jar qui contient un ou plusieurs beans enterprise. Il peut y avoir plusieurs fichiers EJB .jar dans un fichier .ear.

  • Nom du composant

    Nom de l'EJB présent dans un module (ou un fichier EJB .jar). Il peut y avoir un ou plusieurs beans enterprise dans un fichier .jar.

  • Nom de la méthode

    Nom d'une méthode distante sur un EJB.

Classez le travail IIOP dans plusieurs applications à un de ces niveaux en utilisant l'élément iiop_classification_info.

iiop_classification_info
<iiop_classification_info 	transaction_class="value1"
                          application_name="value2"
                          module_name="value3"
                          component_name="value4"
                          method_name="value5"
                          description="value6" 
                          dispatch_timeout="value7"
                          queue_timeout_percent ="value8"
                          request_timeout="value9"
                          stalled_thread_dump_action="traceback"
                          cputimeused_limit="value11"
                          cputimeused_dump_action="traceback" 
                          dpm_interval="value13"
                          dpm_dump_action="traceback"
                          SMF_request_activity_enabled="1"
                          SMF_request_activity_timestamps="1"
                          SMF_request_activity_security="1"
                          SMF_request_activity_CPU_detail="1" 
                          classification_only_trace="1"
                          message_tag="value20">

Avec l'élément iiop_classification_info, vous pouvez créer des filtres en fonction des noms d'application, de module, de composant et de méthode pour affecter des valeurs TCLASS values, des attributs RAS ou les deux aux demandes entrantes. Utilisez les règles suivantes lorsque vous utilisez l'élément iiop_classification_info :

transaction_class
L'attribut transaction_class est facultatif. Si l'attribut n'est pas défini, il hérite de la classe de transaction de son parent. La valeur de chaîne doit être une classe de transaction WLM valide, une chaîne de type null (telle que "") ou une chaîne qui comporte au maximum huit caractères d'espacement (telle que " "). En définissant une chaîne de type null ou vide, il est possible de remplacer un paramètre TCLASS par défaut ou un paramètre TCLASS établi par un filtre d'un niveau plus élevé. Définir une chaîne de type null ou vide signifie que vous ne disposez pas de valeur TCLASS pour la requête.
application_name, module_name, component_name et method_name
Les attributs nom_application, nom_module, nom_composant, et nom_méthode peuvent être utilisés à tout moment. Ces attributs jouent le rôle de sélecteurs ou de filtres qui attribuent une classe de transaction ou bien qui permettent à un élément iiop_classification_info imbriqué d'attribuer la classe de transaction. Vous pouvez définir les valeurs des ces attributs des manières suivantes :
  • Le nom exact de l'application, du module, du composant ou de la méthode.
  • Valeur à caractère générique. Vous pouvez placer un astérisque (*) n'importe où dans une chaîne pour indiquer que toute chaîne commençant par la suite de caractères qui précède cet astérisque et se terminant par la suite de caractères qui suit cet astérisque doit être considérée comme une correspondance. Si l'astérisque est à la fin de la chaîne, toute chaîne commençant par la suite de caractères qui précède cet astérisque est considérée comme une correspondance.
    Exemples :
    • Si vous spécifiez Mar*61, les chaînes Mar61, March61 et Mar20early61 seront considérées comme concordantes, mais pas la chaîne March81 ou MAR61.
    • Si vous spécifiez MAR*, les chaînes MARCH, MAR61 et MARS seront considérées comme concordantes, mais pas la chaîne Mar61 ou MAY61.
    Eviter les incidents Eviter les incidents: Les comparaisons de valeurs exécutées sont sensibles à la casse.gotcha

Vous pouvez utiliser toute combinaison de ces attributs pour créer un filtre de classification. Toutefois, utilisez uniquement la granularité nécessaire. Par exemple, si une seule application se trouve sur le serveur d'applications, il n'est pas nécessaire que les règles de classification définissent l'attribut nom_application.

Attributs RAS

Vous pouvez définir les attributs RAS suivants dans l'élément iiop_classification_info. Les éléments imbriqués héritent des attributs RAS de l'élément parent. Les éléments imbriqués peuvent remplacer les attributs RAS d'un élément parent. Tous les attributs RAS sont facultatifs.

dispatch_timeout

Définit le délai d'attente d'une région de contrôle après la distribution d'une demande à la file d'attente WLM. Si la région de contrôle ne reçoit pas de réponse dans le temps imparti, elle émet un dépassement de délai d'attente. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur control_region_wlm_dispatch_timeout.

queue_timeout_percent

Définit le délai d'attente de la file d'attente WLM sous la forme d'un pourcentage du délai de distribution. La plage de pourcentages est 0 - 99. Le délai d'attente de la file d'attente est le délai de séjour d'une demande dans la file d'attente WLM avant son expiration. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur control_region_iiop_queue_timeout.

request_timeout

Définit le délai en secondes appliqué aux demandes entrantes provenant des demandes distribuées. La demande distribuée est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur com.ibm.CORBA.RequestTimeout.

stalled_thread_dump_action

Définit l'action de vidage que le serveur exécute lorsque les demandes dépassent le délai de distribution défini dans l'attribut dispatch_timeout. La demande est une demande que l'élément de classification a classifié. Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_iiop_stalled_thread_dump_action.

cputimeused_limit

Définit le délai d'attente UC en millisecondes. Le délai d'attente UC est le délai UC autorisé pour la demande avant l'expiration de la demande. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur server_region_request_cputimeused_limit.

cputimeused_dump_action

Définit l'action de vidage que le serveur exécute lorsque les demandes dépassent le délai d'attente UC défini dans l'attribut cputimeused_limit. La demande est une demande que l'élément de classification a classifié.

Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_cputimeused_dump_action.

dpm_interval

Définit l'intervalle DPM (Dispatch Progress Monitor) en secondes. Le moniteur DPM déclenche l'action de vidage DPM dans l'intervalle des demandes que l'élément de classification a classifié. Définissez l'action de vidage DMP dans l'attribut dpm_dump_action.

L'attribut ne remplace aucune des propriétés de serveur. Vous devez utiliser la commande de modification pour activer les intervalles DPM côté serveur.

dpm_dump_action

Définit l'action de vidage DPM exécutée à chaque intervalle DPM pour les demandes que l'élément de classification classifie. Définissez l'intervalle DPM dans l'attribut dpm_interval.

Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_dpm_dump_action.

SMF_request_activity_enabled

Indique si les neuf enregistrements de sous-type SMF 120 (System Management Facilities) sont collectés pour les demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_enabled.

SMF_request_activity_timestamps

Indique si les horodatages doivent être formatés dans une forme lisible par l'utilisateur dans les 9 enregistrements de sous-type SMF 120 pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_timestamps.

SMF_request_activity_security

Indique si la section des données de sécurité des 9 enregistrements de sous-type SMF 120 sont collectées pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_security.

SMF_request_activity_CPU_detail

Indique si la section de ventilation d'utilisation UC des 9 enregistrements de sous-type SMF est collectée pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_CPU_detail.

classification_only_trace

Indique s'il est nécessaire de tracer les enregistrements pour les demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut ne remplace aucune des propriétés de serveur. La commande de modification TRACERECORD remplace classification_only_trace.

Si pour un élément de classification classification_only_trace a la valeur 1, le suivi au niveau de la classification est active sur le serveur d'applications. Les seules unités d'exécution qui génèrent des enregistrements de trace sont les unités d'exécution qui traitent les demandes que classifie l'élément de classification. L'élément de classification doit définir classification_only_trace="1". La collecte de traces pour les unités d'exécution qui ne traitent pas ces demandes est désactivée et elle ne génère pas d'enregistrements de trace.

Si aucun élément de classification définit classification_only_trace="1", le traçage au niveau de la classification n'est pas en vigueur pour le serveur d'applications. Le serveur ne désactive pas la collecte des traces pour les unités d'exécution. Tous les enregistrements de trace sont écrits dans la sortie, comme l'indique la spécification de trace.

L'attribut classification_only_trace n'affecte pas la définition et l'activation de la spécification de trace. L'attribut affecte uniquement les unités d'exécution qui écrivent les enregistrements de traces.

message_tag

Définit un jeton de type chaîne qui est écrit dans tous les enregistrements de trace, les messages des journaux et les messages système générés pour les demandes que classifie l'élément de classification.

L'attribut contient huit caractères maximum.

L'attribut ne remplace pas les propriétés de serveur.

Filtres de classification
  • Les éléments info_classification_iiop peuvent être imbriqués de façon hiérarchique. En imbriquant les éléments, vous pouvez créer des filtres de classification basés sur les valeurs d'attributs. Le filtre suivant classe les requêtes sur les beans enterprise EJB1 et EJB2 se trouvant dans l'application MyAPP1 :
    <iiop_classification_info transaction_class="FAST"
                              application_name="MyAPP1"
                              component_name="EJB1" />
    <iiop_classification_info transaction_class="SLOW"
                              application_name="MyAPP1"
                              component_name="EJB2" />

    Le filtre suivant classe également les requêtes sur EJB1 et EJB2 dans l'application MyAPP1 mais il classe en plus les requêtes sur tous les autres EJB dans l'application :

    <iiop_classification_info transaction_class="MEDIUM"
                              application_name="MyAPP1">
         <iiop_classification_info transaction_class="FAST"
                                   component_name="EJB1" />
         <iiop_classification_info transaction_class="SLOW"
                                   component_name="EJB2" />
    </iiop_classification_info>
  • Si vous définissez une valeur d'attribut qui entre en conflit avec la valeur d'attribut de l'élément parent, le filtre de bas niveau est rejeté. Exemple de valeur enfant qui entre en conflit avec la valeur d'attribut de l'élément parent :
    <iiop_classification_info transaction_class="FAST"
                              application_name="MyAPP1">
         <iiop_classification_info transaction_class="SLOW"
                                   application_name="MyAPP2" />
    </iiop_classification_info>

    Dans cet exemple, les demandes EJB dans MyAPP2 ne sont jamais affectées à la classe de transaction "SLOW", car le filtre de niveau supérieur permet uniquement de transmettre les demandes IIOP de application_name="MyAPP1" via le filtre de niveau inférieur.

  • Le premier filtre se trouvant à un niveau spécifique qui correspond aux attributs de la requête est utilisé, et non le meilleur filtre ou le filtre le plus restrictif. C'est pourquoi l'ordre dans lequel vous spécifiez les filtres est important.
    <iiop_classification_info transaction_class="FAST"
                              application_name="MyAPP" />
         <iiop_classification_info transaction_class="SLOW"
                                   component_name="*" />
         <iiop_classification_info transaction_class="MEDIUM"
                                   component_name="MySSB" />
    </iiop_classification_info>								

    Dans l'exemple précédent, toutes les requêtes IIOP traitées par les beans enterprise dans l'application MyAPP reçoivent la valeur TCLASS de SLOW. Cette affectation est effectuée également pour les demandes vers MySSB enterprise. Même si MySSB se voit attribuer une classe de transaction, le filtre n'est pas appliqué car le premier filtre s'est vu appliquer et attribuer une valeur TCLASS de SLOW. La liste de filtres restante au même niveau est ignorée.

  • La zone de description est facultative. Cependant, vous devez utiliser une description sur tous les éléments iiop_classification_info. La chaîne de description s'imprime dans le cadre du support de commande d'opérateur pour que vous puissiez identifier les règles de classification utilisées. Utilisez des descriptions d'une longueur relativement courte car elles s'affichent dans la console MVS.

Classification HTTP

L'élément InboundClassification avec le type d'attribut="http" définit la section du document qui s'applique à la classification HTTP. Vous trouverez ci-dessous un exemple de cet élément :

<InboundClassification  	type="http"
                        schema_version="1.0"
                        default_transaction_class="value1">
Le travail HTTP peut être classé sur la base des artefacts J2EE suivants :
  • Nom d'hôte virtuel

    Définit le nom d'hôte dans l'en-tête HTTP auquel la requête entrante est envoyée.

  • Numéro du port

    Définit le port sur lequel le serveur catcher HTTP effectue l'écoute.

  • Identificateur URI (Uniform Resource Identifier)

    Il s'agit de la chaîne qui identifie l'application web.

Vous pouvez classer le travail HTTP dans différentes applications à un de ces niveaux en utilisant l'élément http_classification_info.
<http_classification_info transaction_class="value1"
                          host="value2"
                          port="value3"
                          uri="value4"
                          description="value5"
                          dispatch_timeout="value6"
                          queue_timeout_percent ="value7"
                          request_timeout="value8"
                          stalled_thread_dump_action="traceback"
                          cputimeused_limit="value10"
                          cputimeused_dump_action="traceback" 
                          dpm_interval="value12"
                          dpm_dump_action="traceback"
                          SMF_request_activity_enabled="1"
                          SMF_request_activity_timestamps="1"
                          SMF_request_activity_security="1"
                          SMF_request_activity_CPU_detail="1"
                          classification_only_trace="1"
                          message_tag="value19"
                          timeout_recovery="value20">

Avec l'élément http_classification_info, vous pouvez créer des filtres en fonction de l'hôte, du port et de l'identificateur URI pour affecter des valeurs TCLASS, des attributs RAS ou les deux aux demandes entrantes. Utilisez les règles suivantes lorsque vous utilisez l'élément http_classification_info :

transaction_class
L'attribut transaction_class est facultatif. Si l'attribut n'est pas défini, il hérite de la classe de transaction de son parent. La valeur de chaîne doit être une classe de transaction WLM valide, une chaîne de type null (telle que "") ou une chaîne qui comporte au maximum huit caractères d'espacement (telle que " "). En définissant une chaîne de type null ou vide, il est possible de remplacer un paramètre TCLASS par défaut ou un paramètre TCLASS établi par un filtre d'un niveau plus élevé. Définir une chaîne de type null ou vide signifie que vous ne disposez pas de valeur TCLASS pour la requête.
host, port et uri
Les attributs host, port et l'uri peuvent être utilisés en fonction des besoins. Ces attributs jouent le rôle de sélecteurs ou de filtres qui attribuent une classe de transaction ou bien qui permettent à un élément http_classification_info imbriqué d'attribuer la classe de transaction. Vous pouvez définir les valeurs des ces attributs des manières suivantes :
  • Nom exact de l'hôte, du port ou de l'identificateur URI.
  • Toute valeur. Pour définir une correspondance avec n'importe quelle valeur, utilisez le symbole astérisque (*).
  • Valeur à caractère générique. Vous pouvez placer un astérisque (*) n'importe où dans une chaîne pour indiquer que toute chaîne commençant par la suite de caractères qui précède cet astérisque et se terminant par la suite de caractères qui suit cet astérisque doit être considérée comme une correspondance. Si l'astérisque est à la fin de la chaîne, toute chaîne commençant par la suite de caractères qui précède cet astérisque est considérée comme une correspondance.
    Exemples :
    • Si vous spécifiez Mar*61, les chaînes Mar61, March61 et Mar20early61 seront considérées comme concordantes, mais pas la chaîne March81.
    • Si vous spécifiez MAR*, les chaînes MARCH, MAR61 et MARS seront considérées comme concordantes, mais pas la chaîne Mar61 ou MAY61.
    Eviter les incidents Eviter les incidents: Les comparaisons de valeurs exécutées sont sensibles à la casse.gotcha

Utilisez certains ou tous les attributs pour créer un filtre de classification. N'utilisez que la granularité demandée. Par exemple, si une seule application se trouve sur le serveur d'applications, les règles de classification n'ont pas besoin de définir l'attribut uri.

Attributs RAS :

Vous pouvez définir les attributs RAS suivants dans l'élément http_classification_info. Les éléments imbriqués héritent des attributs RAS de l'élément parent. Les éléments imbriqués peuvent remplacer les attributs RAS d'un élément parent. Tous les attributs RAS sont facultatifs.

dispatch_timeout

Définit le délai d'attente d'une région de contrôle après la distribution d'une demande à la file d'attente WLM. Si la région de contrôle ne reçoit pas de réponse dans le temps imparti, elle émet un dépassement de délai d'attente. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace les propriétés de serveur suivantes :
HTTP
protocol_http_timeout_output
HTTPS
protocol_https_timeout_output
queue_timeout_percent

Définit le délai d'attente de la file d'attente WLM sous la forme d'un pourcentage du délai de distribution. La plage de pourcentages est 0 - 99. Le délai d'attente de la file d'attente est le délai de séjour d'une demande dans la file d'attente WLM avant son expiration. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace les propriétés de serveur suivantes :
HTTP
control_region_http_queue_timeout_percent
HTTPS
control_region_https_queue_timeout_percent
request_timeout

Définit le délai en secondes appliqué aux demandes entrantes provenant des demandes distribuées. La demande distribuée est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur com.ibm.CORBA.RequestTimeout.

stalled_thread_dump_action

Définit l'action de vidage que le serveur exécute lorsque les demandes dépassent le délai de distribution défini dans l'attribut dispatch_timeout. Il s'agit d'une requête classée par l'élément de classification. Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace les propriétés de serveur suivantes :
HTTP
server_region_http_stalled_thread_dump_action
HTTPS
server_region_https_stalled_thread_dump_action
cputimeused_limit

Définit le délai d'attente UC en millisecondes. Le délai d'attente UC est le délai UC autorisé pour la demande avant l'expiration de la demande. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur server_region_request_cputimeused_limit.

cputimeused_dump_action

Définit l'action de vidage que le serveur exécute lorsque les demandes dépassent le délai d'attente UC défini dans l'attribut cputimeused_limit. La demande est une demande que l'élément de classification a classifié.

Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_cputimeused_dump_action.

dpm_interval

Définit l'intervalle DPM (Dispatch Progress Monitor) en secondes. Le moniteur DPM déclenche l'action de vidage DPM dans l'intervalle des demandes que l'élément de classification a classifié. Définissez l'action de vidage DMP dans l'attribut dpm_dump_action.

L'attribut ne remplace aucune des propriétés de serveur. Vous devez utiliser la commande de modification pour activer les intervalles DPM côté serveur.

dpm_dump_action

Définit l'action de vidage DPM exécutée à chaque intervalle DPM pour les demandes que l'élément de classification classifie. Définissez l'intervalle DPM dans l'attribut dpm_interval.

Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_dpm_dump_action.

SMF_request_activity_enabled

Indique si les neuf enregistrements de sous-type SMF 120 (System Management Facilities) sont collectés pour les demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_enabled.

SMF_request_activity_timestamps

Indique si les horodatages doivent être formatés dans une forme lisible par l'utilisateur dans les 9 enregistrements de sous-type SMF 120 pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_timestamps.

SMF_request_activity_security

Indique si la section des données de sécurité des 9 enregistrements de sous-type SMF 120 sont collectées pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_security.

SMF_request_activity_CPU_detail

Indique si la section de ventilation d'utilisation UC des 9 enregistrements de sous-type SMF est collectée pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_CPU_detail.

classification_only_trace

Indique s'il est nécessaire de tracer les enregistrements pour les demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut ne remplace aucune des propriétés de serveur. La commande de modification TRACERECORD remplace classification_only_trace.

Si pour un élément de classification classification_only_trace a la valeur 1, le suivi au niveau de la classification est active sur le serveur d'applications. Les seules unités d'exécution qui génèrent des enregistrements de trace sont les unités d'exécution qui traitent les demandes que classifie l'élément de classification. L'élément de classification doit définir classification_only_trace="1". La collecte de traces pour les unités d'exécution qui ne traitent pas ces demandes est désactivée et elle ne génère pas d'enregistrements de trace.

Si aucun élément de classification définit classification_only_trace="1", le traçage au niveau de la classification n'est pas en vigueur pour le serveur d'applications. Le serveur ne désactive pas la collecte des traces pour les unités d'exécution. Tous les enregistrements de trace sont écrits dans la sortie, comme l'indique la spécification de trace.

L'attribut classification_only_trace n'affecte pas la définition et l'activation de la spécification de trace. L'attribut affecte uniquement les unités d'exécution qui écrivent les enregistrements de traces.

message_tag

Définit un jeton de type chaîne qui est écrit dans tous les enregistrements de trace, les messages des journaux et les messages système générés pour les demandes que classifie l'élément de classification.

L'attribut contient huit caractères maximum.

L'attribut ne remplace pas les propriétés de serveur.

timeout_recovery

Définit l'action que le serveur exécute lorsqu'une demande classifiée par l'élément de classification dépasse le délai d'attente de distribution. Définissez l'intervalle dispatch dans l'attribut dispatch_timeout.

Les valeurs valides sont servant et session.

Lorsque l'attribut a la valeur servant, l'espace adresse de serviteur qui traite la demande se termine avec un par ABEND EC3 et un code anomalie 04130007. L'espace adresse de contrôleur envoie une réponse d'échec au client, puis ferme le socket associé à la demande.

Lorsque l'attribut a la valeur session, l'espace adresse de contrôleur envoie une réponse d'échec au client, puis ferme le socket associé à la demande. L'espace adresse de serviteur n'est pas fermé. La demande n'est pas perturbée, mais elle est autorisée à s'exécuter complètement.

L'attribut remplace les propriétés de serveur suivantes :
HTTP
protocol_http_timeout_output_recovery
HTTPS
protocol_https_timeout_output_recovery

Filtres de classification :

  • Les éléments http_classification_info peuvent être imbriqués de façon hiérarchique. Vous pouvez construire des filtres basés sur des noms d'attributs. Observons les deux filtres suivants :
    <http_classification_info transaction_class="FAST"
                              host="MyVHost1.com"
                              uri="/MyWebApp1/*" />
    <http_classification_info transaction_class="SLOW"
                              host="MyVHost2.com"
                              uri="/MyWebApp2/*" />
    <http_classification_info transaction_class="MEDIUM"
                              host="MyVHost1.com">
         <http_classification_info transaction_class="FAST"
                                   uri="/MyWebApp1/*" />
         <http_classification_info transaction_class="SLOW"
                                   uri="/MyWebApp2/*" />
    </http_classification_info>

    Les deux filtres classent les requêtes envoyées aux applications web qui sont identifiées par les racines de contexte /MyWebApp1 et /MyWebApp2 se trouvant dans le serveur d'applications qui héberge les applications web pour l'hôte virtuel MyVHost1.com. Cependant, le second filtre classe également les requêtes sur n'importe quelle autre racine de contexte dans le serveur d'applications.

  • La définition d'un nom d'attribut différent de la valeur de l'élément parent empêche d'utiliser filtre de niveau intérieur. Pär exemple,
    <http_classification_info transaction_class="FAST"
                              uri="/MyWebApp1/*">
         <http_classification_info transaction_class="SLOW"
                                   uri="/MyWebApp2">
         </http_classification_info>
    </http_classification_info>

    Cet exemple ne pourrait aboutir à des applications web avec une racine de contexte de /MyWebApp2 attribuée à la classe de transaction SLOW. Le filtre de niveau supérieur permet uniquement d'envoyer les demandes HTTP avec la racine de contexte /MyWebApp1/* à un filtre de niveau inférieur.

  • Le premier filtre se trouvant à un niveau spécifique est utilisé, et non le meilleur filtre ou le filtre le plus restrictif. C'est pourquoi l'ordre des filtres à chaque niveau est important. Par exemple :
    <http_classification_info transaction_class="FAST"
                              host="MyVHost.com" />
         <http_classification_info transaction_class="SLOW"
                                   uri="*" />
         <http_classification_info transaction_class="MEDIUM"
                                   uri="/MyWebAppX/*" />
    </http_classification_info>

    Dans cet exemple, les demandes HTTP traitées par le serveur d'applications par l'hôte virtuel "MyVHost.com" se voient attribuer une valeur TCLASS de SLOW. Même les requêtes envoyées à l'application web avec racine de contexte /MyWebAppX se voient attribuer une valeur TCLASS de SLOW car le filtre n'était pas appliqué. Le premier filtre qui correspond est utilisé pour l'affectation TCLASS et les filtres restants au même niveau sont ignorés.

  • Le paramètre description est facultatif, cependant vous devez l'utiliser sur tous les éléments http_classification_info. La description s'affiche lorsque vous contrôlez les classes de transaction dans la console MVS.

Classification MDB

L'élément InboundClassification ayant pour type d'attribut="mdb" définit la section du document qui s'applique au travail pour les beans gérés par message (MDB) déployés avec les ports d'écoute. Vous trouverez ci-dessous un exemple de cet élément :
<InboundClassification  type="mdb"
                        schema_version="1.0"
                        default_transaction_class="qrs">
Chaque élément InboundClassification peut contenir un ou plusieurs éléments de point de contact avec un type messagelistenerport défini. Définissez un élément de point de contact pour chaque port d'écoute défini dans le serveur où vous souhaitez associer les classes de transaction avec le bean géré par message. Voici un exemple d'élément de point de contact :
<endpoint  type="messagelistenerport" 
           name="IPVListenerPort" 
           defaultclassification="MDBX"
           description="ABC">
Utilisez les règles suivantes lorsque vous définissez vos éléments de point de contact :
  • L'attribut type doit toujours être égal à messagelistenerport.
  • L'attribut nom correspond au module d'écoute pour votre élément de point de contact. La valeur de l'attribut nom doit être le nom du module d'écoute qui est précisé dans la console d'administration pour le serveur.
  • L'élément defaultclassification est la classe de transaction par défaut qui est associée aux beans gérés par message. La valeur de cet attribut remplace la valeur de classification de la transaction par défaut.
  • Le paramètre de description est facultatif, cependant vous devez l'utiliser sur tous les éléments de point de contact. La description s'affiche lorsque vous contrôlez les classes de transaction dans la console MVS.
Chaque élément de point de contact peut avoir zéro, un ou plusieurs éléments classificationentry. Vous trouverez ci-dessous un exemple d'élément d'entrée de classification :
<classificationentry  selector="Location=&apos;East&apos;"
                      classification="MDB2"
                      description="XYZ" 
                      dispatch_timeout="value1"
                      queue_timeout_percent ="value2"
                      request_timeout="value3"
                      stalled_thread_dump_action="traceback"
                      cputimeused_limit="value5"
                      cputimeused_dump_action="traceback" 
                      dpm_interval="value7"
                      dpm_dump_action="traceback"
                      SMF_request_activity_enabled="1"
                      SMF_request_activity_timestamps="1"
                      SMF_request_activity_security="1"
                      SMF_request_activity_CPU_detail="1" 
                      classification_only_trace="1"
                      message_tag="value14"/>
selector
Utilisez l'attribut sélecteur de l'élément classificationentry pour attribuer une classe de transaction à un bean géré par message qui possède une clause sélecteur dans son descripteur de déploiement. Utilisez les règles suivantes lorsque vous définissez vos éléments classificationentry :
  • La valeur de l'attribut sélecteur doit correspondre exactement à la clause sélecteur dans le descripteur de déploiement MDB.
  • La valeur de l'attribut selector doit avoir la syntaxe correcte pour un document XML. Vous devez remplacer le symbole < avec la référence d'entité &lt; et le symbole > avec la référence d'entité &gt;. De la même façon, si vous utilisez une apostrophe ou les guillemets, utilisez les références des entités &apos; et &quot;.
classification

L'attribut de classification est facultatif. Si l'attribut n'est pas défini il hérite de la classe de classification de son parent. La valeur de chaîne doit être une classe de transaction WLM valide, une chaîne de type null (telle que "") ou une chaîne qui comporte au maximum huit caractères d'espacement (telle que " "). En définissant une chaîne de type null ou vide, il est possible de remplacer un paramètre TCLASS par défaut ou un paramètre TCLASS établi par un filtre d'un niveau plus élevé. Définir une chaîne de type null ou vide signifie que vous ne disposez pas de valeur TCLASS pour la requête.

Attributs RAS :

Vous pouvez définir les attributs RAS suivants dans l'élément classificationentry. Les éléments imbriqués héritent des attributs RAS de l'élément parent. Les éléments imbriqués peuvent remplacer les attributs RAS d'un élément parent. Tous les attributs RAS sont facultatifs.

dispatch_timeout

Définit le délai d'attente d'une région de contrôle après la distribution d'une demande à la file d'attente WLM. Si la région de contrôle ne reçoit pas de réponse dans le temps imparti, elle émet un dépassement de délai d'attente. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur control_region_mdb_request_timeout.

queue_timeout_percent

Définit le délai d'attente de la file d'attente WLM sous la forme d'un pourcentage du délai de distribution. La plage de pourcentages est 0 - 99. Le délai d'attente de la file d'attente est le délai de séjour d'une demande dans la file d'attente WLM avant son expiration. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur control_region_mdb_queue_timeout_percent.

request_timeout

Définit le délai en secondes appliqué aux demandes entrantes provenant des demandes distribuées. La demande distribuée est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur com.ibm.CORBA.RequestTimeout.

stalled_thread_dump_action

Définit l'action de vidage que le serveur exécute lorsque les demandes dépassent le délai de distribution défini dans l'attribut dispatch_timeout. Il s'agit d'une requête classée par l'élément de classification. Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_mdb_stalled_thread_dump_action.

cputimeused_limit

Définit le délai d'attente UC en millisecondes. Le délai d'attente UC est le délai UC autorisé pour la demande avant l'expiration de la demande. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur server_region_request_cputimeused_limit.

cputimeused_dump_action

Définit l'action de vidage que le serveur exécute lorsque les demandes dépassent le délai d'attente UC défini dans l'attribut cputimeused_limit. La demande est une demande que l'élément de classification a classifié.

Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_cputimeused_dump_action.

dpm_interval

Définit l'intervalle DPM (Dispatch Progress Monitor) en secondes. Le moniteur DPM déclenche l'action de vidage DPM dans l'intervalle des demandes que l'élément de classification a classifié. Définissez l'action de vidage DMP dans l'attribut dpm_dump_action.

L'attribut ne remplace aucune des propriétés de serveur. Vous devez utiliser la commande de modification pour activer les intervalles DPM côté serveur.

dpm_dump_action

Définit l'action de vidage DPM exécutée à chaque intervalle DPM pour les demandes que l'élément de classification classifie. Définissez l'intervalle DPM dans l'attribut dpm_interval.

Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_dpm_dump_action.

SMF_request_activity_enabled

Indique si les neuf enregistrements de sous-type SMF 120 (System Management Facilities) sont collectés pour les demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_enabled.

SMF_request_activity_timestamps

Indique si les horodatages doivent être formatés dans une forme lisible par l'utilisateur dans les 9 enregistrements de sous-type SMF 120 pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_timestamps.

SMF_request_activity_security

Indique si la section des données de sécurité des 9 enregistrements de sous-type SMF 120 sont collectées pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_security.

SMF_request_activity_CPU_detail

Indique si la section de ventilation d'utilisation UC des 9 enregistrements de sous-type SMF est collectée pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_CPU_detail.

classification_only_trace

Indique s'il est nécessaire de tracer les enregistrements pour les demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut ne remplace aucune des propriétés de serveur. La commande de modification TRACERECORD remplace classification_only_trace.

Si pour un élément de classification classification_only_trace a la valeur 1, le suivi au niveau de la classification est active sur le serveur d'applications. Les seules unités d'exécution qui génèrent des enregistrements de trace sont les unités d'exécution qui traitent les demandes que classifie l'élément de classification. L'élément de classification doit définir classification_only_trace="1". La collecte de traces pour les unités d'exécution qui ne traitent pas ces demandes est désactivée et elle ne génère pas d'enregistrements de trace.

Si aucun élément de classification définit classification_only_trace="1", le traçage au niveau de la classification n'est pas en vigueur pour le serveur d'applications. Le serveur ne désactive pas la collecte des traces pour les unités d'exécution. Tous les enregistrements de trace sont écrits dans la sortie, comme l'indique la spécification de trace.

L'attribut classification_only_trace n'affecte pas la définition et l'activation de la spécification de trace. L'attribut affecte uniquement les unités d'exécution qui écrivent les enregistrements de traces.

message_tag

Définit un jeton de type chaîne qui est écrit dans tous les enregistrements de trace, les messages des journaux et les messages système générés pour les demandes que classifie l'élément de classification.

L'attribut contient huit caractères maximum.

L'attribut ne remplace pas les propriétés de serveur.

Classification d'adaptateur local optimisé

L'élément InboundClassification avec l'attribut type="ola" définit la section du document applicable à la classification d'adaptateur local optimisé. Vous trouverez ci-dessous un exemple de cet élément :

<InboundClassification 	type="ola" schema_version="1.0" 
                         default_transaction_class="value1"
>

Vous pouvez classifier le travail de l'adaptateur local optimisé en ajoutant une section pour chaque application EJB qui utilise le nom de service le nom d'interface Home Java Naming and Directory Interface (JNDI). Vous pouvez utiliser un caractère générique pour indiquer le nom de l'interface home JNDI.

Classez le travail de l'adaptateur local optimisé dans les applications à ces niveaux en utilisant l'élément ola_classification_info.

ola_classification_info
<ola_classification_info  transaction_class="value1"
                          propagate_transaction_name="value2"
                          service_name="value3"
                          description="value4" 
                          dispatch_timeout="value5"
                          queue_timeout_percent ="value6"
                          request_timeout="value7"
                          stalled_thread_dump_action="traceback"
                          cputimeused_limit="value9"
                          cputimeused_dump_action="traceback" 
                          dpm_interval="value11"
                          dpm_dump_action="traceback"
                          SMF_request_activity_enabled="1"
                          SMF_request_activity_timestamps="1"
                          SMF_request_activity_security="1"
                          SMF_request_activity_CPU_detail="1" 
                          classification_only_trace="1"
                          message_tag="value18">

Avec l'élément ola_classification_info, vous pouvez créer des filtres en fonction du service ou du nom JNDI. Utilisez le nom pour affecter des valeurs TCLASS, des attributs RAS ou les deux aux demandes entrantes. Utilisez les règles suivantes lorsque vous utilisez l'élément ola_classification_info :

transaction_class
L'attribut transaction_class est facultatif. Si l'attribut n'est pas défini, il hérite de la classe de transaction de son parent. La valeur de chaîne doit être une classe de transaction WLM valide, une chaîne de type null (telle que "") ou une chaîne qui comporte au maximum huit caractères d'espacement (telle que " "). En définissant une chaîne de type null ou vide, il est possible de remplacer un paramètre TCLASS par défaut ou un paramètre TCLASS établi par un filtre d'un niveau plus élevé. Définir une chaîne de type null ou vide signifie que vous ne disposez pas de valeur TCLASS pour la requête.
propagate_transaction_name
L'attribut propagate_transaction_name est facultatif. Si l'attribut est défini, la valeur de type chaîne doit être true ou false. En définissant la valeur true, la classe de service WLM de Customer Information Control System (CICS) est propagée au serveur d'applications dans chaque demande ou dans chaque demande correspondante si service_name filter est défini. Le travail distribué dans le serveur d'applications via l'adaptateur local optimisé s'exécute sous la même classe de service que la demande client.
service_name
L'attribut service_name est facultatif. Cet attribut fait office de sélecteur ou de filtre qui affecte une classe de transaction ou permet à un élément ola_classification_info imbriqué d'affecter la classe de transaction. Vous pouvez définir la valeur de cet attribut des manières suivantes :
  • Nom de service exacte ou nom d'interface Home JNDI de l'application EJB à gérer.
  • Valeur à caractère générique. Vous pouvez placer un astérisque (*) n'importe où dans une chaîne pour indiquer que toute chaîne commençant par la suite de caractères qui précède cet astérisque et se terminant par la suite de caractères qui suit cet astérisque doit être considérée comme une correspondance. Si l'astérisque est à la fin de la chaîne, toute chaîne commençant par la suite de caractères qui précède cet astérisque est considérée comme une correspondance.
    Exemples :
    • service_name="ejb/mySecondBean"
    • service_name="ejb/my*Bean"
    • service_name="ejb/my*"
    • service_name="ejb/security/*"
    ATTENTION :
    Les comparaisons de valeurs exécutées sont sensibles à la casse.

Attributs RAS

Vous pouvez définir les attributs RAS suivants dans l'élément ola_classification_info. Les éléments imbriqués héritent des attributs RAS de l'élément parent. Les éléments imbriqués peuvent remplacer les attributs RAS d'un élément parent. Tous les attributs RAS sont facultatifs.

dispatch_timeout

Définit le délai d'attente d'une région de contrôle après la distribution d'une demande à la file d'attente WLM. Si la région de contrôle ne reçoit pas de réponse dans le temps imparti, elle émet un dépassement de délai d'attente. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur control_region_wlm_dispatch_timeout.

queue_timeout_percent

Définit le délai d'attente de la file d'attente WLM sous la forme d'un pourcentage du délai de distribution. La plage de pourcentages est 0 - 99. Le délai d'attente de la file d'attente est le délai de séjour d'une demande dans la file d'attente WLM avant son expiration. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur control_region_iiop_queue_timeout.

request_timeout

Définit le délai en secondes appliqué aux demandes entrantes provenant des demandes distribuées. La demande distribuée est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur com.ibm.CORBA.RequestTimeout.

stalled_thread_dump_action

Définit l'action de vidage que le serveur exécute lorsque les demandes dépassent le délai de distribution défini dans l'attribut dispatch_timeout. Il s'agit d'une requête classée par l'élément de classification. Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_iiop_stalled_thread_dump_action.

cputimeused_limit

Définit le délai d'attente UC en millisecondes. Le délai d'attente UC est le délai UC autorisé pour la demande avant l'expiration de la demande. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur server_region_request_cputimeused_limit.

cputimeused_dump_action

Définit l'action de vidage que le serveur exécute lorsque les demandes dépassent le délai d'attente UC défini dans l'attribut cputimeused_limit. La demande est une demande que l'élément de classification a classifié.

Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_cputimeused_dump_action.

dpm_interval

Définit l'intervalle DPM (Dispatch Progress Monitor) en secondes. Le moniteur DPM déclenche l'action de vidage DPM dans l'intervalle des demandes que l'élément de classification a classifié. Définissez l'action de vidage DMP dans l'attribut dpm_dump_action.

L'attribut ne remplace aucune des propriétés de serveur. Vous devez utiliser la commande de modification pour activer les intervalles DPM côté serveur.

dpm_dump_action

Définit l'action de vidage DPM exécutée à chaque intervalle DPM pour les demandes que l'élément de classification classifie. Définissez l'intervalle DPM dans l'attribut dpm_interval.

Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_dpm_dump_action.

SMF_request_activity_enabled

Indique si les neuf enregistrements de sous-type SMF 120 (System Management Facilities) sont collectés pour les demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_enabled.

SMF_request_activity_timestamps

Indique si les horodatages doivent être formatés dans une forme lisible par l'utilisateur dans les 9 enregistrements de sous-type SMF 120 pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_timestamps.

SMF_request_activity_security

Indique si la section des données de sécurité des 9 enregistrements de sous-type SMF 120 sont collectées pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_security.

SMF_request_activity_CPU_detail

Indique si la section de ventilation d'utilisation UC des 9 enregistrements de sous-type SMF est collectée pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_CPU_detail.

classification_only_trace

Indique s'il est nécessaire de tracer les enregistrements pour les demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut ne remplace aucune des propriétés de serveur. La commande de modification TRACERECORD remplace classification_only_trace.

Si pour un élément de classification classification_only_trace a la valeur 1, le suivi au niveau de la classification est active sur le serveur d'applications. Les seules unités d'exécution qui génèrent des enregistrements de trace sont les unités d'exécution qui traitent les demandes que classifie l'élément de classification. L'élément de classification doit définir classification_only_trace="1". La collecte de traces pour les unités d'exécution qui ne traitent pas ces demandes est désactivée et elle ne génère pas d'enregistrements de trace.

Si aucun élément de classification définit classification_only_trace="1", le traçage au niveau de la classification n'est pas en vigueur pour le serveur d'applications. Le serveur ne désactive pas la collecte des traces pour les unités d'exécution. Tous les enregistrements de trace sont écrits dans la sortie, comme l'indique la spécification de trace.

L'attribut classification_only_trace n'affecte pas la définition et l'activation de la spécification de trace. L'attribut affecte uniquement les unités d'exécution qui écrivent les enregistrements de traces.

message_tag

Définit un jeton de type chaîne qui est écrit dans tous les enregistrements de trace, les messages des journaux et les messages système générés pour les demandes que classifie l'élément de classification.

L'attribut contient huit caractères maximum.

L'attribut ne remplace pas les propriétés de serveur.

Filtres de classification :
  • Les éléments info_classification_iiop peuvent être imbriqués de façon hiérarchique. En imbriquant les éléments, vous pouvez créer des filtres de classification basés sur les valeurs d'attributs.
    <ola_classification_info transaction_class="MEDIUM"
                              service_name="ejb/my*Bean">
         <ola_classification_info transaction_class="FAST"
                                   service_name="ejb/myFastBean" />
         <ola_classification_info transaction_class="SLOW"
                                   service_name="ejb/mySlowBean" />
    </ola_classification_info>
  • La zone de description est facultative. Cependant, vous devez utiliser une description dans tous les éléments ola_classification_info. La chaîne de description s'imprime dans le cadre du support de commande d'opérateur pour que vous puissiez identifier les règles de classification utilisées. Utilisez des descriptions d'une longueur relativement courte car elles s'affichent dans la console MVS.

Classification SIP

L'élément InboundClassification avec le type d'attribut="sip" définit la section du document qui définit la classe de transaction par défaut pour les demandes liées au protocole SIP. Vous trouverez ci-dessous un exemple de cet élément :

<InboundClassification 	type="sip" schema_version="1.0" 
                         default_transaction_class="value1">

Classification RA JMS

L'élément SibClassification ayant pour type d'attribut="jmsra" définit la section du document qui s'applique au travail pour les beans gérés par message (MDB) déployés sur des ressources compatibles JCA 1.5 à utiliser avec l'adaptateur de ressources (RA) JCA du fournisseur de messagerie par défaut. Vous trouverez ci-dessous un exemple de cet élément :
<SibClassification  type="jmsra"
                        schema_version="1.0"
                        default_transaction_class="a">
Chaque élément SibClassification peut contenir un ou plusieurs éléments sib_classification_info. Vous trouverez ci-dessous un exemple d'élément d'entrée de classification :
<sib_classification_info  
                      transaction_class="sibb"
                      selector="user.Location=&apos;East&apos;"
                      bus="bigrred"
                      destination="abusqueue"
                      description="Some words" 
                      discriminator="XPath Expression"
                      dispatch_timeout="value1"
                      queue_timeout_percent ="value2"
                      request_timeout="value3"
                      stalled_thread_dump_action="traceback"
                      cputimeused_limit="value5"
                      cputimeused_dump_action="traceback" 
                      dpm_interval="value7"
                      dpm_dump_action="traceback"
                      SMF_request_activity_enabled="1"
                      SMF_request_activity_timestamps="1"
                      SMF_request_activity_security="1"
                      SMF_request_activity_CPU_detail="1" 
                      classification_only_trace="1"
                      message_tag="value14"/>
selector
Utilisez l'attribut selector de l'élément sib_classification_info pour attribuer une classe de transaction à un bean géré par message qui comporte une clause selector dans son descripteur de déploiement. Utilisez les règles suivantes lors de la définition des éléments sib_classification_info :
  • La valeur de l'attribut de sélecteur est une expression SQL qui sélectionne un message selon les valeurs des propriétés du message. La syntaxe est celle d'un sélecteur de message dans la spécification JMS 1.1 mais elle peut agir sur les messages SIMessage (plus que sur les messages JMS). La syntaxe peut sélectionner des propriétés système (en-tête JMS, propriétés JMSX et propriétés JMS_IBM) et des propriétés utilisateur (qui doivent avoir le préfixe ".user" - par exemple, pour la propriété utilisateur "Location", le sélecteur préciserait "user.Location" comme expliqué dans l'exemple précédent). Pour plus d'informations, voir la rubrique relative à l'utilisation des propriétés des messages.
  • La valeur de l'attribut selector doit avoir la syntaxe correcte pour un document XML. Vous devez remplacer le symbole < par la référence d'entité &lt; et le symbole > par la référence d'entité &gt;. De la même façon, si vous utilisez une apostrophe ou les guillemets, utilisez les références des entités &apos; et &quot;.
bus
Nom du bus d'intégration de services sur lequel la destination cible est attribuée. La classification s'applique au bus nommé par cette propriété ou à tout bus si vous n'avez pas spécifié cette propriété. Les destinations auxquelles la classification s'applique dépendent de l'utilisation que vous faites de la propriété de destination.
destination
Nom de la destination du bus cible à laquelle ce message a été distribué. IL s'agit du nom d'une file d'attente ou d'un espace de sujet. La classification s'applique à la destination nommée par cette propriété ou à toute destination si vous n'avez pas spécifié cette propriété. Les bus d'intégration de services auxquels la classification s'applique dépendent de l'utilisation que vous faites de la propriété du bus.
discriminator
Cette propriété s'applique uniquement lorsque la propriété destination nomme un espace de sujet. Cette valeur est une expression XPath qui sélectionne un ou plusieurs sujets dans l'espace de sujet.
description
Bien que la zone description soit facultative, vous devez l'utiliser pour tous les éléments sib_classification_info. La description s'affiche lorsque vous contrôlez les classes de transaction dans la console MVS.

Attributs RAS

Vous pouvez définir les attributs RAS suivants dans l'élément sib_classification_info. Les éléments imbriqués héritent des attributs RAS de l'élément parent. Les éléments imbriqués peuvent remplacer les attributs RAS d'un élément parent. Tous les attributs RAS sont facultatifs.

dispatch_timeout

Définit le délai d'attente d'une région de contrôle après la distribution d'une demande à la file d'attente WLM. Si la région de contrôle ne reçoit pas de réponse dans le temps imparti, elle émet un dépassement de délai d'attente. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur control_region_wlm_dispatch_timeout.

queue_timeout_percent

Définit le délai d'attente de la file d'attente WLM sous la forme d'un pourcentage du délai de distribution. La plage de pourcentages est 0 - 99. Le délai d'attente de la file d'attente est le délai de séjour d'une demande dans la file d'attente WLM avant son expiration. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur control_region_iiop_queue_timeout.

request_timeout

Définit le délai en secondes appliqué aux demandes entrantes provenant des demandes distribuées. La demande distribuée est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur com.ibm.CORBA.RequestTimeout.

stalled_thread_dump_action

Définit l'action de vidage que le serveur exécute lorsque les demandes dépassent le délai de distribution défini dans l'attribut dispatch_timeout. Il s'agit d'une requête classée par l'élément de classification. Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_iiop_stalled_thread_dump_action.

cputimeused_limit

Définit le délai d'attente UC en millisecondes. Le délai d'attente UC est le délai UC autorisé pour la demande avant l'expiration de la demande. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur server_region_request_cputimeused_limit.

cputimeused_dump_action

Définit l'action de vidage que le serveur exécute lorsque les demandes dépassent le délai d'attente UC défini dans l'attribut cputimeused_limit. La demande est une demande que l'élément de classification a classifié.

Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_cputimeused_dump_action.

dpm_interval

Définit l'intervalle DPM (Dispatch Progress Monitor) en secondes. Le moniteur DPM déclenche l'action de vidage DPM dans l'intervalle des demandes que l'élément de classification a classifié. Définissez l'action de vidage DMP dans l'attribut dpm_dump_action.

L'attribut ne remplace aucune des propriétés de serveur. Vous devez utiliser la commande de modification pour activer les intervalles DPM côté serveur.

dpm_dump_action

Définit l'action de vidage DPM exécutée à chaque intervalle DPM pour les demandes que l'élément de classification classifie. Définissez l'intervalle DPM dans l'attribut dpm_interval.

Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_dpm_dump_action.

SMF_request_activity_enabled

Indique si les neuf enregistrements de sous-type SMF 120 (System Management Facilities) sont collectés pour les demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_enabled.

SMF_request_activity_timestamps

Indique si les horodatages doivent être formatés dans une forme lisible par l'utilisateur dans les 9 enregistrements de sous-type SMF 120 pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_timestamps.

SMF_request_activity_security

Indique si la section des données de sécurité des 9 enregistrements de sous-type SMF 120 sont collectées pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_security.

SMF_request_activity_CPU_detail

Indique si la section de ventilation d'utilisation UC des 9 enregistrements de sous-type SMF est collectée pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_CPU_detail.

classification_only_trace

Indique s'il est nécessaire de tracer les enregistrements pour les demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut ne remplace aucune des propriétés de serveur. La commande de modification TRACERECORD remplace classification_only_trace.

Si pour un élément de classification classification_only_trace a la valeur 1, le suivi au niveau de la classification est active sur le serveur d'applications. Les seules unités d'exécution qui génèrent des enregistrements de trace sont les unités d'exécution qui traitent les demandes que classifie l'élément de classification. L'élément de classification doit définir classification_only_trace="1". La collecte de traces pour les unités d'exécution qui ne traitent pas ces demandes est désactivée et elle ne génère pas d'enregistrements de trace.

Si aucun élément de classification définit classification_only_trace="1", le traçage au niveau de la classification n'est pas en vigueur pour le serveur d'applications. Le serveur ne désactive pas la collecte des traces pour les unités d'exécution. Tous les enregistrements de trace sont écrits dans la sortie, comme l'indique la spécification de trace.

L'attribut classification_only_trace n'affecte pas la définition et l'activation de la spécification de trace. L'attribut affecte uniquement les unités d'exécution qui écrivent les enregistrements de traces.

message_tag

Définit un jeton de type chaîne qui est écrit dans tous les enregistrements de trace, les messages des journaux et les messages système générés pour les demandes que classifie l'élément de classification.

L'attribut contient huit caractères maximum.

L'attribut ne remplace pas les propriétés de serveur.

Chaque élément sib_classification_info peut contenir une ou plusieurs de ces propriétés pour classer le travail d'un message. Un élément sib_classification_info ne peut pas contenir plus d'une instance de chaque propriété.

Si un message correspond à plusieurs éléments sib_classification_info, le premier élément qui apparaît est utilisé. Par exemple, prenons les spécifications suivantes :
<sib_classification_info bus="MyBus" transaction_class="a" />
<sib_classification_info destination="MyDest" transaction_class="b" />

Un message qui arrive à la destination MyDest depuis le bus d'intégration de services MyBus se voit attribuer la classification "a". Un message qui arrive à MyDest depuis un autre bus se voit attribuer la classification "b".

Si un message ne correspond à aucun élément sib_classification_info dans un élément fermant SibClassification, le message se voit attribuer la classification par défaut de l'élément SibClassification.

Si un message ne correspond à aucun élément sib_classification_info dans aucun élément SibClassification, ou si aucun élément SibClassification n'est défini, le travail entier reçoit une classification intégrée par défaut avec la valeur "SIBUS". Vous devez exécuter des actions Workload Manager z/OS nécessaires pour utiliser la valeur TCLASS "SIBUS", comme ceci est expliqué dans Classification de la charge de travail z/OS.

Classification de médiation

L'élément SibClassification ayant pour type d'attribut="destinationmediation" définit la section du document qui s'applique au travail pour des médiations attribuées à des destinations sur un bus d'intégration de services. Vous trouverez ci-dessous un exemple de cet élément :
    <SibClassification type="destinationmediation"
                        schema_version="1.0"
                        default_transaction_class="b">
Chaque élément SibClassification peut comporter un ou plusieurs éléments sib_classification_info. Vous trouverez ci-dessous un exemple d'élément d'entrée de classification :
<sib_classification_info
                      transaction_class="e"
                      selector="user.Location=&apos;East&apos;"
                      bus="bigrred"
                      destination="themoon"
                      discriminator="sides/dark" 
                      description="n" 
                      dispatch_timeout="value1"
                      queue_timeout_percent ="value2"
                      request_timeout="value3"
                      stalled_thread_dump_action="traceback"
                      cputimeused_limit="value5"
                      cputimeused_dump_action="traceback" 
                      dpm_interval="value7"
                      dpm_dump_action="traceback"
                      SMF_request_activity_enabled="1"
                      SMF_request_activity_timestamps="1"
                      SMF_request_activity_security="1"
                      SMF_request_activity_CPU_detail="1" 
                      classification_only_trace="1"
                      message_tag="value14"/>
selector
Utilisez l'attribut selector de l'élément sib_classification_info pour attribuer une classe de transaction à une médiation qui comporte une clause selector dans son descripteur de déploiement. Utilisez les règles suivantes lors de la définition des éléments sib_classification_info :
  • La valeur de l'attribut de sélecteur est une expression SQL qui sélectionne un message selon les valeurs des propriétés du message. La syntaxe est celle d'un sélecteur de message dans la spécification JMS 1.1 mais elle peut agir sur les messages SIMessage (plus que sur les messages JMS). La syntaxe peut sélectionner des propriétés système (en-tête JMS, propriétés JMSX et propriétés JMS_IBM) et des propriétés utilisateur (qui doivent avoir le préfixe ".user" - par exemple, pour la propriété utilisateur "Location", le sélecteur préciserait "user.Location" comme expliqué dans l'exemple précédent).

    Pour plus d'informations, voir la rubrique relative à l'utilisation des propriétés des messages.

  • La valeur de l'attribut selector doit avoir la syntaxe correcte pour un document XML. Vous devez remplacer le symbole < par la référence d'entité &lt; et le symbole > par la référence d'entité &gt;. De la même façon, si vous utilisez une apostrophe ou les guillemets, utilisez les références des entités &apos; et &quot;.
bus
Nom du bus d'intégration de services sur lequel la destination cible est attribuée. La classification s'applique au bus nommé par cette propriété ou à tout bus si vous n'avez pas spécifié cette propriété. Les destinations auxquelles la classification s'applique dépendent de l'utilisation que vous faites de la propriété de destination.
destination
Nom de la destination du bus cible à laquelle ce message a été distribué. IL s'agit du nom d'une file d'attente ou d'un espace de sujet. La classification s'applique à la destination nommée par cette propriété ou à toute destination si vous n'avez pas spécifié cette propriété. Les bus d'intégration de services auxquels la classification s'applique dépendent de l'utilisation que vous faites de la propriété du bus.
discriminator
Cette propriété s'applique uniquement lorsque la propriété destination nomme un espace de sujet. Cette valeur est une expression XPath qui sélectionne un ou plusieurs sujets dans l'espace de sujet.
description
Bien que la zone description soit facultative, vous devez l'utiliser pour tous les éléments sib_classification_info. La description s'affiche lorsque vous contrôlez les classes de transaction dans la console MVS.

Attributs RAS

Vous pouvez définir les attributs RAS suivants dans l'élément sib_classification_info. Les éléments imbriqués héritent des attributs RAS de l'élément parent. Les éléments imbriqués peuvent remplacer les attributs RAS d'un élément parent. Tous les attributs RAS sont facultatifs.

dispatch_timeout

Définit le délai d'attente d'une région de contrôle après la distribution d'une demande à la file d'attente WLM. Si la région de contrôle ne reçoit pas de réponse dans le temps imparti, elle émet un dépassement de délai d'attente. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur control_region_wlm_dispatch_timeout.

queue_timeout_percent

Définit le délai d'attente de la file d'attente WLM sous la forme d'un pourcentage du délai de distribution. La plage de pourcentages est 0 - 99. Le délai d'attente de la file d'attente est le délai de séjour d'une demande dans la file d'attente WLM avant son expiration. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur control_region_iiop_queue_timeout.

request_timeout

Définit le délai en secondes appliqué aux demandes entrantes provenant des demandes distribuées. La demande distribuée est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur com.ibm.CORBA.RequestTimeout.

stalled_thread_dump_action

Définit l'action de vidage que le serveur exécute lorsque les demandes dépassent le délai de distribution défini dans l'attribut dispatch_timeout. Il s'agit d'une requête classée par l'élément de classification. Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_iiop_stalled_thread_dump_action.

cputimeused_limit

Définit le délai d'attente UC en millisecondes. Le délai d'attente UC est le délai UC autorisé pour la demande avant l'expiration de la demande. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur server_region_request_cputimeused_limit.

cputimeused_dump_action

Définit l'action de vidage que le serveur exécute lorsque les demandes dépassent le délai d'attente UC défini dans l'attribut cputimeused_limit. La demande est une demande que l'élément de classification a classifié.

Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_cputimeused_dump_action.

dpm_interval

Définit l'intervalle DPM (Dispatch Progress Monitor) en secondes. Le moniteur DPM déclenche l'action de vidage DPM dans l'intervalle des demandes que l'élément de classification a classifié. Définissez l'action de vidage DMP dans l'attribut dpm_dump_action.

L'attribut ne remplace aucune des propriétés de serveur. Vous devez utiliser la commande de modification pour activer les intervalles DPM côté serveur.

dpm_dump_action

Définit l'action de vidage DPM exécutée à chaque intervalle DPM pour les demandes que l'élément de classification classifie. Définissez l'intervalle DPM dans l'attribut dpm_interval.

Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_dpm_dump_action.

SMF_request_activity_enabled

Indique si les neuf enregistrements de sous-type SMF 120 (System Management Facilities) sont collectés pour les demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_enabled.

SMF_request_activity_timestamps

Indique si les horodatages doivent être formatés dans une forme lisible par l'utilisateur dans les 9 enregistrements de sous-type SMF 120 pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_timestamps.

SMF_request_activity_security

Indique si la section des données de sécurité des 9 enregistrements de sous-type SMF 120 sont collectées pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_security.

SMF_request_activity_CPU_detail

Indique si la section de ventilation d'utilisation UC des 9 enregistrements de sous-type SMF est collectée pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_CPU_detail.

classification_only_trace

Indique s'il est nécessaire de tracer les enregistrements pour les demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut ne remplace aucune des propriétés de serveur. La commande de modification TRACERECORD remplace classification_only_trace.

Si pour un élément de classification classification_only_trace a la valeur 1, le suivi au niveau de la classification est active sur le serveur d'applications. Les seules unités d'exécution qui génèrent des enregistrements de trace sont les unités d'exécution qui traitent les demandes que classifie l'élément de classification. L'élément de classification doit définir classification_only_trace="1". La collecte de traces pour les unités d'exécution qui ne traitent pas ces demandes est désactivée et elle ne génère pas d'enregistrements de trace.

Si aucun élément de classification définit classification_only_trace="1", le traçage au niveau de la classification n'est pas en vigueur pour le serveur d'applications. Le serveur ne désactive pas la collecte des traces pour les unités d'exécution. Tous les enregistrements de trace sont écrits dans la sortie, comme l'indique la spécification de trace.

L'attribut classification_only_trace n'affecte pas la définition et l'activation de la spécification de trace. L'attribut affecte uniquement les unités d'exécution qui écrivent les enregistrements de traces.

message_tag

Définit un jeton de type chaîne qui est écrit dans tous les enregistrements de trace, les messages des journaux et les messages système générés pour les demandes que classifie l'élément de classification.

L'attribut contient huit caractères maximum.

L'attribut ne remplace pas les propriétés de serveur.

Chaque élément sib_classification_info peut contenir une ou plusieurs de ces propriétés pour classer le travail d'un message. Un élément sib_classification_info ne peut pas contenir plus d'une instance de chaque propriété.

Si un message correspond à plusieurs éléments sib_classification_info, le premier élément qui apparaît est utilisé. Par exemple, prenons les spécifications suivantes :
<sib_classification_info transaction_class="e" destination="themoon" description="n" />
<sib_classification_info transaction_class="f" description="n" />

Un message qui arrive à la médiation d'une destination themoon se voit attribuer la classification "e". Un message qui arrive à une autre médiation de destination se voit attribuer la classification "f".

Si un message ne correspond à aucun élément sib_classification_info dans un élément fermant SibClassification, le message se voit attribuer la classification par défaut de l'élément SibClassification.

Si un message ne correspond à aucun élément sib_classification_info dans aucun élément SibClassification, ou si aucun élément SibClassification n'est défini, le travail entier reçoit une classification intégrée par défaut avec la valeur "SIBUS". Vous devez exécuter des actions Workload Manager z/OS nécessaires pour utiliser la valeur TCLASS "SIBUS", comme ceci est expliqué dans Classification de la charge de travail z/OS.

Classification des fournisseurs de messagerie WebSphere MQ

L'élément WMQRAClassification ayant pour type d'attribut="mdb" définit la section du document qui s'applique au travail pour les beans gérés par message (MDB) déployés par rapport aux spécifications d'activation du fournisseur de messagerie WebSphere MQ. Vous trouverez ci-dessous un exemple de cet élément :
    <WMQRAClassification default_transaction_class="TC99" schema_version="1.0">
Chaque élément WMQRAClassification peut comporter un ou plusieurs éléments wmqra_classification_info. Voici deux exemples d'éléments wmqra_classification_info :
<wmqra_classification_info transaction_class="TC_4"
                      destination="topic://a/b/*"
                      description="Any topics starting with a/b/ map to TC_4"/>

<wmqra_classification_info transaction_class="TC_3"
                      selector="JMSPriority&gt;3 AND JMSPriority&lt;8"
                      destination="queue://QMGR1/Q1"
                      queue_manager="QMGR1" 
                      description="medium priorities with a queue manager name of QMGR1 and
                                   a queue name of Q1 map to TC_3"
                      dispatch_timeout="value1"
                      queue_timeout_percent ="value2"
                      request_timeout="value3"
                      stalled_thread_dump_action="traceback"
                      cputimeused_limit="value5"
                      cputimeused_dump_action="traceback" 
                      dpm_interval="value7"
                      dpm_dump_action="traceback"
                      SMF_request_activity_enabled="1"
                      SMF_request_activity_timestamps="1"
                      SMF_request_activity_security="1"
                      SMF_request_activity_CPU_detail="1" 
                      classification_only_trace="1"
                      message_tag="value14"/>
selector
Utilisez l'attribut sélecteur (selector) de l'élément wmqra_classification_info pour affecter une classe de transaction à un message en fonction de ses propriétés. Ce attribut peut également permettre d'attribuer une classe de transaction à un bean géré par message qui possède une clause sélecteur dans son descripteur de déploiement :
  • La valeur de l'attribut de sélecteur est une expression SQL qui sélectionne un message selon les valeurs des propriétés du message. La syntaxe est celle d'un sélecteur de message dans la spécification JMS 1.1.
  • La valeur de l'attribut selector doit avoir la syntaxe correcte pour un document XML. Vous devez remplacer le symbole < par la référence d'entité &lt; et le symbole > par la référence d'entité &gt;. De la même façon, si vous utilisez une apostrophe ou les guillemets, utilisez les références des entités &apos; et &quot;.
destination
Identificateur URI représentant la destination WebSphere MQ à laquelle le message a été remis. La classification s'applique à la destination nommée par cette propriété ou à toute destination si vous n'avez pas spécifié cette propriété. Si l'identificateur URI représente une destination de type de file d'attente, il peut contenir éventuellement un nom de gestionnaire de files d'attente, mais le nom est ignoré et il n'est pas utilisé pour la classification. S'il représente une destination de type de sujet, il peut utiliser des caractères génériques. Pour plus d'informations sur le support des caractères génériques avec WebSphere MQ, voir le centre de documentation WebSphere MQ.
gestionnaire_file d'attente
Nom du gestionnaire de files d'attente WebSphere MQ auquel le message auquel le message a été envoyé. La classification s'applique au gestionnaire de files d'attente appelé par cette propriété ou à tout gestionnaire de files d'attente si vous ne précisez pas cette propriété. Le nom du gestionnaire de files d'attente doit être conforme aux conventions de dénomination WebSphere MQ.
Notez que ce champ ne doit pas contenir le nom d'un groupe de partage de files d'attente WebSphere MQ. En fait, vous devez créer un élément wmqra_classification_info pour chaque gestionnaire de files d'attente dans le groupe de partage de files d'attente ou baser la classification sur un autre élément que l'attribut de destination.
description
Bien que la zone description soit facultative, vous devez l'utiliser pour tous les éléments wmqra_classification_info.

Attributs RAS :

Vous pouvez définir les attributs RAS suivants dans l'élément wmqra_classification_info. Les éléments imbriqués héritent des attributs RAS de l'élément parent. Les éléments imbriqués peuvent remplacer les attributs RAS d'un élément parent. Tous les attributs RAS sont facultatifs.

dispatch_timeout

Définit le délai d'attente d'une région de contrôle après la distribution d'une demande à la file d'attente WLM. Si la région de contrôle ne reçoit pas de réponse dans le temps imparti, elle émet un dépassement de délai d'attente. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur control_region_wlm_dispatch_timeout.

queue_timeout_percent

Définit le délai d'attente de la file d'attente WLM sous la forme d'un pourcentage du délai de distribution. La plage de pourcentages est 0 - 99. Le délai d'attente de la file d'attente est le délai de séjour d'une demande dans la file d'attente WLM avant son expiration. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur control_region_iiop_queue_timeout.

request_timeout

Définit le délai en secondes appliqué aux demandes entrantes provenant des demandes distribuées. La demande distribuée est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur com.ibm.CORBA.RequestTimeout.

stalled_thread_dump_action

Définit l'action de vidage que le serveur exécute lorsque les demandes dépassent le délai de distribution défini dans l'attribut dispatch_timeout. Il s'agit d'une requête classée par l'élément de classification. Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_iiop_stalled_thread_dump_action.

cputimeused_limit

Définit le délai d'attente UC en millisecondes. Le délai d'attente UC est le délai UC autorisé pour la demande avant l'expiration de la demande. La demande est une demande que l'élément de classification a classifié.

L'attribut remplace la propriété de serveur server_region_request_cputimeused_limit.

cputimeused_dump_action

Définit l'action de vidage que le serveur exécute lorsque les demandes dépassent le délai d'attente UC défini dans l'attribut cputimeused_limit. La demande est une demande que l'élément de classification a classifié.

Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_cputimeused_dump_action.

dpm_interval

Définit l'intervalle DPM (Dispatch Progress Monitor) en secondes. Le moniteur DPM déclenche l'action de vidage DPM dans l'intervalle des demandes que l'élément de classification a classifié. Définissez l'action de vidage DMP dans l'attribut dpm_dump_action.

L'attribut ne remplace aucune des propriétés de serveur. Vous devez utiliser la commande de modification pour activer les intervalles DPM côté serveur.

dpm_dump_action

Définit l'action de vidage DPM exécutée à chaque intervalle DPM pour les demandes que l'élément de classification classifie. Définissez l'intervalle DPM dans l'attribut dpm_interval.

Les valeurs valides sont svcdump, javacore, heapdump, traceback, javatdump et none.

L'attribut remplace la propriété de serveur server_region_dpm_dump_action.

SMF_request_activity_enabled

Indique si les neuf enregistrements de sous-type SMF 120 (System Management Facilities) sont collectés pour les demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_enabled.

SMF_request_activity_timestamps

Indique si les horodatages doivent être formatés dans une forme lisible par l'utilisateur dans les 9 enregistrements de sous-type SMF 120 pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_timestamps.

SMF_request_activity_security

Indique si la section des données de sécurité des 9 enregistrements de sous-type SMF 120 sont collectées pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_security.

SMF_request_activity_CPU_detail

Indique si la section de ventilation d'utilisation UC des 9 enregistrements de sous-type SMF est collectée pour les demandes. Les demandes sont des demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut remplace la propriété de serveur server_SMF_request_activity_CPU_detail.

classification_only_trace

Indique s'il est nécessaire de tracer les enregistrements pour les demandes que l'élément de classification classifie.

Les valeurs valides sont 0 (non) et 1 (oui).

L'attribut ne remplace aucune des propriétés de serveur. La commande de modification TRACERECORD remplace classification_only_trace.

Si pour un élément de classification classification_only_trace a la valeur 1, le suivi au niveau de la classification est active sur le serveur d'applications. Les seules unités d'exécution qui génèrent des enregistrements de trace sont les unités d'exécution qui traitent les demandes que classifie l'élément de classification. L'élément de classification doit définir classification_only_trace="1". La collecte de traces pour les unités d'exécution qui ne traitent pas ces demandes est désactivée et elle ne génère pas d'enregistrements de trace.

Si aucun élément de classification définit classification_only_trace="1", le traçage au niveau de la classification n'est pas en vigueur pour le serveur d'applications. Le serveur ne désactive pas la collecte des traces pour les unités d'exécution. Tous les enregistrements de trace sont écrits dans la sortie, comme l'indique la spécification de trace.

L'attribut classification_only_trace n'affecte pas la définition et l'activation de la spécification de trace. L'attribut affecte uniquement les unités d'exécution qui écrivent les enregistrements de traces.

message_tag

Définit un jeton de type chaîne qui est écrit dans tous les enregistrements de trace, les messages des journaux et les messages système générés pour les demandes que classifie l'élément de classification.

L'attribut contient huit caractères maximum.

L'attribut ne remplace pas les propriétés de serveur.

Chaque élément wmqra_classification_info peut contenir une ou plusieurs de ces propriétés pour classer le travail d'un message. Un élément wmqra_classification_info ne peut pas contenir plus d'une instance de chaque propriété.

Si un message correspond à plusieurs éléments wmqra_classification_info, le premier élément qui apparaît est utilisé. Par exemple, prenons les spécifications suivantes :
<wmqra_classification_info queue_manager="QMGR1" transaction_class="TC_1" />
<wmqra_classification_info destination="queue:///Q1" transaction_class="TC_2" />

Un message qui arrive à la destination Q1 sur le gestionnaire de files d'attente QMRG1 se voit attribuer la classification "TC_1". Un message qui arrive à Q1 depuis un autre gestionnaire de files d'attente se voit attribuer la classification "TC_2".

Si un message ne correspond à aucun élément wmqra_classification_info se trouvant dans l'élément WMQRAClassification, la classification par défaut de l'élément WMQRAClassification est attribuée au message. S'il existe plusieurs éléments WMQRAClassification, la classe de transaction par défaut du premier élément WMQRAClassification sera utilisée.

Si aucun élément WMQRAClassification n'est défini, tous les travaux reçoivent la classification par défaut "WMQRA". Vous devez exécuter des actions Workload Manager z/OS nécessaires pour utiliser la valeur TCLASS "WMQRA", comme expliqué dans Classification de la charge de travail z/OS.

Exemple de document de classification de charge de travail z/OS sans attributs RAS

L'exemple de document de classification de charge de travail z/OS contient des attributs pour classer les demandes de travail entrantes HTTP, IIOP, SIP (Session Initiation Protocol) et MDB (message-driven bean) pour le gestionnaire de charge de travail z/OS. Cet exemple ne contient pas d'attributs RAS.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE Classification SYSTEM "Classification.dtd" >
<Classification schema_version="1.0">
<!--
        Internal Classification Rules
-->
   <InboundClassification 	type="internal" 
                           schema_version="1.0" 
                           default_transaction_class="value1"/>

<!--
        IIOP Classification Rules
-->
   <InboundClassification type="iiop" 
                          schema_version="1.0"
                          default_transaction_class="A0">
     <iiop_classification_info transaction_class="A1"
                               application_name="IIOPStatelessSampleApp"
                               module_name="StatelessSample.jar"
                               component_name="Sample20"
                               description="Sample20 EJB Classification">
     <iiop_classification_info  transaction_class=""
                               method_name="echo"
                               description="No TCLASS for echo()" />
     <iiop_classification_info 	transaction_class="A1B"
                               method_name="ping"
                               description="Ping method" />
     </iiop_classification_info>
     <iiop_classification_info application_name="*"
                               module_name="*"
                               component_name="*"
                               transaction_class="A2"
                               description="TCLASS the rest to A2">
     <iiop_classification_info  transaction_class="A2A"
                               method_name="resetFilter"
                               description="Sp1 case resetFilter()" />
     </iiop_classification_info>
  </InboundClassification>

<!--
        HTTP Classification Rules
-->
   <InboundClassification  type="http"
                          schema_version="1.0"
                          default_transaction_class="M">
     <http_classification_info  transaction_class="N"
                               host="yourhost.yourcompany.com"
                               description="Virtual Host yourhost">
     <http_classification_info	transaction_class="O"
                               port="9080"
                               description="Def yourhost HTTP reqs">
     <http_classification_info  transaction_class="Q"
                               uri="/gcs/admin"
                               description = "Gcs" />
     <http_classification_info 	transaction_class="S"
                               uri="/gcs/admin/1*"
                               description="GCS login" />
     <http_classification_info  transaction_class="P"
                               port="9081"
	                             description=" Def yourhost HTTPS reqs "/>
     <http_classification_info  transaction_class=""
                               uri="/gcss/mgr/*"
                               description="GCSS Mgr" />
     </http_classification_info>
     </http_classification_info>
   </InboundClassification>

<!--
        SIP Classification Rules
-->
   <InboundClassification 	type="sip" 
                          schema_version="1.0" 
                          default_transaction_class="value1"/> 

<!-- 
        MDB Classification Rules
-->
   <InboundClassification  type="mdb"	
                          schema_version="1.0"
                          default_transaction_class="qrs">
     <endpoint  type="messagelistenerport"
               name="IVPListenerPort"
               defaultclassification="MDBX"
               description="ABC">
        <classificationentry  selector="Location=&apos;East&apos;"
                              classification="MDB1"
                              description="DEF"/>
        <classificationentry  selector="Location&lt;&gt;&apos;East&apos;"
                              classification="MDB2"
                              description="XYZ" />
     </endpoint>
     <endpoint  type="messagelistenerport"
                name="SimpleMDBListenerPort"
                defaultclassification="MDBX"
                description="GHI" />

   </InboundClassification>

     <SibClassification type="jmsra" schema_version="1.0"
          default_transaction_class="a">
        <sib_classification_info transaction_class="b"
            selector="user.Location=&apos;East&apos;" bus="magic"
            destination="nowhere" description="n" />
        <sib_classification_info transaction_class="c"
            selector="user.Location=&apos;West&apos;" bus="omni"
description="n" />
    </SibClassification>
    <SibClassification type="destinationmediation" schema_version="1.0"
           default_transaction_class="b">
        <sib_classification_info transaction_class="e"
            selector="user.Location=&apos;East&apos;" destination="themoon"
            discriminator="sides/dark" description="n" />
        <sib_classification_info transaction_class="f"
            selector="user.Location=&apos;West&apos;" description="n"
/>
    </SibClassification>

    <WMQRAClassification default_transaction_class="TC99" schema_version="1.0">
       <wmqra_classification_info transaction_class="TC_1"
                               queue_manager="GOLD"
                               description="gold queue manager maps
to TC_1"/>
       <wmqra_classification_info transaction_class="TC_2"
                               selector="JMSPriority&gt;7"
                               description="high priorities maps to
TC_2"/>
       <wmqra_classification_info transaction_class="TC_3"
                               selector="JMSPriority&gt;3 AND
JMSPriority&lt;8"
                               description="medium priorities maps
to TC_3"/>
    </WMQRAClassification>

<!--
        OLA Classification Rules
-->
   <InboundClassification type="ola" 
                          schema_version="1.0"
                          default_transaction_class="A0">
     <ola_classification_info transaction_class="FAST1"
                              service_name="ejb/InteractiveTransactionBean"
                              description="EJB classification for quick turnaround"/>
     <ola_classification_info transaction_class="SLOW1"
                              service_name="ejb/BackgroundBean"
                              description="EJB classification for low priority" />
     <ola_classification_info propagate_transaction_name="true"
                              service_name="ejb/CalledFromCICSBean"
                              description="use same service class as client" />
  </InboundClassification>

<!--
   Workload Classification Document for P5SR01x servers
   Change History
   _______________________________________________________
   Activity	                    Date                 Author
   Created                     01-28-2005           IPL

-->

</Classification>

Exemple de document de classification de charge de travail z/OS contenant des attributs RAS

Le document de classification de charge de travail z/OS contient des attributs pour classer les demandes de travail entrantes HTTP, IIOP, SIP (Session Initiation Protocol) et MDB (message-driven bean) pour le gestionnaire de charge de travail z/OS. Cet exemple contient des attributs RAS.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE Classification SYSTEM "Classification.dtd" >
<Classification schema_version="1.0">

<!-- IIOP Classification Rules -->
<InboundClassification 
  type="iiop" 
  schema_version="1.0"
  default_transaction_class="TC">

  <!-- 
       IIOP classification info for app "EJBApp1".  L'élément de classification définit l'attribut      
       transaction_class "TC1".  Cette valeur remplace la classe de transaction par défaut default_transaction_class de     
       l'élément InboundClassification ("TC").  L'élément de classification définit également             
       un attribut message_tag qui est appliqué à toutes les demandes classées     
       sous cet élément de classification.                                             -->
  <iiop_classification_info 
    application_name="EJBApp1" 
    transaction_class="TC1" 
    message_tag="EJBApp1">
  
    <!-- 
         EJBApp1 contient le module JAR "MyEJB.jar" avec l'EJB "MyEJBClass".      
         La classe de transaction transaction_class n'est pas définie pour cet élément. Par conséquent, l'élément    
         hérite de la classe de transaction transaction_class de son noeud parent, "TC1".  Cet élément hérite également de l'attribut       
         message_tag de son noeud parent "EJBApp1".  En règle générale,     
         un élément de classification hérite de tous les attributs RAS de tous ces noeud ancêtres, les       
         noeuds ancêtres les plus proches (parents directs) étant prioritaires sur les       
         noeud ancêtres plus éloignés dans la chaîne (grand parents, par exemple).          -->
    <iiop_classification_info  
      module_name="MyEJB.jar" 
      component_name="MyEJBClass">
    
      <!-- 
           MyEJBClass contient les méthodes "helloWorld" et "goodbyeWorld".  helloWorld     
           est affecté d'un délai d'attente d'envoi dispatch_timeout de 30 secondes et d'un pourcentage de délai d'attente de file d'attente queue_timeout_percent de 90,    
           ce qui implique que le délai d'attente de file d'attente est égal à 90 % du délai d'attente d'envoi dispatch_timeout value.  L'élément de         
           classification définit également SMF_request_activity_enabled=1, ce qui implique que les      
           9 enregistrements de sous-type SMF 120 sont collectés pour les demandes ciblées par rapport      
           à la méthode helloWorld.  Notez également que cet élément de classification ne définit pas        
           d'attribut transaction_class. Par conséquent, il hérite de l'attribut transaction_class de l'élément       
           ancêtre le plus proche qui en définit un.  Dans ce cas, l'élément ancêtre le plus proche           
           qui définit un attribut transaction_class est l'élément grand-parent,      
           "TC1".  Remarque : si des éléments ancêtres définissent un attribut transaction_class, l'élément de classification         
           hérite de l'attribut default_transaction_class de l'élément               
           InboundClassification.  L'attribut default_transaction_class dans               
           InboundClassification est nécessaire.                                                 
           Cet élément de classification hérite de l'attribut message_tag attribute de son élément       
           grand-parent, "EJBApp1".                                                 -->
      <iiop_classification_info  
        method_name="helloWorld" 
        dispatch_timeout="30" 
        queue_timeout_percent="90"
        SMF_request_activity_enabled="1" 
      /> 

      <!-- 
           La méthode goodbyeWorld définit un délai d'attente d'envoi dispatch_timeout de 60 secondes.  L'attribut           
           classification définit également l'attribut transaction_class, "TC1gbye" qui          
           remplace l'attribut transaction_class défini par son ancêtre.  Cet élément hérite    
           de l'attribut message_tag de son ancêtre "EJBApp1".                                     -->
      <iiop_classification_info  
        method_name="goodbyeWorld" 
        transaction_class="TC1gbye"
        dispatch_timeout="60" 
      /> 

    </iiop_classification_info>
  </iiop_classification_info>

  <!-- 
       IIOP classification info for app "EJBApp2".  L'élément de classification définit l'attribut      
       dispatch_timeout, un délai d'attente d'envoi de 15 secondes et l'attribut "EJBApp2".  L'attribut                    
       transaction_class est hérité de l'attribut default_transaction_class dans               
       InboundClassification, "TC".   Toutes les demandes qui sont classées sous cet élément de             
       classification ont un délai d'attente d'envoi de 15 secondes et tous les enregistrements de trace           
       et les messages de journal générés par ces demandes sont marqués de la valeur d'attribut           
       message_tag, "EJBApp2".                                            -->
  <iiop_classification_info 
    application_name="EJBApp2" 
    dispatch_timeout="15"
    message_tag="EJBApp2">

    <!-- 
         EJBApp2 contient deux modules JAR, "MyEJB2a.jar" et "MyEJB2b.jar".  Les deux éléments de    
         classification définissent l'attribut transaction_class pour chaque module JAR.  Aucun autre attribut n'est      
         défini.  Les deux éléments héritent des attributs de leurs noeuds         
         ancêtres (dispatch_timeout="15" et message_tag="EJBApp2").                 -->
    <iiop_classification_info  
      module_name="MyEJB2a.jar" 
      transaction_class="TC2a" 
    />

    <iiop_classification_info  
      module_name="MyEJB2b.jar" 
      transaction_class="TC2b" 
    />

  </iiop_classification_info>
    

  <!-- 
       L'élément de classification suivant définit les attributs d'un module,         
       d'un composant et d'une méthode de l'application "EJBApp3".  Le module est 
       "MyEJB3.jar", le composant     
       est "MyEJB3Class" et la méthode est "method3".   Les attributs transaction_class, dispatch_timeout   
       queue_timeout_percent, SMF_request_activity_enabled et                               
       SMF_request_activity_timestamps sont tous définis pour cette méthode dans l'application        
       EJBApp3.  Aucune autre méthode dans aucun autre EJB dans l'application
       n'est affectée de ces attributs.                                           -->
  <iiop_classification_info  
    application_name="EJBApp3" 
    module_name="MyEJB3.jar" 
    component_name="MyEJB3Class"
    method_name="method3" 
    transaction_class="TC3"
    dispatch_timeout="40" 
    queue_timeout_percent="90"
    SMF_request_activity_enabled="1" 
    SMF_request_activity_timestamps="1"
  /> 

</InboundClassification>


<!-- Internal Classification Rules -->
<InboundClassification 
  type="internal" 
  schema_version="1.0"
  default_transaction_class="internal" />

<!-- HTTP Classification Rules -->
<InboundClassification
  type="http"
  schema_version="1.0"
  default_transaction_class="HTC">

  <!-- 
       L'élément de classification suivant définit l'attribut transaction_class, "HTC8080", de       
       toutes les demandes HTTP reçues sur l'hôte "my.server.com" et le port "8080".  L'élément de               
       classification définit également les attributs RAS dispatch_timeout,                   
       queue_timeout_percent, timeout_recovery et stalled_thread_dump_action.  Tous           
       les éléments enfant sous cet élément héritent de ces attributs RAS.           --> 
  <http_classification_info 
    host="my.server.com"
    port="8080"
    transaction_class="HTC8080" 
    dispatch_timeout="100"
    queue_timeout_percent="98"
    timeout_recovery="session"
    stalled_thread_dump_action="javacore">

    <!-- 
         L'élément de classification suivant s'applique à toutes les demandes HTTP avec un identificateur URI qui    
         commence par "/PlantsByWebSphere/".  Chaque demande HTTP reçue sur l'hôte              
         my.server.com et sur le port 8080 avec un identificateur URI commençant par /PlantsByWebSphere       
         tombe dans cette classification (remarque : l'hôte et le port hérités de l'élément        
         parent).  L'élément de classification définit également l'attribut message_tag,        
         "plantsbw", qui est ajouté à chaque enregistrement de trace et message de journal géré      
         par une demande /PlantsByWebSphere/*.                                              -->
    <http_classification_info	
      uri="/PlantsByWebSphere/*"
      message_tag="plantsbw">
    
      <!-- 
           L'élément de classification suivant s'applique à toutes les demandes HTTP ayant un identificateur URI       
           correspond à "/PlantsByWebSphere/*.jpg (par exemple, /PlantsByWebSphere/mypic.jpg,         
           /PlantsByWebSphere/some/path/anotherpic.jpg).  Là encore, le filtre s'applique uniquement     
           aux demandes reçues sur l'hôte my.server.com et le port 8080 (comme indiqué par un         
           noeud ancêtre).   L'élément de classification définit l'attribut transaction_class,       
           "HTCPjpg" et l'attribut dispatch_timeout, "10".  Il hérite des attributs restants de ses noeuds      
           ancêtres.                                                        -->
      <http_classification_info	
        uri="*.jpg"
        transaction_class="HTCPjpg"
        dispatch_timeout="10"
      />

      <!-- 
           L'élément de classification suivant s'applique à toutes les demandes HTTP ayant un identificateur URI       
           qui correspond à "/PlantsByWebSphere/*.html (par exemple, /PlantsByWebSphere/index.html,       
           /PlantsByWebSphere/some/path/afile.html).                                       -->
      <http_classification_info	
        uri="*.html" 
        transaction_class="HTChtml" 
      />
    </http_classification_info>
  </http_classification_info>

  <!-- 
       L'élément de classification suivant définit l'attribut transaction_class, "HTC80", de toutes les demandes         
       HTTP reçues sur le port "80".  L'attribut host n'est pas défini. Par conséquent,          
       cet élément correspond à n'importe quel hôte.                                   -->
  <http_classification_info 
    port="80"
    transaction_class="HTC80" 
    dispatch_timeout="60"
    timeout_recovery="servant"
    message_tag="vanilla"
  />

</InboundClassification>

<!-- MDB Classification Rules -->
<InboundClassification
  type="mdb"
  schema_version="1.0"
  default_transaction_class="mdbdflt">
 
  <!-- Endpoint for LP 1414, skLP1, for MDB Plan 'A' Test  -->
  <endpoint
    type="messagelistenerport"
    name="skLP1"
    defaultclassification="lp1dft"
    description="Endpoint for LP 1414, skLP1, for MDB Plan 'A' Test">

    <classificationentry
      selector="JMSCorrelationID='TestCase1'"
      classification="lp1s1"
      description="New MDB Sample, TestCase1"
      cputimeused_limit="200101"
      request_timeout="20"
      dispatch_timeout="30"
      dpm_interval="0"
      queue_timeout_percent="20"
      stalled_thread_dump_action="traceback"
      />
  </endpoint>

</InboundClassification>


<!-- SIB Classification Rules -->
<SibClassification type="jmsra" schema_version="1.0" default_transaction_class="Dclass">
       <sib_classification_info transaction_class="Tclass"
                                bus="testbus"
                                destination="themoon"
                                description="test1"
                                dispatch_timeout="30"
                                queue_timeout_percent="20"
                                request_timeout="20"
                                stalled_thread_dump_action="traceback"
                                cputimeused_limit="200101"
                                cputimeused_dump_action="traceback"
                                dpm_interval="0"
                                dpm_dump_action="traceback"
                                classification_only_trace="1"
                                message_tag="sibreqst"
        />
   </SibClassification>

</Classification>

DTD :

Le DTD suivant définit les éléments et les attributs utilisés dans les exemples de documents de classification de charge de travail.

<?xml version='1.0' encoding="UTF-8"?>
<!ELEMENT Classification (InboundClassification|SibClassification|WMQRAClassification)+>
<!ATTLIST Classification schema_version CDATA #REQUIRED>
<!ELEMENT InboundClassification ((iiop_classification_info*|http_classification_info*|endpoint*|ola_classification_info*))>
<!ATTLIST InboundClassification type (iiop|mdb|http|internal|sip|ola) #REQUIRED>
<!ATTLIST InboundClassification default_transaction_class CDATA #REQUIRED>
<!ATTLIST InboundClassification schema_version CDATA #REQUIRED>
<!ATTLIST InboundClassification default_iiop_application_name CDATA #IMPLIED>
<!ATTLIST InboundClassification default_iiop_module_name CDATA #IMPLIED>
<!ATTLIST InboundClassification default_iiop_component_name CDATA #IMPLIED>
<!ELEMENT iiop_classification_info (iiop_classification_info*)>
<!-- inputs -->
<!ATTLIST iiop_classification_info activity_workload_classification CDATA #IMPLIED>
<!ATTLIST iiop_classification_info application_name CDATA #IMPLIED>
<!ATTLIST iiop_classification_info component_name CDATA #IMPLIED>
<!ATTLIST iiop_classification_info description CDATA #IMPLIED>
<!ATTLIST iiop_classification_info method_name CDATA #IMPLIED>
<!ATTLIST iiop_classification_info module_name CDATA #IMPLIED>
<!-- outputs -->
<!ATTLIST iiop_classification_info transaction_class CDATA #IMPLIED>
<!ATTLIST iiop_classification_info dispatch_timeout CDATA #IMPLIED>
<!-- control_region_wlm_dispatch_timeout -->
<!ATTLIST iiop_classification_info queue_timeout_percent CDATA #IMPLIED>
<!-- control_region_iiop_queue_timeout_percent -->
<!ATTLIST iiop_classification_info request_timeout CDATA #IMPLIED>
<!-- com.ibm.CORBA.RequestTimeout -->
<!ATTLIST iiop_classification_info stalled_thread_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED>
<!-- server_region_iiop_stalled_thread_dump_action -->
<!ATTLIST iiop_classification_info cputimeused_limit CDATA #IMPLIED>
      <!-- server_region_request_cputimeused_limit -->
<!ATTLIST iiop_classification_info cputimeused_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED>
  <!-- server_region_cputimeused_dump_action -->
<!ATTLIST iiop_classification_info dpm_interval CDATA #IMPLIED>
           <!-- MODIFY [JOBNAME],DPM,IIOP= -->
<!ATTLIST iiop_classification_info dpm_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED>
  <!-- server_region_dpm_dump_action -->
<!ATTLIST iiop_classification_info SMF_request_activity_enabled (0|1) #IMPLIED>
     <!-- server_SMF_request_activity_enabled -->
<!ATTLIST iiop_classification_info SMF_request_activity_timestamps (0|1) #IMPLIED>
  <!-- server_SMF_request_activity_timestamps -->
<!ATTLIST iiop_classification_info SMF_request_activity_security (0|1) #IMPLIED>
    <!-- server_SMF_request_activity_security -->
<!ATTLIST iiop_classification_info SMF_request_activity_CPU_detail (0|1) #IMPLIED>
  <!-- server_SMF_request_activity_CPU_detail -->
<!ATTLIST iiop_classification_info classification_only_trace (0|1) #IMPLIED>
<!ATTLIST iiop_classification_info message_tag CDATA #IMPLIED>

<!ELEMENT endpoint (classificationentry*)>
<!ATTLIST endpoint defaultclassification CDATA #REQUIRED>
<!ATTLIST endpoint name CDATA #REQUIRED>
<!ATTLIST endpoint type (messagelistenerport) #REQUIRED>
<!ATTLIST endpoint description CDATA #IMPLIED>
<!ELEMENT classificationentry EMPTY>
<!-- inputs -->
<!ATTLIST classificationentry selector CDATA #REQUIRED>
<!ATTLIST classificationentry description CDATA #IMPLIED>
<!-- outputs -->
<!ATTLIST classificationentry classification CDATA #REQUIRED>
<!ATTLIST classificationentry dispatch_timeout CDATA #IMPLIED>
       <!-- control_region_mdb_request_timeout -->
<!ATTLIST classificationentry queue_timeout_percent CDATA #IMPLIED>
  <!-- control_region_mdb_queue_timeout_percent -->
<!ATTLIST classificationentry request_timeout CDATA #IMPLIED>
        <!-- com.ibm.CORBA.RequestTimeout -->
<!ATTLIST classificationentry stalled_thread_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED>
 <!-- server_region_mdb_stalled_thread_dump_action -->
<!ATTLIST classificationentry cputimeused_limit CDATA #IMPLIED>
      <!-- server_region_request_cputimeused_limit -->
<!ATTLIST classificationentry cputimeused_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED>
  <!-- server_region_cputimeused_dump_action -->
<!ATTLIST classificationentry dpm_interval CDATA #IMPLIED>
           <!-- MODIFY [JOBNAME],DPM,IIOP= -->
<!ATTLIST classificationentry dpm_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED>
  <!-- server_region_dpm_dump_action -->
<!ATTLIST classificationentry SMF_request_activity_enabled (0|1) #IMPLIED>
     <!-- server_SMF_request_activity_enabled -->
<!ATTLIST classificationentry SMF_request_activity_timestamps (0|1) #IMPLIED>
  <!-- server_SMF_request_activity_timestamps -->
<!ATTLIST classificationentry SMF_request_activity_security (0|1) #IMPLIED>
    <!-- server_SMF_request_activity_security -->
<!ATTLIST classificationentry SMF_request_activity_CPU_detail (0|1) #IMPLIED>
  <!-- server_SMF_request_activity_CPU_detail -->
<!ATTLIST classificationentry classification_only_trace (0|1) #IMPLIED>
<!ATTLIST classificationentry message_tag CDATA #IMPLIED>
<!ELEMENT http_classification_info (http_classification_info*)>
<!-- inputs -->
<!ATTLIST http_classification_info host CDATA #IMPLIED>
<!ATTLIST http_classification_info port CDATA #IMPLIED>
<!ATTLIST http_classification_info uri CDATA #IMPLIED>
<!ATTLIST http_classification_info description CDATA #IMPLIED>
<!ATTLIST http_classification_info transaction_class CDATA #IMPLIED>
<!-- outputs -->
<!ATTLIST http_classification_info dispatch_timeout CDATA #IMPLIED>
       <!-- protocol_http_timeout_output -->
<!ATTLIST http_classification_info queue_timeout_percent CDATA #IMPLIED>
  <!-- control_region_http_queue_timeout_percent -->
<!ATTLIST http_classification_info request_timeout CDATA #IMPLIED>
        <!-- com.ibm.CORBA.RequestTimeout -->
<!ATTLIST http_classification_info stalled_thread_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED>
  <!-- server_region_http_stalled_thread_dump_action -->
<!ATTLIST http_classification_info cputimeused_limit CDATA #IMPLIED>
      <!-- server_region_request_cputimeused_limit -->
<!ATTLIST http_classification_info cputimeused_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED>
  <!-- server_region_cputimeused_dump_action -->
<!ATTLIST http_classification_info dpm_interval CDATA #IMPLIED>
           <!-- MODIFY [JOBNAME],DPM,HTTP= -->
<!ATTLIST http_classification_info dpm_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED>
  <!-- server_region_dpm_dump_action -->
<!ATTLIST http_classification_info SMF_request_activity_enabled (0|1) #IMPLIED>
     <!-- server_SMF_request_activity_enabled -->
<!ATTLIST http_classification_info SMF_request_activity_timestamps (0|1) #IMPLIED>
  <!-- server_SMF_request_activity_timestamps -->
<!ATTLIST http_classification_info SMF_request_activity_security (0|1) #IMPLIED>
    <!-- server_SMF_request_activity_security -->
<!ATTLIST http_classification_info SMF_request_activity_CPU_detail (0|1) #IMPLIED>
  <!-- server_SMF_request_activity_CPU_detail -->
<!ATTLIST http_classification_info classification_only_trace (0|1) #IMPLIED>
<!ATTLIST http_classification_info message_tag CDATA #IMPLIED>
<!ATTLIST http_classification_info timeout_recovery (servant|session) #IMPLIED>
     <!-- protocol_http_timeout_output_recovery -->

<!ELEMENT ola_classification_info (ola_classification_info*)>
<!ATTLIST ola_classification_info transaction_class CDATA #IMPLIED>
<!ATTLIST ola_classification_info propagate_transaction_name (true|false) #IMPLIED>
<!ATTLIST ola_classification_info service_name CDATA #IMPLIED>
<!ATTLIST ola_classification_info description CDATA #IMPLIED>
<!ATTLIST ola_classification_info dispatch_timeout CDATA #IMPLIED>
       <!-- control_region_wlm_dispatch_timeout -->
<!ATTLIST ola_classification_info queue_timeout_percent CDATA #IMPLIED>
  <!-- control_region_iiop_queue_timeout_percent -->
<!ATTLIST ola_classification_info request_timeout CDATA #IMPLIED>
        <!-- com.ibm.CORBA.RequestTimeout -->
<!ATTLIST ola_classification_info stalled_thread_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED>
 <!-- server_region_iiop_stalled_thread_dump_action -->
<!ATTLIST ola_classification_info cputimeused_limit CDATA #IMPLIED>
      <!-- server_region_request_cputimeused_limit -->
<!ATTLIST ola_classification_info cputimeused_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED>
  <!-- server_region_cputimeused_dump_action -->
<!ATTLIST ola_classification_info dpm_interval CDATA #IMPLIED>
           <!-- MODIFY [JOBNAME],DPM,IIOP= -->
<!ATTLIST ola_classification_info dpm_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED>
  <!-- server_region_dpm_dump_action -->
<!ATTLIST ola_classification_info SMF_request_activity_enabled (0|1) #IMPLIED>
     <!-- server_SMF_request_activity_enabled -->
<!ATTLIST ola_classification_info SMF_request_activity_timestamps (0|1) #IMPLIED>
  <!-- server_SMF_request_activity_timestamps -->
<!ATTLIST ola_classification_info SMF_request_activity_security (0|1) #IMPLIED>
    <!-- server_SMF_request_activity_security -->
<!ATTLIST ola_classification_info SMF_request_activity_CPU_detail (0|1) #IMPLIED>
  <!-- server_SMF_request_activity_CPU_detail -->
<!ATTLIST ola_classification_info classification_only_trace (0|1) #IMPLIED>
<!ATTLIST ola_classification_info message_tag CDATA #IMPLIED>

<!ELEMENT SibClassification (sib_classification_info+)>
<!ATTLIST SibClassification type (jmsra|destinationmediation) #REQUIRED>
<!ATTLIST SibClassification default_transaction_class CDATA #REQUIRED>
<!ATTLIST SibClassification schema_version CDATA #REQUIRED>
<!ELEMENT sib_classification_info EMPTY>
<!-- inputs -->
<!ATTLIST sib_classification_info selector CDATA #IMPLIED>
<!ATTLIST sib_classification_info bus CDATA #IMPLIED>
<!ATTLIST sib_classification_info destination CDATA #IMPLIED>
<!ATTLIST sib_classification_info discriminator CDATA #IMPLIED>
<!ATTLIST sib_classification_info description CDATA #IMPLIED>
<!-- outputs -->
<!ATTLIST sib_classification_info transaction_class CDATA #REQUIRED>
<!ATTLIST sib_classification_info dispatch_timeout CDATA #IMPLIED>
       <!-- control_region_wlm_dispatch_timeout -->
<!ATTLIST sib_classification_info queue_timeout_percent CDATA #IMPLIED>
  <!-- control_region_iiop_queue_timeout_percent -->
<!ATTLIST sib_classification_info request_timeout CDATA #IMPLIED>
        <!-- com.ibm.CORBA.RequestTimeout -->
<!ATTLIST sib_classification_info stalled_thread_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED>
 <!-- server_region_iiop_stalled_thread_dump_action -->
<!ATTLIST sib_classification_info cputimeused_limit CDATA #IMPLIED>
      <!-- server_region_request_cputimeused_limit -->
<!ATTLIST sib_classification_info cputimeused_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED>
  <!-- server_region_cputimeused_dump_action -->
<!ATTLIST sib_classification_info dpm_interval CDATA #IMPLIED>
           <!-- MODIFY [JOBNAME],DPM,IIOP= -->
<!ATTLIST sib_classification_info dpm_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED>
  <!-- server_region_dpm_dump_action -->
<!ATTLIST sib_classification_info SMF_request_activity_enabled (0|1) #IMPLIED>
     <!-- server_SMF_request_activity_enabled -->
<!ATTLIST sib_classification_info SMF_request_activity_timestamps (0|1) #IMPLIED>
  <!-- server_SMF_request_activity_timestamps -->
<!ATTLIST sib_classification_info SMF_request_activity_security (0|1) #IMPLIED>
    <!-- server_SMF_request_activity_security -->
<!ATTLIST sib_classification_info SMF_request_activity_CPU_detail (0|1) #IMPLIED>
  <!-- server_SMF_request_activity_CPU_detail -->
<!ATTLIST sib_classification_info classification_only_trace (0|1) #IMPLIED>
<!ATTLIST sib_classification_info message_tag CDATA #IMPLIED>

<!ELEMENT WMQRAClassification (wmqra_classification_info+)>
<!ATTLIST WMQRAClassification default_transaction_class CDATA #REQUIRED>
<!ATTLIST WMQRAClassification schema_version CDATA #REQUIRED>
<!ELEMENT wmqra_classification_info EMPTY>
<!-- inputs -->
<!ATTLIST wmqra_classification_info selector CDATA #IMPLIED>
<!ATTLIST wmqra_classification_info queue_manager CDATA #IMPLIED>
<!ATTLIST wmqra_classification_info destination CDATA #IMPLIED>
<!ATTLIST wmqra_classification_info description CDATA #IMPLIED>
<!-- outputs -->
<!ATTLIST wmqra_classification_info transaction_class CDATA #REQUIRED>
<!ATTLIST wmqra_classification_info dispatch_timeout CDATA #IMPLIED>
       <!-- control_region_wlm_dispatch_timeout -->
<!ATTLIST wmqra_classification_info queue_timeout_percent CDATA #IMPLIED>
  <!-- control_region_iiop_queue_timeout_percent -->
<!ATTLIST wmqra_classification_info request_timeout CDATA #IMPLIED>
        <!-- com.ibm.CORBA.RequestTimeout -->
<!ATTLIST wmqra_classification_info stalled_thread_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED>
 <!-- server_region_iiop_stalled_thread_dump_action -->
<!ATTLIST wmqra_classification_info cputimeused_limit CDATA #IMPLIED>
      <!-- server_region_request_cputimeused_limit -->
<!ATTLIST wmqra_classification_info cputimeused_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED>
  <!-- server_region_cputimeused_dump_action -->
<!ATTLIST wmqra_classification_info dpm_interval CDATA #IMPLIED>
           <!-- MODIFY [JOBNAME],DPM,IIOP= -->
<!ATTLIST wmqra_classification_info dpm_dump_action (none|svcdump|javacore|heapdump|traceback|javatdump) #IMPLIED>
  <!-- server_region_dpm_dump_action -->
<!ATTLIST wmqra_classification_info SMF_request_activity_enabled (0|1) #IMPLIED>
     <!-- server_SMF_request_activity_enabled -->
<!ATTLIST wmqra_classification_info SMF_request_activity_timestamps (0|1) #IMPLIED>
  <!-- server_SMF_request_activity_timestamps -->
<!ATTLIST wmqra_classification_info SMF_request_activity_security (0|1) #IMPLIED>
    <!-- server_SMF_request_activity_security -->
<!ATTLIST wmqra_classification_info SMF_request_activity_CPU_detail (0|1) #IMPLIED>
  <!-- server_SMF_request_activity_CPU_detail -->
<!ATTLIST wmqra_classification_info classification_only_trace (0|1) #IMPLIED>
<!ATTLIST wmqra_classification_info message_tag CDATA #IMPLIED>

Exemple de classification de demande entrante HTTP

Utilisez la demande HTTP suivante avec l'exemple de document de classification de charge de travail z/OS décrit précédemment contenant des attributs RAS :

http://my.server.com:8080/PlantsByWebSphere/plants/newOrder.html

Comme cette demande est une demande HTTP, le serveur d'applications analyse uniquement les éléments http_classification_info. Le serveur d'applications les analyse selon l'ordre dans lequel ils apparaissent dans le fichier de classification de charge de travail.

Le serveur d'applications recherche d'abord l'élément http_classification_info suivant dans l'exemple de document de classification de charge de travail z/OS qui content des attributs RAS :
  <http_classification_info 
    host="my.server.com"
    port="8080"
    transaction_class="HTC8080" 
    dispatch_timeout="100"
    queue_timeout_percent="98"
    timeout_recovery="session"
    stalled_thread_dump_action="javacore">
Cet élément a les attributs et valeurs d'entrée host="my.server.com" et port="8080". Comme ces attributs correspondent à la demande HTTP entrante, le serveur d'applications accède à cet élément et compare le noeud enfant. Le serveur d'applications recherche l'élément enfant suivant :
  <http_classification_info	
      uri="/PlantsByWebSphere/*"
      message_tag="plantsbw">
L'élément enfant définit l'attribut et la valeur d'entrée uri="/PlantsByWebSphere/*" qui correspond à l'identificateur URI de l'identificateur URI de demande entrante. Le serveur d'applications analyse ensuite les enfants de l'élément. Il recherche d'abord le premier élément enfant :
      <http_classification_info	
        uri="*.jpg"
        transaction_class="HTCPjpg"
        dispatch_timeout="10"
      />
Cet élément enfant contient l'attribut et la valeur uri="*.jpg". Comme cette paire attribut-valeur ne correspond pas à l'identificateur URI d'entrée, le serveur d'applications passe à l'élément enfant suivant. Le serveur d'applications trouve le deuxième élément enfant :
  <http_classification_info	
        uri="*.html" 
        transaction_class="HTChtml" 
      />
Cet élément enfant contient l'attribut uri="*.html" et la valeur qui correspond à l'identificateur URI d'entrée.
Comme aucun autre élément enfant n'existe, l'élément de classification classe la demande. Le serveur d'applications affecte à la demande tous les attributs de sortie de cet élément de classification et tous ses éléments ancêtres. Les paires attribut-valeur suivantes correspondent à la liste complète des paires attribut-valeur que le serveur d'applications affecte à la demande :
dispatch_timeout="100"
  queue_timeout_percent="98"
  timeout_recovery="session"
  stalled_thread_dump_action="javacore"
  message_tag="plantsbw"
  transaction_class="HTChtml"
Le serveur d'applications lit les attributs RAS non définis dans le fichier de classification de charge de travail depuis la configuration serveur et les affecte à la demande. Les propriétés appropriées de configuration serveur, y compris les données de classification remplacées, se trouvent dans la liste suivante :
  protocol_http_timeout_output                    -- overridden by dispatch_timeout 
  control_region_http_queue_timeout_percent       -- overridden by queue_timeout_percent
  com.ibm.CORBA.RequestTimeout 
  server_region_http_stalled_thread_dump_action   -- overridden by stalled_thread_dump_action
  server_region_request_cputimeused_limit 
  server_region_cputimeused_dump_action 
  server_region_dpm_dump_action
  server_SMF_request_activity_enabled 
  server_SMF_request_activity_timestamps 
  server_SMF_request_activity_CPU_detail
  protocol_http_timeout_output_recovery           -- overridden by timeout_recovery
Pour les propriétés de configuration serveur que les données de classification ne remplacent pas, la demande hérite de la valeur de propriété de serveur.

Exemple de classification de demande entrante IIOP

Utilisez la demande IIOP suivante avec l'exemple de document de classification de charge de travail z/OS décrit précédemment contenant les attributs RAS :

IIOP inbound request for MyEJB2bBean.someMethod() in module MyEJB2b.jar from application EJBApp2.

Comme la demande entrante est une demande IIOP, le serveur recherche uniquement les éléments iiop_classification_info. Le serveur d'applications recherche d'abord l'élément iiop_classification_info suivant dans l'exemple de fichier de classification de charge de travail z/OS qui contient des attributs RAS :
<iiop_classification_info 
    application_name="EJBApp1" 
    transaction_class="TC1" 
    message_tag="EJBApp1">
Cet élément a un attribut d'entrée et la valeur application_name="EJBApp1". Le nom d'application EJBApp1 dans l'attribut application_name ne correspond pas au nom d'application EJBApp2 de la demande entrante. Par conséquent, le serveur d'applications ignore cet élément de classification et tous ses éléments enfant et passe à l'élément suivant. Le serveur d'applications recherche l'élément suivant :
<iiop_classification_info 
    application_name="EJBApp2" 
    dispatch_timeout="15"
    message_tag="EJBApp2">
Cet élément a un attribut d'entrée et la valeur application_name="EJBApp2". Comme cette paire attribut-valeur correspond au nom d'application de la demande entrante, l'analyseur accède à l'élément suivant. Il recherche d'abord le premier élément enfant :
<iiop_classification_info  
      module_name="MyEJB2a.jar" 
      transaction_class="TC2a" 
    />
Cet élément contient l'attribut d'entrée et la valeur module_name="MyEJB2a.jar". Comme cette paire attribut-valeur ne correspond pas au nom de module MyEJB2b.jar de la demande entrante, le serveur d'applications analyse l'élément enfant suivant :
<iiop_classification_info  
      module_name="MyEJB2b.jar" 
      transaction_class="TC2b" 
    />
Cet élément contient l'attribut et la valeur module_name="MyEJB2b.jar". Le nom du module MyEJB2b.jar dans l'attribut module_name correspond au nom du module de la demande entrante. Comme aucun autre élément enfant n'existe, le serveur d'applications classe la demande dans cet élément. La demande hérite de tous les attributs de sortie de cet élément et de tous les éléments ancêtres. Les paires attribut-valeur suivantes correspondent à la liste complète des paires attribut-valeur que le serveur d'applications affecte à la demande :
  dispatch_timeout="15"
  message_tag="EJBApp2"
  transaction_class="TC2b"
Le serveur d'applications lit les attributs RAS non définis dans le fichier de classification de charge de travail depuis la configuration serveur et les affecte à la demande. Les propriétés appropriées de configuration serveur, y compris les données de classification remplacées, se trouvent dans la liste suivante :
  control_region_wlm_dispatch_timeout             -- overridden by dispatch_timeout 
  control_region_iiop_ queue_timeout_percent       
  com.ibm.CORBA.RequestTimeout 
  server_region_iiop_stalled_thread_dump_action  
  server_region_request_cputimeused_limit 
  server_region_cputimeused_dump_action 
  server_region_dpm_dump_action
  server_SMF_request_activity_enabled 
  server_SMF_request_activity_timestamps 
  server_SMF_request_activity_CPU_detail
Pour les propriétés de configuration serveur que les données de classification ne remplacent pas, la demande hérite de la valeur de propriété de serveur.

Icône indiquant le type de rubrique Rubrique de référence



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=rrun_wlm_tclass_dtd
Nom du fichier : rrun_wlm_tclass_dtd.html