SNDSMTPEMM

La commande Envoyer un message électronique SMTP (SNDSMTPEMM) permet de créer et d'envoyer un message électronique MIME (Multipurpose Internet Mail Extensions) via le serveur SMTP d'IBM i. L'adresse d'expédition ne peut pas être indiquée, par précaution contre le spam. L'adresse d'expédition sera recherchée dans le répertoire approprié actuellement utilisé, d'après le profil utilisateur en cours. The Send SMTP E-mail Message (SNDSMTPEMM) command allows you to create and send a Multipurpose Internet Mail Extensions (MIME) e-mail message through the IBM i SMTP Server. The sending address cannot be specified as an anti-spam precaution. The sending address will be looked up in the appropriate directory currently in use based on the current user profile.

Restrictions:

• Votre profil utilisateur en cours doit être inscrit dans le répertoire de messagerie défini par la commande CHGSMTPA et le mot clé DIRTYPE. Pour la valeur *SDD du mot clé DIRTYPE, votre profil utilisateur doit être inscrit dans le répertoire de distribution système (SDD) et posséder également un nom smtp défini via la commande WRKNAMSMTP. Pour la valeur *SMTP ou *SMTPMSF, votre profil utilisateur doit être inscrit via ADDUSRSMTP Your current user profile must be enrolled in the e-mail directory that is set by the CHGSMTPA command and the DIRTYPE keyword. For a setting of *SDD for the DIRTYPE keyword your user profile must be enrolled in the System Distribution Directory(SDD) and your user profile must also have an smtp name defined via the WRKNAMSMTP command. For a setting of *SMTP or *SMTPMSF your user profile must be enrolled via ADDUSRSMTP
• Signed and encrypted S/MIME documents require the following to be installed:
  • L'option 33 d'IBM i (IBM PASE - Portable Application Solutions Environment) doit être installée. IBM i option 33 (IBM PASE - Portable Application Solutions Environment) must be installed.
  • L'option 34 d'IBM i (Digital Certificate Manager - DCM) doit être installée. IBM i Option 34 (Digital Certificate Manager - DCM) must be installed.
  • L'option 1 d'IBM Portable Utilities for i (OpenSSL) doit être installée. IBM Portable Utilities for i Option 1 (OpenSSL) must be installed.
  • Le magasin de certificats utilisateur du profil utilisateur en cours doit également être configuré avant l'utilisation de S/MIME. Tous les certificats d'expéditeur doivent être importés en tant que certificat de serveur/client. Tous les certificats de destinataire doivent être importés en tant qu'autorité de certification. Les libellés de certificat de l'expéditeur et du destinataire doivent correspondre à l'adresse électronique associée, en minuscules. The user certificate store for the current user profile must also be set up before the use of S/MIME. All originator certificates should be imported as a server/client certificate. All recipient certificates should be imported as a certificate authority. Both originator and recipient certificate labels must be the associated e-mail address in lowercase.

Paramètres

Destinataire (RCP)Recipient (RCP)

Indique le destinataire de ce message électronique. Vous pouvez indiquer jusqu'à 20 destinataires. Specifies the recipient to receive this e-mail. You may specify up to 20 recipients.

Élément 1: E-mail address

Indique l'adresse électronique de destination. Le format d'une adresse électronique est boîte@domaine. La boîte peut contenir tout caractère convertible en ISO-8859-1, mais si elle comporte des caractères non imprimables, elle doit être placée entre guillemets. Le domaine doit être constitué de caractères latins majuscules ou minuscules, de points, de tirets ou de traits de soulignement. Specifies the e-mail address to send to. The format of an e-mail address is mailbox@domain. The mailbox can be any character that can be converted to ISO-8859-1, but if there are unprintable characters the mailbox must be encapsulated with double quotation marks. The domain must be upper or lower case latin characters, period, dash, or underscore.

Élément 2: Type

*PRI

