Aller au contenu

ADDWSE

Ajouter poste écran à s-syst

En bref

La commande Ajouter poste écran à s-syst ADDWSE permet d'ajouter un poste écran à la description de sous-système indiquée.

ADDWSE se lit ADD (Ajouter) + WSE. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

ADDWSE SBSD(…)

Paramètres

  • SBSD Description de sous-système obligatoire
  • WRKSTN Nom du poste de travail
  • WRKSTNTYPE Type d'écran
  • JOBD Description de travail
  • MAXACT Maximum de travaux actifs
  • AT Affectation

Astuce : dans une session 5250, tapez ADDWSE 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 Ajouter poste écran à s-syst ADDWSE permet d'ajouter un poste écran à la description de sous-système indiquée. Chaque poste décrit le ou les postes écran contrôlés par le sous-système. Les postes écran identifiés permettent d'ouvrir une session ou d'entrer dans le sous-système pour y lancer des travaux.

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 opérationnels sur les objets (*OBJOPR) et de lecture (*READ) sur la description de travail, et le droit d'exécution (*EXECUTE) sur la bibliothèque contenant cette description de travail
  2. Seul un utilisateur détenant le droit spécial *ALLOBJ peut ajouter un poste qui ne possède pas de description de travail.

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
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
WRKSTN Nom du poste de travail Nom générique, nom Facultatif, positionnel 2
WRKSTNTYPE Type d'écran *ALL, 3179, 3180, 3196, 3197, 3277, 3278, 3279, 3476, 3477, 3486, 3487, 5251, 5291, 5292, 5555, *ASCII, CONS, *CONS, *NONASCII Facultatif, positionnel 3
JOBD Description de travail Valeurs uniques: *USRPRF, *SBSD
Autres valeurs: Nom d'objet qualifié
Facultatif, positionnel 4
Qualificatif 1: Description de travail Nom
Qualificatif 2: Biblio Nom, *LIBL, *CURLIB
MAXACT Maximum de travaux actifs 0-32000, *NOMAX Facultatif
AT Affectation *SIGNON, *ENTER Facultatif

Description de sous-système (SBSD)

Indique le nom et la bibliothèque de la description de sous-système à laquelle le poste écran est ajouté.

Ce paramètre est obligatoire.

Qualificatif 1 : Description de sous-système

nom
Indiquez le nom de la description de sous-système à laquelle le poste écran est ajouté.

Remarque : Les objets suivants fournis par IBM ne sont pas admis pour ce paramètre :

  • QLPINSTALL
  • QSYSSBSD

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.

Nom du poste de travail (WRKSTN)

Indique le nom du poste écran que le sous-système doit utiliser. Le nom pris en compte est le nom de description d'unité indiqué dans la commande Créer une unité écran CRTDEVDSP (Créer une description d'unité écran) associée à ce poste écran.

Considérations DBCS : Pour le jeu de caractères à deux octets, un poste de travail de type 555 doit être affecté à ce paramètre ou au paramètre Type d'écran WRKSTNTYPE, pas aux deux.

nom-générique
Indiquez un nom générique. Par exemple : DSP*, RMT*,...

Remarque :L'utilisation d'un nom générique n'entraîne pas l'ajout, la modification ou la suppression de plusieurs postes.

nom
Indiquez le nom d'un poste de travail spécifique. Par exemple : DSP10, DSP11, RMT55,...

Vous devez obligatoirement affecter une valeur à ce paramètre ou au paramètre Type d'écran WRKSTNTYP, mais pas aux deux.

Type d'écran (WRKSTNTYPE)

Indique le type de poste écran associé au poste à ajouter, modifier ou enlever. Ce poste s'applique à tous les postes écran de ce type qui sont dépourvus de poste correspondant à un poste écran particulier.

