CHGSBSD

La commande Modifier descr de sous-système CHGSBSD (Modifier une description de sous-système) permet de modifier les attributs opérationnels de la description de sous-système indiquée. Vous pouvez modifier cette dernière alors que le sous-système est actif. Cependant, vous ne pouvez pas indiquer la valeur *RMV au paramètre Pools mémoire POOLS, car le travail risque d'être interrompu.

Restrictions :

1. Pour utiliser cette commande, vous devez détenir les droits suivants :
   • les droits opérationnels sur les objets (*OBJOPR), de gestion des objets (*OBJMGT) et de lecture (*READ) sur la description de sous-système indiquée, et le droit d'exécution (*EXECUTE) sur la bibliothèque contenant la description de sous-système
   • les droits sur tous les objets (*ALLOBJ) et l'administration de la sécurité (*SECADM) pour indiquer une entrée de liste de bibliothèque.
   • les droits sur tous les objets (*ALLOBJ) et l'administration de la sécurité (*SECADM) pour indiquer un nom de groupe de pool de mémoire secondaire (ASP).
2. Lorsque le sous-système est actif, vous ne pouvez pas indiquer la valeur *RMV au paramètre POOLS, car le travail risque d'être interrompu.
3. Vous ne pouvez pas modifier la valeur du paramètre ASPGRP pendant que le sous-système est actif.

Paramètres

Description de sous-système (SBSD)

Indique le nom et la bibliothèque de la description de sous-système à modifier.

Ce paramètre est obligatoire.

Qualificatif 1 : Description de sous-système

nom

Indiquez le nom de la description de sous-système à modifier.

Qualificatif 2 : Biblio

*LIBL

Une recherche s'effectue sur toutes les bibliothèques figurant dans la liste des bibliothèques d'unité d'exécution, afin de trouver une occurrence.

*CURLIB

L'objet est recherché dans la bibliothèque en cours de l'unité d'exécution. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom

Indiquez la bibliothèque dans laquelle figure la description de sous-système.

Pools mémoire (POOLS)

Indique les identificateurs d'une ou plusieurs définitions de pools mémoire ainsi que les modifications apportées.

Pour qu'une définition de pool existante puisse être enlevée, le sous-système doit être inactif.

La taille et le niveau d'activité ne sont pas modifiés pour chacune des définitions de pool existantes non indiquées.

Valeurs uniques

*SAME

Les définitions de pools mémoire dans la description de sous-système ne sont pas modifiées.

