Purpose

Instructions to fork and to join orders to enable parallel processing in a workflow.
The Fork Instruction allows the creation of a number of parallel branches that process any further instructions and jobs.
- The max. number of parallel branches is limited to 15.
- Branches can include any number of instructions and jobs.
When an order enters a Fork Instruction then a child order is created for each branch . Each child order will pass the nodes in its branch independently of the other parallel child orders.
While child orders are running, the parent order waits for its child orders to be completed, i.e. to arrive at the Join Instruction. The parent order therefore is assigned the WAITING state, see JS7 - Order State Transitions.
- If a job in a child order's branch fails then the child order will be assigned a FAILED state. Such child orders require user intervention to resume, to suspend or to cancel child orders.

Workflow Instruction: Fork/Join

Download Workflow Example: pdwFork.json

Explanation:

The Fork Instruction is used here for two parallel branches, the names of the branches can be specified.
After the child orders for both branches have arrived with the Join Instruction then the parent order will continue with the next node.

Download Workflow Example: pwdForkNested.json

The Workflows View for the above workflow will display parallel child orders like this:

Explanation:

The Workflows View shows three levels of orders: the parent order sitting with the initial Fork Instruction and two levels of child orders passing their respective branches.
As soon as the inner child orders are completed then the outer level of parent orders continues and completes respectively.

This video explains how to create parallel jobs in a workflow that can be nested and joined.