General Information for DO MAIL

The specified e-mail is sent to the specified destinations when the accompanying ON statement criteria are satisfied. Although an 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. System variables and user-defined AutoEdit variables (Global IOA variables and variables defined in the SET VAR job scheduling definition parameter only) 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 JCL and AutoEdit Facility.

If installation parameter ATTSYSOT=Y, the job's SYSOUT will be attached to the email message. Setting ATTSYSOT=Y ensures that the SYSOUT is attached to any job where DO Mail is specified.

However, if you only need to attach SYSOUTs to specific jobs, then set ATTSYSOT=N, and set the ATTACH SYSOUT subparameter to Y only for those specific jobs.

The SYSOUT attached to the email message is the first three SYSOUT datasets of the job. The attachment file name has the following format:

<jobname>-D<ldate>-O<orderid>-R<run-number>.txt

The file attachment size limit, if any, is determined by the Control-M ATTSOTSZ customization parameter. See the INCONTROL for z/OS Installation Guide for details.

Note: Attaching SYSOUT data can only be executed if the job's SYSOUT was successfuly extracted by Control-M from SPOOL and saved in Control-M Archived SYSOUT data sets. Attaching SYSOUT cannot be performed, for example, in the following cases:

• Control-M/Restart is not installed (and therefore Control-M Archived SYSOUT data sets are not created).
• The AUTO-ARCHIVE parameter set to 'N' for the job.
• For DUMMY jobs
• The job was not submitted.
• The job finished ENDED NOTOK with "Job Disappeared" or "Error Reading SYSOUT" status.

Subparameters TO and CC

Each of these parameters 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.