Commande chclass

Objectif

Modifiez les attributs et les droits d'accès aux ressources d'une classe de gestion de charge de travail.

Syntaxe

chclass '-a Attribut=Valeur {[-a Attribut=Valeur]...} [ -c | -m | -b | -v | -C | -B | -P | -T | -L | -V | -A Mot clé=Valeur] [ -d Config_Dir] [ -S SuperClass] Nom

Descriptif

La commande chclass modifie les attributs de la classe identifiée par le paramètre Nom . La classe doit déjà exister. Pour modifier un attribut, indiquez le nom de l'attribut et la nouvelle valeur à l'aide du paramètre Attribut=Valeur. Pour modifier une limite ou une valeur de partages, utilisez l'option -c pour l'unité centrale, -m pour la mémoire et -b pour le débit d'E-S du disque, avec la valeur du mot clé dans min, softmax, hardmax ou partages. Pour définir les limites totales du processus (les limites qui s'appliquent à chaque processus de la classe), utilisez une ou plusieurs des options -CtotalCPU, -BtotalDiskIO), -AtotalConnectTime), ou '-v (totalVirtualMemoryLimit), avec la valeur du mot-clé 'hardmax. Pour définir les limites totales de la classe (les limites qui s'appliquent à l'ensemble de la classe), utilisez une ou plusieurs des options -PtotalProcesses, -TtotalThreads), -LtotalLogins), ou '-V (totalVirtualMemoryLimit), avec la valeur du mot-clé 'hardmax. Pour réinitialiser une limite totale, utilisez - pour Valeur. Les limites de processus, de classe ou les deux peuvent être désactivées lors du démarrage ou de la mise à jour de WLM (voir la commande wlmcntrl ).

Remarque: seul l'utilisateur root peut modifier les attributs d'une superclasse. Seuls les utilisateurs root ou autorisés dont l'ID utilisateur ou l'ID groupe correspond au nom d'utilisateur ou au nom de groupe spécifié dans les attributs adminuser et admingroup d'une superclasse peuvent modifier les attributs d'une sous-classe de cette superclasse.

Normalement, chclass met à jour les attributs d'une classe dans les fichiers de propriétés WLM appropriés et les modifications sont appliquées à la définition de classe interne (classes actives) uniquement après une mise à jour de WLM à l'aide de la commande wlmcntrl .

Si une chaîne vide est transmise en tant que nom de configuration (Config_dir) avec l'indicateur -d , la modification s'applique uniquement aux attributs de classe in-core et aucun fichier de propriétés n'est mis à jour, ce qui rend les modifications temporaires (la modification est perdue si WLM est arrêté et redémarré ou si le système est réamorcé).

Remarque: Cette commande ne peut pas s'appliquer à un ensemble de configurations basées sur le temps (ne spécifiez pas d'ensemble avec l'indicateur -d ). Si la configuration en cours est définie, l'indicateur -d doit être indiqué pour indiquer la configuration standard à laquelle la commande doit s'appliquer.

Attributs

Les modifications possibles sont décrites ci-dessous :

Propriétés de classe:

Article Descriptif
niveau Indique la valeur tier . La valeur tier d'une classe correspond à la position de la classe dans la hiérarchie de l'opportunité de la limitation des ressources pour toutes les classes. Une classe avec une valeur de niveau inférieure est plus favorisée. La valeur tier est comprise entre 0 et 9 (la valeur par défaut est 0).
héritage Si l'attribut héritage est défini sur yes, les enfants des processus de cette classe restent dans la classe lors de la commande exec , quelles que soient les règles d'affectation automatique en vigueur. Si l'attribut héritage est défini sur no, les règles d'affectation s'appliquent normalement. La valeur par défaut, si elle n'est pas spécifiée, est no.
localshm Indique si les segments de mémoire auxquels accèdent les processus de différentes classes restent locaux par rapport à la classe à laquelle ils ont été affectés initialement ou s'ils sont affectés à la classe Partagée . Vous pouvez spécifier la valeur Yes ou No. S'il n'est pas spécifié, la valeur par défaut est No.
utilisateur_auth Indique le nom de l'utilisateur autorisé à affecter des processus à cette classe. La valeur par défaut lorsque l'attribut n'est pas spécifié est root.
groupe_auth Indique le nom du groupe d'utilisateurs autorisé à affecter des processus à cette classe. Il n'existe pas de valeur par défaut.
rset Indique le nom d'un ensemble de ressources auquel les processus de la classe ont accès. Par défaut, la classe a accès à toutes les ressources du système.
vmenforce Indique si tous les processus ou uniquement les processus incriminés dans la classe doivent être arrêtés lorsque la classe atteint la limite maximale de la machine virtuelle. Vous pouvez spécifier la valeur de class ou proc. La valeur par défaut est proc.
delshm Indique si les segments partagés seront supprimés lorsque le dernier processus les référençant se termine en raison d'un dépassement de mémoire virtuelle. Vous pouvez spécifier la valeur de yes ou no. La valeur par défaut est no.
utilisateur_admin Indique le nom de l'utilisateur autorisé à administrer les sous-classes de cette superclasse. Cet attribut est valide uniquement pour les superclasses. La valeur par défaut, lorsque l'attribut n'est pas spécifié, est une chaîne nulle et, dans ce cas, seuls les utilisateurs root peuvent administrer les sous-classes.
Remarque: Si l'attribut adminuser ou admingroup est modifié pour une superclasse appartenant à la configuration en cours d'exécution (ou à une configuration de l'ensemble en cours d'exécution), une mise à jour WLM globale doit être effectuée pour refléter ces modifications dans la configuration interne, ailleurs, Les mises à jour qui sont limitées à la superclasse par un tel utilisateur peuvent échouer en raison d'un manque de droits.
groupe_admin Indique le nom de groupe du groupe d'utilisateurs autorisé à administrer les sous-classes de cette superclasse. Cet attribut est valide uniquement pour les superclasses. La valeur par défaut, lorsque l'attribut n'est pas spécifié, est une chaîne nulle, ce qui signifie qu'aucun groupe ne peut administrer les sous-classes.
Remarque: Si l'attribut adminuser ou admingroup est modifié pour une superclasse appartenant à la configuration en cours d'exécution (ou à une configuration de l'ensemble en cours d'exécution), une mise à jour WLM globale doit être effectuée pour refléter ces modifications dans la configuration interne, ailleurs, Les mises à jour qui sont limitées à la superclasse par un tel utilisateur peuvent échouer en raison d'un manque de droits.
priorité d'E-S Indique la priorité affectée aux demandes d'E-S. Les demandes d'E-S sont émises par les unités d'exécution qui sont classées dans la classe. La priorité est utilisée pour définir la priorité des mémoires tampon d'E-S au niveau de l'unité. Si l'unité de stockage ne prend pas en charge les priorités d'E-S, la priorité est ignorée. Les valeurs de priorité d'E-S valides sont comprises entre 0 et 15.

