Aller au contenu

WRKSBSD

Gérer description sous-système

À quoi ça sert

Gérer les sous-systèmes, les « ateliers » où s'exécutent les travaux : les voir, les démarrer, les arrêter, regarder comment ils sont configurés.

Pourquoi on fait ça

Un travail ne tourne jamais seul : il s'exécute dans un sous-système (QINTER pour les sessions 5250, QBATCH pour le batch…). Celui-ci décide quelles files d'attente il sert, combien de travaux il accepte en même temps et avec quelle mémoire. Quand les batchs ne démarrent plus, ou que plus personne ne peut ouvrir de session, la réponse est souvent là.

Le cas concret

/* Tous les sous-systèmes, avec leur état actif / inactif */
WRKSBSD    SBSD(*ALL)

/* Un sous-système précis */
WRKSBSD    SBSD(QSYS/QBATCH)

Sur la liste, l'option 5 affiche la description : postes de file d'attente de travaux (quelles JOBQ sont servies, avec quel MAXACT), pools de mémoire, postes de poste de travail. C'est ici que l'on vérifie qu'une file créée avec CRTJOBQ est bien rattachée.

Le piège classique

Arrêter QINTER déconnecte tous les utilisateurs 5250, vous compris si votre session y tourne. Avant d'arrêter un sous-système, regardez qui est dedans avec WRKSBSJOB.

Voir aussi : STRSBS, ENDSBS, WRKSBS, WRKSBSJOB, ADDJOBQE, CRTSBSD, la vue SQL QSYS2.SUBSYSTEM_INFO.

Aide IBM i de la commande

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

Où s'exécute : Environnements interactifs (*INTERACT *IPGM *IREXX *EXEC)
Compatible multitâche : Non

La commande WRKSBSD (Gérer une description de sous-système) permet d'afficher une liste de descriptions de sous-système à partir de laquelle vous pouvez modifier, supprimer, afficher des descriptions indiquées, lancer ou arrêter des sous-systèmes correspondants, ainsi que gérer des travaux de sous-système pour une description de travail donnée.

Restrictions :

  1. La recherche s'effectue uniquement dans les bibliothèques sur lesquelles vous disposez du droit USE.
  2. Seules les descriptions de sous-système sur lesquelles vous disposez de droits s'affichent sur l'écran.
  3. Pour effectuer des opérations sur les descriptions de sous-système, vous devez disposer du droit USE sur la commande utilisée par l'opération et du droit approprié sur les descriptions de sous-système sur lesquelles l'opération est à effectuer.
  4. Vous devez disposez des droits d'opération et des droits de gestion de l'objet sur les descriptions de sous-système.

Paramètres

Mot-clé Description Valeurs possibles Remarques
SBSD Description de sous-système Nom d'objet qualifié Obligatoire, positionnel 1
Qualificatif 1: Description de sous-système Nom générique, nom, *ALL
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB, *USRLIBL, *ALLUSR, *ALL

Description de sous-système (SBSD)

Indique le nom et la bibliothèque des descriptions de sous-système à afficher sur l'écran Gestion des descriptions de sous-système.

Ce paramètre est obligatoire.

Les valeurs possibles sont les suivantes :

*ALL
Affiche toutes les descriptions de sous-système.
nom-générique*-description-sous-système
Entrez le nom générique des descriptions de sous-système à afficher. Toutes les requêtes QM dont le nom commence par la chaîne de caractères indiquée seront affichées. Par exemple, ABC*.
nom-description-sous-système
Entrez le nom de la description de sous-système à afficher. Si *LIBL ou *USRLIBL est indiqué comme nom de bibliothèque, seule sera affichée la première description rencontrée portant le nom indiqué.

Qualificateur 2: Biblio

*LIBL
La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution. Tous les objets contenus dans ces bibliothèques sont affichés avec leur nom.
*CURLIB
La recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL.
*USRLIBL
S'il existe un poste de bibliothèque en cours dans la liste des bibliothèques de l'unité d'exécution en cours, la recherche porte sur celle-ci ainsi que sur les bibliothèques de la partie utilisateur de la liste des bibliothèques. Dans le cas contraire, la recherche porte uniquement sur les bibliothèques de la partie utilisateur de la liste des bibliothèques.
*ALLUSR
La recherche porte sur toutes les bibliothèques utilisateur. La recherche porte sur toutes les bibliothèques dont le nom ne commence pas par la lettre Q, à l'exception des bibliothèques suivantes :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques Qxxx suivantes soient fournies par IBM, elles contiennent généralement des données utilisateur qui sont fréquemment modifiées. Par conséquent, ces bibliothèques sont considérées comme des bibliothèques utilisateur et sont donc recherchées :

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2xxxxx  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

  1. 'xxxxx' représente le numéro de l'ASP principal.
  2. L'utilisateur peut créer une bibliothèque de nom différent, au format QUSRVxRxMx, pour chacune des éditions précédentes prises en charge par IBM, afin d'y stocker les commandes utilisateur à compiler dans un programme CL pour une édition précédente. En ce qui concerne la bibliothèque utilisateur QUSRVxRxMx, VxRxMx correspond à une version, édition et niveau de modification précédents encore admis par IBM.
*ALL
La recherche porte sur toutes les bibliothèques du système, y compris QSYS.
nom
Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Exemples

WRKSBSD   SBSD(LIB6/ORDER*)

Cette commande affiche l'écran Gestion de descriptions de sous-systèmes qui la liste des descriptions de sous-systèmes de la bibliothèque LIB6 dont les noms commencent par les lettres 'ORDER'. Depuis cet écran, vous pouvez sélectionner des options permettant de gérer toute description de sous-système répertoriée.

Messages d'erreur

Messages *ESCAPE

CPF9809
Accès à la bibliothèque &1 impossible.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.