Schedules

Name: The user-defined name of the task

Category: The user-defined name of the general category or group to which the task belongs

Start Time: The time at which the task is scheduled to start, using the following syntax:

year-month-day hour:minute:second

End Time: The time at which the task is to end. The time displays as N/A if the task does not end, or using the following syntax:

year-month-day hour:minute:second

Recurrence: The frequency of the task. Recurrence displays as, Never (if the task occurs only once), a Cron expression, or the recurrence interval, whichever is specified.

Note: cron expressions display according to the time zone of the FME Server that is running the task. All other times display in your local time zone.

Workspace: The workspace that runs the request.

Status: The current status of the task.

• Enabled (green checkmark): it will run at the next scheduled time.
• Disabled (red circle with x): the task has been paused.

Owner: The user who created the schedule owns it and has full permissions on it.

Share: To share a schedule, click the Share with Others icon. Through sharing, you can grant levels of permissions on an item to other users. You can share an item if you own it, or if you are a user with Manage permission in Security, such as an administrator. For more information about sharing and ownership, see Role-Based and User-Based Access Control.

To add a scheduled task, do any of the following:

• From the Schedules page (Schedules > Manage Schedules), click New; or, select a task from the table, and select Actions > Duplicate.
• Select Schedules > Build Schedule.

Enter or edit the following information to define the task. When finished, click OK.

Tip: You can test a workspace that is initiated by a Schedule trigger, regardless of the times the Schedule is configured to execute. See Testing a Schedule-Initiated Workspace, below.

Name: Name of the task

Category: Name of the general category or group to which the task belongs.

This name can be used to organize tasks into site-specific types as required.

Task names must be unique within the table.

Description: Description of the task.

Enabled: Check to enable the task.

Schedule Type:

• Basic: The task repeats in a calendar-friendly selection of intervals derived from a specified start time.
• Repeat On Interval: The task repeats in intervals from a list of predefined units.
• CRON Expression: The task repeats based on your own cron expression.
• Only Occur Once: The task runs once only at the specified Start time

Note: Basic and CRON Expression must be configured according to the time zone of the FME Server that runs the task. All other times can be expressed according to your local time zone.

If Repeat on Interval is specified, the schedule does not adjust when switching between Standard Time and Daylight Saving Time.

Date Range:

• Start: Date and time the task is to start. For more information, see Specifying a Future Time.
• Start Immediately: When checked, the task starts as soon as it is added to the Schedules table. When unchecked, you must specify a Start time (above).
• End: Date and time to stop running the task. For more information, see Specifying a Future Time.
• Does Not Expire: When checked, the task has no end time. When unchecked, you must specify an End time (above).

Recurrence: If Schedule Type is Basic, specify how often the task repeats from the drop-down selections.

Skip if Job In Progress: If checked, and Schedule Type is Basic, Repeat on Interval or CRON Expression, the next scheduled task is not triggered if the status of the previously triggered job is still Running or Queued.

Tip: You can check a job's status on the Jobs page.

Workspace

Repository: Name of the repository in which the workspace resides.

Workspace: Workspace the task is to run.

Once the workspace is specified, any published parameters of the workspace display. You can modify these parameters, if desired. The changes take effect when the task is run.

Notifications

If desired, specify the Notification Service topics to which to send a notification if the task executes successfully (Post to Topic on Success) or unsuccessfully (Post to Topic on Failure). For more information, see Monitoring FME Server Events from Topics.

Advanced

• Job Queue (optional): The job queue in which to run the job. The specified queue overrides the queue of the repository to which the workspace belongs. If not specified, the job is placed in the job queue of the repository.
• Queued Job Expiry Time (optional): The length of time after which a job that is waiting in queue does not execute. If the job does not execute before this time is reached, it remains in the queue until it is ready to execute, but execution is not attempted. This directive is useful for time-sensitive jobs that you do not want to run after the specified time is exceeded.
• Running Job Expiry Time (optional): The time a job will remain in the running state. This directive is used to ensure that a job does not hang and block an FME Engine indefinitely. The minimum allowable value is 1.
• Run Until Cancelled (optional): If checked, the job runs continuously, even after a server shutdown or crash, until it is explicitly canceled.

For testing purposes, you can force a workspace that is initiated by a Schedule to run at any time, regardless of the specified parameters of the Schedule.

From the Schedules Page

1. Select the schedule that initiates the workspace you want to test.
2. Select Actions > Trigger.

From the Create or Editing Page of an Individual Schedule

• When ready to test, click Trigger (at bottom).

A Trigger Schedule message displays to indicate whether the Schedule was successfully requested. If so, the scheduled task runs as it is currently configured.

To view a list of jobs that have been triggered by a schedule, select a schedule, and select Actions > View Triggered Jobs.

Click on any job in the list to examine its properties. To remove a job from the list, select it and click Remove.

To examine or modify the properties of a scheduled task, click the task entry in the Schedules table.

This displays the properties of the task in a page similar to the one used for Adding a Scheduled Task, above.

You can suspend scheduled tasks when they are created or by modifying an existing task. Click the Enabled check box in the Editing Schedule or Create a New Schedule page. Alternatively, on the Schedules page, select the tasks you want to enable or disable (suspend), and select Actions > Enable or Disable.

To remove a scheduled task, check the box beside the task on the Schedules page, and select Actions > Remove.

Note: Removing a scheduled task while its workspace is running does not interrupt the associated translation — the translation is not affected by task removal and will run to completion. Removing a task only prevents the subsequent running of its associated workspace.