Autres valeurs (jusqu'à 10 répétitions)

Elément 1 : Identificateur du pool

1-10

Indiquez l'identificateur de pool de la définition de pool de mémoire à modifier.

Elément 2 : Taille mémoire

*BASE

La définition de pool indiquée correspond au pool de mémoire de base du système, lequel peut être partagé avec d'autres sous-systèmes. La taille minimale et le niveau d'activité de ce pool sont indiqués dans les valeurs système QBASPOOL et QBASACTLVL.

*NOSTG

Initialement, il n'est pas attribué de mémoire et de niveau d'activité au pool. (Il est inactif.)

*RMV

La définition de pool de mémoire indiquée est supprimée de la description de sous-système.

*INTERACT

La définition de pool indiquée est le pool partagé pour les travaux interactifs. Sa taille et son niveau d'activité sont précisés par la commande Modifier pool mémoire partagé CHGSHRPOOL.

*SPOOL

La définition de pool indiquée est le pool partagé à l'usage des éditeurs du spoule. Sa taille et son niveau d'activité sont précisés par la commande CHGSHRPOOL.

*SHRPOOLnn

La définition de pool indiquée est un pool partagé général. Il existe 60 pools partagés généraux qui sont identifiés par les valeurs spéciales *SHRPOOL1 à *SHRPOOL60. Leur taille et leur niveau d'activité sont précisés par la commande CHGSHRPOOL.

nombre-entier

Indiquez la taille mémoire du pool de stockage spécifié. Une valeur au moins égale à 256 kilooctets doit être indiquée. La taille est spécifiée en kilooctets à l'aide de l'élément 4 : Unité de mesure.

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 3 : Niveau d'activité

nombre-entier

Indiquez le nombre maximal d'unités d'exécution pouvant s'exécuter simultanément dans le pool.

Elément 4 : Unité de mesure

*KB

La taille du pool de stockage est exprimée en kilooctets.

*MB

La taille du pool de stockage est exprimée en mégaoctets.

Nombre maximal de travaux (MAXJOBS)

Indique le nombre maximal de travaux qui peuvent être actifs simultanément dans le sous-système contrôlé par cette description de sous-système. Ce nombre maximal s'applique à la totalité des travaux démarrés et qui sont en attente ou en cours d'exécution, à l'exclusion des travaux qui figurent dans la file d'attente ou sont terminés.

*SAME

Le nombre maximal de travaux admis dans le sous-système ne change pas.

*NOMAX

Aucun maximum n'est fixé pour le nombre de travaux admis dans ce sous-système.

0-32000

Indiquez le nombre maximal de travaux admis dans ce sous-système.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*SAME

Le texte, s'il existe, ne change pas.

*BLANK

Aucun texte n'est spécifié.

valeur-alphanumérique

Entrez, entre apostrophes, un texte de 50 caractères au maximum.

Fichier écran d'ouverture (SGNDSPF)

Indique le nom et la bibliothèque du fichier écran d'ouverture utilisé pour l'affichage des écrans d'ouverture sur les postes de travail alloués au sous-système. Si le fichier écran d'ouverture indiqué n'existe pas lors de la création ou de la modification de la description de sous-système, vous devez indiquer un qualifiant de bibliothèque car le nom qualifié du fichier écran d'ouverture est conservé par le système. Le fichier écran d'ouverture doit contenir un format d'enregistrement portant le nom SIGNON.

Remarque :Le fichier écran d'ouverture peut être modifié lorsque le sous-système est actif. Toutefois, le nouveau fichier écran d'ouverture ne sera utilisé que lors du prochain démarrage du sous-système.

Remarque :Vous devez disposer du droit d'utilisation (*USE) pour pouvoir vérifier le format du fichier écran. Il est ainsi possible de vérifier le bon fonctionnement de l'écran lors du démarrage du sous-système. Si vous ne possédez pas le droit sur le fichier écran ou sur sa bibliothèque, la vérification des formats ne pourra être réalisée.

Valeurs uniques

*SAME

La valeur en cours pour le fichier écran d'ouverture reste inchangée.

*QDSIGNON

Le fichier écran d'ouverture QDSIGNON de QSYS est utilisé lors de l'affichage d'écrans d'ouverture sur les postes de travail alloués au sous-système.

Qualificatif 1 : Fichier écran d'ouverture

nom

Indiquez le nom du fichier écran d'ouverture à utiliser.

Qualificatif 2 : Biblio

*LIBL

Une recherche s'effectue sur toutes les bibliothèques figurant dans la liste des bibliothèques d'unité d'exécution, afin de trouver une occurrence.

*CURLIB

L'objet est recherché dans la bibliothèque en cours de l'unité d'exécution. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom

Indiquez la bibliothèque dans laquelle figure le fichier écran d'ouverture.

Bibliothèque système associée (SYSLIBLE)

Indique une bibliothèque à placer en tête de la liste des bibliothèques, dans la partie système de la liste des travaux démarrés dans le sous-système. Ce paramètre vous permet d'utiliser une bibliothèque langue secondaire.

Restrictions :

1. Ce paramètre peut être modifié lorsque le sous-système est actif. Toutes les modifications apportées prendront effet pour les nouveaux travaux lancés. La liste des bibliothèques des travaux actifs dans le sous-système n'est pas modifiée.
2. La bibliothèque langue secondaire ne doit pas être indiquée dans les valeurs système QSYSLIBL ou QUSRLIBL. Pour que la bibliothèque langue secondaire puisse être admise dans la partie système de la liste de bibliothèques, QSYSLIBL doit contenir moins de 15 bibliothèques.
3. Pour indiquer une valeur autre que *NONE au poste liste des bibliothèques système, vous devez détenir les droits spéciaux *ALLOBJ et *SECADM.

*SAME

La liste des bibliothèques système n'est pas modifiée.

*NONE

La bibliothèque de langue secondaire est enlevée de la liste des bibliothèques système.

nom

Indiquez le nom de la bibliothèque à ajouter à la liste des bibliothèques système.

Groupe ASP (ASPGRP)

Indique le nom d'un groupe d'ASP qui doit être inclus dans l'espace de nom de bibliothèque du travail de moniteur de sous-système. Le nom de groupe d'ASP est le nom de l'unité du pool de mémoire secondaire principal au sein du groupe d'ASP.

Lorsque le travail de moniteur de sous-système crée un travail utilisateur, la description du travail se trouve dans l'espace de nom de bibliothèque du travail de moniteur de sous-système. Les files d'attente de travaux, le fichier écran de connexion et la bibliothèque de sous-système se trouvent dans l'espace de nom de bibliothèque du travail de moniteur de sous-système.

Lorsque le travail de moniteur de sous-système effectue un travail pour le compte d'un travail utilisateur, le sous-système utilise l'espace de nom de bibliothèque du travail utilisateur. Le programme et la classe se trouvent dans l'espace de nom de bibliothèque du travail utilisateur. Pour ces objets, le paramètre ASPGRP contenu dans la description de sous-système est sans effet.

Lorsqu'un travail de moniteur de sous-système sollicite un groupe d'ASP, les travaux figurant dans ce sous-système doivent utiliser le même groupe d'ASP. Utilisez le paramètre INLASPGRP (Groupe d'ASP initial) pour la description du travail de sorte que le groupe d'ASP soit défini pendant la création du travail et serve à trouver d'autres objets pendant la création du travail. La cohérence entre le travail de moniteur de sous-système et le travail utilisateur est particulièrement importante pour les postes de travail à démarrer, car le sous-système peut être amené à trouver le programme afin de déterminer quelle description du travail utiliser.

