For z/OS platforms

Classification WLM pour z/OS

Syntaxe et notes de support à propos de Liberty pour la fonction de gestion de charge de travail (WLM) z/OS.

Une enclave WLM est associée à l'unité sur laquelle la demande est répartie. Elle est également associée à la classe de service WLM. Une classe de service WLM est affectée à l'enclave WLM par WLM, selon les règles que vous définissez dans la configuration WLM. La classe de service WLM indique les objectifs WLM pour chaque classe de travail client, par exemple, 95 % terminé en 1 seconde ou moins. La classe de service WLM indique également l'importance des objectifs par rapport aux autres travaux du système. WLM utilise les informations fournies par le serveur Liberty lors de la classification pour affecter une classe de service WLM. Les trois propriétés suivantes aident WLM à classifier le travail :
Type de sous-système
Pour WebSphere, le type de sous-système est CB.
Nom de la collection
Nom du serveur exécutant le travail. Vous pouvez créer des règles de classification WLM qui sont basées sur le serveur exécutant le travail.
Classe de transaction
Nom déterminé à partir de la classification du travail dans le code Liberty. La classe de transaction est basée sur la configuration Liberty que vous fournissez pour la requête qui est en cours de distribution. Vous pouvez affecter différentes classes de transaction à différentes applications dans le même serveur et donc différentes classes de service WLM.
Syntaxe pour la configuration dans le fichier server.xml :
<featureManager>
	<feature>zosWlm-1.0</feature>
</featureManager>

<wlmClassification>
	<httpClassification transactionClass="CLASS001" host="127.0.0.1" port="9080" method="GET"
                      resource="/testResource" />
</wlmClassification>
Tableau 1. Valeurs par défaut
Attributs Valeurs par défaut
transactionClass="" Chaîne vide
host="*" Valeur générique
port="*" Valeur générique
method="*" Valeur générique
resource="*" Valeur générique
Important :
  • Tous les attributs de l'élément <httpClassification ... /> sont facultatifs.
  • Si vous activez WLM sans spécifier au moins une règle, la gestion de charge de travail sera active, mais aucune enclave ne sera créée.
  • Les règles de classification ont un ordre de priorité décroissant : chaque règle est prioritaire sur toutes celles qui sont en dessous d'elle dans la configuration.
  • Les classes de transaction peuvent être en casse mixte.
  • Il est possible de spécifier des plages de valeurs pour les ports. Par exemple, port="9080-9085".
  • Les ports et les méthodes peuvent être spécifiés sous forme de listes séparées par des virgules. Par exemple, port="9043,9080" ou method="GET,PUT".
  • Les ressources peuvent être spécifiées à l'aide de caractères génériques . Un astérisque représente n'importe quel nombre de caractères, et est utilisé comme caractère générique représentant la chaîne entre deux caractères de séparateur de chemin (/). Deux astérisques consécutifs représentent n'importe quel nombre de caractères incluant le séparateur de chemin. Deux astérisques ne peut pas apparaître avec d'autres caractères dans une paire de séparateurs de chemin.
    • resource="/test*/*" renvoie une correspondance avec /testaa/bb.html, mais non pas avec /testaa/bb/cc.html
    • resource="*.html" renvoie une correspondance avec /aaa.html, mais non pas avec /aaa/bbb.html
    • resource="/go/set*/**/archive.jsp" renvoie une correspondance avec /go/seta/bb/2/archive.jsp, /go/setaa/bb/2/archive.jsp et avec /go/set/archive.jsp
    • La valeur par défaut, si resource= n'est pas spécifié, renvoie une correspondance avec TOUTES les chaînes, et est équivalente à l'expression resource="/**/*", laquelle renvoie une correspondance avec /aaa, /aaa/bbb et /aaa/bbb/ccc.html
Exemple de configuration :
<wlmClassification>
	<httpClassification transactionClass="CLASS004" resource="/res2"/>
	<httpClassification transactionClass="CLASS003" resource="/res1"/>
	<httpClassification transactionClass="CLASS002" port="9043" />
	<httpClassification transactionClass="CLASS001" />
</wlmClassification>
Notes :
  • Les règles 1 et 2 envoient toutes les demandes entrantes à leurs ressources respectives.
  • La règle 3 intercepte toute demande entrante ne ciblant aucune des deux ressources listées plus haut, mais ciblant le port 9043
  • La règle 4 est une sorte de règle "attrape-tout" qui intercepte toute demande entrante n'ayant pas déjà été interceptée par les règles qui précèdent.

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

Nom du fichier : rwlp_wlmclassification.html