Aller au contenu

CHGSMTPRLE

Modifier poste connexion distante

Change Remote Login Entry

En bref

La commande Modifier une connexion distante (CHGSMTPRLE) permet de modifier une connexion distante associée à un profil utilisateur pour un seul domaine dans le répertoire de la boîte aux lettres SMTP locale. The Change Remote Login (CHGSMTPRLE) command allows you change a remote logon associated with a user profile for a single domain in the local SMTP mailbox directory.

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

Syntaxe minimale

CHGSMTPRLE USRPRF(…) DOMAIN(…)

Paramètres

  • USRPRF Profil utilisateur User profile obligatoire
  • DOMAIN Domaine Domain obligatoire
  • USERNAME Nom d'utilisateur User name
  • PASSWORD Mot de passe Password
  • PRFSVR Serveur SMTP préféré Prefer SMTP Server
  • CNNSEC Connexion sécurisée par Security connect by
  • AUTHTYPE Type d'authentification Authentication type
  • CNNPORT Port de connexion Connection port
  • SMTPLOG Journal SMTP SMTP log
  • USEDBY Utilisé par Used by

Astuce : dans une session 5250, tapez CHGSMTPRLE 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 une connexion distante (CHGSMTPRLE) permet de modifier une connexion distante associée à un profil utilisateur pour un seul domaine dans le répertoire de la boîte aux lettres SMTP locale. Une entrée de connexion distante est composée d'un nom d'utilisateur et d'un mot de passe permettant de se connecter à un domaine de messagerie distant. Un profil utilisateur ne peut avoir qu'une seule entrée de connexion distante par domaine, mais peut avoir autant de domaines que nécessaire. Les domaines ne peuvent pas être modifiés à l'aide de cette commande car ils font partie de la clé de l'entrée de connexion distante. Pour modifier un domaine, supprimez l'entrée à l'aide de RMVSMTPRLE avec l'ancien domaine, puis ajoutez une nouvelle entrée à l'aide de ADDSMTPRLE avec le nouveau domaine. The Change Remote Login (CHGSMTPRLE) command allows you change a remote logon associated with a user profile for a single domain in the local SMTP mailbox directory. A remote login entry is a username and password for connecting to a remote e-mail domain. A user profile may have only one remote login entry per domain, but may have as many domains as needed. Domains can not be changed using this command as they are part of the key for the remote login entry. To change a domain remove the entry using RMVSMTPRLE with the old domain and add a new entry using ADDSMTPRLE with the new domain.

Restrictions:

  • Vous devez posséder le droit spécial de responsable de la sécurité (*SECADM) pour modifier les entrées de connexion distante du répertoire pour des profils utilisateur différents du profil utilisateur en cours. You must have security administrator (*SECADM) special authority to change remote login entries in the directory for user profiles different than the current user profile.

Paramètres

Mot-clé Description Valeurs possibles Remarques
USRPRF Profil utilisateurUser profile Nom simple Obligatoire, clé, positionnel 1
DOMAIN DomaineDomain Valeur caractère Obligatoire, clé, positionnel 2
USERNAME Nom d'utilisateurUser name Valeur caractère Facultatif
PASSWORD Mot de passePassword Valeur caractère Facultatif
PRFSVR Serveur SMTP préféréPrefer SMTP Server Valeur caractère Facultatif
CNNSEC Connexion sécurisée parSecurity connect by *AUTO, *NONE, *STARTTLS, *SSLTLS Facultatif
AUTHTYPE Type d'authentificationAuthentication type *NONE, *LOGINPLAIN, *CRAMMD5, *DIGESTMD5 Facultatif
CNNPORT Port de connexionConnection port 0-65535, 0 Facultatif
SMTPLOG Journal SMTPSMTP log *NO, *YES Facultatif
USEDBY Utilisé parUsed by *API, *SVR Facultatif

Profil utilisateur (USRPRF)User profile (USRPRF)

Indique le profil utilisateur du répertoire de boîtes aux lettres SMTP local auquel ajouter la connexion distante. Chaque entrée de connexion distante est identifiée à la fois par un profil utilisateur et par un domaine de messagerie distant. Specifies the user profile in the local SMTP mailbox directory to add the remote login to. Each remote login entry is keyed to both a user profile and a remote e-mail domain.

nom
Indique le nom d'un profil utilisateur valide. Specifies the name of a valid user profile.

