Exclusion Period Properties

Version Compatibility: Server version 5.0 or later Console version 5.0 or later.

An Exclusion Period defines a time period when jobs are not permitted to run. The Exclusion Period Properties window contains the settings for an Exclusion Period.

Property Pages

Schedule

The Schedule page contains basic settings for the Exclusion Period.

Name

The name of the Exclusion Period. The name must be unique.

Enable this Exclusion Period

Check to enable the Exclusion Period. If the Exclusion Period is not enabled (box unchecked) the Exclusion Period is ignored and does not affect job execution.

Date Selection

There are two options for specifying the days that the Exclusion Period applies to:

• Applies every __ days. The Exclusion Period applies on the beginning date you specify and every n days afterward (where n is the interval you have specified).
• Applies on specific days. When you select this option you have complete flexibility to define as many specific dates or rules as you wish. Use the list to add, edit, or remove Date Rules that specify the days on which the Exclusion Period applies.

Time Selection

Specify the Start Time and End Time for the Exclusion Period. The start time and end time are both included in the range. For example if the time range is 11:00pm to 11:30pm, jobs will stop being triggered after 11:29 and will resume at 11:31.

The same time period applies each day defined in the Date Selection section. If you want to use different time periods for different days, you need to define separate Exclusion Periods for each date/time combination.

If the End Time is earlier than the Start Time, the range wraps to the next day. For example, if the Start Time is 11:30pm and and the End Time is 12:30am, the Exclusion Period starts at 11:30pm on each day defined in the Date Selection section and goes until 12:30am the next day (regardless of whether the next day matches the Date Selection rules).

Show matching dates and times

Click Show matching dates and times to open a window where you can get a list of all dates and times that match the Exclusion Period for a certain time range. Use this to confirm that your settings produce the expected results.

Rules

The Rules page contains settings that determine which execution types the Exclusion Period applies to. For example, you may choose to have the Exclusion Period affect scheduled executions (Schedule Triggers) but not affect other types of execution.

The following options are available:

• Apply to Schedule Triggers. The Exclusion Period applies to scheduled execution using Scheduled Triggers. The Exclusion Period will be factored in when calculating runtimes for affected jobs, so jobs will not be scheduled during the Exclusion Period.
• Apply to other triggers (except Job Triggers). The Exclusion Period applies to all triggers other than Schedule Triggers and Job Triggers. Jobs will still be triggered during the Exclusion Period but will remain in "Waiting for Exclusion Period" status until the Exclusion Period ends.
• Apply to chained execution (Responses and Job Triggers). The Exclusion Period applies to execution chains, where jobs are linked together by Job Control Actions and Job Triggers. Jobs will still be triggered during the Exclusion Period but will remain in "Waiting for Exclusion Period" status until the Exclusion Period ends.
• Apply to manual (on-demand) execution. The Exclusion Period applies when jobs are submitted for execution on demand (e.g., through the Execute Job command in the Console or using the command-line utility adtexec). If jobs are submitted during an Exclusion Period they will remain in "Waiting for Exclusion Period" status until the Exclusion Period ends.

Notes

Optionally enter documentation or notes for the Exclusion Period.

Security

The Security page is used to view or modify the security settings for this object. See the Security Editor topic for more information on editing security settings.

The following permissions apply to Exclusion Periods:

Permission	Description
Full Control	Permission to perform all actions on the Exclusion Period.
List/Use	Permission to use the Exclusion Period.
View	Permission to view the properties of the Exclusion Period.
Modify	Permission to modify the properties of the Exclusion Period.
Delete	Permission to delete the Exclusion Period.
Administer security	Permission to change the security settings for the Exclusion Period.
Change owner	Permission to take ownership of the Exclusion Period.

Permission to create new Exclusion Periods is controlled through the Exclusion Periods window.