Version actuelle datée du 9 juillet 2019 à 14:25

Sommaire

1 Préambule
2 Configuration système
3 Configuration Mapping
4 Envoi de mails

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.

@@ Ligne 4 : / Ligne 4 : @@
 =Configuration système=
 ==Configuration du répertoire de distribution==
-* Depuis une entrée de commande, tapez '''WRKDIRE''' puis validez.
+Depuis une entrée de commande, taper '''WRKDIRE''' puis valider.
-* Créez un utilisateur et une adresse '''INTERNET GATEWAY''' (par exemple)
-* Dans « Nom et groupe du syst » indiquez '''INTERNET''' (par exemple)
+Créer un utilisateur et une adresse '''INTERNET GATEWAY''' (par exemple).
-* Dans « Profil utilisateur » ne rien saisir
-* Défilez jusqu’à trouver « Adresse de prédilection » et indiquez 9
+Dans « Nom et groupe du syst » indiquer '''INTERNET''' (par exemple).
-* Dans « Type d’adresse » indiquez '''ATCONTXT'''
-* Dans « Nom de zone » indiquez '''NETUSERID *IBM'''
+Dans « Profil utilisateur » ne rien saisir.
-* Validez
+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==
@@ Ligne 27 : / Ligne 34 : @@
 Faire défiler jusqu’à trouver « '''Mail routeur''' » et indiquer '''SERVEURSMTP''' (par exemple)
-Notes :<br>
+Remarques :<br>
 La commande '''STRTCPSVR *SMTP''' démarre le serveur immédiatement.<br>
@@ Ligne 46 : / Ligne 53 : @@
 Exemple :
   SMTP user ID  . . . . . .   jdieu
   SMTP domain . . . . . . .   mappingsuite.com
 L’adresse sera sous la forme UserID@Domain.
@@ Ligne 53 : / Ligne 59 : @@
 Valider 2 fois pour prendre en compte les modifications
-Note : 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 ne paramétrez pas un utilisateur et que celui-ci envoie quand même un mail, il y aura plantage.
-Note : 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 : 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.
-Note : La commande CFGTCPSMTP puis l’option 1 permet également de gérer les adresses mail (seulement pour les profils déjà créés).
+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, tapez '''MAPPING''' pour afficher le menu principal de 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é » indiquez '''*IBM'''
-Dans « Dossier temporaire » indiquez le nom d’un dossier temporaire pour créer les mails
-Dans « Dtaq d’attente de traitement » indiquez le nom de la data queue d’attente
-Dans « Jobd d’envoi du mail » indiquez 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.
-Note : Si vous modifiez la jobd pour indiquer un utilisateur particulier (au lieu de *RQD), l’envoi en mail se fera depuis cet utilisateur.
+Dans « mode utilisé » indiquer '''*IBM'''
-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.
+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=

Différence entre versions