pub.scheduler:addOneTimeTask

service

String Name of the service you want to schedule for execution.

description

String Text string describing this task.

target

String Server or servers on which the task is to run.(Clustered environments only). Set to:

any to run the task on any server in the cluster. The task will run on only one of the servers.

For example, suppose that all the servers in your cluster share a single database for a parts inventory application, and that a particular function needs to run against that database once a day. Any of the servers can perform this task, therefore you can specify the all option to schedule a task to run on any of the servers.

Note:

There is no predetermined order in which servers in the cluster are selected to run tasks. Rather, the first server to detect that a task is ready to be executed runs it.

For more information about how Integration Server handles the scheduling of tasks in a clustered environment, see the chapter about managing services webMethods Integration Server Administrator’s Guide.

all to run the task on all servers in the cluster.

For example, suppose you run an application on each server in the cluster, and each server maintains its own database for that application. If you need to run a cleanup task against all the databases every day, you can schedule a task to run every day on all the servers in the cluster.

hostname to run the task on a specific server in the cluster.

lateness

String The number of minutes (after the scheduled execution time) after which the server is to take a special action for a late task. You specify the action to be taken in the latenessAction parameter, described below. The server checks scheduled tasks at startup, and again periodically. If the server finds a task that is overdue and has exceeded the lateness period, the server performs the requested lateness action. If the server finds a task that is overdue but has not yet exceeded the lateness period, the server starts the task immediately.

latenessAction

String Action to take if a task has missed its scheduled start time by a number of minutes you specified with the lateness parameter. Possible actions are:

run immediately or 0 - Runs the task immediately

skip and run at next scheduled interval or 1 - Skips this execution of the task and runs it again at the next scheduled run time.

suspend or 2 - Places the task in a suspended state until an administrator resumes or cancels the task.

runAsUser

String Optional. User ID under which the service is to be executed. If you do not specify a user name, the “Default” access rights are used.

inputs

Document Optional. Document (IData object) containing input to the scheduled service.

Note:

You can also assign values to input parameters of services using the Assign Inputs option while scheduling a task in Integration Server Administrator

date

String Date on which to run the service, in the format yyyy/MM/dd.

time

String Time at which to run the service, in the format HH:mm:ss.

taskID	String Identification number of the task added to the scheduler.
type	String Code indicating the type of task added. For this type of task, the value of type will be once.
taskAdded	String Indicates whether the task was successfully added to the Scheduler. If the task was successfully added to the Scheduler, taskAdded contains true. If the task was not successfully added, the server throws an exception and terminates the service.