This page allows you to identify email Recipients and select the message format they will recieve when Events trigger an email alert message.
Showing 1of 3
Recipient:
Subject:

Include
standard
message
(default or
cell phone)
Default Email Message:
This is an automated email alert originating from
<system name> at <system location> at <time/date>.
The event named <event name> with a test criteria of
<rule> a value of <test value>
tested <true/false> for register <n> <register name> with a value of <value>.
Cell Phone Message (160 char. max.):
<system name>/<system location>/<register name>/<value>=<event name>
Send Status: 

(0 = No Error)

Recv Status:


Include
custom
message
Additional comments are as follows:

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.