Specifications

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.