Domaine (DOMAIN)Domain (DOMAIN)

Indique le domaine de messagerie auquel appartient cette connexion distante. Chaque entrée de connexion distante a pour clé à la fois un profil utilisateur et un domaine de messagerie distant. Le domaine d'une entrée de connexion distante ne peut pas être modifié à l'aide de cette commande car il fait partie de la clé de l'entrée. Specifies the e-mail domain this remote logon belongs to. Each remote login entry is keyed to both a user profile and a remote e-mail domain. The domain of a remote login entry can not be changed using this command as it is part of the key for the entry.

character value
Indique un domaine de messagerie valide. Seuls les caractères valides pour un nom d'hôte sont autorisés. Les caractères valides comprennent les lettres majuscules, les lettres minuscules, les chiffres, le point, le trait de soulignement et le trait d'union (A-Z, a-z, 0-9 , . ,_, -). Jusqu'à 255 caractères peuvent être indiqués. Specifies a valid email domain. Only valid hostname characters are allowed. Valid characters include uppercase alphabetic letters, lowercase alphabetic letters, digits, period, underscore, and hyphen (A-Z, a-z, 0-9 , . ,_, -). Up to 255 characters may be specified.

Nom d'utilisateur (USERNAME)User name (USERNAME)

*SAME
La valeur d'origine de USERNAME n'est pas modifiée. The original value for USERNAME will not be changed.
valeur-caractère
Specifies the identifier used to logon to the remote SMTP server. Up to 80 characters can be specified.

Les caractères valides sont sensibles à la casse et comprennent tous les caractères alphanumériques (a-z, A-Z et 0-9) ainsi que les caractères spéciaux suivants : Valid characters are case sensitive and include all alpha-numeric characters (a-z, A-Z, and 0-9), and the following special characters:

