MACROMEDIA COLFUSION MX 7 - INSTALLING AND USING COLDFUSION MX, Reference

Page: 373 / 1108

cfschedule 373
History
ColdFusion MX 6.1: Changed the way intervals are calculated. The day length now reflects
changes between standard and daylight saving times. The month length is now the calendar
month length, not four weeks. The scheduler handles leap years correctly.
Attributes
Attribute Req/Opt Default Description
action Required
•
delete: deletes the specified task .
•
update: updates an existing task or creates a
new task, if one with the name specified by the
task
attribute does not exist.
•
run: executes the specified task.
task Required Name of the task.
operation Required if
action =
"update"
Operation that the scheduler performs. Must be
HTTPRequest
.
file Required if
publish =
"Yes"
Name of the file in which to store the published
output of the scheduled task.
path Required if
publish
= "Yes"
Path to the directory in which to put the published
file.
startDate Required if
action =
"update"
Date on which to first run the scheduled task.
startTime Required if
action =
"update"
Time at which to run the scheduled of task starts.
url Required if
action =
"update"
URL of the page to execute.
port Optional 80 Port to use on the server that is specified by the
url
parameter. If
resolveURL = "yes"
, retrieved
document URLs that specify a port number are
automatically resolved, to preserve links in the
retrieved document. A port value in the
url
attribute overrides this value.
publish Optional No
•
Yes: saves the result to a file.
•
No
endDate Optional Date when scheduled task ends.
endTime Optional Time when scheduled task ends (seconds).
interval Required if
action =
"update"
Interval at which task is scheduled:
•
number of seconds
•
once
•
daily
•
weekly
•
monthly
requestTimeOut Optional Can be used to extend the default timeout period.
username Optional Username, if URL is protected.