Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • The ForkList Instruction is the dynamic version of the JS7 - Fork-Join Instruction. Use of the ForkList Instruction with a JS7 - Agent Cluster is subject to the terms for clustering with the JS7 - License.
  • Technically it implements the Fork/Join operation, however, it allows a number of child orders and branches to be created dynamically in order to execute the same sequence of jobs on a number of Subagents: users can run the same jobs in parallel on a number of servers or containers operating Subagents. Use cases include for example to execute similar backup jobs on a larger number of servers.
    • The ForkList Instruction expects a Subagent Cluster to be assigned that can include any number of Subagents running on the same or different server nodes that execute the same jobs, for example for backup purposes on a larger number of servers.
    • The ForkList Instruction is designed as a single branch when configuring the workflow with the Configuration View of the JOC Cockpit user interface. Depending on the number of Subagents provided with the assigned Subagent Cluster the Controller will dynamically create branches for each Subagent.
  • 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.
  • A variant of this instruction is available with the JS7 - ForkList-Join Instruction for variable sets.

...

Workflow Instruction: ForkList

Static Assignment of Subagent Cluster

Download example (upload .json): pdfAgentClusterForkList.workflow.json

The workflow editor is used to add a ForkList Instruction as shown:

  • The ForkList Instruction is assigned a Subagent Cluster.
  • The ForkList Instruction includes a number of jobs that should be executed in parallel on all Subagents of the given Subagent Cluster.

Image Added


Explanation: StatuscolourYellowtitleTBD

  • The ForkList Instruction is assigned the Subagent Cluster active-active-all-agents from the AgentCluster001 cluster.
  • The jobs inside the ForkList Instruction are executed in parallel on all Subagents included with the active-active-all-agents Subagent Cluster.
    • Users are free to exempt individual jobs from being executed on Subagents of the cluster an instead to be executed for example on Standalone Agents. 


Individual jobs inside the ForkList Instruction are assigned Subagents like this:

  • The Subagent Expression radio button is selected and the same AgentCluster001 cluster as for the ForkList Instruction is selected.

Image Added


Explanation:

  • If the Subagent Cluster is modified later on to include fewer or more Subagents then this will be considered without modification of the workflow.

Error Handling

The same error handling applies as for the JS7 - ForkList-Join Instruction.

...