PERIOD(.),
COMMA(,),
EXCLAMATION MARK(!),
NUMBER SIGN(#),
DOLLAR SIGN($),
PERCENT SIGN(%),
AMPERSAND(&),
ASTERISK(*),
PLUS SIGN(+),
HYPHEN(-),
SLASH(/),
COLON(:),
SEMICOLON(;),
EQUAL SIGN(=),
COMMERCIAL AT(@),
QUESTION MARK(?),
UNDERSCORE(_),
TILDE,
CIRCUMFLEX ACCENT.

Mot de passe (PASSWORD)Password (PASSWORD)

*SAME
La valeur d'origine de PASSWORD n'est pas modifiée. The original value for PASSWORD will not be changed.
valeur-caractère
Specifies the password that corresponds to the username to logon to the SMTP server. Up to 128 characters can be specified.

Les caractères valides sont sensibles à la casse et comprennent tous les caractères alphanumériques (a-z, A-Z et 0-9) ainsi que les caractères spéciaux suivants : Valid characters are case sensitive and include all alpha-numeric characters (a-z, A-Z, and 0-9), and the following special characters:

PERIOD(.),
COMMA(,),
EXCLAMATION MARK(!),
NUMBER SIGN(#),
DOLLAR SIGN($),
PERCENT SIGN(%),
AMPERSAND(&),
ASTERISK(*),
PLUS SIGN(+),
HYPHEN(-),
SLASH(/),
COLON(:),
SEMICOLON(;),
EQUAL SIGN(=),
COMMERCIAL AT(@),
QUESTION MARK(?),
UNDERSCORE(_),
TILDE,
CIRCUMFLEX ACCENT.

Utilisé par (PRFSVR)Used by (PRFSVR)

Indique le serveur SMTP distant préféré utilisé pour la connexion au domaine de messagerie. Specifies the preferred remote SMTP server used for the e-mail domain logon.

character value
Indiquez le nom de domaine qualifié complet de l'échangeur de courrier du serveur SMTP. Si une adresse IP est indiquée à la place d'un nom de domaine, la connexion s'effectue directement à cette adresse IP. Jusqu'à 255 caractères peuvent être indiqués. Specify the fully qualified mail exchanger domain name of the SMTP server, If an IP address is specified instead of a domain name the IP address will be connected to directly. Up to 255 characters can be specified.

Connexion sécurisée par (CNNSEC)Security connect by (CNNSEC)

Indique le type de connexion sécurisée utilisé pour se connecter au serveur SMTP préféré. Specifies which type security connection used to connect to the preferred SMTP server.

*AUTO
La connexion sécurisée dépend du port de connexion : le port 465 utilise SSL/TLS, le port 587(25) utilise STARTTLS. Security connection depends on the connection port, port 465 will use SSL/TLS, 587(25) will use STARTTLS.
*NONE
Aucune connexion sécurisée n'est nécessaire. No security connection needed.
*STARTTLS
Utilise STARTTLS pour démarrer la connexion sécurisée. Using STARTTLS to start security connection.
*SSLTLS
Utilise SSL/TLS pour démarrer la connexion sécurisée. Using SSL/TLS to start security connection.

Type d'authentification (AUTHTYPE)Authentication type (AUTHTYPE)

Indique le type d'authentification utilisé pour se connecter au serveur SMTP distant préféré. Specifies the authentication type used to connect to the preferred remote SMTP server.

*NONE
Aucune authentification n'est nécessaire. Authentication is no need.
*LOGINPLAIN
AUTH LOGIN ou AUTH PLAIN est utilisé. The AUTH LOGIN or AUTH PLAIN will be used.
*CRAMMD5
AUTH CRAM-MD5 est utilisé. The AUTH CRAM-MD5 will be used.
*DIGESTMD5
AUTH DIGEST-MD5 est utilisé. The AUTH DIGEST-MD5 will be used.

Port de connexion (CNNPORT)Connection port (CNNPORT)

Indique le numéro de port utilisé pour se connecter au serveur SMTP distant préféré. Specifies the port number used to connect to the preferred remote SMTP server.

0
Pour CNNSEC(*NONE) et CNNSEC(*STARTTLS), la valeur par défaut est 25. Pour CNNSEC(*SSLTLS), la valeur par défaut est 465. For CNNSEC(*NONE) and CNNSEC(*STARTTLS) the default value is 25. For CNNSEC(*SSLTLS) the default is 465.
1-65535
Indiquez un numéro de port de serveur SMTP valide. Specify a valid SMTP server port number.

Journal SMTP (SMTPLOG)SMTP log (SMTPLOG)

Indique que les journaux de messagerie sont générés lors de la connexion au domaine distant ; vous pouvez les consulter avec WRKSMTPEMM. Specifies the E-mail logs will be output when connecting to the remote domain, you can view it by WRKSMTPEMM.

*NO
Aucun journal de messagerie n'est généré pour le domaine. No E-mail log output for the domain.
*YES
Les journaux de messagerie sont générés pour le domaine. E-mail logs output for the domain.

Serveur SMTP préféré (USEDBY)Prefer SMTP Server (USEDBY)

Indique si cette connexion distante est utilisée par une API ou par le serveur SMTP. Seul le profil utilisateur QTCP peut ajouter la connexion distante utilisée par le serveur SMTP. Specifies this remote logon will be used by API or SMTP server. Only user profile QTCP can add the remote logon used by SMTP server.

*API
Indique que cette connexion distante est utilisée par des API telles que QtmmSendMail et QtmsCreateSendEmail. Specifies this remote logon will be used by API like QtmmSendMail, QtmsCreateSendEmail.
*SVR
Indique que cette connexion distante est utilisée par le serveur SMTP. Specifies this remote logon will be used by SMTP server.

Exemples

Modification du nom d'utilisateur et du mot de passe d'une connexion distante à gmail.com pour un profil utilisateur Change Username and Password for a Remote Logon to gmail.com for a User Profile

CHGSMTPRLE USRPRF(XXXX) DOMAIN(gmail.com)
           USERNAME(YYYY) PASSWORD(ZZZZZ)

Cette commande modifie le nom d'utilisateur YYYY et le mot de passe ZZZZZ du client SMTP à utiliser lorsque l'expéditeur correspond à la boîte aux lettres associée à ce profil utilisateur XXXX avec une destination de gmail.com. This command changes the SMTP client's username YYYY and password ZZZZZ to be used when the originator matches the mailbox associated with this user profile XXXX with a destination of gmail.com.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

TCP5068
La connexion distante SMTP de l'utilisateur &1 n'a pas été modifiée. SMTP remote logon for user &1 not changed.
TCP90A8
Le droit spécial *SECADM est requis pour effectuer l'opération demandée. *SECADM special authority required to do requested operation.
TCP9999
Erreur système interne dans le programme &1. Internal system error in program &1.

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