Home >	Contents >	Index >
Template Tag TOC  |   Alpha TOC  |   Tag Family TOC  |   Purpose TOC  |   Annotated TOC  |   Index

EMAILEVENT

Creates an event that sends SMTP mail to one or more recipients at a specific time.

Syntax

<EMAILEVENT NAME="EVENT_NAME"
            TO="USER"
            TIMES="SEND_TIMES"
            FILE="FILE_NAME"/>

Parameters

NAME (required)

Name of the e-mail event.

TO (required)

A comma-separated list of the recipients to receive the message

TIMES (required)

The time at which the event is triggered. Use the format:

hh:mm:ss W/DD/MM

where:

• hh: 0 -23
• mm: 0 - 59
• ss: 0 - 59
• W (day of the week): 0-6 with 0 = Sunday.
• DD (day of the month): 1 - 31
• MM (month): 1 - 12

For each of these fields, you can use an asterisk (all legal values) or a list of elements separated by commas. A value can be one or more numbers separated by a minus sign, indicating an inclusive range. For example, 2, 5 - 7:0:0 5/*/* means the event is triggered at 2 a.m., 5 a.m., 6 a.m. and 7 a.m. every Friday.

Specify days by two fields: day of the month (DD) and day of the week (W). If you specify both, both take effect. For example, 1:0:0 1/15/* means the event is triggered at 1 a.m. every Monday, as well as on the fifteenth of each month. To specify days by only one field, set the other field to *.

FILE (required)

Complete file specification of the file whose content is used as the body of the mail message.

Description

The MAILEVENT tag creates an event that sends SMTP mail to one or more recipients at a specific time. To send mail, the Sites properties file (futuretense.ini) must contain valid values for the cs.emailhost and cs.emailreturnto properties. To receive mail, the Sites properties file must contain valid values for the cs.emailhost, cs.emailaccount, and cs.emailpassword properties.

Error Numbers

The possible values of errno include:

Value	Description
-200	Failed to register event.
-201	Exception in event.

Example

This example constructs an email event called SomeEmail which sends mail to user joeuser every day at 12:55 in the afternoon. The file "readme.txt" contains the text used for the body of the mail message.

<SETVAR NAME="errno" VALUE="0"/>
<EMAILEVENT NAME="SomeEmail"
   TO="joeuser@someadress.com"
   TIMES="12:55:00 */*/*"
   FILE="c:program filesxircomcem56readme.txt"/>
<IF COND="IsError.Variables.errno=true">
	 	 <THEN>
	 	 <!--Handle error-->
	 	 </THEN>
</IF>

See Also

mail.send

		Home >	Contents >	Index >
	Oracle XML Tag Reference Copyright (c) 2013, 2019, Oracle and/or its affiliates. All rights reserved.