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 . 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.
To place a project in the scheduler, do the following:
- Click Schedules in the left menu.
- Click Add Scheduled Run.
- Enter a description for the schedule entry in Description.
- Select a project from the Project list.
- 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.
- 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.
- 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.
- Specify the time settings. Fill in values for Minutes, Hours,
Dates, Months, and Days. See Schedule parameters for
the values to use.
- 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.
- Green circle: Active
- Blue circle: Once
- Red circle: Inactive
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.