User manual CRESTRON SW-MAIL

[. . . ] CRESTRON e-controlTM Mail (SW-MAIL) version 1. 4 © 1999 Crestron Electronics, Inc. Crestron e-control Mail SW-MAIL Contents How to Use This Manual 4 A Note on Printing This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Quick Start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Section Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Quick Start Guide 1: Sending e-Mail (demo3) Quick Start Guide 2: Receiving e-Mail (demo4) Introduction 6 7 8 What is Crestron e-control Mail? [. . . ] msgBody msgNew msgDel Verbatim text of message. Indicates if message has been read yet or not. Used by server to produce the new and old "mail views. " Indicates if the message has been marked for deletion (i. e. , the Delete signal was received following a Pickn signal that opened this message). Message Display Table Like the IN box table, the message display table is completely maintained by the e-mailbox signal block. The structure of this table is simply a series of 80-character lines with an ID field for proper ordering. The contents of this table are transient; it emptied and repopulated every time the server opens a mail message. Recipients Table (Recipient tables are not used by the server at this time. A future server upgrade may support a scroller for recipients as well. The table is included here so that today's database file will be compatible with tomorrow's upgrade. ) Supplied Empty Tables Creating new IN box and message tables is not possible from the server. To create a new IN box table, use Microsoft® Access to copy one from the supplied sample database file. (You only need to copy the structure of the table, not the data. ) As a courtesy to those users who do not have a copy of Microsoft® Access handy, the supplied sample database file already contains five (5) sets of empty IN box and message tables ready for use by up to five distinct e-mailbox signal blocks. Looking at the Queries table (using the Database | Queries Table. . . command), you can see five pairs of entries that refer to these five sets of tables. The essential information is summarized below: Query Number (ID) IN box table name (Table) Query Number (ID) Message table name (Table) 10 12 14 16 18 Inbox1 Inbox2 Inbox3 Inbox4 Inbox5 11 13 15 17 19 msg1 msg2 msg3 msg4 msg5 The first set, queries 10 and 11, are used in Demo4. Feel free to change the query numbers if you like (being sure to change them as well in your scroller signal block definitions!), but without MS Access, you cannot change the names of the tables to which they refer, so do not change the table names in the Table field. 45 · The e-Mail Database Tables Installation & Reference Guide -- Doc. 5798 Crestron e-control Mail Editing the Existing Database SW-MAIL It is not necessary to have Microsoft Access to view or edit the e-mail tables; they can be edited directly from within the server application. Open the server and select e-Mail | Tables. The e-Mail Tables window opens to display the contents of the eMail_Msg, eMail_Addr, and eMail_Subst tables of the database file named in the COM Settings tab of the Configuration Options window. You can also use the Database | Queries Table. . . command to open (and edit) the Queries table. NOTE: The IN box and message tables are not viewable (nor editable) from the server. Normally these tables would not require any maintenance. The tables can only be viewed using Microsoft® Access (available separately). Each "data grid" in this window features the following interactivity for editing its respective table: · · · · For viewing purposes (only), tables can be sorted by clicking on the head of each column (field). Resize the window by clicking and dragging on the lower right corner. [. . . ] The server automatically unmarks a message when it is "opened. " Messages can be marked as new again using the KeepAsNew signal. KeepAsNew, NewCount, and OldCount signals See Also 106 · Appendices Installation & Reference Guide -- Doc. 5798 Crestron e-control Mail SW-MAIL Appendix D: System limitations Serial Transmissions The length of the value of all serial signals (all the Set-- signals) is limited to 83 characters. Furthermore, the total length of all signals (including header bytes) to be transmitted in a single logic "wave" must not exceed 255 characters. [. . . ]