Indique qu'il s'agit d'un destinataire principal, qui sera placé dans la zone TO du document MIME. Indicates this is a primary recipient, will be put in the TO field in the MIME document.

*CC

Indique qu'il s'agit d'un destinataire en copie carbone, qui sera placé dans la zone CC du document MIME. Indicates this is a carbon copy recipient, will be put in the CC field in the MIME document.

*BCC

Indique qu'il s'agit d'un destinataire en copie carbone, qui ne figurera ni dans la zone TO ni dans la zone CC du document MIME. Indicates this is a carbon copy recipient, will not be on either TO or CC in the MIME document.

Objet (SUBJECT)Subject (SUBJECT)

Indique l'objet à utiliser dans ce message électronique. Specifies the subject to use in this e-mail.

character-value

Indique la valeur qui apparaîtra dans le document MIME créé sous l'en-tête d'objet. Jusqu'à 255 caractères peuvent être indiqués. Specifies the value that will appear in the created MIME document under the subject heading. Up to 255 characters can be specified.

Note (NOTE)

Indique le corps principal à utiliser dans ce message électronique. Le mot clé NOTE ne peut pas être vide s'il n'y a aucune pièce jointe. Specifies the main body to use in this e-mail. The NOTE keyword cannot be blank when there are no attachments.

*NONE

Indique que le corps est vide. Specifies the body to be blank.

valeur-caractère

Indique la valeur qui constituera le corps dans la première limite MIME. Jusqu'à 5000 caractères peuvent être indiqués. Specifies the value that will be the body in the first MIME boundary. Up to 5000 characters can be specified.

Pièce jointe (ATTACH)Attachment (ATTACH)

Indique les pièces jointes à envoyer avec ce message électronique. Une pièce jointe est un fichier du système de fichiers intégré (IFS) à joindre à ce message électronique. Pour joindre un fichier, le type de contenu MIME enregistré auprès de l'IANA (Internet Assigned Numbers Authority) doit être fourni, ainsi que la méthode de transfert souhaitée. Vous pouvez avoir jusqu'à dix pièces jointes. Specifies the attachments to send with this e-mail message. An attachment is an Integrated File System (IFS) file to be attached to this e-mail message. In order to attach a file the Internet Assigned Numbers Authority (IANA) registered MIME content type must be provided, as well as the desired transfer method. You may have up to ten attachments.

Élément 1: File name

Indique le chemin d'accès absolu du nom de fichier du système de fichiers intégré (IFS) à joindre au document. Jusqu'à 200 caractères peuvent être indiqués. Specifies the absolute path of the Integrated File System (IFS) file name to attach to the document. Up to 200 characters can be specified.

Élément 2: Content type

Indique le type de contenu MIME de ce fichier. Toute valeur pouvant atteindre 50 caractères peut être indiquée. Pour assurer la compatibilité avec le client de messagerie destinataire, toute valeur fournie doit être définie par l'IANA (Internet Assigned Numbers Authority) et prise en charge par le client de messagerie souhaité. En cas de doute sur le type MIME ou sur la prise en charge par le client destinataire, envoyez avec *OCTET en mode *BIN. Specifies the MIME content-type for this file. Any value up to 50 characters can be specified. For compatibility with the receiving e-mail client any supplied value should be defined by the Internet Assigned Numbers Authority (IANA) and supported by the desired e-mail client. If there is doubt on the MIME type or support of the receiving client send with *OCTET in *BIN mode.

*OCTET

application/octet-stream

*PLAIN

text/plain

*HTML

text/xml

*RTF

application/rtf

*OGG

application/ogg

*PDF

application/pdf

*VISIO

application/visio

*ZIP

application/zip

*POST

application/postscript

*L123

application/vnd.lotus-1-2-3

*FREE

application/vnd.lotus-freelance

*WORDPRO

application/vnd.lotus-wordpro

*WORD

msword

*POWERPT

vnd.ms-powerpoint

*EXCEL

