Specify dependencies on a job array

About this task

When you draw a dependency line from a job array to another work item in the flow definition, the dependency you create is the default: the work item cannot run until all of the jobs in the job array complete successfully.

You can specify the type of dependency to be one of the following:

  • All jobs in the job array complete successfully—this is the default
  • All jobs in the job array end, regardless of success or failure
  • The sum of the exit codes of all the jobs in the job array has a value
  • A specified number of jobs in the job array complete successfully
  • A specified number of jobs in the job array fail
  • A specified number of jobs in the job array end regardless of success or failure
  • A specified number of jobs in the job array have started
  • Any job fails
  • The job array is submitted
  • The job array runs longer than it should
  • The job array runs an abnormally short length of time
  • The job array fails to start
  • The job array cannot run
  • The job array misses its scheduled start time

Procedure

  1. Draw both the predecessor job array and the work item that succeeds it.
  2. Change to job dependency mode by clicking the Insert Dependency button.
  3. Draw a dependency line from the job array to the work item that depends on the array.
  4. To change the type of dependency, right-click on the dependency line and select Open Definition. The Event Definition dialog box appears.
  5. In the Event type field, select Trigger the next work item, then the type of dependency you want to use to trigger the successor job, and the appropriate operator and value if applicable. See the examples that follow for some of the job array dependencies you can use.
  6. In the Description field, add any descriptive text that may be helpful for understanding this event. For example, if this event requires special instructions for operations staff, place those instructions here.
  7. Click OK.

Examples

All jobs in the array end, regardless of success or failure

Sum of the exit codes is...

Number of successful jobs is...

Number of failed jobs is...

Number of jobs started is...