ATTACH <file title> {AS <name>}

ATTACH attaches the designated file to the email message. Depending on the file's FILEKIND and the current setting of the WRAP option, the attachment is either wrapped or attached as is.

ATTACH [ <wrap file list> ] {AS <name>}

The [. . .] syntax wraps the list of files into a container and attaches that container to the e-mail message.

AUTHenticate

The AUTHenticate option, when set, causes OBJECT/EMAIL to send login credentials to the email server as soon as a connection is established.

BCCself

Sends a bcc of e-mail and news to the sender.

BODy {=} <file title>

Appends the file to the message.

CLIENTCertificate {=} <certificate name>

Specifies the client certificate name for a secure connection. The client certificate is needed if the email server requests client certificates for a secure connection; it is used to authenticate clients during SSL communication.

<email address>

Specifies the email address to which the email is to be sent. The characters that otherwise have a specific meaning to the EMAIL utility can be used in an <email address> as long as it is enclosed in angular brackets ( ‘<’ and ‘>’) or double quotes (")

EXPires {= days}

Sets news expiration to the specified number of days (or 1 if not specified).

FROM {=} * |<email address>|#<alias>

The FROM option, when used, sets the FROM header to the specified e-mail address.

LOGIN {=} <usercode>/<password>

Specifies the usercode and password that are sent to an SMTP server that requires login authentication.

MARKid

Includes the MARKID field of the BODY.

MIME

The MIME option, when set, causes the e-mail message to be formatted with MIME headers. Setting RICHText or attaching a file automatically sets MIME.

NOTRIM

The NOTRIM option, when set, causes blank characters at the end of MCP data file records to be maintained when the file is sent as an attachment.

RECYCLE { {=} <integer> }

Specifies the number of times EMAIL is forced to retry. (If the <integer> is not specified, EMAIL will retry once.)

RETRYQueue {=} <integer>

Specifies the system queue used to schedule retries when the SMTP or NNTP server reports a transient failure (see Retry Mechanism later in this section).

RICHText | RText | RTF

RICHText (or RText or RTF), when set, designates the body of the message to be text enriched rather than text plain. This activates Rich Text Format (RTF) tags (for example, <bigger> and </bigger>) that might occur in the text.

RRR

Requests delivery receipt notification.

SECALLOWSELFSIGNED

Specifies that EMAIL accepts self-signed certificates when set to TRUE. This enables EMAIL to communicate with an SSL connection and a self-signed certificate to an email server. The default value is FALSE.

SEQuence

Includes the SEQ field of the BODY.

SIGnature = “<signature>” = <file title> OFF

When used, appends the <signature> or file to the end of the body.

TEST

Redirects the message to the sender only.

TRace

Creates a TASKFILE trace.

WRAP { {ON} | OFF | * }

When set to ON, wraps subsequent attachments. By default, wrap is set to “*” and wraps nonsymbol files.

The WRAP option controls whether subsequent ATTACH <file name> files are sent as is or automatically wrapped into a container. By default or when WRAP is set to “*”, the method chosen is determined by each file's FILEKIND. The file is sent as is if its FILEKIND ends in SYMBOL (for example, ALGOLSYMBOL) the file is TEXTDATA, SEQDATA, or CSEQDATA, or the file is DATA or CDATA and has an extension in its last node (for example, temp/welcome.htm). Other FILEKIND files are automatically wrapped into a container. When WRAP is set to ON, all ATTACH <file name> files are automatically wrapped into a container. When set to OFF, they are not.

XHeaders {=} <file title>

The x-header records in the designated file are included in the email. X-header records begin with an “X-“ or “x-“ target delimited by a “:” (for example X-SYSTEM: NEWTN).