Manual > Server Creation Guide > Actions > Action Reference

How to read the manual

This chapter is for reference information only.

For setup instructions, please refer to "Sending an email" in the Monitoring System Setup Guide.

Features of this action

The Send mail action allows you to send an email.

When this action is executed, it creates email information according to the predefined Send mail content and makes a request to the mail server to send it. The actual sending of the email is done by the mail server.

You can also define the content in a text file called a "mail master." By editing the mail master and reloading it, you can change the destination even during operation.

c_action_0371

This package does not include a mail server function. To use this action, you must have a mail server running separately.

Action Settings

The settings for this action are explained below.

Action specifications

Parameters

You can specify parameters for the action to be executed from the event that calls this action.

c_action_logger_0118

Parameter Characters

Operation

Do not specify anything

Send the email.

RELOADMAILMASTER

Reloads the mail master file. Specify this parameter if the mail master file has been edited during system operation.

To allow operators to change or add information such as email destinations while the system is running, first edit and save the mail master file from an external application such as VB. Then, execute the Send mail action with an event (such as Tag event) that has RELOADMAILMASTER added, and the edited mail master file will be reloaded. After reloading, execute the Send mail action without parameters to send emails with the edited contents.

*When you specify this parameter and execute the command, only the mail master will be reloaded and no mail will be sent.

dialog

■ Email settings

c_action_0047

▪Outgoing mail server (SMTP)
The address and port number of the SMTP server for sending email.

▪Incoming mail server (POP)
The address and port number of the POP server used for authentication.

▪Account Name
Account name.

▪password
Password.

▪Authentication Method
Select the authentication method when Send mail.
For authentication method, select the authentication method supported by the sending mail server.

item	Operation
NONE	No authentication
POPBEFORESMTP	Authentication with POP before SMTP
SMTPAUTH_LOGIN	SMTP authentication using AUTH and LOGIN commands
SMTPAUTH_PLAIN	SMTP authentication using AUTH and PLAIN commands
SMTPAUTH_CRAMMD5	SMTP authentication using AUTH and CRAM-MD5 commands
SMTPAUTH_DIGESTMD5	SMTP authentication using AUTH and DIGEST-MD5 commands

▪Character Encoding
Select the encoding method for characters.

▪Use an encrypted connection (SSL)
Check this if you want to connect via SSL.

■ Contents of transmission

c_action_0048

▪Specifying the content to be sent in the mail master file
The content of the email to be sent can be specified in an external text file. When an operator wants to add or edit a destination during operation, a mail master file is used. If this setting is checked, specify a mail master file. For information on the format of the mail master file, see "Format of the mail master file".

Please set the following if you do not use the mail master.

▪Sender
The sender's email address.

▪address
The destination email address.

▪CC
Carbon copy. When a message is sent with a CC address, the recipient can read from the message headers to see who else the message was sent to.

▪BCC
Blind carbon copy. When an email is sent using the BCC field, the recipient's name is not recorded in the message header, so you won't know if the email was sent to someone other than you.

▪subject
Specify the subject of the email.

▪Delete attachments after sending
After sending the email, the attached file will be deleted. For example, you can automate the process of creating a subreport such as Excel in a specific folder using the summary action, sending the subreport file as an attachment using the Send mail action, and then deleting the file.

▪Attachments
The file to attach to the email. If you want to specify multiple files, separate them with a semicolon ";". If you press the selection button on the right, they will be added one by one, so if you want to delete them, delete them directly from the edit box.

▪Attachments Folder
Attach all files in the folder to the email.

▪Message File
If you do not use the mail master, you must define the body of the mail separately as a text file. The contents of the text file specified here will be sent as is as the body of the mail.
This text file is read every time you send an email. By updating this text file in some way just before sending the email, you can change the content of the message.

▪Display the "Compose Message" screen before sending
If you check this setting, a screen will appear for you to compose your message before sending the email. Use this if you want to manually edit the email message each time you send an email.

In the "Advanced Settings" tab, you can specify the timing for executing a script (SC1) before an action is executed, or the timing for adjusting the execution of the action (setting the execution wait time). For details on the advanced settings of each action, see "Settings on the Advanced Settings tab of an action".

Mail master file format

The mail master is a text file that defines information such as the recipient. It is created and edited with a text editor such as Notepad. The file name of the mail master can be freely chosen.

The format of the mail master is as follows:

Properties	Commentary
[MailParam]	Describe the parameters of Send mail. Currently, the only parameters that can be set are the following: // Do not delete attached files after Send mail DELETEATTACHEDFILE=0 // Delete the attached file after Send mail DELETEATTACHEDFILE=1 *Please do not put spaces before or after "=".
[MailSubject]	Specify the title (subject) of the email. example) [MailSubject] Title
[MailSender]	Send mailSpecify the person. example) [MailSender] xxx@xxx.com
[MailSendToName]	Send mail destination. If you want to send to multiple email addresses, list the email addresses on separate lines as shown below. Be sure to end the email with "(end)". example) [MailSendToName] xxx1@xxx.com xxx2@xxx.com (end)
[MailSendToNameCC]	Specify the recipient (CC). If you want to send to multiple email addresses, list the email addresses on separate lines as shown below. Be sure to end the email with "(end)". example) [MailSendToNameCC] xxx1@xxx.com xxx2@xxx.com (end)
[MailSendToNameBCC]	Send mail destination (BCC). If you want to send to multiple email addresses, list the email addresses on separate lines as shown below. Be sure to end the email with "(end)". example) [MailSendToNameBCC] xxx1@xxx.com xxx2@xxx.com (end)
[MailAttachedFile]	Specify the name of the file you want to attach. If you want to attach multiple files, list the file names on separate lines as shown below. Be sure to end the line with "(end)". example) [MailAttachedFile] c:\xxx1.txt c:\xxx2.txt (end)
[MailAttachedFolder]	Specify the folder that contains the file you want to attach. All files in the folder will be attached. If you want to attach multiple folders, list the folder names on separate lines as shown below. Be sure to end the line with "(end)". example) [MailAttachedFolder] c:\xxx1 c:\xxx2 (end)
[MailMessage]	Specify the text of the email. Be sure to end it with "(end)". example) [MailMessage] The first line of the email content. Second line of the email content. The third line of the email. (end)