CHGSHRPOOL

Modifier pool mémoire partagé

En bref

La commande CHGSHRPOOL (Modifier pool mémoire partagé) permet à l'utilisateur de modifier la taille mémoire, le niveau d'activité ou les valeurs de réglage d'un pool partagé.

CHGSHRPOOL se lit CHG (Modifier) + SHRPOOL. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CHGSHRPOOL POOL(…)

Paramètres

POOL Identificateur du pool obligatoire
SIZE Taille mémoire
ACTLVL Niveau d'activité
PAGING Option de pagination
TEXT Texte 'descriptif'
MINFAULT Taux de pagination minimal
JOBFAULT Taux pagination par unité exéc
MAXFAULT Taux de pagination maximal
PTY Priorité
MINPCT % mémoire minimale allouée
MAXPCT % mémoire maximale allouée

Astuce : dans une session 5250, tapez CHGSHRPOOL puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande CHGSHRPOOL (Modifier pool mémoire partagé) permet à l'utilisateur de modifier la taille mémoire, le niveau d'activité ou les valeurs de réglage d'un pool partagé. Pour ce faire, seuls les droits sur cette commande sont nécessaires. Lors de l'augmentation de la taille du pool partagé, si le pool est actif (utilisé par un sous-système, par un travail actif ou pour les données), les modifications prennent effet immédiatement. Dans le cas contraire, les modifications deviennent effectives lors du lancement d'un sous-système utilisant le pool.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
POOL	Identificateur du pool	MACHINE, BASE, INTERACT, SPOOL, SHRPOOL1, SHRPOOL2, SHRPOOL3, SHRPOOL4, SHRPOOL5, SHRPOOL6, SHRPOOL7, SHRPOOL8, SHRPOOL9, SHRPOOL10, SHRPOOL11, SHRPOOL12, SHRPOOL13, SHRPOOL14, SHRPOOL15, SHRPOOL16, SHRPOOL17, SHRPOOL18, SHRPOOL19, SHRPOOL20, SHRPOOL21, SHRPOOL22, SHRPOOL23, SHRPOOL24, SHRPOOL25, SHRPOOL26, SHRPOOL27, SHRPOOL28, SHRPOOL29, SHRPOOL30, SHRPOOL31, SHRPOOL32, SHRPOOL33, SHRPOOL34, SHRPOOL35, SHRPOOL36, SHRPOOL37, SHRPOOL38, SHRPOOL39, SHRPOOL40, SHRPOOL41, SHRPOOL42, SHRPOOL43, SHRPOOL44, SHRPOOL45, SHRPOOL46, SHRPOOL47, SHRPOOL48, SHRPOOL49, SHRPOOL50, SHRPOOL51, SHRPOOL52, SHRPOOL53, SHRPOOL54, SHRPOOL55, SHRPOOL56, SHRPOOL57, SHRPOOL58, SHRPOOL59, SHRPOOL60	Obligatoire, positionnel 1
SIZE	Taille mémoire	Valeurs uniques: SAME, NOSTG Autres valeurs: Liste d'éléments	Facultatif, positionnel 2
	Élément 1: Nombre d'unités	Entier
	Élément 2: Unité de mesure	KB, MB
ACTLVL	Niveau d'activité	Entier, SAME, DATA	Facultatif, positionnel 3
PAGING	Option de pagination	SAME, FIXED, *CALC	Facultatif, positionnel 4
TEXT	Texte 'descriptif'	Valeur caractère, SAME, BLANK	Facultatif
MINFAULT	Taux de pagination minimal	Nombre décimal, SAME, DFT	Facultatif
JOBFAULT	Taux pagination par unité exéc	Nombre décimal, SAME, DFT	Facultatif
MAXFAULT	Taux de pagination maximal	Nombre décimal, SAME, DFT	Facultatif
PTY	Priorité	1-14, SAME, DFT	Facultatif
MINPCT	% mémoire minimale allouée	0.0-100.0, SAME, DFT	Facultatif
MAXPCT	% mémoire maximale allouée	0.0-100.0, SAME, DFT	Facultatif

Identificateur du pool (POOL)

Identifie le pool partagé en cours de modification. Pour plus de détails sur les pools mémoire, reportez-vous aux rubriques Work Management et Backup and Recovery du manuel IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Ce paramètre est obligatoire.