Restrictions :

1. L'espace de nom de bibliothèque du travail de moniteur de sous-système pour le sous-système de contrôle ne contient pas de groupe d'ASPGRP. Si une valeur autre que *NONE est indiquée dans la description du sous-système de contrôle, elle est ignorée.
2. L'espace de nom de bibliothèque du travail de moniteur de sous-système pour le sous-système QSYSWRK ne contient pas de groupe d'ASPGRP. Si une valeur autre que *NONE est indiquée dans la description du sous-système QSYSWRK, elle est ignorée.
3. Le groupe d'ASP doit être mis sous tension et avoir le statut 'Disponible' avant le démarrage du sous-système.
4. Le sous-système doit être arrêté avant que le groupe d'ASP ne soit mis hors tension.
5. Ce paramètre ne peut pas être modifié lorsque le sous-système est actif.

*SAME

La valeur du groupe d'ASP n'est pas modifiée.

*NONE

L'espace de nom de bibliothèque du travail de moniteur de sous-système ne contient pas de groupe d'ASP.

nom

Indique le nom du groupe d'ASP qui doit être inclus dans l'espace de nom de bibliothèque du travail de moniteur de sous-système.

Groupe de charge de travail (WLCGRP)

Indique le nom d'un groupe de charge de travail à utiliser pour les travaux du sous-système.

Restrictions :

1. Ce paramètre peut être modifié lorsque le sous-système est actif. Toutes les modifications apportées prendront effet pour les nouveaux travaux lancés. Le groupe de charge de travail des travaux actifs dans le sous-système n'est pas modifié.
2. Le sous-système de contrôle n'utilise pas de groupe de charge de travail pour les travaux du sous-système de contrôle. Si une valeur autre que *NONE est indiquée dans la description du sous-système de contrôle, elle est ignorée.

*SAME

La valeur du groupe de charge de travail reste inchangée.

*NONE

Un groupe de charge de travail ne sera pas utilisé pour les travaux du sous-système.

nom

Indiquez le nom du groupe de charge de travail à utiliser pour les travaux du sous-système.

Exemples

Exemple 1 : modification de la taille mémoire et du niveau d'activité

CHGSBSD   SBSD(QGPL/PAYCTL)  POOLS((2 1500 3))
          SGNDSPF(QGPL/COMPANYA)

Cette commande modifie la définition du pool de mémoire 2 utilisé par le sous-système PAYCTL en sélectionnant une taille mémoire de 1500 K et un niveau d'activité de 3. Le fichier écran d'ouverture se trouve dans la bibliothèque QGPL. Il est modifié de sorte à afficher le fichier COMPANYA. Si le sous-système est actif lorsque cette commande est émise, le fichier COMPANYA n'est utilisé qu'au démarrage suivant du sous-système.

Exemple 2 : modification des attributs multiples

CHGSBSD   SBSD(LIB6/ORDER)
          POOLS((1 *BASE)(2 750 4)(3 *RMV)(4 *NOSTG))
          MAXJOBS(5)

Cette commande limite à cinq le nombre maximal de travaux que le sous-système ORDER peut prendre en charge. (La description de sous-système se trouve dans la bibliothèque LIB6.) La définition du pool de mémoire 1 devient un pool partagé du système de base, la définition du pool 2 est modifiée de sorte à disposer d'une taille mémoire de 750 K et d'un niveau d'activité de 4, la définition du pool 3 est enlevée du sous-système et la définition du pool 4 est modifiée de sorte à ne plus avoir de mémoire ni de niveau d'activité.

Exemple 3 : modification de la bibliothèque de langues

CHGSBSD   SBSD(QGPL/SPANISH)  SGNDSPF(QSYS2931/QDSIGNON)
          SYSLIBLE(QSYS2931)

Cette commande change la description de sous-système SPANISH en une langue secondaire espagnole.

Messages d'erreur

Messages *ESCAPE

CPF1619

Description de sous-système &1 de &2 endommagée.

CPF1691

La description de sous-système actif n'a peut-être pas été modifiée.

CPF1697

Description de sous-système &1 non modifiée.