CRTSBSD

La commande Créer description sous-système CRTSBSD (Créer une description de sous-système) permet de créer une description de sous-système qui définit les attributs opérationnels de celui-ci. Après sa création, la description de sous-système peut être personnalisée par des commandes permettant d'ajouter, modifier et enlever des postes travaux ou des postes de routage.

Restrictions :

1. Pour utiliser cette commande, vous devez détenir les droits suivants :
   • les droits de lecture (*READ) et d'ajout (*ADD) sur la bibliothèque dans laquelle la description de sous-système doit être créée
   • les droits sur tous les objets (*ALLOBJ) et l'administration de la sécurité (*SECADM), ainsi que le droit d'indiquer une valeur différente de *NONE dans une entrée de liste de bibliothèque.
   • le droit d'utilisation (*USE) sur toutes les descriptions d'ASP du groupe d'ASP pour indiquer un nom du groupe d'ASP.
2. Seul un utilisateur détenant le droit spécial *ALLOBJ sur tous les objets est admis à indiquer un nom de groupe d'ASP lorsque la description d'unité ASP n'existe pas.

Paramètres

Description de sous-système (SBSD)

Indique le nom et la bibliothèque de la description de sous-système à créer. La description est stockée dans la bibliothèque indiquée.

Ce paramètre est obligatoire.

Qualificatif 1 : Description de sous-système

nom

Indiquez le nom de la description de sous-système à créer.

Qualificatif 2 : Biblio

*CURLIB

La bibliothèque en cours de l'unité d'exécution est utilisée. Si l'unité ne possède aucune bibliothèque en cours, c'est la bibliothèque QGPL qui est utilisée.

nom

Indiquez la bibliothèque dans laquelle sera créée la description de sous-système.

Pour plus d'informations sur les descriptions de sous-système, reportez-vous à la brochure Work Management Guide.

Pools mémoire (POOLS)

Indique une ou plusieurs définitions de pool de mémoire devant figurer dans la description de sous-système. Chaque définition indique, pour un pool de mémoire :

• Identificateur de définition de pool : L'identificateur interne à la description de sous-système de la définition de pool de mémoire. Les mêmes identificateurs (de 1 à 10) peuvent être utilisés pour des définitions de pool dans des descriptions de sous-systèmes différentes.
• Taille : La taille du pool de mémoire, exprimée en multiples de kilooctets (1 ko = 1024 octets) ou de mégaoctets (1 Mo = 1048576 octets). Il s'agit de la quantité de mémoire principale pouvant être utilisée par le pool.
• Niveau d'activité : Le nombre maximal d'unités d'exécution pouvant être exécutées simultanément dans le pool.

Vous pouvez indiquer jusqu'à 10 définitions de pools mémoire lorsque vous créez une description de sous-système. Toutefois, le nombre de pools mémoire pouvant être actifs dans le système est soumis à une limite opérationnelle. En effet, seuls 64 pools mémoire peuvent être actifs simultanément sur le système, y compris le pool de base et le pool machine. Un pool de mémoire pour lequel *NOSTG a été indiqué n'est pas considéré comme actif et n'est alloué à aucun sous-système.

En cas de démarrage d'un sous-système dont tous les pools mémoire ne peuvent pas être alloués sans dépasser le seuil des 64 pools admis, l'allocation s'effectue dans la limite fixée pour le système. Le pool de mémoire de base est ensuite utilisé pour chaque phase d'activation lancée par le sous-système, qui doit normalement être routée dans l'un des pools n'ayant pu être alloué.

Ce paramètre est obligatoire.

Vous pouvez indiquer 10 valeurs pour ce paramètre.

Elément 1 : Identificateur du pool

1-10

Indiquez l'identificateur de pool de la définition de pool de mémoire qui doit figurer dans ce sous-système. Vous devez également indiquer les attributs du pool au moyen d'une des valeurs indiquées ci-dessous. Vous pouvez indiquer jusqu'à 10 groupes de valeurs pour définir 10 pools mémoire dans le sous-système.

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.)

*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.

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.

*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.

*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 :Si l'utilisateur qui fait appel à cette commande dispose du droit d'utilisation (*USE) sur le fichier écran et du droit d'exécution (*EXECUTE) sur sa bibliothèque, il peut 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 l'utilisateur ne dispose pas de ces droits, le format n'est pas vérifié.

Valeurs uniques

*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. Ce paramètre vous permet d'utiliser une bibliothèque langue secondaire.