*MACHINE: La modification porte sur le pool machine utilisé pour le microcode sous licence, dont seule la taille est modifiable. L'utilisation de la commande CHGSYSVAL (Modifier une valeur système) pour modifier la valeur QMCHPOOL permet d'aboutir au même résultat.
*BASE: La modification porte sur le pool de base, dont seul le niveau d'activité est modifiable. L'utilisation de la commande CHGSYSVAL pour modifier la valeur système QBASACTLVL permet d'aboutir au même résultat.
*INTERACT: La modification porte sur le pool partagé utilisé par les travaux interactifs.
*SPOOL: La modification porte sur le pool partagé utilisé par les éditeurs de spoule.
*SHRPOOLnn: La modification porte sur un pool partagé général. Il existe soixante pools partagés généraux, identifiés par les valeurs spéciales *SHRPOOL1 à *SHRPOOL60.

Taille mémoire (SIZE)

Indique la taille du pool de stockage. Il s'agit de la quantité de mémoire principale pouvant être utilisée par le pool. Une valeur au moins égale à 256 kilooctets doit être indiquée. Le second élément de ce paramètre indique si la taille est exprimée en kilooctets ou en mégaoctets.

Valeurs uniques

*SAME: La taille mémoire n'est pas modifiée.
*NOSTG: Le pool ne dispose pas de mémoire, ni de niveau d'activité. Cette valeur ne peut pas être associée à un pool en cours d'utilisation par un sous-système ou un travail actif, ou bien à un pool disposant d'une mémoire réservée.

Elément 1 : Nombre d'unités

