Scheduled Tasks

iCM scheduled tasks carry out background and housekeeping jobs in iCM. They can also be run on demand and be used to schedule the executions of end points that have been deployed to the serverlibrary.

The scheduled tasks home page lists all of the core tasks, temporary tasks that have been scheduled via iCM, such as bulk mailings and iCM reports (provided you have sufficient iCM security privileges to see them) and any schedules set up for end points.

The core set of tasks will always be listed regardless of whether they are currently scheduled or not.

Running a Task

Right-click a listed task to display a menu of available actions. You can either create a schedule or run the task now.

Scheduling a Task

When creating a schedule you can set the following properties. All dates should be entered in the format dd-MMM-yyyy and times as hh:mm:ss (twenty-four hour format)

Deleting a Schedule

To clear a schedule, right-click on it a select "Delete". This deletes the schedule and returns the status to "Not scheduled".

Task Results

Results are emailed to the "Task Status" email address held in your iCM Autoconfig. This address is set when iCM is first installed and can only be changed by our network support team. Please raise a support ticket if you need to update it.

Scheduling End Points

To schedule and end point, click "Schedule and end point" in the actions panel. The schedule properties have the same options as the core tasks described above.

Use the "Select" button to pick the end point you'd like to invoke on a schedule. The end point must be deployed to the serverlibrary. You can pick the latest version, the latest version within a major version number, or a specific major-minor version.

The description you enter here will be visible in the list of scheduled tasks. If you don't enter one, the end point's description will be used instead.

The parameters editor is the same as that found in the testing area of the end point editor. Parameters must be a valid JSON object of name/value pairs. The same parameters will be used each time the end point is invoked.

End point schedules can also be imported and exported from one iCM to another. To export an individual schedule, right click on it. To export all schedules, select "Export end point schedules" from the actions panel.

The request to execute the chosen end point is made by iCM. This means an iCM server must be running for the schedules to execute.

Copying Databases

When you copy an iCM database from one environment to another you should delete then recreate any scheduled tasks listed in this section of iCM.

Core Scheduled Task Recommendations

The following recommendations will suit a typical iCM installation. Most tasks should be run at "off-peak" periods, we recommend midnight and the very early hours.