Restrictions :

1. 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.
2. 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.

*NONE

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

nom

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

Droits (AUT)

Indique les droits que vous accordez aux utilisateurs qui n'ont pas de droits spécifiques sur l'objet, qui ne figurent pas sur une liste d'autorisation ou dont le profil de groupe ou les profils du groupe supplémentaire ne disposent pas de droits spécifiques sur l'objet.

*LIBCRTAUT

Les droits sur l'objet correspondent à la valeur indiquée en regard de l'invite Droits pour objets créés (paramètre CRTAUT) de la bibliothèque dans laquelle l'objet est créé. Si cette valeur est modifiée, elle n'affectera pas les objets existants.

*CHANGE

L'utilisateur peut effectuer toutes les opérations sur l'objet, à l'exception de celles réservées au propriétaire ou contrôlées par les droits d'existence de l'objet (*OBJEXIST) et de gestion de l'objet (*OBJMGT). L'utilisateur peut réaliser des fonctions de base sur l'objet et le modifier. Le droit *CHANGE fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que les droits sur toutes les données. Si l'objet est une liste d'autorisation, vous pouvez ajouter, modifier ou supprimer des utilisateurs dans cette liste.

*ALL

L'utilisateur peut effectuer toutes les opérations, à l'exception de celles réservées au propriétaire ou soumises au droit de gestion de la liste d'autorisation (*AUTLMGT). L'utilisateur a un droit d'existence sur l'objet Il peut également effectuer des fonctions de base sur ce dernier, le modifier, définir son niveau de protection et en transférer la propriété.

*USE

L'utilisateur peut effectuer des opérations de base sur l'objet, telles que l'affichage de son contenu. Il ne peut pas le modifier. Le droit *USE fournit les droits d'opération, les droits de lecture et les droits d'exécution sur l'objet.

*EXCLUDE

L'utilisateur n'a pas accès à l'objet.

nom

Indiquez le nom d'une liste d'autorisation permettant de déterminer les droits sur l'objet. Les droits sur l'objet précisés dans la liste sont accordés aux utilisateurs qui figurent sur cette liste. La liste d'autorisation doit exister à la création de l'objet.

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.

*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.

*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 : création d'une description à l'aide d'un fichier écran d'ouverture

CRTSBSD   SBSD(BAKER)  POOLS((1 *BASE)(2 2000 4))
          SGNDSPF(*LIBL/NEWSGNON)
          TEXT ('Subsystem for running Baker Department jobs')

Cette commande crée une description de sous-système nommée BAKER et la stocke dans la bibliothèque en cours. Si aucune bibliothèque en cours n'existe, la description est stockée dans la bibliothèque générale (QGPL). La définition du pool de mémoire 1 indique que le pool 1 doit partager le pool du système de base ; la définition du pool de mémoire 2 doit disposer de 2000 K de mémoire et d'un niveau d'activité de 4. Le nombre de travaux actifs simultanément dans la description de sous-système n'est pas limité. Les niveaux d'activité du sous-système peuvent toutefois être contrôlés par les paramètres MAXACT indiqués dans les postes écran, les postes file d'attente et les postes de routage indiqués dans la description de sous-système. Le fichier écran d'ouverture est NEWSGNON. Il est utilisé pour l'affichage des écrans d'ouverture sur les postes de travail alloués au sous-système BAKER. La recherche du fichier écran NEWSGNON s'effectue dans la liste des bibliothèques de l'utilisateur.

Exemple 2 : création d'une description contenant trois définitions de pool de mémoire

CRTSBSD   SBSD(MEDLIB/MEDICAL)
          POOLS((1 1500 2) (2 *BASE) (3 *NOSTG))
          MAXJOBS(5)  TEXT('Medical files inquiry and update')

Cette commande crée une description de sous-système nommée MEDICAL et la stocke dans la bibliothèque MEDLIB. La description de sous-système comporte trois définitions de pool de mémoire : le pool de mémoire 1 est défini de sorte à disposer de 1500 K de mémoire et d'un niveau d'activité de 2, le pool 2 doit partager le pool de système de base et le pool 3 est défini en premier de sorte à être inactif lorsque les autres pools sont actifs (il n'a ni mémoire ni niveau d'activité). Cinq travaux au maximum peuvent être actifs simultanément dans ce sous-système. Le sous-système fait l'objet d'une brève description.

Messages d'erreur

Messages *ESCAPE

CPF1696

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