Crestron
e-control Mail SW-MAIL
69
••
Appendices
Installation & Reference Guide — Doc. 5798
Applies to
e-Mailbox signal blocks
Description
Checks the e-mail host for waiting mail.
Direction
system-to-server
Type
Digital
Value
Pulse (actually, leading edge is the trigger; trailing edge is ignored)
Expected Reply
Done
pulse
Comments
The server logs onto the POP3 (incoming e-mail ) host and retrieves waiting mail.
Precise behavior depends on whether or not there is an attached IN Box table in
which to save the mail, as follows:
Case 1:
Signal Block configured with “IN box” scroller
(see “IN Box scroller” on
page 35).
The message is skipped (not downloaded) if it is already in the IN box (already
downloaded).
Furthermore, when the message is already in the IN box, and it is found to have
been previously marked for deletion, it is deleted from the host at this time.
If the message is new, it is downloaded in full (headers plus body text).
If the signal block is configured to Process control messages and the message is
a control message, control equates in the subject header or body text are
processed and the message is deleted; it is not saved in the IN box. (See
“Control Messages” on page 34
.
)
When
Delete messages as downloaded
is checked in the
e-Mailbox Signal Block
Configuration
window
,
messages are always deleted from the host immediately
after downloading.
Case 2:
Signal Block not configured with “IN box” scroller (must be configured to
Process control messages):
All messages resident on the host are considered, as follows:
Each message’s headers (only) are downloaded; if the subject header was not
received (depends on the host), the full message is downloaded.
The subject header is checked to see if this is a control message. If there is a
control equate in the subject header, it is processed. If the control equate is null
(just
CTRL>
with nothing else), the body text is downloaded from the host (if not
already downloaded) and all
CTRL>
lines therein are processed.
A control message is always deleted from the host immediately after it is
processed; regardless of whether there is an IN box attached or not.
Note that if the message is not a control message, the headers are discarded
and the body text may never be downloaded.
The above process can also be set up to occur implicitly on a regular schedule
using an option in the
e-Mailbox Signal Block Configuration
window. Note that
explicit CheckMail signals are ignored if the an implicit check is already in
progress..
See Also
NewMail
signal
