Show TOC

Procedure documentationCreating Job Chains with Job Dependencies Locate this document in the navigation structure

 

Complex job dependencies can be implemented with job chains and other repository objects in an intuitive way.

The following different repository objects can be used to create dependencies:

  • Locks - Prevent two different jobs to run simultaneously.

  • Events - Jobs can raise and clear events as well as get submitted by events.

The following job chain features create dependencies:

  • Status Handlers - Job chain execution can be adapted at runtime by the use of status handlers.

  • Precondition function - Allow or disallow job execution based on the output of a function.

Procedure

Using Locks

Two independent job chains are not to run simultaneously and no job chain should be running twice simultaneously.

1. Creating a lock

  1. Choose   Definitions → Locks   in the Navigation bar.

  2. Choose New and fill in a name.

  3. Choose Save and Close.

2. Attaching the lock to the job chains

  1. Choose   Definitions → Job Chains  .

  2. From the context menu, choose Edit.

  3. Choose the job chain.

  4. Choose the Job Locks tab and choose New, choose the previously created lock.

  5. Choose Save and Close.

Events

  1. Create an event

    1. Choose   Definitions → Event Definitions   in the Navigation bar.

    2. Choose New and fill in a name.

    3. Choose Save and Close.

  2. Attach an event to be raised by the job chain.

    1. Choose   Definitions → Job Chains  

    2. From the context menu, choose Edit.

    3. Choose the job chain.

    4. Choose the Raise Events tab and choose New, choose the previously created event.

    5. Choose Save to save the job chain.

  3. Attach an event to submit the job chain.

    1. Choose   Definitions → Job Chains  

    2. From the context menu, choose Edit.

    3. Choose the job chain.

    4. Choose the Wait Events tab and choose New, choose the previously created event.

    5. Choose Save to save the job chain.

Status Handlers

A job chain with four steps should run step 4 only when one of the three previous steps failed and upon successful completion restart the job chain.

When step 4 fails an operator should be informed of the problem.

  1. Choose   Definitions → Job Chains  

  2. From the context menu, choose Edit.

  3. Under Error, choose GotoStep and step 4.

  4. Edit the second step in the same way.

  5. Choose the third Step, choose the Status Handler tab.

  6. Under Error, choose GotoStep and step 4.

  7. Under Completed, choose MarkCompleted.

  8. Choose the last Step.

  9. UnderCompleted, choose RestartChain.

  10. Under Error, choose RequestRestart.

  11. Choose Save to save the job chain.

Precondition Functions

The 1st step should only run on Mondays

  1. Choose   Definitions → Job Chains  

  2. From the context menu, choose Edit.

  3. Choose the first Step.

  4. Fill in an expression under Precondition.

  5. Choose Save to save the job chain.