Commande CL IBM i (AS/400)

CHGRWSPWD

Modifier mot de passe ctrl RWS

En bref

La commande CHGRWSPWD permet de modifier le mot de passe du contrôleur du poste de travail éloigné indiqué.

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

Syntaxe minimale

CHGRWSPWD CTLD(…) RMTPWD(…)

Paramètres

CTLD Description de contrôleur obligatoire
RMTPWD Mot de passe éloigné obligatoire
LCLLOCNAME Lieu local
MODE Mode

Astuce : dans une session 5250, tapez CHGRWSPWD 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 CHGRWSPWD permet de modifier le mot de passe du contrôleur du poste de travail éloigné indiqué. Ce mot de passe permet d'accéder à certaines fonctions du programme utilitaire 5494.

Restrictions :

Pour utiliser cette commande, vous devez disposer du droit spécial *SECADM.
Pour que cette commande puisse aboutir, le contrôleur de postes de travail distant spécifié et l'unité APPC associée doivent être actifs sur le système local.
Vous ne pouvez pas exécuter cette commande lorsque le programme utilitaire 5494 est utilisé en même temps que le contrôleur spécifié.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
CTLD	Description de contrôleur	Nom	Obligatoire, positionnel 1
RMTPWD	Mot de passe éloigné	Nom simple	Obligatoire, positionnel 2
LCLLOCNAME	Lieu local	Nom de communication, *LOC	Facultatif
MODE	Mode	Nom de communication, LOC, NETATR	Facultatif

Description de contrôleur (CTLD)

Indique le nom de la description du contrôleur de postes de travail distant 5494.

Mot de passe éloigné (RMTPWD)

Indique le nouveau mot de passe à définir sur l'unité de contrôle éloignée. Si un mot de passe existe déjà, il sera remplacé par le nouveau mot de passe.

Lieu local (LCLLOCNAME)

Indique le nom de lieu local utilisé pour établir une conversation avec le contrôleur du poste de travail éloigné.

Les valeurs possibles sont les suivantes :

*LOC: Le nom de lieu utilisé est celui du lieu local identifié sur l'unité APPC associée au contrôleur de postes de travail distant.
nom-lieu-local: Indiquez un nom de lieu qui permettra d'identifier le système local sur le contrôleur du poste de travail éloigné. Si le nombre maximal de sessions est atteint pour le mode utilisé pour les postes de travail non programmables, vous devez indiquer un nom de lieu différent du nom de lieu local identifié sur l'unité APPC associée au contrôleur de postes de travail distant, sinon la commande n'aboutira pas.
Remarque :Si vous indiquez un nom de lieu local qui n'existe pas sur le système, une entrée de liste de configuration locale est créée automatiquement pour ce nom de lieu.

Mode (MODE)

Indique le nom de mode utilisé pour établir une conversation avec le contrôleur de postes de travail distant.

Les valeurs possibles sont les suivantes :

*LOC: Le mode varie en fonction de la valeur indiquée pour le paramètre LCLLOCNAME (nom de lieu local). Si ce paramètre a pour valeur *LOC, le mode est celui utilisé pour les sessions postes de travail non programmables. Si une autre valeur est indiquée pour ce paramètre, le mode utilisé est #INTER.
*NETATR: Le mode défini dans les attributs du réseau est utilisé.
nom-mode: Indiquez un nom de mode ou spécifiez BLANK pour indiquer un nom de mode composé de huit blancs.
Remarque :SNASVCMG et CPSVCMG sont des noms réservés. Vous ne pouvez pas les utiliser.

Exemples

CHGRWSPWD   CTLD(L5494RMT)  RMTPWD(NEWPASS)

Cette commande remplace le mot de passe du contrôleur du poste de travail éloigné 5494 par NEWPASS.

Messages d'erreur

Messages *ESCAPE

CPF2625: Impossible d'allouer l'objet &1.
CPF2634: Non autorisé à l'objet &1.
CPF2703: Description de contrôleur &1 non trouvée.
CPF8104: Description de contrôleur &4 endommagée.
CPF8105: Description d'unité &4 endommagée.
CPF90A8: Droit spécial *SECADM exigé pour l'exécution de l'opération demandée.
CPF91E0: Echec de l'opération sur le contrôleur &2 avec le code raison &1.