Instructions

UM-0085-B09 DT80 Range User Manual Page 87
RG
 Text Labels
The DO command in conjunction with alarm text provides a simple way to output a text string in a schedule, e.g.:
RA5M DO"Boiler 1^M^J" 1TK 2TK DO"Boiler 2^M^J" 3TK 4TK DO"^M^J"
will include a heading before each group of measurements:
Boiler 1
1TK 239.4 degC
2TK 99.9 degC
Boiler 2
3TK 212.4 degC
4TK 90.9 degC
Alarm Communication Actions
Alarm communication actions allow you to send the alarm action text (or other message) to one or more recipients via
email and/or SMS.
Alarm Email Messages
To send an alarm email, add a mailto: URI (Uniform Resource Identifier), in square brackets, after the alarm text
string. The URI consists of a recipient email address, followed by up to four optional parameters, i.e.
mailto:recipient-email?priority=priority&subject=subject&body=body&interface=iface
where:
• recipient-email is a comma-separated list of up to 5 email addresses in the usual format (e.g.
[e-mail]). There is no extra overhead in sending an email to multiple addresses – the data is only
sent once and the delivery to the required recipients is handled by the Internet email system.
• priority is high, normal (default) or low. A high priority message will be sent as soon as possible, with the
"high importance" flag set (typically displayed as an exclamation mark in email clients). A normal priority
message is also sent as soon as possible, but without the "high importance" flag. A low priority message will be
queued and sent when a communications session next starts. (If a communications session is already active
then it will be sent immediately.) If the Ethernet interface is used then all messages are either high or normal
priority – if low priority is specified then normal priority is assumed.
• subject is a string to use as the subject of the email. If not specified then "dataTaker SN serial alarm" is used
as the subject (where serial is the DT80 serial number).
• body is a string to use as the body of the email. If not specified then the alarm action text is used.
• interface is applicable to DT8xM models only, and specifies the network interface to use: modem (default), or
ethernet. For models without internal modem, Ethernet is always used and this option is ignored.
Notice that the format of this URI is identical to that used for email unloads (see Email (P107))
See Communications Sessions (P222) for more details about how email transmission is managed.
Note: No more than 12 emails can be queued; any subsequent attempts will be discarded (a message will be written to the event log,
and a warning email will be generated).
 Examples
Send the alarm text (e.g. "Hi temp 3TK=47.2") in the body of an email to two recipients:
ALARM(3TK>45)"Hi temp ?n=?v"[mailto:[e-mail],[e-mail]]
Send a test email:
DO[mailto:[e-mail]?subject=test subject!&body=test body!]
Measure a temperature every 4 hours and generate an email, but send all emails in one daily batch at 9am:
RA4H IF(1TK<9999)"Temp at # @: ?v"[mailto:[e-mail]?priority=low]
RB[0:0:9] DO{SESSION START}
Alarm SMS Messages
DT8xM models only
Sending an alarm SMS is similar to sending an email – add an
sms: URI in square brackets. An SMS URI consists of
the recipient phone number, then up to two optional parameters, i.e.
sms:recipient-phone?priority=priority&body=body
where:
• recipient-phone is the destination phone number. The acceptable number formats will depend on the country.
For example, in Australia you can enter a standard mobile number (e.g. 0400123456) or a fixed line number
with area code (e.g.
0398765432). The safest approach, however, is to use international format, i.e. a "+",
then country code, then area code with any leading zero dropped, then the number (e.g.
[phone]).