Commande CL IBM i (AS/400)
ADDSMTPLE
Ajouter poste liste SMTP
Add SMTP List Entry
En bref
La commande Ajouter une entrée de liste SMTP (ADDSMTPLE) permet d'ajouter des éléments aux listes de configuration SMTP. The Add SMTP List Entry (ADDSMTPLE) command is used to add elements to SMTP configuration lists.
ADDSMTPLE se lit ADD
(Ajouter) + SMTPLE.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
ADDSMTPLE TYPE(…)
Paramètres
-
TYPEType de liste obligatoire -
INTNETADRAdresse Internet Internet address -
SUBNETMASKMasque de sous-réseau Subnet mask -
HOSTNAMENom d'hôte Host name -
FTRDATADonnées de filtre Filter data -
USERNAMENom d'utilisateur -
PASSWORDMot de passe utilisateur -
IP6PFXPréfixe IPv6 IPv6 prefix -
IP6NETADRAdresse IPv6 IPv6 address
Astuce : dans une session 5250, tapez ADDSMTPLE 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 QTCP)
Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non
La commande Ajouter une entrée de liste SMTP (ADDSMTPLE) permet d'ajouter des éléments aux listes de configuration SMTP. Ces listes peuvent être activées ou désactivées à l'aide de la commande Modifier les attributs SMTP (CHGSMTPA) ou à partir du panneau Propriétés SMTP d'IBM i Navigator. Les modifications prennent effet au prochain démarrage du serveur SMTP, par la commande Démarrer TCP/IP (STRTCP) ou la commande Démarrer un serveur TCP/IP (STRTCPSVR). The Add SMTP List Entry (ADDSMTPLE) command is used to add elements to SMTP configuration lists. These lists may be enabled or disabled using the Change SMTP Attributes (CHGSMTPA) command or from the SMTP Properties panel in IBM i Navigator. The changes take effect the next time the SMTP server is started either by the Start TCP/IP (STRTCP) command or by the Start TCP/IP Server (STRTCPSVR) command.
Restrictions:
- Vous devez posséder le droit spécial de configuration du système d'entrée-sortie (*IOSYSCFG) pour utiliser cette commande. You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| TYPE | Type de liste | *ACCEPT, *REJECT, *NEAR, *DOMAIN, *SVRBIND, *CLTBIND, *ETRNSVR, *FTRSUBJECT, *FTRORIGIN, *FTRFILNAME, *FTRTYPE, *HOSTAUTH, *ACCEPTIP6, *REJECTIP6, *DOMAINIP6, *SVRBNDIP6, *CLTBNDIP6 | Obligatoire, positionnel 1 |
| INTNETADR | Adresse InternetInternet address | Valeur caractère | Facultatif |
| SUBNETMASK | Masque de sous-réseauSubnet mask | Valeur caractère, '255.255.255.255' | Facultatif |
| HOSTNAME | Nom d'hôteHost name | Valeur caractère | Facultatif |
| FTRDATA | Données de filtreFilter data | Valeur caractère | Facultatif |
| USERNAME | Nom d'utilisateur | Valeur caractère | Facultatif |
| PASSWORD | Mot de passe utilisateur | Valeur caractère | Facultatif |
| IP6PFX | Préfixe IPv6IPv6 prefix | Valeur caractère | Facultatif |
| IP6NETADR | Adresse IPv6IPv6 address | Valeur caractère | Facultatif |
Type de liste (TYPE)List type (TYPE)
Indique la liste à laquelle ajouter le nouvel élément. Specifies which list to add the new element to.
- *ACCEPT
- La liste Accept Relay est mise à jour. Indique une liste d'adresses IP avec masques de réseau qui sont autorisées à relayer lorsque "Accept relay messages from" est sélectionné dans la page Relay Restrictions des propriétés SMTP d'IBM i Navigator. Les paramètres valides avec cette valeur sont INTNETADR et SUBNETMASK. The Accept Relay list is updated. Specifies a list of IP addresses with netmasks that will be allowed to relay when "Accept relay messages from" is selected on the SMTP Properties Relay Restrictions page on IBM i Navigator. Parameters valid with this value are INTNETADR and SUBNETMASK.
- *REJECT
- Ajoute une adresse IP et un masque de réseau à la liste Relay Restrictions. Il s'agit d'une liste d'adresses IP avec masques de réseau qui sont rejetées si elles tentent de se connecter au serveur SMTP d'IBM i. Les paramètres valides avec cette valeur sont INTNETADR et SUBNETMASK. Adds an IP address and netmask to the Relay Restrictions list. This a list of IP addresses with netmasks that will be rejected if they try to connect to the IBM i SMTP. Parameters valid with this value are INTNETADR and SUBNETMASK.
- *NEAR
- Ajoute un domaine à la liste Near Domain. La liste Near Domain est une liste de domaines pour lesquels le courrier ne doit pas être acheminé via le pare-feu, lorsque "Forward outgoing mail to router through firewall" est sélectionné dans la page General des propriétés SMTP d'IBM i Navigator. Indique également que SMTP doit relayer le courrier destiné aux destinataires dont les domaines figurent dans la liste Near Domain lorsque "Relay mail for only these domains" est sélectionné. Le paramètre valide avec cette valeur est HOSTNAME. Adds a domain to the Near Domain list. The Near Domain list is a list of domains for which mail should not be routed through the firewall, when "Forward outgoing mail to router through firewall" is selected on the SMTP Properties General page in IBM i Navigator. Also specifies SMTP should relay mail for recipients whose domains are in the Near Domain list when "Relay mail for only these domains" is selected. Parameter valid with this value is HOSTNAME.
- *DOMAIN
- Indique le domaine à associer à chaque interface IPv4 à laquelle le serveur SMTP se lie. Les paramètres valides avec cette valeur sont HOSTNAME et INTNETADR. Specifies the domain to associate with each IPv4 interface that the SMTP server will bind to. Parameters valid with this value are HOSTNAME, and INTNETADR.
- *SVRBIND
- Indique les interfaces IPv4 auxquelles le serveur SMTP se lie. Le paramètre valide avec cette valeur est INTNETADR. Specifies the IPv4 interfaces that the SMTP server will bind to. Parameter valid with this value is INTNETADR.
- *CLTBIND
- La liste Client Bind est mise à jour. Indique l'interface IPv4 à laquelle le client SMTP doit se lier. Le paramètre valide avec cette valeur est INTNETADR. The Client Bind list is updated. Specifies the IPv4 interface the SMTP client should bind to. Parameter valid with this value is INTNETADR.
- *ETRNSVR
- La liste ETRN Server est mise à jour. Indique la liste des hôtes dont le serveur accepte la commande ETRN. Le paramètre valide avec cette valeur est HOSTNAME. The ETRN Server list is updated. Specifies the list of hosts from which the server will accept the ETRN command. Parameter valid with this value is HOSTNAME.
- *FTRSUBJECT
- La liste Subject Filter est mise à jour. Ajoute un élément à la liste de comparaison des objets (Subject). Le courrier est supprimé ou mis en quarantaine, comme indiqué dans la page Filters des propriétés SMTP, si les conditions de comparaison sont remplies. Le paramètre valide avec cette valeur est FTRDATA. The Subject Filter list is updated. Adds an item to the Subject comparison list. Mail is discarded or quarantined, as specified on the SMTP properties Filters Page, if comparison conditions are met. Parameter valid with this value is FTRDATA.
- *FTRORIGIN
- La liste Originator Filter est mise à jour. Ajoute un élément à la liste de comparaison des adresses d'expéditeur. Le courrier est supprimé ou mis en quarantaine, comme indiqué dans la page Filters des propriétés SMTP, si les conditions de comparaison sont remplies. Le paramètre valide avec cette valeur est FTRDATA. The Originator Filter list is updated. Adds an item to the Originator's address comparison list. Mail is discarded or quarantined, as specified on the SMTP properties Filters Page, if comparison conditions are met. Parameter valid with this value is FTRDATA.
- *FTRFILNAME
- La liste File Name Filter est mise à jour. Ajoute un élément à la liste "Filename / extension comparison". Le courrier est supprimé ou mis en quarantaine, comme indiqué dans la page Filters des propriétés SMTP, si les conditions de comparaison sont remplies. Le paramètre valide avec cette valeur est FTRDATA. The File Name Filter list is updated. Adds an item to the "Filename / extension comparison" list. Mail is discarded or quarantined, as specified on the SMTP properties Filters Page, if comparison conditions are met. Parameter valid with this value is FTRDATA.
- *FTRTYPE
- La liste File Type Filter est mise à jour. Ajoute un élément à la liste de comparaison type / sous-type. Le courrier est supprimé ou mis en quarantaine, comme indiqué dans la page Filters des propriétés SMTP, si les conditions de comparaison sont remplies. Le paramètre valide avec cette valeur est FTRDATA. The File Type Filter list is updated. Adds an item to the Type / subtype comparison list. Mail is discarded or quarantined, as specified on the SMTP properties Filters Page, if comparison conditions are met. Parameter valid with this value is FTRDATA.
- *HOSTAUTH
- Les informations de connexion à l'hôte sont mises à jour. Ajoute le nom d'utilisateur et le mot de passe qui servent à authentifier l'hôte indiqué. Les informations sont stockées chiffrées dans un fichier de base de données au moyen de base64. Les paramètres valides avec cette valeur sont HOSTNAME, USERNAME et PASSWORD. Les valeurs USERNAME et PASSWORD sont utilisées pour se connecter à l'hôte suivant. The host logon information is updated. Adds the username and password which will be used to authenticate the specified host. The information is stored encrypted in a database file using base64. Parameters valid with this value are HOSTNAME, USERNAME, and PASSWORD. The USERNAME and PASSWORD values will be used to logon to the next host.
- *ACCEPTIP6
- La liste Accept Relay est mise à jour. Indique une liste d'adresses ou de préfixes IPv6 qui sont autorisés à relayer lorsque "Accept relay messages from" est sélectionné dans la page Relay Restrictions des propriétés SMTP d'IBM i Navigator. Le paramètre valide avec cette valeur est PREFIXIP6. The Accept Relay list is updated. Specifies a list of IPv6 addresses or prefixes that will be allowed to relay when "Accept relay messages from" is selected on the SMTP Properties Relay Restrictions page on IBM i Navigator. Parameter valid with this value is PREFIXIP6.
- *REJECTIP6
- Ajoute une adresse ou un préfixe IPv6 à la liste Relay Restrictions. Il s'agit d'une liste d'adresses IPv6 avec préfixes qui sont rejetées si elles tentent de se connecter à SMTP. Le paramètre valide avec cette valeur est PREFIXIP6. Adds an IPv6 address or prefix to the Relay Restrictions list. This a list of IPv6 addresses with prefixes that will be rejected if they try to connect to SMTP. Parameter valid with this value is PREFIXIP6.
- *DOMAINIP6
- Indique le domaine à associer à chaque interface IPv6 à laquelle le serveur SMTP se lie. Les paramètres valides avec cette valeur sont IP6NETADR et HOSTNAME. Specifies the domain to associate with each IPv6 interface that the SMTP server will bind to. Parameters valid with this value are IP6NETADR and HOSTNAME.
- *SVRBINDIP6
- Indique les interfaces IPv6 auxquelles le serveur SMTP se lie. Le paramètre valide avec cette valeur est IP6NETADR. Specifies the IPv6 interfaces that the SMTP server will bind to. Parameter valid with this value is IP6NETADR.
- *CLTBINDIP6
- La liste Client Bind est mise à jour. Indique l'interface IPv6 à laquelle le client SMTP doit se lier. Le paramètre valide avec cette valeur est IP6NETADR. The Client Bind list is updated. Specifies the IPv6 interface the SMTP client should bind to. Parameter valid with this value is IP6NETADR.
Adresse IPv4 (INTNETADR)IPv4 address (INTNETADR)
Indique l'adresse Internet IPv4 à ajouter à la liste indiquée. Cette adresse doit être au format décimal pointé. Jusqu'à 15 caractères peuvent être indiqués. Specifies the IPv4 internet address to add to the specified list. This address should be in dotted decimal format. Up to 15 characters can be specified.
Masque de sous-réseau (SUBNETMASK)Subnet mask (SUBNETMASK)
Indique le masque à utiliser avec l'adresse Internet IPv4. Specifies the mask to use with the IPv4 internet address.
- 255.255.255.255
- Cette valeur ne sélectionne qu'une seule valeur d'adresse. This value selects only a single address value.
- subnet-mask
- Le masque à utiliser avec l'adresse Internet IPv4. Jusqu'à 15 caractères peuvent être indiqués. Les valeurs de masque valides vont de 128.0.0.0 à 255.255.255.255 The mask to use with the IPv4 internet address. Up to 15 characters can be specified. Valid mask values are 128.0.0.0 - 255.255.255.255
Nom d'hôte (HOSTNAME)Host name (HOSTNAME)
Indique le nom d'hôte à ajouter à la liste. Jusqu'à 255 caractères peuvent être indiqués. Specifies the host name to add to the list. Up to 255 characters can be specified.
Données de filtre (FTRDATA)Filter data (FTRDATA)
Indique les données à faire correspondre lors du filtrage. Jusqu'à 512 caractères peuvent être indiqués. Specifies the data to match when filtering. Up to 512 characters can be specified.
Nom d'utilisateur (USERNAME)User name (USERNAME)
Indique l'identificateur utilisé pour se connecter au serveur SMTP. Jusqu'à 80 caractères peuvent être indiqués. Specifies the identifier used to logon to the 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 utilisateur (PASSWORD)User password (PASSWORD)
Indique le mot de passe correspondant au nom d'utilisateur pour se connecter au serveur SMTP. Si le mot de passe doit être modifié, vous devez d'abord exécuter la commande CL RMVSMTPLE TYPE(*HOSTAUTH) pour supprimer le nom d'hôte indiqué, puis exécuter ADDSMTPLE TYPE(*HOSTAUTH) pour ajouter le nom d'hôte. Jusqu'à 128 caractères peuvent être indiqués. Specifies the password that corresponds to the username to logon to the SMTP server. If the password needs to be changed, you must first issue the RMVSMTPLE TYPE(*HOSTAUTH) CL command to remove the specified hostname and then issue the ADDSMTPLE TYPE(*HOSTAUTH) to add the hostname. 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.
Préfixe IPv6 (IP6PFX)IPv6 prefix (IP6PFX)
Indique l'adresse Internet IPv6 ou un préfixe IPv6 à ajouter à la liste indiquée. Cette adresse doit être au format de réseau IPv6. Jusqu'à 44 caractères peuvent être indiqués. Specifies the IPv6 internet address or a IPv6 prefix to add to the specified list. This address should be in IPv6 network format. Up to 44 characters can be specified.
Adresse IPv6 (IP6NETADR)IPv6 address (IP6NETADR)
Indique l'adresse Internet IPv6 à ajouter à la liste indiquée. Cette adresse doit être une adresse IPv6 et non un réseau. Jusqu'à 40 caractères peuvent être indiqués. Specifies the IPv6 internet address to add to the specified list. This address should be an IPv6 address and not a network. Up to 40 characters can be specified.
Exemples
Exemple 1 : Ajout d'un élément IPv4 à la liste Accept Relay Example 1: Adding an IPv4 Element to the Accept Relay List
ADDSMTPLE TYPE(*ACCEPT) INTNETADR('1.2.3.4')
Cette commande ajoute l'adresse 1.2.3.4 à la liste Accept Relay. Le masque supposé est 255.255.255.255. Cela signifie que cette adresse peut être utilisée pour se connecter au serveur SMTP afin de relayer du courrier vers un autre serveur. This command adds an address 1.2.3.4 to the Accept Relay list. The assumed mask is 255.255.255.255. This means that this address can be used to connect to the SMTP server to relay mail to another server.
Exemple 2 : Ajout d'un élément à la liste Subject Filter Example 2: Adding an Element to the Subject Filter List
ADDSMTPLE TYPE(*FTRSUBJECT) FTRDATA('Love you.')
Cette commande ajoute un élément à la liste Subject Filter. Tout courrier dont l'objet correspond exactement à 'Love you.' est filtré comme indiqué par les attributs CHGSMTPA. This command adds an element to the Subject Filter list. Any mail with an exact match to the subject 'Love you.' will be filtered as specified by the CHGSMTPA attributes.
Exemple 3 : Ajout d'un élément à la liste d'authentification d'hôte Example 3: Adding an Element to the Host Authentication List
ADDSMTPLE TYPE(*HOSTAUTH) HOSTNAME('xyz.com')
USERNAME(admin) PASSWORD(secret)
Cette commande ajoute un élément à la liste de connexion à l'hôte. Le serveur SMTP peut se connecter à l'hôte 'xyz.com'. This command adds an element to the Host logon list. The SMTP server will be able to logon to the host 'xyz.com'.
Exemple 4 : Ajout d'un seul élément IPv6 à la liste Accept Relay Example 4: Adding a Single IPv6 Element to the Accept Relay List
ADDSMTPLE TYPE(*ACCEPTIP6) IP6PFX('2001:DB8::1')
Cette commande ajoute l'adresse IPv6 2001:DB8::1 à la liste Accept Relay. This command adds the IPv6 Address 2001:DB8::1 to the accept relay list.
Exemple 5 : Ajout d'un élément de préfixe IPv6 à la liste Accept Relay Example 5: Adding a IPv6 Prefix Element to the Accept Relay List
ADDSMTPLE TYPE(*ACCEPTIP6) IP6PFX('2001:DB8::/32')
Cette commande ajoute le préfixe IPv6 2001:DB8::/32 à la liste Accept Relay. This command adds the IPv6 Prefix 2001:DB8::/32 to the accept relay list.
Exemple 6 : Ajout d'un élément d'adresse IPv6 à la liste Server Bind Example 6: Adding a IPv6 Address Element to the Server Bind List
ADDSMTPLE TYPE(*SVRBINDIP6) IP6NETADR('2001:DB8::1')
Cette commande ajoute l'adresse IPv6 2001:DB8::1 à la liste Server Bind. This command adds the IPv6 Address 2001:DB8::1 to the server bind list.
Messages d'erreur
Messages *ESCAPE *ESCAPE Messages
- TCP1901
- Adresse Internet &2 non valide. Internet address &2 not valid.
- TCP1903
- Le nom d'hôte indiqué n'est pas valide. Specified host name not valid.
- TCP96B7
- Valeur USERNAME non valide. USERNAME value not valid.
- TCP96B8
- Une valeur USERNAME est requise pour le type de liste indiqué. USERNAME value required for specified list type.
- TCP96B9
- Une valeur PASSWORD est requise pour le type de liste indiqué. PASSWORD value required for specified list type.
- TCP96BA
- Une valeur PASSWORD n'est pas autorisée pour le type de liste indiqué. PASSWORD value not allowed for specified list type.
- TCP96BB
- Une valeur USERNAME n'est pas autorisée pour le type de liste indiqué. USERNAME value not allowed for specified list type.
- TCP96BC
- Valeur PASSWORD non valide. PASSWORD value not valid.
- TCP264F
- Valeur &2 du paramètre SUBNETMASK non valide. SUBNETMASK parameter value &2 not valid.
- TCP265F
- Valeur &2 du paramètre INTNETADR non valide. INTNETADR parameter value &2 not valid.
- TCP8050
- Le droit *IOSYSCFG est requis pour utiliser &1. *IOSYSCFG authority required to use &1.
- TCP96AE
- Entrée en double trouvée dans le type de liste SMTP &1. Duplicate entry found in SMTP list type &1.
- CPF9847
- Une erreur s'est produite lors de la fermeture du fichier &1 de la bibliothèque &2. Error occurred while closing file &1 in library &2.
- CPF9848
- Impossible d'ouvrir le fichier &1 de la bibliothèque &2, membre &3. Cannot open file &1 in library &2 member &3.
- CPF9849
- Erreur lors du traitement du fichier &1 de la bibliothèque &2, membre &3. Error while processing file &1 in library &2 member &3.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.