entier: Indiquez la taille mémoire du pool de stockage.
Remarque :Toute modification de taille d'un ASP peut nécessiter d'écrire des pages dans la mémoire secondaire. La durée nécessaire à une modification d'ampleur par le système peut être supérieure au temps d'attente indiqué par défaut. Si cela se produit, le message CPF1001 (Délai d'attente expiré pour réponse système.) est généré, même si la modification aboutit.

Elément 2 : Unité de mesure

*KB: La taille est spécifiée en kilooctets (unités de 1024 octets).
*MB: La taille est spécifiée en mégaoctets (unités de 1048576 octets).

Niveau d'activité (ACTLVL)

Indique le nombre maximal d'unités d'exécution exécutables simultanément dans le pool.

*SAME: Le niveau d'activité n'est pas modifié.
*DATA: Aucune unité d'exécution ne peut s'exécuter dans le pool. Les unités d'exécution ne sont utilisées que pour les données. Un pool ne peut pas être modifié depuis ou vers *DATA s'il est en cours d'utilisation.
entier: Indiquez le niveau d'activité du pool.

Option de pagination (PAGING)

Indique l'option de pagination associée au pool. Cette option détermine l'ajustement dynamique ou non par le système des caractéristiques de pagination pour le pool de mémoire afin d'obtenir des performances optimales. Les pools au niveau d'activité *DATA ne sont pas ajustés dynamiquement par le système.

*SAME: La valeur reste inchangée.
*FIXED: Les valeurs par défaut du système sont utilisées. L'ajustement dynamique des caractéristiques de pagination pour le pool de mémoire n'est pas effectué.
*CALC: L'ajustement dynamique des caractéristiques de pagination est effectué pour le pool de mémoire afin d'obtenir des performances optimales.

Texte 'descriptif' (TEXT)

Indique le texte décrivant brièvement le pool partagé.

*SAME: Le texte n'est pas modifié.
*BLANK: Aucun texte n'est indiqué.
valeur-alphanumérique: Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Taux de pagination minimal (MINFAULT)

Indique le taux de pagination minimal par seconde à utiliser pour le pool de mémoire. Cette valeur est utilisée par le système si la valeur système QPFRADJ est 2 ou 3 (ajustement automatique). Les pools au niveau d'activité *DATA ne sont pas ajustés automatiquement par le système.

*SAME: La valeur ne change pas.

*DFT: Le taux de pagination minimal correspond à la valeur par défaut du système pour ce pool.
nombre-décimal: Indiquez le taux de pagination minimal par seconde à utiliser pour ce pool.

Taux pagination par unité exéc (JOBFAULT)

Indique le taux de pagination par seconde à utiliser pour le pool de mémoire pour chaque unité d'exécution active. Chaque travail est composé d'une ou plusieurs unités d'exécution. Une unité d'exécution est considérée comme active lorsqu'elle utilise les ressources UC. Cette valeur est utilisée par le système si la valeur système QPFRADJ est 2 ou 3 (ajustement automatique). Les pools au niveau d'activité *DATA ne sont pas ajustés automatiquement par le système.

*SAME: La valeur ne change pas.

*DFT: Le taux de pagination par seconde pour chaque unité d'exécution active correspond à la valeur par défaut du système pour ce pool.
nombre-décimal: Indiquez le taux de pagination par seconde pour chaque unité d'exécution active, à utiliser pour ce pool.

Taux de pagination maximal (MAXFAULT)

Indique le taux de pagination maximal par seconde à utiliser pour le pool de mémoire. Cette valeur est utilisée par le système si la valeur système QPFRADJ est 2 ou 3. Les pools au niveau d'activité *DATA ne sont pas ajustés automatiquement par le système.

*SAME: La valeur ne change pas.

*DFT: Le taux de pagination maximal correspond à la valeur par défaut du système pour ce pool.
nombre-décimal: Indiquez le taux de pagination maximal par seconde à utiliser pour ce pool.

Priorité (PTY)

Indique la priorité de ce pool par rapport à la priorité des autres pools mémoire. La plage de valeurs admises pour les priorités est comprise entre 1 (valeur la plus élevée) et 14 (valeur la plus basse). Cette valeur est utilisée par le système si la valeur système QPFRADJ est 2 ou 3. Les pools au niveau d'activité *DATA ne sont pas ajustés automatiquement par le système.

*SAME: La valeur ne change pas.

*DFT: La priorité du pool de mémoire correspond à la valeur par défaut du système pour ce pool.
1-14: Indiquez la priorité du pool de mémoire.

% mémoire minimale allouée (MINPCT)

Indique la quantité minimale de mémoire à attribuer au pool de mémoire (sous forme d'un pourcentage de la mémoire principale totale). Cette valeur est utilisée par le système si la valeur système QPFRADJ est 2 ou 3. Les pools au niveau d'activité *DATA ne sont pas ajustés automatiquement par le système.

*SAME: La valeur ne change pas.

*DFT: La taille de pool minimale correspond à la valeur par défaut du système pour le pool.
0.0-100.0: Indiquez le pourcentage de mémoire principale totale à utiliser comme taille minimale pour le pool de mémoire.

% mémoire maximale allouée (MAXPCT)

Indique la quantité maximale de mémoire à attribuer au pool de mémoire (sous forme d'un pourcentage de la mémoire principale totale). La taille maximale d'un pool est déterminée par ce pourcentage et par la quantité de mémoire attribuée aux autres pools actifs. Cette valeur est utilisée par le système si la valeur système QPFRADJ est 2 ou 3. Les pools au niveau d'activité *DATA ne sont pas ajustés automatiquement par le système.

*SAME: La valeur ne change pas.

*DFT: La taille maximale du pool correspond à la valeur par défaut du système pour le pool.
0.0-100.0: Indiquez le pourcentage de mémoire principale totale à utiliser comme taille maximale pour le pool de mémoire.

Exemples

Exemple 1: Modification de la taille du pool interactif

CHGSHRPOOL   POOL(*INTERACT)  SIZE(4200)
             ACTLVL(*SAME)  PAGING(*SAME)

Cette commande permet de modifier la taille du pool interactif à 4200 kilo-octets. Le niveau d'activité et l'option de pagination restent inchangés.

Exemple 2: Modification d'un pool de façon à ne le rendre utilisable que pour les données

CHGSHRPOOL   POOL(*SHRPOOL5)  SIZE(80000)
             ACTLVL(*DATA)  TEXT('pool de données pour LINUX1 NWSD')

Cette commande permet de transformer le pool partagé 5 en pool de données à 80000 kilo-octets. Ce niveau d'activité empêche l'exécution des travaux dans le pool.

Messages d'erreur

Messages *ESCAPE

CPF1001: Délai d'attente expiré pour réponse système.
CPF1076: Valeur indiquée incorrecte pour valeur système &1.
CPF1078: Valeur système &1 non modifiée.
CPF113A: La somme de MINFAULT et JOBFAULT est supérieure à la valeur de MAXFAULT.
CPF113B: Pourcentage mémoire minimale supérieur au pourcentage mémoire maximale.
CPF113C: Attributs de pool privé non modifiés.
CPF115D: Pool partagé &1 non modifié.
CPF1157: Pool partagé &1 non modifié en *NOSTG.
CPF1165: Paramètre indiqué non admis pour le pool *MACHINE.
CPF1166: Paramètre indiqué non admis pour le pool *BASE.
CPF1167: Le paramètre ACTLVL n'a pas été précisé pour le pool &1.
CPF1225: Paramètre SIZE non indiqué pour le pool &1.
CPF1831: L'utilisateur n'est pas autorisé à modifier la valeur système &1.
CPF1864: L'utilisateur n'est pas autorisé à modifier la valeur système &1.