vnd.ms-excel

*AC3

audio/ac3

*MP3

audio/mp3

*WAV

audio/wav

*GIF

image/gif

*BMP

image/bmp

*JPEG

image/jpeg

*PNG

image/png

*mpeg

image/mpeg

*MSG

message/rfc822

character-value

Type MIME valide enregistré auprès de l'IANA. Jusqu'à 60 caractères peuvent être indiqués. A valid IANA registered MIME type. Up to 60 characters can be specified.

Élément 3: Type

*BIN

Indique que ce fichier est binaire. Le fichier sera codé en Base64. Indicates this file is binary. The file will be encoded with Base64.

*TXT

Indique que ce fichier est du texte. Le fichier ne sera pas codé si tous les caractères peuvent être représentés sur 7 bits. Si le fichier contient un caractère de 8 bits, Base64 sera utilisé. L'envoi d'un fichier sous forme de texte n'est valide que si l'élément précédent a été fourni par l'utilisateur ou s'il s'agit de *PLAIN, *HTML ou *XML. Indicates this file is text. The file will be not be encoded if all characters can be represented in 7 bits. If the file contains an 8 bit character Base64 will be used. Sending a file as text is only valid if the previous element was user supplied or is either *PLAIN, *HTML or *XML.

Jeu de caractères (CHARSET)Character set (CHARSET)

Indique le jeu de caractères MIME (charset) de tout le texte du message électronique à envoyer. Le corps principal et toutes les pièces jointes de type fichier texte utiliseront ce jeu de caractères. Tous les jeux de caractères doivent être définis par l'IANA (Internet Assigned Numbers Authority). Si une valeur spéciale correspondant au jeu de caractères voulu est absente, l'utilisateur peut entrer le nom du jeu de caractères et le CCSID correspondant à ce jeu de caractères. Il est fortement recommandé d'utiliser UTF8 pour l'envoi de messages électroniques NON ASCII. Specifes the MIME character set (charset) for all text in the e-mail message to be sent. The main body and all text file attachments will use this charset. All charsets must be defined by the Internet Assigned Numbers Authority (IANA). If a special value for the desired charset is missing, the user may enter the name of the charset and the corresponding CCSID that matches that charset. It is strongly recommended that UTF8 is used for sending NON-ASCII e-mail messages.

Élément 1: Character set name

Indique le nom du jeu de caractères à utiliser pour tout le texte du message électronique envoyé. Les jeux de caractères sont définis par l'IANA (Internet Assigned Numbers Authority). Lors de la sélection d'un jeu de caractères, l'utilisateur doit s'assurer que le client de messagerie destinataire prend en charge ce jeu de caractères. Les valeurs spéciales de ce mot clé comportent une liste de jeux de caractères généralement acceptés par la plupart des clients de messagerie. Celui-ci sera ajouté à la zone content-type du document MIME produit. UTF-8 est le jeu de caractères recommandé pour l'envoi de messages électroniques NON ASCII. Specifies the charset name to be used for all text in the sent email. Charsets are defined by the Internet Assigned Numbers Authority. When selecting a charset the user should be aware if the receiving e-mail client supports that charset. The special values for this keyword have a list of charsets that are generally accepted by most e-mail clients. This will be added to the content-type field in the produced MIME document. UTF-8 is the recommended charset for sending of NON-ASCII e-mail.

*UTF8

utf-8

*BIG5

big5

*EUCKR

euc-kr

*EUCJP

euc-jp

*GB2312

gb2312

*ISO2022JP

iso-2022-jp

*ISO8859_1

iso-8859-1

*ISO8859_2

iso-8859-2

*ISO8859_4

iso-8859-4

*ISO8859_5

iso-8859-5

*ISO8859_6

iso-8859-6

*ISO8859_7

iso-8859-7

*ISO8859_8

iso-8859-8

*ISO8859_9

iso-8859-9

*ISO8859_15

