Previous Topic: /ECHO ExamplesNext Topic: /FETCH Command


/EMAIL Command

The /EMAIL command creates and queues an email request to the CA Workload Automation SE email interface.

This command has the following format:

►►─ /EMAIL ─ ,TO=member ─ ,TXT=member ─┬─────────────────────────┬────────────►
                                       └─ ,JOB= ─┬─ jobname ───┬─┘
                                                 └─ jobnumber ─┘

 ►─┬───────────────────┬─┬───────────────────────────┬────────────────────────►◄
   └─ ,TRC= ─┬─ N ◄ ─┬─┘ └─ ,VAR=(value1,...value8) ─┘
             └─ Y ───┘
TO

Defines the member in the EADDRLIB PDS that contains the email addresses of the recipients for this email. Up to 100 email addresses can be specified in the member, each starting in column 1 and each up to 70 characters long. The email address member can also contain an override of the email reply address.

Note: For more information about the format of the email address member, see the Interface Reference Guide.

TXT

Defines the member in the EMAILLIB PDS that contains the email template for this email. The template defines the contents of the subject and body of the email.

Note: For more information about the format of the email template member, see the Interface Reference Guide.

JOB

(Optional) Defines a job in the CA Workload Automation SE queues. If specified, the job's queue information will be used to populate variables that can be substituted in the email template. Either a job name or a CA Workload Automation SE job number can be specified. If a job name is entered, and multiple jobs with that name exist in the CA Workload Automation SE queues, then the first job found is used. The queues are searched in the order REQ, RDY, and ACT.

TRC

(Optional) Specifies whether to trace this email request. The email trace is written to SYSOUT data set ETRACE in the CA Workload Automation SE task and contains information about the connection between CA Workload Automation SE and TCP/IP and the conversation with the SMTP (email) server.

VAR

(Optional) Defines one to eight values for email template variables &VAR1 to &VAR8. Each value can be up to eight characters long. CA Workload Automation SE converts lowercase letters to uppercase when processing the command.

Note: For more information about using variables in email, see the Interface Reference Guide.