Previous Topic: /ECHO ExamplesNext Topic: /FETCH Command


/EMAIL Command

The /EMAIL command creates and queues an email request to the CA WA CA 7 Edition email interface.

Note: The first time this command is issued, it also attempts a connection to TCP/IP if one was not successfully established at initialization.

This command has the following format:

/EMAIL,TO=member,TXT=member
       [,JOB={jobname|jobnumber}]
       [,TRC={N|Y}]
       [,VAR=(value1,...value8)]
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 WA CA 7 Edition queues. If specified, the queue information of the job is used to populate variables that can be substituted in the email template. Either a job name or a CA 7 job number can be specified. If a job name is entered, and multiple jobs with that name exist in the database, then the first job that is 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 WA CA 7 Edition task and contains information about the connection between CA WA CA 7 Edition 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 WA CA 7 Edition converts lowercase letters to uppercase when processing the command.

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