Scheduling jobs

Use the Schedules panel to schedule projects to run at a future time or at regular, repeated intervals. For example, you can set up a project to run every hour or every day.

To view job schedules, click Schedules. A calendar for the current month is shown, with a panel beneath it used to create and modify schedule entries.

Each day in the calendar displays the number of projects scheduled for that day. Mouse over a day to see the names and schedule parameters for jobs that are scheduled for that day.

If you have more than one project scheduled, the system displays a dropdown box and Filter button to allow you to filter the calendar by project.

Screen image shows the Schedule Details tab in the Schedules panel

To place a project in the scheduler, do the following:

  1. Click Schedules in the left menu.
  2. Click Add Scheduled Run.
  3. Enter a description for the schedule entry in Description.
  4. Select a project from the Project list.
  5. The current snapshot for the project is shown in a field underneath Project. If you want a different snapshot to run for the scheduled job, select a snapshot from the list.
  6. For Mode, choose Active (the default), Inactive, or Once. If set to Once, the job runs only once, at the next time the time settings match. If set to Active, the job runs each time the time settings match.
  7. Optional: you can override the following project properties. Settings you choose here are in affect only for this instance of the scheduled job.
    • Access: if specified, the scheduled job uses the indicated Access property.
    • Owner: if specified, the scheduled job runs as if manually launched by the indicated Owner.
    • Class: if specified, the scheduled job uses the indicated Class.
    • Environment: A copy of the environment in this field is made for this scheduled job, whether it is set explicitly or left at Project Default. If the environment is specified, you can also set starting values for the variables.
      Important: After the copy is made, changes to the original environment and its variables are not automatically updated in the copy of the environment made for the scheduled job. You can update the copy to reflect changes made to the original environment manually or automatically. For a manual update, click Resync Environment. For automatic updates, set Auto-Sync Environment to Yes. With automatic updates, the environment is updated every time the scheduled job runs. Be aware though that the Environment tab is only available for schedules that have Auto-Sync Environment set to No.
    • Selector: if specified, the job uses the specified selector.
  8. Specify the time settings. Fill in values for Minutes, Hours, Dates, Months, and Days. See Schedule parameters for the values to use.
  9. Click Save Schedule.

    The Next Run column displays Calculating, and then displays the next scheduled time that the job will run.

After the schedule is created, the schedule name appears in the calendar. An icon next to it displays its Mode. You can change the mode by clicking the icon. It changes each time it is clicked.

When a scheduled job attempts to run, the system checks the job queue, the Hard Run Limit system setting, and potentially the Run Limit property of the project. If one or more jobs of a project are already running when the schedule activates, the system behavior depends on the Hard Run Limit system setting, as explained in the following table.

Hard Run Limit value System checks Run Limit value? Systems launches job?
Yes Yes

Yes if the number of running jobs is less than the Run Limit value

No if the number of running jobs equals the Run Limit value

No No Yes
Note: Set the Run Limit value to 1 and Hard Run Limit to Yes to skip a run if the prior run has not completed.

Feedback