Commande MAILSMTP

Compatible SMTP.

Prépare la connexion avec le serveur SMTP.

Pour tout envoi de messages par le protocole SMTP, il faut débuter le programme par l’appel de cette commande.
Le premier paramètre de la commande reçoit la liste des propriétés séparées entre elles par des ";".

Syntaxe

CHGVAR	VAR(&CMD) VALUE('MAILSMTP')
CHGVAR	VAR(&PARM1) VALUE(' Server="serveur SMTP"; Sender="adresse email de l’expéditeur du mail" [ ;UserId="Profil utilisateur smtp"] [ ;password=Mot de passe profil utilisateur smtp] [ ;reply="adresse email recevant les réponses"] [ ;logfile="chemin du fichier logfile"] [ ;port=numéro du port du serveur SMTP ] [ ;enableSSL=true/false ] [ ;SSLType=SMTPS/TLS ] [ ;Sign=true/false ] [ ;Encrypt=true/false ] [ ;Certif="chemin du certificat .p12"] [ ;PwdCertif=Mot de passe du certificat] [ ;Timeout=en secondes] [ ;SecureHeaders=true/false ] [ ;WrapperSubject="Sujet du wrapper RFC 822"] [ ;checkMail= true/false] [ ;useTestMode= true/false] ')
CHGVAR	VAR(&PARM2) VALUE(' ')
CALL	PGM(LNCCMD) PARM(&HANDLE &CMD &OPT &PARM1 + &PARM2 &RESULT)

Paramètres

Paramètres
Parm1	Liste des propriétés* de la connexions SMTP, séparées entre elles par des ";".

*Propriétés
sender	Adresse de la personne qui envoie le message. Obligatoire.
Server	Adresse IP ou nom DNS du serveur SMTP. Obligatoire.
UserId	Profil de l'utilisateur pour la connexion SMTP. Optionnel.
password	Mot de passe de l'utilisateur. Optionnel.
reply	Adresse de la personne qui réceptionne les réponses au message envoyé, si elle est différente de l’expéditeur. Optionnel.

logfile	Chemin et nom du fichier où seront inscrites les traces des envois effectués. Permet de s'assurer que l'envoi du message s'est déroulé sans erreur. Ce fichier est formaté par des séparateur(;), pour pouvoir être importé dans une base de données ou Excel. Optionnel.
port EnableSLL SSL Type Sign Encrypt Certif PwdCertif Timeout SecureHeaders WrapperSubject checkMail useTestMode	Optionnel. Port du serveur SMTP dans le cas ou le serveur n'utilise pas le port 25. Pour le protocole TLS, généralement le port 587 est utilisé. Et pour le protocole SMTPS (SMTP over SSL), c’est généralement le port 465. True/False (par défaut). Si true, Launcher utilise par défaut le protocole TLS. Vous pouvez aussi le protocole SMTPS (SMTP over SSL) en utilisant le paramètre SSLType. Deux valeurs possibles : TLS (par défaut) et SMTPS. TLS : Launcher prend en charge l’Extension de Service SMTP pour SMTP sécurisé sur le protocole TLS comme défini dans RFC 3207. Dans ce mode, la session SMTP commence sur un canal non chiffré, puis une commande STARTTLS est émise par le client au serveur pour basculer vers une communication sécurisée via SSL. Consultez RFC 3207 publiée par l’IETF (Internet Engineering Task Force) pour plus d’informations. Généralement le port 587 est utilisé. SMTPS : Appelé aussi SMTP/SSL ou SMTP over SSL. Le port 465 est généralement utilisé. La communication est sécurisée via SSL dès le début de la connexion. True/False (par défaut). Si true, Launcher signe l’email envoyé, comme défini dans RFC 8551. Il utilise le certificat (.p12) spécifié avec le paramètre Certif. Conforme à S/MIME Version 4.0 et RFC 8551. Consultez RFC 8551 publiée par l’IETF (Internet Engineering Task Force) pour plus d’informations. True/False (par défaut). Si true, Launcher va chiffrer le corps de l’email envoyé comme défini dans RFC 8551. Il utilise le certificat (.p12) spécifié avec le paramètre Certif. Conforme à S/MIME Version 4.0 et RFC 8551. Consultez RFC 8551 publiée par l’IETF (Internet Engineering Task Force) pour plus d’informations. Chemin complet du certificat (.p12) utilisé pour chiffrer et/ou signer l’email. Mot de passe du certificat (.p12) utilisé pour chiffrer et/ou signer l’email. Définit le délai d’expiration de l’opération en secondes. Protection des en-têtes grâce à l'utilisation d'un message RFC 822. Un wrapper message/rfc822 est utilisé pour appliquer les services de sécurité S/MIME aux headers. Voir norme RFC 8551 pour plus de détails. L'email sera reçu en pièce jointe par le destinataire. Si SecureHeaders=true, par défaut le destinataire recevra un email sans objet et une pièce jointe contenant l'email spécifié. Vous pouvez spécifier ici un sujet afin d'éviter que l'email aille dans les spams. True/False (par défaut). Si true, une vérification des adresses email des destinataires sera effectuée selon la norme RFC 5322. La vérification sera effective pour les commandes MAILPREP, MAILTO et MAILCC. True/False (par défaut). Si true, un serveur SMTP de test, qui utilise un certificat auto signé, peut être utilisé. A ne pas utiliser en production.

Exemple

LNCCMD     CMD(MAILSMTP) +
PARM1('SERVER="SMTP.AURA.FR";SENDER="TECH+
@EASYCOM-AURA.COM";REPLY="TECH@EASYCOM-+
AURA.COM";logfile="c:\temp\logaurasmtp.txt"')

Voir aussi

• LNCSNDMAIL - Commande CL

• MAILPREP, pour préparer le message ;

• MAILATT, pour ajouter un fichier attaché au message ;

• MAILTEXT, pour définir un corps de texte ;

• MAILSUBJ, ajoutant un sujet au message ;

• MAILSEND, envoie le message ;

• MAILEND, libère toutes les structures allouées par le message.

• MAILBODYF définir un corps de texte au format HTML.

• MAILCC définir les destinataires secondaires du message.