User manual

Publication ENET-UM001I-EN-P - January 2010 129
Send Email Chapter 8
Enter Email Text
Use the string browser to enter the text of the email. To include To:, From:,
and Subject: fields in the email, use <CR><LF> symbols to separate each of
these fields. The To: and From fields are required; the Subject: field is optional.
For example:
To: email address of recipient <CR><LF>
From: email address of sender <CR><LF>
Subject: subject of message <CR><LF>
body of email message
An email message must not exceed 474 characters in length. An
additional
4-byte string-length value is added to the tag. As a result, the maximum source
length is 478 characters.
Possible Email Status
Codes
Examine the destination element of the email MSG to see whether the email
was successfully delivered to the mail relay server. A successful delivery
indicates that the mail relay server placed the email message in a queue for
delivery, but it does not mean the intended recipient received the email
message. These are the possible codes that a destination element could
contain.
Email Status Code Descriptions
Error
Code
(Hex
)
Extended-
er
ror
Code
(Hex)
Description
0x00 None Delivery successful to the mail relay server.
0x02 None Resource unavailable. The email object was unable to obta
in memory resources to initiate the SMTP session.
0x08 None Unsupported Service Request. Make sure the service code is 0x4B and the Class is 0x32F.
0x11 None Reply data too large. The Destination string must reserve space for the SMTP server reply message. The maximum
rep
ly can be 470 bytes.
0x13 None Configuration data size too short. The Source Length is less than the Source Element string size plus the 4-byte length.
The
Source Length must equal the Source Element string size + 4.
0x15 None Configuration data size too large. The Source Length is greater than the Source Element string size plus the 4-byte
leng
th. The Source Length must equal the Source Element string size + 4.
0x19 None Data write failure. An error occurred when attempting to write
the SMTP server address (attribute 4) to non-volatile
memory.
0xFF 0x0100 Error returned by email server; check the Destination string for reason. The email message was not queued for
deliv
ery.
0x0101 SMTP mail server not configured. Attribute 5 was not set with a SMTP server address.
0x0102 “To:” address not specified. Attribute 1 was not set with a “To:” address AND there is not a “To:” field header in the
email bo
dy.
0x0103 “From:” address not specified. Attribute 2 was not set with a “From:” address AND there is not a “From:” field header
in th
e email body.