CHGWSE

Modifier un poste écran

En bref

La commande Modifier un poste écran CHGWSE (Modifier un poste écran) permet de modifier un ou plusieurs attributs d'un poste écran dans la description de sous-système indiquée.

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

Syntaxe minimale

CHGWSE 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 CHGWSE 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 Modifier un poste écran CHGWSE (Modifier un poste écran) permet de modifier un ou plusieurs attributs d'un poste écran dans la description de sous-système indiquée.

Remarques :

Si vous indiquez le paramètre Description de travail JOBD, le poste écran est modifié. Cependant, la valeur de ce paramètre n'est pas modifiée pour tous les travaux qui ont été démarrés par l'intermédiaire de ce poste et qui sont en cours d'activité.
Si le paramètre Maximum de travaux actifs MAXACT prend une valeur inférieure au nombre total d'écrans en cours d'activité qui dépendent du poste écran, aucun nouvel écran n'est admis à se connecter. Les postes de travail actifs ne sont pas déconnectés. En utilisant la commande Transférer à session alternée TFRSECJOB ou Transférer à travail de groupe TFRGRPJOB, il est possible d'ajouter de nouveaux travaux à un poste de travail actif. Les nouveaux postes de travail ne sont admis à se connecter que lorsque le nombre de postes de travail actifs est inférieur à la valeur indiquée par le paramètre MAXACT.

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 modifier 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: SAME, 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, SAME, NOMAX	Facultatif
AT	Affectation	SAME, SIGNON, *ENTER	Facultatif

Description de sous-système (SBSD)

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

Ce paramètre est obligatoire.

Qualificatif 1 : Description de sous-système

nom

Indiquez le nom de la description de sous-système associée au poste écran à modifier.

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

*SAME: La description de travail ne change pas.
*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.

*SAME: Le nombre maximal de travaux pouvant être actifs simultanément ne change pas.
*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).

*SAME: La spécification du poste écran ne change pas.
*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 : modification d'un poste à l'ouverture d'une session

CHGWSE   SBSD(QGPL/BAKER)  WRKSTN(A12)  AT(*SIGNON)

Cette commande modifie le poste écran de travail pour le poste de travail A12 du sous-système BAKER situé dans la bibliothèque générale. Un travail est créé pour le poste de travail A12 lorsque le mot de passe de l'utilisateur est entré dans l'invite d'ouverture de session et que la touche Entrée est enfoncée.

Exemple 2 : modification d'un poste

CHGWSE   SBSD(QGPL/BAKER)  WRKSTN(B28) JOBD(*USRPRF)

Cette commande modifie le poste écran de travail pour le poste de travail B28 du sous-système BAKER situé dans la bibliothèque QGPL. 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. Les autres paramètres de commande ont par défaut la valeur *SAME.

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.