iso-8859-15

*MACINTOSH

MACINTOSH

*UTF16BE

utf16be

*UTF32BE

utf32be

*WINDOWS_1252

windows-1252

*WINDOWS_1253

windows-1253

*WINDOWS_1254

windows-1254

*WINDOWS_1255

windows-1255

*WINDOWS_1256

windows-1256

*WINDOWS_1257

windows-1257

*WINDOWS_1258

windows-1258

character-value

Jeu de caractères MIME valide enregistré auprès de l'IANA. Un CCSID correspondant doit être fourni dans le mot clé CHSETCCSID. Jusqu'à 60 caractères peuvent être indiqués. A valid IANA registered MIME charset. Must provide a matching CCSID in the CHSETCCSID keyword. Up to 60 characters can be specified.

Élément 2: Character set CCSID

Indique l'identificateur de jeu de caractères codés du jeu de caractères fourni par l'utilisateur pour le message électronique sortant. Cette valeur est ignorée si l'une des valeurs spéciales fournies est utilisée. Specifies the coded-character set identifier of the the user supplied charset for the outgoing email. This value is ignored if using one of the provieded special values.

Le CCSID du jeu de caractères doit correspondre au jeu de caractères IANA fourni, faute de quoi le message électronique sera illisible. The CCSID of the charset must match the IANA charset provided or the e-mail will not be legible.

*DFT

ISO-8859-1 est utilisé -- CCSID 00819. ISO-8859-1 is used -- CCSID 00819.

1-65533

Indiquez la valeur de CCSID à utiliser. Les CCSID non ASCII ne sont pas recommandés, car la majorité des clients de messagerie ne prennent en charge que l'ASCII. Specify the CCSID value to be used. Non-ASCII CCSIDs are not recommended, as the majority of e-mail clients only support ASCII.

Type de contenu (CONTENT)Content type (CONTENT)

Indique le type de contenu du corps principal fourni par le mot clé NOTE. Les types de contenu pris en charge pour le corps sont le texte brut, html ou xml. Sont énumérés ci-dessous les types MIME enregistrés auprès de l'IANA (Internet Assigned Numbers Authority) qui correspondent à chaque valeur spéciale. Specifies the content-type of the main body provided by the NOTE keyword. The supported content-types for the body are plain text, html, or xml. Listed below are the Internet Assigned Numbers Authority (IANA) register MIME type that correspond with each special value.

*PLAIN

text/plain

*HTML

text/html

*XML

text/xml

S/MIME (SMIME)

Indique le paramètre à utiliser pour S/MIME (Secure Multipurpose Internet Mail Extensions). Ce mot clé définit le niveau de sécurité du message électronique : aucun, signé, chiffré, ou signé/chiffré. Specifies the setting to use for Secure Multipurpose Internet Mail Extensions (S/MIME). This keyword sets the level of security for the e-mail: none, signed, encrypted, or signed/encrypted.

*NONE

S/MIME non utilisé. S/MIME not used.

*SIGNED

Le document sera signé à l'aide du certificat de l'utilisateur figurant dans le magasin de certificats utilisateur du profil utilisateur en cours. The document will be signed using the user's certificate in the current user profile's user certificate store.

*ENCRYPT

Le document sera chiffré à l'aide du certificat de l'utilisateur figurant dans le magasin de certificats utilisateur du profil utilisateur en cours. The document will be encrypted using the user's certificate in the current user profile's user certificate store.

*BOTH

Le document sera signé et chiffré à l'aide du certificat de l'utilisateur figurant dans le magasin de certificats utilisateur du profil utilisateur en cours. The document will be signed and encrypted using the user's certificate in the current user profile's user certificate store.

Mot de passe (PASSWORD)Password (PASSWORD)

