Prerequisite Elements

Prerequisite Elements must be completed before a Job can execute. A Job or folder can have an unlimited number of Prerequisite Elements. JAMS Jobs on any server in a given environment can serve as a prerequisite for other Jobs in JAMS by using the Job Dependency or Remote Job Dependency Elements. Any elements set on a Folder will be inherited by that folder's child objects.

Users may also create their own user-defined Dependencies through the use of Pre-Check Jobs. User-defined Dependencies add the ability to handle any type of pre-processing needs.

Adding a Prerequisite Element to a Job or Folder

  1. Open the Definition dialog for the Job or Folder where the Prerequisite Element will be defined.
    NOTE: You can right-click either a Folder or Job and select Properties from the drop-down list to open the Definition dialog.
  2. Select the Elements tab, then click the Add button. The Add Element dialog will appear.
  3. Expand the Prerequisite category to reveal the Prerequisite Elements.
  4. Select the relevant Element and click Next.
  5. Define the available properties for the given Prerequisite Element, then click Finish.
  6. Save and Close the Definition dialog.

Modify an existing Prerequisite Element

  1. Open the Definition dialog for the desired Job or Folder where the Prerequisite Element resides.
    NOTE: You can right-click either a Folder or Job and select Properties from the drop-down list to open the Definition dialog.
  2. Select the Elements tab, then double-click the desired Prerequisite Element to open the Prerequisite Properties dialog.
  3. Modify the properties as desired, then click Save and Close on the Prerequisite Properties dialog.
  4. Save and close the Definition dialog.

Prerequisite Element Properties

Each prerequisite element has a list of associated properties used to define how the prerequisite will be satisfied. Reference the tables below for a description of the properties available on each prerequisite.

Date Specific Dependency

Depends On Description
Depends on Job The Job that this element depends on.
Wait For All If there is more than one instance of the Depends On Job, should we wait for all of them to complete before satisfying the dependency?
Completion Severity The Depends on Job must meet or exceed this completion severity to satisfy the dependency.
Depend on Date A natural language date specification for the date that the depends-on job must have been scheduled to run.
Status Description
Enabled This can be used to enable or disable a Job, Element, or Event Handler.

File Dependency

File Watch Description
Credentials Select a set of Credentials for this element. The credentials must have access to the file location.
File Name The file specification to watch for. Wildcards are allowed.
File Presence Option Specifies if the file must be present, absent, or available.
Minimum Size Used to specify a minimum acceptable size for the file.
Agent Used to specify the Agent where the file watch will be performed.
Status Description
Enabled This can be used to enable or disable a Job, Element, or Event Handler.

Job Dependency

Depends On Description
Depends on Job The Job that this element depends on.
Wait For All If there is more than one instance of the Depends On Job, should we wait for all of them to complete before satisfying the dependency?
Completion Severity The Depends on Job must meet or exceed this completion severity to satisfy the dependency.
Status Description
Enabled This can be used to enable or disable a Job, Element, or Event Handler.
Since Description
Since Severity The Since Job must have last completed with a severity that meets or exceeds the severity set here to satisfy the dependency.
Since Job The completion of this Job defines how far back we look for the completion of the Depends On Job.
Within Time Users may enter a delta time to define how recently the Depends On Job must have completed in order to satisfy the dependency.

Precheck Job

Prerequisite Description
Precheck Job Specifies a Job which is executed before this Job is allowed to start.
Precheck Interval The delay between executions of the Precheck Job
Status Description
Enabled This can be used to enable or disable a Job, Element, or Event Handler.

Remote Job Dependency

Depends On Description
Completion Severity The Depends on Job must meet or exceed this completion severity to satisfy the dependency.
Remote Job Name The name of the Remote Job
Remote Scheduler The name of the Remote Scheduler where the Job resides.
Status Description
Enabled This can be used to enable or disable a Job, Element, or Event Handler.
Since Description
Since Severity The Since Job must have last completed with a severity that meets or exceeds the severity set here to satisfy the dependency.
Since Job The completion of this Job defines how far back we look for the completion of the Depends On Job.
Within Time Users may enter a delta time to define how recently the Depends On Job must have completed in order to satisfy the dependency.

Resource Requirement

General Description
Quantity Required The resource quantity required to satisfy the dependency.
Resource The resource associated with this definition

Variable Dependency

Condition Description
Compare Condition Specifies the logical comparison that should be performed.
Compare Value Specifies the value used in the condition comparison.
Status Description
Enabled This can be used to enable or disable a Job, Element, or Event Handler.
Value Description
Variable A JAMS Variable that contains the default value.

Time Window

General Description
Missed Window Action The action taken when the Schedule Window is missed.
Schedule From Time The start of the Job's scheduled time window.
Schedule To Time The end of the Job's scheduled time window.
Schedule Window A flexible window of time where Jobs may be scheduled to run.
Notify Description
Notify Event Class Select the event class that this event will generate when it occurs.
Notify Of Missed Window Determines whether a notification will be performed if this Job misses its schedule window.
Level This level can be used by event handlers to classify events.
Message A message that will be passed to event handlers when this event is generated.