General Information

The specified e-mail is sent to the specified destinations when the accompanying ON statement criteria are satisfied. Although e-mail can be sent using a DO SHOUT statement, the DO MAIL statement provides the following advantages:

• Using DO MAIL, you can specify any number of TO and CC recipients. With DO SHOUT, you must specify the mail destination prefix, and you must define the address in the MAILDEST table.
• Using DO MAIL, the e-mail text can exceed 70 characters. Both system and user-defined AutoEdit variables are supported in the subject line and message text. These variables are resolved when the DO MAIL statement is processed.

Note: The resolved value of an AutoEdit variable is truncated after 70 characters.

For information on the use of AutoEdit variables, see AutoEdit Variables.

The TO and CC Subparameters

The TO and CC subparameters can contain more than one mail name address. When a value is specified in the TO or CC field, a new empty line is displayed so that an additional value can be specified (up to a maximum of 255 lines).

Multiple addresses, separated by a semicolon (;), can be specified on a line.

If an address exceeds the length of a full line, it can be continued on the following line.