Quick Help
Check
one or both portions of the email message to be included. You may wish
to exclude the default message and create your own abbreviated message
if emailing to a cell phone. If only the additional comments portion is
included, the "additional comments are..." line itself will be
excluded.
You
may include more than one email name as the recipient if the names are
separated by semicolons. Each name should be in the form of
myname@mycompany.com. You may provide a general subject line that will
be used for all event notifications, or simply enter the single
character # to cause the event name to be used in the subject line. An example of the default auto-generated message might be as follows:
This is an automated email alert originating from 'Cooler System' at 'Winky's Kitchen' at 14:45:10 02/23/2006. The event named 'Freezer Failure' with a test criteria of 'Greater than or equal to' a value of 28.0000 tested true for register 44, 'Freezer Temperature' with a value of 33.0000. Additional comments are as follows: Somebody needs to call Chilly's Freezer Service right away. |
An example of the equivalent auto-generated cell phone message would be as follows:
Cooler System/Winky's Kitchen/Freezer Temperature/33.0000=Freezer Failure |
The "report on false" version of the above auto-generated cell phone message would be as follows:
Cooler System/Winky's Kitchen/Freezer Temperature/27.0000#Freezer Failure |
The
true condition is indicated by (=) while the false or event resolved
condition is indicated by (#) between value and event name. Only the
first 30 characters of each name field are included in the message. The
standard auto-generated cell phone message will be limited to 160
characters. However, selecting both the standard cell phone message and
a custom message will exceed this limit. If you want to send a custom
cell phone message, you should exclude the standard message to keep
within the typical 160 character limit. Error
codes are more likely to occur after a short period of attempting to
send an email rather than right away. Possible error codes indicated by
"Status" include: eSendMail_NoAccessLogin +1 eSendMail_ServerBusy +2 eSendMail_ServerNotReady +3 eSendMail_MissingRecipient +4 eSendMail_MissingSender +5 eSendMail_ServerError +6 eSendMail_ErrorRecipient +7 eSendMail_TooManyRecipient +8 eSendMail_ErrorCc +9 eSendMail_TooManyCc +10 eSendMail_ErrorAttachment +11 eSendMail_TooManyAttachment +12 eSendMail_ErrorSend +13 eSendMail_BodyFull +14 eSendMail_NoDNSaddress +15
NAMAILC_OK 0 NAMAILC_MISSADDRESS -1 NAMAILC_INVALIDBODY -2 NAMAILC_NOSERVER -4 NAMAILC_NOMAILBOX -5 NAMAILC_TCPERROR -6 NAMAILC_CANCELLED -7 NAMAILC_SYNTAXERROR -8 NAMAILC_MAILBOXBUSY -9 NAMAILC_GENERALERROR -13 NAMAILC_BUFFERFULL -14 NAMAILC_FILESYSTEMERROR -15 NAMAILC_INVALIDFILE -16 NAMAILC_NOATTACHFILENAME -17 NAMAILC_NOATTACHDATA -18 NAMAILC_INVALIDATTACHSIZE -19 NAMAILC_TOOMANYATTACH -20 NAMAILC_INVAILDMAILID -21 NAMAILC_INVALIDUSERNAME -22 NAMAILC_INVALIDAUTHTYPE -23 NAMAILC_INVALIDLENGTH -24 NAMAILC_NOMEMORY -25 NAMAILC_NOTCONNECTED -26
The difference between positive and negative errors is this: Positive
error codes are detected prior to the attempt to actually send the
email. These are detected primarily in preparation to send. Some of
these errors will never occur as they are not applicable. The entire
list is shown for completeness. Missing recipient is an obvious problem
easily fixed. The most common error code that is less obvious is (+15)
NoDNSaddress. This means the system could not find the mail server's
IP address using DNS host lookup. The nameserver might not be
accessible, or the host name is incorrect. Negative
error codes are detected after the send process has begun. The most
common error code, (-13), has the least useful name. However, it most
often means the login name and/or password were not accpted by the mail
server, or they do not match the sender's email address. In general, it
means i.CanDoIt was unable to log into the mail server for any of a
variety of possible reasons related to invalid login or broken
connection. Error
code (-9) will occur when there is an attempt to send an email before
the previous email has completed the send process. Error code
(-15) means the data log file that i.CanDoIt was attempting to
attach to an email could not be accessed. |