Limites de classe et partages pour l'unité centrale, la mémoire ou la ressource d'E-S de disque:

Article Descriptif
min. Indique le pourcentage minimal de la ressource qui doit être rendue disponible à la demande, exprimé en pourcentage de la ressource totale disponible dans le système. Les valeurs possibles sont comprises entre 0 et 100 (la valeur par défaut est 0).
catégories Indique le rapport maximal de la ressource pouvant être mise à disposition en cas de conflit. Ce paramètre est exprimé en partages de la ressource totale disponible dans le système. Le rapport réel de la ressource est calculé de manière dynamique, proportionnellement aux partages de toutes les classes actives. Si une classe n'a pas de processus en cours d'exécution, ses partages sont exclus du calcul. Les partages sont des nombres arbitraires allant de 1 à 65535. Si les partages sont spécifiés sous la forme d'un trait d'union (-), la classe est toujours prise en compte sur la cible et son utilisation pour cette ressource n'est pas réglementée par WLM, mais les limites minimale et maximale, le cas échéant, s'appliquent toujours. Il s'agit de la valeur par défaut si les partages d'une ressource ne sont pas spécifiés.
softmax Indique le pourcentage maximal de la ressource pouvant être rendue disponible en cas de conflit. Les valeurs possibles sont comprises entre 1 et 100 (la valeur par défaut est 100). Une classe peut dépasser son maximum souple pour une ressource donnée s'il n'y a pas de conflit sur la ressource.
hardmax Indique le pourcentage maximal de la ressource pouvant être mise à disposition, même s'il n'y a pas de conflit. Les valeurs possibles sont comprises entre 1 et 100 (la valeur par défaut est 100). La spécification d'une valeur différente de la valeur par défaut de 100 pour la mémoire peut entraîner l'inutilisation de certaines pages de mémoire, tandis que certains processus de la classe en utilisent davantage.
maximal Indique le pourcentage maximal de la ressource pouvant être mise à disposition, même s'il n'y a pas de conflit. Les valeurs possibles sont comprises entre 1 et 100 (la valeur par défaut est 100). La spécification d'une valeur différente de la valeur par défaut de 100 pour la mémoire peut entraîner l'inutilisation de certaines pages de mémoire, tandis que certains processus de la classe en utilisent davantage.

Note : Les valeurs par défaut d'une classe peuvent être lues à l'aide de la commande lsclass -D et peuvent être modifiées en éditant manuellement les fichiers de propriétés classes, parts ou limites afin d'ajouter une section par défaut. Pour plus d'informations sur ces fichiers, voir Guide de référence des fichiers.

Description de la classe:

Article Descriptif
Description Le texte de la description de classe peut être composé de n'importe quel caractère ASCII, à l'exception des signes deux-points (:) et des virgules (,).

Indicateurs

