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
-
SBSDDescription de sous-système obligatoire -
WRKSTNNom du poste de travail -
WRKSTNTYPEType d'écran -
JOBDDescription de travail -
MAXACTMaximum de travaux actifs -
ATAffectation
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 :
- 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
- 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
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.