When creating a schedule, Distribution List, external distribution file, or Dynamic Distribution List, you can specify multiple e-mail addresses within a single field, row, or record.
When creating a schedule, Distribution List, or Dynamic Distribution List, you can separate each e-mail address with a comma or a semicolon.
When creating an external distribution file, multiple e-mail addresses within a single record (line) must be separated by a semicolon (separation of e-mails by a comma is not supported because a comma is the delimiter character between the e-mail address and burst value).
The multiple e-mail addresses will appear in the To line of a single e-mail when the scheduled output is distributed.
Note:
If you are using the default configuration (Packet Email = YES), one e-mail is distributed for multiple burst values specified for the same e-mail address. The e-mail address values specified on each row are treated as a string that is a key. If there are multiple rows with the same address value (key), one e-mail is distributed with all the burst values. For example, consider the following Distribution List:
Burst Value Address
A user1@abcd.com;user2@abcd.com B user1@abcd.com C user1@abcd.com
In this example, user1@abcd.com receives two e-mails when the scheduled output is distributed. In the first e-mail, user1@abcd.com; user2@abcd.com appears in the e‑mail To line and one attachment is distributed for burst value A. In the second e-mail, user1@abcd.com appears in the To line and two attachments are distributed, one for burst value B and one for burst value C.
If you are using the configuration that specifies to distribute a single e-mail for each row (Packet Email = NO), then the following behavior occurs for our example. Three separate e-mails are distributed. In the first e-mail, user1@abcd.com; user2@abcd.com appears on the To line and one attachment is distributed for burst value A. The second e-mail is sent to user1@abcd.com with one attachment for burst value B. The third e-mail is sent to user1@abcd.com with one attachment for burst value C.
If a schedule has multiple tasks and Packet Email = BURST, then for each burst value the output of all of the tasks is combined and distributed. In our example, three separate e-mails are distributed. In the first e-mail, user1@abcd.com; user2@abcd.com appears on the To line and all output from the multiple tasks for burst value A are distributed. The second e-mail is sent to user1@abcd.com with all output from all tasks for burst value B. The third e-mail is sent to user1@abcd.com with all output from all tasks for burst value C.
Another consideration is when using the default configuration (Packet Email = YES) and the same burst value is specified multiple times for the same Address (key) value. For example, consider the following Distribution List:
Burst Value Address
A user1@abcd.com;user2@abcd.com B user1@abcd.com B user1@abcd.com
In this Distribution List, only two e-mails are distributed for user1@abcd.com. In the first e-mail, user1@abcd.com; user2@abcd.com appears in the To line and the attachment is for burst value A. In the second e-mail, user1@abcd.com appears in the To line and the attachment is for burst value B. The third row in the Distribution List is ignored since it contains the same key and the same burst value, B, as the second row.
As a best practice, be sure to review your distribution information to make sure you have not duplicated the same burst and address value pairs.
Consider the following sample Distribution List, which does not contain burst values:
Address
user1@abcd.com;user2@abcd.com
user1@abcd.com
user2@abcd.com
user3@abcd.com
user1@abcd.com;user2@abcd.com;user3@abcd.com
In this Distribution List, an e-mail is distributed for each address line regardless of whether Packet Email is set to YES or NO. This is because each address value is unique. For the first e-mail, user1@abcd.com; user2@abcd.com appears in the To line and the attachment is for the full report. The second e-mail is distributed to user1@abcd.com, and so on.
If one of the address lines is repeated in the Distribution List (for example, if user3@abcd.com is added as the sixth line in the example Distribution List), the behavior would work as follows. If Packet Email = YES, only one e-mail is distributed for user3@abcd.com. However, if Packet Email = NO, two separate e-mails are distributed to user3@abcd.com.
| WebFOCUS |