Function

The EMAIL utility interfaces with an SMTP or NNTP server to send an e-mail message or to submit a newsgroup article. A secure connection can be established with an SMTP server. Options can be used, for example, to specify a signature or the expiration of a news article. The address (or newsgroup), subject, and body separators are the double slash (//) characters (except when occurring in a URL address). The <address list> is a comma-separated list of one or more of the following: “*”, <email address>, <usercode>, <usercode>@<host>, %<file title>, or #<alias>. The “&” character can be used in place of a comma to designate cc addresses and, if used a second time, bcc addresses, and if used a third time, reply-to addresses. The “&” character can be used when submitting a news article to designate followup-to newsgroups and, if used a second time, reply-to addresses.

The content of the CANDE-editable file or the alias itself is an <address list>, including nested files and aliases, but the file or alias must be separated only by commas. Additional addresses can be designated by file equating the TO, CC, BCC, or REPLY-TO files. Within the <body> and <signature>, the “^” or “//” characters (except when occurring in a URL address) are interpreted as beginning a new line.

An existing disk file can be copied into the body of the message by using the BODY option or file equating BODY. A signature, such as a disclaimer, can be appended using either the SIGNATURE option or by file equating the SIGNATURE file. Nonstandard (X-token) headers can be included using either the XHEADERS option or by file equating the XHEADERS file.