Article Descriptif
-A hardmax=Valeur Définit la durée maximale pendant laquelle une session de connexion dans la classe peut rester active. La valeur est spécifiée sous la forme d'un entier, en ajoutant éventuellement l'unité (s pour les secondes, m pour les minutes, h pour les heures, d pour les jours et w pour les semaines, la valeur par défaut étant les secondes). A mesure qu'un utilisateur s'approche de cette limite de temps de connexion, WLM envoie un message d'avertissement au terminal de session. Lorsque la limite est atteinte, l'utilisateur est averti et le responsable de session reçoit le signal SIGTERM et, après un court délai de grâce, la session est arrêtée (SIGKILL).
-b Mot clé=Valeur Modifie une limite ou une valeur de partages pour le débit d'E-S de disque. Les mots-cléspossibles sont min, softmax, hardmax ou shares.
-B hardmax=Valeur Définit la quantité totale d'E-S de disque autorisée pour chaque processus de la classe. La valeur est indiquée sous la forme d'un entier, avec possibilité d'ajout de l'unité (Ko pour les kilooctets, Mo pour les mégaoctets, To pour les téraoctets, Po pour les pétaoctets et EB pour les exaoctets, la valeur par défaut étant les kilooctets). Une fois qu'un processus a utilisé cette quantité d'E-S de disque, le processus reçoit le signal SIGTERM et, après un délai de grâce, il est arrêté (SIGKILL).
-c Mot clé=Valeur Modifie une limite ou une valeur de partage pour une unité centrale. Les mots-cléspossibles sont min, softmax, hardmax ou shares.
-C hardmax=Valeur Définit la quantité totale de temps UC autorisée pour chaque processus de la classe. La valeur est spécifiée sous la forme d'un entier, en ajoutant éventuellement l'unité (s pour les secondes, m pour les minutes, h pour les heures, d pour les jours et w pour les semaines, la valeur par défaut étant les secondes). Une fois qu'un processus a utilisé ce délai, il reçoit le signal SIGTERM et, après un délai de grâce, il est arrêté (SIGKILL).
-d Rép_config Utilise le répertoire /etc/wlm/Config_Dir comme répertoire de remplacement pour les fichiers de propriétés. Si cet indicateur n'est pas présent, les fichiers de configuration en cours dans le répertoire désigné par /etc/wlm/current sont utilisés. Si une chaîne vide est transmise comme nom de configuration (-d "") les modifications n'affectent que la définition de classe interne et aucun fichier de configuration n'est modifié.
-L hardmax=Valeur Définit le nombre total de sessions de connexion disponibles simultanément dans la classe. Si un utilisateur tente de se connecter au système et que le shell de connexion se trouve dans une classe qui a atteint la limite du nombre total de connexions, l'opération de connexion échouera.
-m Mot clé=Valeur Modifie une limite ou une valeur de partage pour la mémoire. Les mots-cléspossibles sont min, softmax, hardmax ou shares.
-P hardmax=Valeur Définit le nombre maximal de processus autorisés dans la classe. Si une opération aboutit à l'entrée d'un nouveau processus dans la classe alors que la classe contient autant de processus, l'opération échoue.
-S SuperClass Indique le nom de la superclasse lors de la modification des attributs d'une sous-classe. Il existe deux façons de spécifier que la modification doit être appliquée à la sous-classe Sub de la superclasse Super:
  1. Spécifiez le nom complet de la sous-classe comme Super.Sub et n'utilisez pas -S
  2. Utilise l'indicateur -S pour donner le nom de la superclasse et utiliser le nom court de la sous-classe :
    chclass options -S Super  Sub
-T hardmax=Valeur Définit le nombre maximal d'unités d'exécution autorisées dans la classe. Si une opération aboutit à l'entrée d'une nouvelle unité d'exécution dans la classe alors que cette classe contient autant de processus, l'opération échoue. La limite totale des unités d'exécution doit être au moins égale à la limite totale des processus pour une classe. Si une classe a une limite de nombre total d'unités d'exécution mais qu'aucune limite de nombre total de processus n'est spécifiée, la limite de nombre total de processus est définie sur la limite de nombre total d'unités d'exécution.
-v hardmax=Valeur Indique la limite de mémoire virtuelle autorisée par processus dans la classe spécifiée. La quantité maximale de mémoire virtuelle autorisée par processus est (2 ^ 31) -1 pour les noyaux 32 bits et (2 ^ 63) -1 pour les noyaux 64 bits.
-V hardmax=Valeur Indique la mémoire virtuelle autorisée pour la classe spécifiée. La quantité maximale de mémoire virtuelle autorisée par processus est (2 ^ 31) -1 pour les noyaux 32 bits et (2 ^ 63) -1 pour les noyaux 64 bits.

Security

Attention aux utilisateurs RBAC: cette commande peut effectuer des opérations privilégiées. Seuls les utilisateurs privilégiés peuvent exécuter des opérations privilégiées. Pour plus d'informations sur les autorisations et les privilèges, consultez la base de données des commandes privilégiées disponible dans Sécurité. Pour la liste des privilèges et autorisations associés à cette commandes, reportez-vous à la commande lssecattr ou à la sous-commande getcmdattr.

Fichiers

Article Descriptif
classes Contient les noms et les définitions des classes.
limites Contient les limites de ressources appliquées aux classes.
catégories Contient les attributs de partages de ressources pour chaque classe.