Instructions

UM-0085-B09 DT80 Range User Manual Page 86
RG
Substitution Characters
Special substitution characters can be placed into actionText. These instruct the DT80 to dynamically insert the following
information when the alarm returns and/or logs its action text:
Alarm text
where
Substitutes the following
Example
!
DT80 serial number, :, alarm number
080035:8
!!
! character
!
@
time at which action text was returned
(in P39 and P40 format)
12:13:14.634
@@
@ character
@
#
date at which action text was returned
(in P31 format)
17/9/2007
##
# character
#
?C
standard channel name
2PT385
?N
user channel name
Boiler
?R
relation (test condition)
>100
?U
channel units
degC
?V
channel value when alarm tested true
(use
FF
n etc. channel options to control format)
100.2
?A
A = any letter (A-Z)
other than
CNRUV
not valid
?nFp
n = 1-1000, p = 0-7
value of nCV in fixed point format, p decimal places
-1257.42 (p=2)
?nEp
n = 1-1000, p = 0-7
value of nCV in exponential format, p decimal places
-1.26E3 (p=2)
?nMp
n = 1-1000, p = 0-7
value of nCV in mixed format, p significant digits
-1.3E3 (p=2)
?nF
n = 1-1000
same as ?nF1
-1257.4
?nE
n = 1-1000
same as ?nE1
-1.3E3
?nM
n = 1-1000
same as ?nM1
-1E3
?nA
A = any letter (A-Z)
other than
FEM
not valid
?n$
n = 1-50 value of string variable n$
East
?n
n = 1-1000
same as
?nF1
-1257.4
??
? character
?
?
same as ?V
100.2
c
c = any character
c
A
Note: Substitution characters are not case sensitive (?v is equivalent to ?V)
Special Characters
Special characters may be inserted in alarm strings using control character (e.g. ^M) or backslash (e.g. \013) notation.
See ASCII-Decimal Table (P389) for more information.
For example,
ALARM(3TT>120)"\192 hautes temp\233ratures!! ?v \176C^M^J"
will return/log the following string when the specified temperature is exceeded:
À hautes températures! 129.4 °C
In this example the \192 and \233 insert the accented characters, \176 inserts the degree symbol, and ^M^J adds a
carriage return/line feed pair. Note also the !! to generate a single exclamation mark, and the ?v substitution string, which
is replaced by the channel value.
If the software used to enter the program text supports it, you could alternatively have entered the special characters
directly, i.e.
ALARM(3TT>120)"À hautes températures!! ?v °C^M^J"
Be aware that many extended ASCII character codes display differently on the DT80's LCD compared with the host
computer. See ASCII-Decimal Table (P389).
Examples
 Substitution Characters
The following command:
ALARM(9TK("Oven 9")<200)"Alarm: SN ! at # @, ?n value is ?v ?u"[sms:[phone]]
would, on DT8xM models, send an SMS alarm message similar to the following:
Alarm: SN 081234:0 at 17/5/2011 19:09:11.002, Oven 9 value is 187.2 degC