Paramétrage SMTP IBM-i

Préambule

Cette document décrit la configuration et le fonctionnement des envois d'e-mails via l'API d'envoi d'e-mails IBM i.

Configuration système

Configuration du répertoire de distribution

Depuis une entrée de commande, taper WRKDIRE puis valider.

Créer un utilisateur et une adresse INTERNET GATEWAY (par exemple).

Dans « Nom et groupe du syst » indiquer INTERNET (par exemple).

Dans « Profil utilisateur » ne rien saisir.

Défiler jusqu’à trouver « Adresse de prédilection » et indiquer 9.

Dans « Type d’adresse » indiquer ATCONTXT.

Dans « Nom de zone » indiquer NETUSERID *IBM.

Valider.

Configuration des attributs de distribution

Depuis une entrée de commande, taper CHGDSTA puis utiliser la touche F4.

Dans « Route vers la passerelle SMTP » indiquer INTERNET et adresse GATEWAY (nom créé à l’étape précédente)

Configuration des attributs SMTP

Depuis une entrée de commande, taper CHGSMTPA puis utiliser la touche F4

Dans « Autostart server » indiquer *YES et taper ENTRER

Faire défiler jusqu’à trouver « Mail routeur » et indiquer SERVEURSMTP (par exemple)

Remarques :
La commande STRTCPSVR *SMTP démarre le serveur immédiatement.

La commande ENDTCPSVR *SMTP arrête le serveur immédiatement.

Ajouter l’adresse IP d’un serveur SMTP

Depuis une entrée de commande, taper CFGTCP puis prendre l’option 10 (Work with host table)

Ajouter l’adresse IP et le nom SERVEURSMTP (celui indiqué à l’étape précédente)

Pour chaque utilisateur IBM i pouvant envoyer des mails :

Taper WRKDIRE puis option 1 pour un nouvel utilisateur ou 2 pour un utilisateur local :

Utiliser la touche F19 pour modifier le nom et l’adresse mail de l’utilisateur.

Exemple :

SMTP user ID  . . . . . .   jdieu            
SMTP domain . . . . . . .   mappingsuite.com                                        

L’adresse sera sous la forme UserID@Domain.

Valider 2 fois pour prendre en compte les modifications

Remarque : Si vous ne paramétrez pas un utilisateur et que celui-ci envoie quand même un mail, il y aura plantage.

Remarque : Si vous paramétrez un utilisateur mais ne paramétrez pas d’adresse mail pour l’utilisateur, le mail sera de la forme utilisateur@machine.domaine.

Remarque : La commande CFGTCPSMTP puis l’option 1 permet également de gérer les adresses mail (seulement pour les profils déjà créés).

Configuration Mapping

Depuis une entrée de commande, taper MAPPING pour afficher le menu principal de Mapping

Dans la barre de menu, prendre le menu « e-Mail » puis « Paramétrage du mail »

Dans « mode utilisé » indiquer *IBM

Dans « Dossier temporaire » indiquer le nom d’un dossier temporaire pour créer les mails

Dans « Dtaq d’attente de traitement » indiquer le nom de la data queue d’attente

Dans « Jobd d’envoi du mail » indiquer la job description à utiliser pour soumettre la demande

Dans « Message sur succès » indiquez à quelle file d’attente envoyer un message si le mail est envoyé

Dans « Message sur erreur » indiquez à quelle file d’attente envoyer une erreur est survenue

Remarque : Si vous modifiez la jobd pour indiquer un utilisateur particulier (au lieu de *RQD), l’envoi en mail se fera depuis cet utilisateur. Il n’y aura donc pas besoin de paramétrer l’adresse mail de chaque utilisateur (étape 1e). En revanche, les envois de message se feront à cet utilisateur et non à l’utilisateur envoyant le mail.

Envoi de mails

L’envoi de mail fonctionne comme pour un envoi *MAPPING. La file d’attente de mail (commande MAPDSPMAIL) sera toujours disponible.