*ALL
Toutes les unités écran, y compris les unités de type 5250, ASCII, et 327x.
3179
Poste de travail 3179.
3180
Poste de travail 3180.
3196
Poste de travail 3196.
3197
Poste de travail 3197.
3277
Poste de travail 3277.
3278
Poste de travail 3278.
3279
Poste de travail 3279.
3476
Poste de travail 3476.
3477
Poste de travail 3477.
3486
Poste de travail 3486.
3487
Poste de travail 3487.
5251
Poste de travail 5251.
5291
Poste de travail 5291.
5292
Poste de travail couleur 5292.
5555
Poste de travail 5555 compatible DBCS.
*ASCII
Tous les postes de travail de type ASCII.
CONS
Ecran console système. Ce poste est prioritaire sur tout autre poste indiquant le même type d'unité que la console.
*CONS
Ecran console système. Ce poste est prioritaire sur tout autre poste indiquant le même type d'unité que la console.
*NONASCII
Toutes les unités de postes de travail qui utilisent le flot de données 5250, y compris les unités de type 327x.

Vous devez obligatoirement affecter une valeur à ce paramètre ou au paramètre Nom du poste de travail WRKSTN, mais pas aux deux.

Description de travail (JOBD)

Indique le nom et la bibliothèque de la description de travail utilisés pour les travaux démarrés via ce poste. Si la description de travail n'existe pas lors de l'ajout du poste, vous devez indiquer un qualifiant de bibliothèque car le nom qualifié de la description de travail est conservé dans la description de sous-système.

Remarque :Seul un utilisateur détenant les droits spéciaux sur tous les objets (*ALLOBJ) est admis à ajouter ou modifier un élément qui ne possède pas de description de travail.

Valeurs uniques

*USRPRF
Les travaux lancés par l'intermédiaire de ce poste utilisent la description de travail indiquée dans le profil de l'utilisateur qui ouvre une session sur cet écran (ou ce type d'écran).
*SBSD
Les travaux lancés par l'intermédiaire de ce poste utilisent la description de sous-système dont le nom est identique à celui indiqué en regard de l'invite Description de sous-système (paramètre SBSD).

Qualificatif 1 : Description de travail

nom
Indiquez le nom de la description de travail.

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

Maximum de travaux actifs (MAXACT)

Indique, pour les postes de travail utilisant le poste écran, le nombre maximal de travaux poste de travail pouvant être actifs simultanément.

*NOMAX
Aucun maximum n'est fixé pour le nombre de travaux (postes de travail) pouvant être actifs simultanément via le poste écran.
0-32000
Indiquez le nombre maximal de travaux pouvant être actifs simultanément via le poste écran.

Affectation (AT)

Indique comment les postes de travail associés au poste écran sont affectés. Pour plus de détails sur l'affectation des postes de travail aux sous-systèmes, reportez-vous à la commande Démarrer un sous-système STRSBS (Démarrer un sous-système).

*SIGNON
L'affectation des postes de travail s'effectue lors du démarrage du sous-système, excepté pour les postes déjà en service (session ouverte) dans un autre sous-système. Une invite d'ouverture de session s'affiche sur tous les postes de travail associés au poste écran. Si l'affectation d'un poste écran passe d'un sous-système à un autre, les travaux interactifs qui lui sont associés sont admis dans le nouveau sous-système via la commande Transférer un travail TFRJOB (Transférer un travail).
*ENTER
Les postes de travail associés au poste écran ne sont pas affectés lors du démarrage du sous-système. Toutefois, les travaux interactifs associés à ces postes de travail sont admis dans le sous-système via la commande TFRJOB (Transférer un travail).

Exemples

Exemple 1 : ajout d'un poste écran de travail

ADDWSE   SBSD(LIB7/ORDER)  WRKSTNTYPE(5251)  JOBD(QCTL)  AT(*SIGNON)

Cette commande ajoute un poste écran de travail à une description de sous-système nommée ORDER dans la bibliothèque LIB7. Tous les postes de travail de type 5251 sont affectés à ce sous-système lorsque ce dernier est démarré, à moins qu'ils ne soient déjà actifs dans un sous-système précédemment démarré. Une fois l'ouverture terminée, la description de travail QCTL fournie par IBM est utilisée pour démarrer la phase d'activation.

Exemple 2 : ajout d'un poste écran de travail

ADDWSE   SBSD(LIB7/ORDER)  WRKSTN(A12)  JOBD(LIB7/ORDER)  AT(*ENTER)

Cette commande ajoute un poste écran de travail pour le poste de travail A12 à la description de sous-système nommée ORDER dans la bibliothèque LIB7. Les travaux interactifs associés à ce poste de travail sont admis dans le sous-système via la commande Transférer un travail (TFRJOB).

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.

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