Home > Contents > 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 -23mm
: 0 - 59ss
: 0 - 59W
(day of the week): 0-6 with 0 = Sunday.DD
(day of the month): 1 - 31MM
(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 thecs.emailhost
andcs.emailreturnto
properties. To receive mail, the Sites properties file must contain valid values for thecs.emailhost
,cs.emailaccount
, andcs.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 userjoeuser
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
Home > Contents > Index > ![]()
Oracle XML Tag Reference
Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved.