Vous pouvez utiliser un document commun de classification de charge de travail pour classer les demandes de travail HTTP, IIOP, SIP (Session Initiation Protocol), OLA (adaptateur local optimisé) et MDB (bean géré par message) pour z/OS Workload Manager.
Pourquoi et quand exécuter cette tâche
Un fichier de document de classification de charge de travail est un fichier XML dans lequel vous classez les demandes de travail entrantes HTTP, IIOP, SIP (Session Initiation Protocol), OLA (adaptateur local optimisé) et MDB (bean géré par message) et les attribuez à une classe de transaction (TCLASS). La valeur TCLASS, si elle est attribuée, est transférée au MVS Workload Manager. WLM utilise la valeur TCLASS pour classer les demandes de travail entrantes et attribuer une classe de service ou une classe de service de rapport à chaque demande.
Vous devez vous reporter au document de classification de charge de travail pour classer les demandes de travail dans un environnement z/OS.
La prise en charge des autres mécanismes WebSphere Application Server de classification de travail en environnementz/OS
est obsolète. Ces mécanismes ne doivent plus être utilisés.
Si vous souhaitez classer le travail pour les beans gérés par message déployés sur les ressources JCA 1.5
avec le fournisseur de messagerie par défaut, ou souhaitez classer le travail de médiation à utiliser
avec les bus d'intégration de services, vous devez définir un élément de classification qui utilise les éléments SibClassification. Vous devez également effectuer les opérations de z/OS Workload
Manager requises pour utiliser la valeur TCLASS"SIBUS".
Si vous remplacez un port d'écoute par une spécification d'activation utilisable par les applications MDB avec le fournisseur de messagerie Version 6 par défaut, vous devez remplacer toutes les classifications InboundClassification type="mdb" liées par des classifications
SibClassifications type="jmsra".
Si vous souhaitez classer le travail pour les beans gérés par message déployés selon la spécification d'activation du fournisseur de messagerie WebSphere MQ, vous devez définir un élément de classification qui utilise les éléments WMQRAClassification Vous devez également effectuer les opérations de z/OS Workload
Manager requises pour utiliser la valeur TCLASS "WMQRA". Si vous remplacez un port d'écoute par une spécification d'activation JMS utilisable par les applications MDB avec le fournisseur de messagerie WebSphere MQ, vous devez remplacer toutes les classifications InboundClassification type="mdb" liées par des classifications WMQRAClassification
- Développez le document de classification de charge de travail. Utilisez les informations de la rubrique Fichier de classification de charge de travail pour créer le document. La rubrique contient des exemples de document de classification de la charge de travail, avec et sans attributs RAS. Utilisez un document de classification de la charge de travail, qu'il s'agisse de classifier la charge de travail z/OS ou d'implémenter la granularité RAS (Reliability Availability and Serviceability).
- Si vous créez le document sur un système z/OS avec la page de codes IBM-1047, habituellement utilisée pour les fichiers HFS, convertissez le fichier au format ASCII avant de l'utiliser. Utilisez l'une des options suivantes pour
convertir un document de travail en un document pouvant être utilisé par le serveur :
- native2ascii
Ceci est un utilitaire du Java™ kit de développement de logiciels qui permet de convertir un fichier de la page de codes native à la page de codes ASCII. Par exemple, si vous travaillez sur un document
XML appelé x5sr02.classification.ebcdic.xml et souhaitez créer un document appelé x5sr02.classification.xml, utilisez la commande suivante :
/u/userid -> native2ascii \
x5sr02.classification.ebcdic.xml > x5sr02.classification.xml
La ligne de commande est
scindée par une barre oblique inversée (
\) afin de passer à la ligne pour des raisons d'affichage.
- iconv
Ceci est un z/OS utilitaire qui permet de convertir des fichiers d'une page de codes donnée à une autre page de codes. Par exemple, si vous travaillez sur un document
XML appelé x5sr02.classification.ebcdic.xml et souhaitez créer un document appelé x5sr02.classification.xml, utilisez la commande suivante :
/u/userid -> iconv -f IBM-1047 -t UTF-8 \
x5sr02.classification.ebcdic.xml >x5sr02.classification.xml
La ligne de commande est
scindée par une barre oblique inversée (
\) afin de passer à la ligne pour des raisons d'affichage.
- Créez le document sur votre poste de travail, puis envoyez le fichier par FTP au format binaire à l'emplacement correct sur le système z/OS . Cette solution vous permet également de créer le fichier Classification.dtd dans le même répertoire que le document de classification de charge de travail. Vous pouvez ensuite procéder à une vérification de validité XML sur le document avant de l'installer sur un serveur. Utilisez tout type d'analyseur syntaxique. Vous pouvez par exemple utiliser le plan de travail WebSphere Application
Developer pour construire et valider le document de classification de charge de travail.
- Indiquez l'emplacement du document de classification de charge de travail dans la console
d'administration. Utilisez la variable wlm_classification_file
pour définir le fichier XML contenant les informations de classification.
Dans la console d'administration, cliquez sur . Vous pouvez définir la variable au niveau cellule, noeud ou instance de serveur. Si vous définissez la variable au niveau de la cellule ou du noeud, les informations doivent être
accessibles et applicables à tous les serveurs qui héritent de la spécification
du noeud ou de la cellule.
- Effectuez les opérations z/OS Workload Manager requises pour utiliser les valeurs TCLASS. Une classe de service et/ou une classe de service de rapport doit être attribuée à chaque TCLASS, à l'enclave sous laquelle le travail est exécuté. Les règles de classification CB doivent être mises à jour.
Pour classer le travail pour les beans gérés par message déployés sur les ressources JCA 1.5
avec le fournisseur de messagerie par défaut, ou pour classer le travail de médiation à utiliser
avec les bus d'intégration de services, vous devez effectuer les opérations z/OS Workload
Manager requises pour utiliser la valeur TCLASS "SIBUS".
Les classes de transaction sont utilisées comme
sous-règles pour établir les classes de services et les transactions. Les valeurs TCLASS ne sont pas utilisées comme règles de premier niveau. Si vous décidez d'utiliser TCLASS
comme règle de premier niveau et non comme sous-règle, vous devez prêter attention à l'ordre des règles. La première règle de niveau un qui s'applique au travail est utilisée. Davantage de règles particulières doivent par conséquent être utilisées au premier niveau, suivies des règles générales.
Par exemple, examinez les deux exemples suivants de règles de classification CB :Subsystem-Type Xref Notes Options Help
--------------------------------------------------------------------------
Modify Rules for the Subsystem Type Row 1 to 17 of 17
Command ===> ____________________________________________ SCROLL ===> CSR
Subsystem Type . : CB Fold qualifier names? Y (Y or N)
Description . . . CB Class'n w/WLM Trans. CLASSes
Action codes: A=After C=Copy M=Move I=Insert rule
B=Before D=Delete row R=Repeat IS=Insert Sub-rule
More ===>
--------Qualifier-------- -------Class--------
Action Type Name Start Service Report
DEFAULTS: CBCLASS RWASDEF
____ 1 CN P5SR01* 1 CBCLASS RTP5CLUS
____ 1 TC A0 ___ CBHUTCH RP5A0
____ 1 TC A1 ___ CBHUTCH RP5A1
____ 1 TC A1B ___ CBHUTCH RP5A1B
____ 1 CN WSIVP2* ___ CBSLOW RWSIVP
____ 1 CN T%SERV* 1 CBFAST RTSMIGT
____ 1 CN B4* ___ CBFAST ________
Dans l'exemple précédent, les affectations de TCLASS effectuées pour les enclaves exécutées dans le serveur P5SR01x ne sont jamais utilisées par le gestionnaire de charge de travail. Lorsque la règle suivante est exécutée, aucune autre recherche dans la table de classification n'est effectuée :
____ 1 CN P5SR01* 1 CBCLASS
Les affectations TCLASS ne sont pas utilisées. Toutes les enclaves exécutées sur les serveurs P5SR01x sont affectées à la classe de services CBCLASS et à la classe de rapport RTP5CLUS.
Subsystem-Type Xref Notes Options Help
--------------------------------------------------------------------------
Modify Rules for the Subsystem Type Row 1 to 17 of 17
Command ===> ____________________________________________ SCROLL ===> CSR
Subsystem Type . : CB Fold qualifier names? Y (Y or N)
Description . . . CB Class'n w/WLM Trans. CLASSes
Action codes: A=After C=Copy M=Move I=Insert rule
B=Before D=Delete row R=Repeat IS=Insert Sub-rule
More ===>
--------Qualifier-------- -------Class--------
Action Type Name Start Service Report
DEFAULTS: CBCLASS RWASDEF
____ 1 TC A0 ___ CBHUTCH RP5A0
____ 1 TC A1 ___ CBHUTCH RP5A1
____ 1 TC A1B ___ CBHUTCH RP5A1B
____ 1 CN P5SR01* 1 CBCLASS RTP5CLUS
____ 1 CN WSIVP2* ___ CBSLOW RWSIVP
____ 1 CN T%SERV* 1 CBFAST RTSMIGT
____ 1 CN B4* ___ CBFAST ________
Dans l'exemple
précédent, si des valeurs TCLASS A0, A1 ou A1B sont fournies dans la
classification, elles sont utilisées quel que soit le serveur qui exécute le travail. Dans ce cas, le nom du serveur est uniquement utilisé si ces trois valeurs TCLASS ne sont pas présentes.
- Implémentez les modifications apportées au fichier. Vous pouvez redémarrer le serveur d'applications, ou recharger dynamiquement le document de classification de la charge de travail sans qu'il soit nécessaire de redémarrer le serveur :
Si le document de classification de charge de travail n'est pas un
document XML valide, il est ignoré par le serveur d'applications et le message suivant s'affiche :
BBOJ0085E PROBLEMS ENCOUNTERED PARSING WLM CLASSIFICATION XML FILE (0)
- Utilisez la commande d'opérateur DISPLAY WORK pour afficher les informations de classification. Cette commande permet de déterminer si votre schéma de classification classe le travail comme vous l'avez prévu. Exécutez la commande suivante pour afficher les informations de classification IIOP, HTTP, INTERNAL, SIP, MDB et OLA :
MODIFY|F <servername>, DISPLAY,WORK,CLINFO
Exécutez cette commande pour chaque serveur d'applications. L'exemple suivant montre le résultat possible de la nouvelle commande d'opérateur :
00- SY1 f bbos001,display,work,clinfo
SY1 BBOJ0129I: The /tmp/wlm4.class.xml workload classification file was loaded at
2009/07/14 19:33:35.297 (GMT).
SY1 BBOO0281I CLASSIFICATION COUNTERS FOR IIOP WORK
SY1 BBOO0282I CHECKED 0, MATCHED 0, USED 0, COST 2, DESC: IIOP root
SY1 BBOO0282I CHECKED 0, MATCHED 0, USED 0, COST 4, DESC: leotag
SY1 BBOO0282I CHECKED 0, MATCHED 0, USED 0, COST 3, DESC: byetag
SY1 BBOO0282I CHECKED 0, MATCHED 0, USED 0, COST 4, DESC: hellotag
SY1 BBOO0283I FOR IIOP WORK: TOTAL CLASSIFIED 0, WEIGHTED TOTAL COST 0
SY1 BBOO0281I CLASSIFICATION COUNTERS FOR HTTP WORK
SY1 BBOO0282I CHECKED 2, MATCHED 2, USED 0, COST 2, DESC: HTTP root
SY1 BBOO0282I CHECKED 2, MATCHED 2, USED 0, COST 4, DESC: plantta4
SY1 BBOO0282I CHECKED 2, MATCHED 1, USED 1, COST 3, DESC: giftag4
SY1 BBOO0282I CHECKED 1, MATCHED 1, USED 1, COST 4, DESC: jpgtag4
SY1 BBOO0283I FOR HTTP WORK: TOTAL CLASSIFIED 2, WEIGHTED TOTAL COST 7
SY1 BBOO0188I END OF OUTPUT FOR COMMAND DISPLAY,WORK,CLINFO
Explication du résultat de la commande :- BBOJ0129I : Le fichier de classification des charges de travail fichier a été chargé à heure. Le message indique le fichier de classification de la charge de travail actif et l'heure de son chargement.
- BBOO0281I CLASSIFICATION COUNTERS FOR type WORK.
Message d'en-tête des messages ; affiche l'utilisation des règles de classification de charge de travail. La valeur type peut être HTTP, IIOP, INTERNAL, SIP, OLA ou MDB.
- BBOO0282I CHECKED n1, MATCHED n2,
USED n3, COST n4, DESC: text.
Ce message affiche des informations sur une règle particulière lors de la classification de charge de travail. Ces informations sont les suivantes :
- n1 - Nombre d'examens de la règle.
- n2 - Nombre de concordances avec la règle obtenues par la requête.
- n3 - Nombre de fois où cette règle a réellement été utilisée.
- n4 - Coût d'utilisation de la règle ou nombre de comparaisons
requises pour déterminer s'il s'agit bien de la règle à utiliser.
- texte - Texte descriptif de la règle de classification ;
permet de savoir quelle règle de classification est affichée.
Le coût total n2 divisé par le nombre total de demandes
classées n1 est égal au coût d'utilisation de la table. Plus la valeur est proche de un, plus le coût d'utilisation des règles définies est faible. La valeur 1 indique qu'il y a seulement la classification par défaut et qu'aucune demande ne lui correspond.
- Répétez cette procédure jusqu'à ce que vous obteniez la répartition de charge de travail et les coûts optimaux.