![[z/OS]](../images/ngzos.gif)
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">
- 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: 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">
- 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.
<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: 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
<InboundClassification type="mdb"
schema_version="1.0"
default_transaction_class="qrs">
<endpoint type="messagelistenerport"
name="IPVListenerPort"
defaultclassification="MDBX"
description="ABC">
- 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.
<classificationentry selector="Location='East'"
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é < et le symbole > avec la référence d'entité >. De la même façon, si vous utilisez une apostrophe ou les guillemets, utilisez les références des entités ' et ".
- 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
<SibClassification type="jmsra"
schema_version="1.0"
default_transaction_class="a">
<sib_classification_info
transaction_class="sibb"
selector="user.Location='East'"
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é < et le symbole > par la référence d'entité >. De la même façon, si vous utilisez une apostrophe ou les guillemets, utilisez les références des entités ' et ".
- 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é.
<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
<SibClassification type="destinationmediation"
schema_version="1.0"
default_transaction_class="b">
<sib_classification_info
transaction_class="e"
selector="user.Location='East'"
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é < et le symbole > par la référence d'entité >. De la même façon, si vous utilisez une apostrophe ou les guillemets, utilisez les références des entités ' et ".
- 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).
- 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é.
<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
<WMQRAClassification default_transaction_class="TC99" schema_version="1.0">
<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>3 AND JMSPriority<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é < et le symbole > par la référence d'entité >. De la même façon, si vous utilisez une apostrophe ou les guillemets, utilisez les références des entités ' et ".
- 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é.
<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='East'" classification="MDB1" description="DEF"/> <classificationentry selector="Location<>'East'" 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='East'" bus="magic" destination="nowhere" description="n" /> <sib_classification_info transaction_class="c" selector="user.Location='West'" 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='East'" destination="themoon" discriminator="sides/dark" description="n" /> <sib_classification_info transaction_class="f" selector="user.Location='West'" 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>7" description="high priorities maps to TC_2"/> <wmqra_classification_info transaction_class="TC_3" selector="JMSPriority>3 AND JMSPriority<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.
<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.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.
<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.