Indique le mot de passe correspondant au magasin de certificats du profil utilisateur en cours. Jusqu'à 128 caractères peuvent être indiqués. Specifies the password that corresponds to the current user profile's certificate store. 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(#),
PERCENT SIGN(%),
ASTERISK(*),
PLUS SIGN(+),
HYPHEN(-),
SLASH(/),
COLON(:),
SEMICOLON(;),
EQUAL SIGN(=),
COMMERCIAL AT(@),
QUESTION MARK(?),
UNDERSCORE(_),
TILDE,
CIRCUMFLEX ACCENT.

Exemples

Exemple 1 : Envoi d'une note à 2 destinataires Example 1: Send a Note to 2 Recipients

SNDSMTPEMM RCP((mailbox1@domain *PRI)
               (mailbox2@domain2 *CC))
           SUBJECT(some subject) NOTE(some note)

Cette commande envoie un simple message texte/plain à mailbox1@domain, avec copie carbone à mailbox2@domain2. L'objet est "some subject" et la note est "some note". This command sends a simple text/plain email to mailbox1@domain and carbon copied mailbox2@domain2. The subject is "some subject" the note is "some note".

Exemple 2 : Envoi d'une note et de 2 pièces jointes Example 2: Send a Note and 2 Attachments

SNDSMTPEMM RCP((mailbox1@domain *PRI))
           SUBJECT(some subject) NOTE(some note)
           ATTACH((/home/userid/textfile *PLAIN *TXT)
                  (/home/userid/binfile *ZIP *BIN))

Cette commande envoie un message en plusieurs parties à mailbox1@domain. L'objet est "some subject". Le corps est "some note". Il y avait deux pièces jointes : l'une est un fichier texte qui sera transféré en UTF8 car le jeu de caractères par défaut a été utilisé, et en MIME 7 bits si possible, sinon base64 sera utilisé. La seconde est un fichier zip qui sera transféré en base64 ; les jeux de caractères ne sont pas utilisés pour les fichiers binaires. This command sends a multipart email to mailbox1@domain. The subject is "some subject". The body is "some note". There were two attachments one is a text file which will be transferred as UTF8 because the default charset was used and in 7 bit mime if possible other wise base64 will be used. The second file is a zip file it will be transferredin base64 and charsets are not used for binary files.

Exemple 3 : Envoi d'une note dans un jeu de caractères différent avec S/MIME Example 3: Send a Note in a Different Charset Using S/MIME

SNDSMTPEMM RCP((mailbox1@domain *PRI))
           SUBJECT(some subject) NOTE(some note)
           CHARSET(ISO8859-1) SMIME(*BOTH)
           PASSWORD(password)

Cette commande envoie un message en plusieurs parties à mailbox1@domain. L'objet est "some subject. Le corps est "some note". Le corps sera dans le jeu de caractères ISO8859-1 (occidental), qui est un jeu de caractères ASCII et non Unicode. Le message électronique sera signé et chiffré. Dans cet exemple, le mot de passe du magasin de certificats utilisateur était "password". This command sends a multipart email to mailbox1@domain. The subject is "some subject. The body is "some note". The body will be in charset ISO8859-1 (Western) which is an ACSII charset rather than unicode. The email will be signed and encrypted. For this example the password for the user certificate store was "password".

Exemple 4 : Envoi d'une note avec un jeu de caractères défini par l'utilisateur Example 4: Send a Note with a User Defined Charset

SNDSMTPEMM RCP((mailbox1@domain *PRI))
           SUBJECT(some subject) NOTE(some note)
           CHARSET(IBM500 500)

Cette commande envoie un message en plusieurs parties à mailbox1@domain. L'objet est "some subject. Le corps est "some note". Le corps sera dans le jeu de caractères IBM500, dont le CCSID correspondant est 500. IBM500 est un jeu de caractères EBCDIC. La majorité des clients de messagerie n'affichent pas IBM500 ni aucun jeu de caractères EBCDIC ; il est donc fortement recommandé, lorsque vous utilisez un jeu de caractères fourni par l'utilisateur, de vérifier que le client de messagerie destinataire peut afficher ce jeu de caractères. This command sends a multipart email to mailbox1@domain. The subject is "some subject. The body is "some note". The body will be in charset IBM500 which the corresponding CCSID is 500. IBM500 is an EBCDIC charset. The majority of e-mail clients do not render IBM500 or any EBCDIC charset so it is strongly recommended that when using a user supplied that you check to see if the destination e-mail client can render that charset.

Exemple 5 : Envoi d'une note et d'une pièce jointe avec un type MIME fourni par l'utilisateur Example 5: Send a Note and 1 Attachment with a User Supplied MIME Type

SNDSMTPEMM RCP((mailbox1@domain *PRI))
           SUBJECT(some subject) NOTE(some note)
           ATTACH((/home/userid/image image/tiff *BIN))

Cette commande envoie un message en plusieurs parties à mailbox1@domain. L'objet est "some subject. Le corps est "some note". Il y avait une pièce jointe, qui est un fichier image au format tiff et qui sera envoyée en binaire. Le type MIME fourni par l'utilisateur doit correspondre au type du fichier, doit être défini par l'IANA et doit être compris par le client destinataire. En cas de doute sur le type MIME ou sur la prise en charge par le client destinataire, envoyez avec *OCTET en mode *BIN. This command sends a multipart email to mailbox1@domain. The subject is "some subject. The body is "some note". There were one attachment, which is an image file in tiff format and will be sent in binary. The user supplied MIME type needs to match the file type, needs to be defined by the IANA, and needs to be understood by the receiving client. If there is doubt on the MIME type or support of the receiving client send with *OCTET in *BIN mode.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

TCP506F

L'utilisateur &1 ne figure pas dans le répertoire de boîtes aux lettres SMTP local. User &1 not in local SMTP mailbox directory.

TCP5305

Fichier du système de fichiers intégré introuvable. Integrated File System File Not Found.

TCP5306

Erreur de l'API du système de fichiers intégré. Error from integrated file system API.

TCP5308

CCSID &1 non pris en charge. CCSID &1 not supported.

TCP5309

Erreur de l'API de conversion de données &5 Error from Data Conversion API &5

TCP530A

Erreur de traitement grave. Severe processing error.

TCP530B

Erreur lors de l'appel d'openssl avec l'option &1. Error calling openssl with option &1.

TCP530C

Erreur de droit sur le fichier du système de fichiers intégré Integrated File System File Authority Error

TCP530D

Caractères du mot de passe non valides. Password characters invalid.

TCP530F

Adresse électronique non valide. Email Address Invalid.

TCP5310

L'utilisateur &1 n'est pas inscrit dans le répertoire de distribution système. User &1 not enrolled in System Distribution Directory.

TCP5311

L'utilisateur &1 n'a pas d'ID utilisateur SMTP ni de domaine SMTP. User &1 does not have a SMTP userid and SMTP domain.

TCP5312

La conversion de données a échoué lors de la construction du document MIME. Data conversion failed when building the MIME document.

TCP5313

Une erreur s'est produite lors de la création ou de l'envoi du document MIME. A failure occurred on creating or sending the MIME document.

TCP5314

Option &1 du produit requis &2 non installée. Required product &2 option &1 not installed.

TCP5315

Le magasin de certificats utilisateur de l'utilisateur &1 n'est pas configuré. User certificate store for user &1 not configured.

TCP5316

Le certificat du signataire ne figure pas dans le magasin de certificats utilisateur de l'utilisateur &1. Signer certificate not in the user certificate store for user &1.

TCP5317

Le certificat du destinataire ne figure pas dans le magasin de certificats utilisateur de l'utilisateur &1. Recipient certificate not in the user certificate store for user &1.

TCP5318

Mot de passe du magasin de certificats utilisateur non valide. Password for User Certificate Store Invalid.

TCP9999

Erreur système interne dans le programme &1. Internal system error in program &1.