The AW_EMAIL output interface
Customize the AW_EMAIL output interface, output device, and message template to email output however you choose.
Applications Manager ships with an email output interface object and an output device both named AW_EMAIL. You can use the AW_EMAIL output device to send email on any supported operating system.
Setting Up the AW_EMAIL Output Interface
In the AW_EMAIL output interface object definition (as shown below), add any email addresses you want users to be able to select as output options to the Option List. You can add individual email addresses using the Add button, or select email addresses specified in for Applications Manager users with the Select button.
The AW_EMAIL output interface
Do not copy the AW_EMAIL output interface. It will only work when named AW_EMAIL.
Setting Up the AW_EMAIL Output Device
In the AW_EMAIL output device object definition, optionally select values for the following fields:
| Field | Description |
|---|---|
|
Output Option |
A default email address. |
|
Subject |
The subject for the email. |
|
From |
A required valid email address that emails will say they are from. You can enter a static value or you can use the replacement value {email} to pick up the users/requestors email address. |
|
Attach, ZIP, PDF, In Body |
Pick an option to either send the output file as an attachment, include it in an attached zip file, attach it as a PDF file, or include it in the message body. |
A sample AW_EMAIL output device object is shown below.
The AW_EMAIL output device
Remember, for a task to send output to any output device including an email address, its output function must be set to PRINT.
If there is an error printing to the AW_EMAIL output device, Applications Manager will write error messages to the task's comment (not its task log file).
Specifying Email Body Text with the AW_EMAIL Message Template
When output files are attached to an email, the task's run_id replacement value will be entered as the email body. To use custom text as the email body, create a message template named AW_EMAIL. You don't need to assign the AW_EMAIL message template to the job. Message templates can include replacement values and subvars. A sample message template is shown below.
A sample AW_EMAIL message template.
For more information on message templates, see the Development Guide.
Emailing Output to Multiple Addresses
To send output to more than one address, create an output device for each email address and add them to a distribution list. For information, see Defining Distribution Lists.
Emailing Output without Defining an Email Output Device
Another method for sending output to one or more email addresses is by defining Applications Manager notifications and assigning them to applications, program types, and jobs. For more information, see the Development Guide.