Crestron
e-control Mail SW-MAIL
99
••
Appendices
Installation & Reference Guide — Doc. 5798
SetRcptName
Applies to
e-Mailer signal blocks
Description
Sets the recipient’s real name. This is included in quotes in the “To:
”
header of the
e-Mail message, in front of the recipient’s e-Mail address. It is not considered part
of the address and may be set to anything — or excluded entirely.
Direction
system-to-server
Type
Serial (string)
Value
New recipient name
.
May contain spaces and punctuation.
Expected Reply
None
Comments
This signal is not required to send e-mail. This signal is one of several methods of
setting the recipient name.
The recipient name may be any string. It normally does not have to represent the
real name of the recipient and in fact may be set to null (blank). For example, when
the recipient’s real name is not known, it could simply be specified as “Instructor.”
The recipient name as specified is recorded but is not actually added to the
recipient list until the
SetAddr
signal is issued, that signal acting as a “trigger.”
Therefore, this signal may be sent and then resent repeatedly with different values;
the most recently sent value is eventually used. Specifying the recipient name after
the actual address does not work as expected.
If no name has been specified when the
SetAddr
signal is issued and if that
address is null (blank), then and only then if the name is also null, the default
recipient name is used. The default recipient name is specified in the e-Mailer
signal block definition and may itself be null. The initial value of the default (for a
newly defined e-mailer signal block) is:
System Manager
The recipient list is reset to the default by the
ClearNames, NewMail,
and
SendNow
signals.
Note that
SetRcptName
does not actually send any mail. Subsequent use of the
SendNow
signal is required to actually send a message.
See Also
The other “Set” signals (
SetFromName, SetAddr, SetSubj,
and
SetBody
).
The comment under SetAddr for information involving multiple recipients.
Other methods of setting the recipient name are: the
LookupRcpt
signal, and
manually picking a recipient from the bound recipient scroller.
