CHGCTLVWS

Modifier ctl postes virtuels

En bref

La commande CHGCTLVWS permet de modifier une description de contrôleur de postes de travail virtuels (passe-système).

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

Syntaxe minimale

CHGCTLVWS CTLD(…)

Paramètres

CTLD Description de contrôleur obligatoire
ONLINE En ligne à l'IPL
DEVWAITTMR Délai d'attente unité
MSGQ File attente messages
TEXT Texte 'descriptif'

Astuce : dans une session 5250, tapez CHGCTLVWS 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 CHGCTLVWS permet de modifier une description de contrôleur de postes de travail virtuels (passe-système).

Restriction : Pour utiliser cette commande, vous devez disposer du droit spécial *IOSYSCFG (configuration de système d'entrée-sortie).

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
CTLD	Description de contrôleur	Nom	Obligatoire, clé, positionnel 1
ONLINE	En ligne à l'IPL	SAME, YES, *NO	Facultatif
DEVWAITTMR	Délai d'attente unité	2-120, *SAME	Facultatif
MSGQ	File attente messages	Valeurs uniques: SAME, SYSVAL, SYSOPR Autres valeurs: Nom d'objet qualifié*	Facultatif
	Qualificatif 1: File attente messages	Nom
	Qualificatif 2: Biblio	Nom
TEXT	Texte 'descriptif'	Valeur caractère, SAME, BLANK	Facultatif

Description de contrôleur (CTLD)

Ce paramètre est obligatoire.

Indique le nom de la description de contrôleur.

En ligne à l'IPL (ONLINE)

Indique si cet objet est mis en fonction automatiquement lors de la procédure de chargement initial (IPL).

*SAME

La valeur reste inchangée.

*YES

Le contrôleur est automatiquement mis en fonction lors de l'IPL.

*NO

Le contrôleur n'est pas automatiquement mis en fonction lors de l'IPL.

Délai d'attente unité (DEVWAITTMR)

Indique le délai d'attente de l'unité. Cette valeur sert à limiter le délai accordé à un sous-système pour réaliser des opérations d'entrée-sortie sur un poste de travail. Le délai d'attente d'une unité est obtenu à partir du contrôleur auquel celle-ci est connectée lors de sa mise en fonction. Toute modification de ce paramètre prend effet sur les unités lors de leur prochaine remise en fonction.

*SAME

La valeur reste inchangée.

délai-attente-unité

Indiquez une valeur comprise entre 2 et 600 représentant le délai maximal (en secondes) pendant lequel le sous-système attend l'achèvement des opérations d'entrée-sortie sur tous les postes de travail connectés à ce contrôleur.

Lorsque vous sélectionnez une valeur pour ce paramètre, vous devez tenir compte des types d'unités connectés au contrôleur. La valeur de ce paramètre doit être peu élevée pour des postes de travail connectés en local (10 secondes maximum).

File attente messages (MSGQ)

Indique le nom de la file d'attente de messages vers laquelle sont envoyés les messages d'exploitation.

*SAME

La valeur reste inchangée.

*SYSVAL: Les messages sont envoyés dans la file d'attente de messages définie dans la valeur système QCFGMSGQ.

*SYSOPR: Les messages sont envoyés dans la file d'attente de messages de l'opérateur système (QSYS/QSYSOPR).

Qualificatif 1 : File attente messages

nom: Indiquez le nom de la file d'attente de messages dans laquelle sont envoyés les messages d'exploitation.

Qualificatif 2 : Biblio

nom: Indiquez le nom de la bibliothèque contenant la file d'attente de messages.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*SAME

La valeur reste inchangée.

*BLANK

Aucun texte n'est indiqué.

valeur-alphanumérique

Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Exemples

CHGCTLVWS   CTLD(VRTCTL325)  TEXT('Contrôleur virtuel S/325')

Cette commande permet de modifier la description du contrôleur VRTCTL325 de sorte que ce dernier soit doté d'une nouveau texte descriptif.

Messages d'erreur

Messages *ESCAPE

CPF2652: Description de contrôleur &1 non modifiée.