NOTIFY command

Used to send email notification messages.

Syntax

NOTIFY USER username <PASSWORD pwd> MAILBOX pathname ADDRESS recipient
<CC cc_recipient> <BCC bcc_recipient> <SUBJECT subject> MESSAGE message
<ATTACHMENT pathname>

Parameters

USER username

Specifies the email address of the sender.

PASSWORD pwd

Specifies the password for the mail server.

MAILBOX pathname

Specifies the SMTP server name to use to send the email message. For example: mailserver.acl.com

ADDRESS recipient

Specifies the email address of the recipient. Separate the email addresses of multiple recipients with a comma.

CC cc_recipient

Specifies the email addresses of carbon copy recipients.

BCC bcc_recipient

Specifies the email addresses of blind carbon copy recipients.

SUBJECT subject

Specifies the text of the subject line.

MESSAGE message

Specifies the text of the message.

ATTACHMENT pathname

Specifies the path and filename of one or more attachments. You must use a quoted string. You can specify multiple attachments by entering a comma separated list of files for the pathname parameter. For example, “result1,result2”

Remarks

You can use the NOTIFY command to send email notification messages to one or more recipients. Messages can include attached data files and ACL projects. The NOTIFY command can be used to notify the appropriate personnel when a script fails unexpectedly. The command can be used with any mail server that supports SMTP (Simple Mail Transfer Protocol), which is used by Microsoft Exchange and many other mail servers. The NOTIFY command can also be used with older email applications, from Microsoft and others, that send mail locally.

If ACL is unable to connect with the mail server, it makes five additional attempts to connect, with a 10-second pause between each attempt. If all connection attempts are unsuccessful, the NOTIFY command is canceled, with a message written to the log, but the script continues processing. You can use the SET command to change this default behavior. You can specify a different number of connection attempts and a different amount of time between attempts, or you can turn off additional connection attempts. You can also specify that ACL stops processing a script if the NOTIFY command is canceled. For more information, see SET command.

An invalid email recipient is not considered a failure of the NOTIFY command and does not cause a script to stop regardless of the associated setting.

Example

The following example uses the NOTIFY command to send a error report email with two attached files when a script fails.

NOTIFY USER "support@company.com" MAILBOX "mail.company.com"
ADDRESS "script_admin@acl.com" SUBJECT "Error Report"
MESSAGE "Failed to process script. Details attached."
ATTACHMENT "Errors.fil,ACL_Demo.log"


(C) 2015 ACL Services Ltd. All Rights Reserved.