---
agentTools:
  projectIndex: https://sb-biodatacatalyst.readme.io/llms.txt
---

# List of execution hints

[block:parameters]
{
  "data": {
    "h-0": "Hint name",
    "h-1": "Workflow level",
    "h-2": "Node level",
    "h-3": "Tool level",
    "h-4": "Default",
    "h-5": "Notes",
    "h-6": "See also",
    "0-0": "`sbg:CPURequirement`<sup>1</sup>\nAllocates this many CPU cores for the execution of the tool.",
    "1-2": ":no-entry-sign:",
    "0-3": ":white-check-mark:",
    "2-4": "Decided by the scheduling algorithm",
    "2-5": ":warning: The task will fail if the resources available on the instance are insufficient for any tool in the workflow.",
    "0-2": ":no-entry-sign:",
    "0-1": ":no-entry-sign:",
    "0-4": "1",
    "0-5": "Accepts dynamic expressions",
    "0-6": "[Tool resource requirements](https://sb-biodatacatalyst.readme.io/docs/about-tool-resource-requirements)",
    "1-1": ":no-entry-sign:",
    "1-3": ":white-check-mark:",
    "2-1": ":white-check-mark:",
    "2-2": ":white-check-mark:",
    "2-3": ":white-check-mark:",
    "3-1": ":white-check-mark:",
    "4-3": ":white-check-mark:",
    "3-2": ":no-entry-sign:",
    "3-3": ":no-entry-sign:",
    "4-1": ":no-entry-sign:",
    "4-2": ":no-entry-sign:",
    "3-5": ":warning:  If a step is an inner workflow, its `sbg:maxNumberOfParallelInstances` will be overridden with the value from the outer workflow, even if it has not been set explicitly (*i.e.* the default value takes precedence).",
    "1-5": "Accepts dynamic expressions",
    "1-4": "1024 [MB]",
    "3-4": "1",
    "4-4": "file name",
    "1-0": "`sbg:MemRequirement`<sup>1</sup>\nAllocates this much MB of RAM for the execution of the tool.",
    "2-0": "`sbg:AWSInstanceType`\nConfigures the type of all the AWS instances provisioned for this workflow/node/tool.\nPriority: \n*workflow > node > tool*",
    "3-0": "`sbg:maxNumberOfParallelInstances`\nSets the maximum number of instances that can run in parallel for workflow execution.",
    "4-0": "`sbg:SaveLogs`\nConfigures the additional files to preserve as logs inside the project",
    "1-6": "[Tool resource requirements](https://sb-biodatacatalyst.readme.io/docs/about-tool-resource-requirements)",
    "2-6": "[Available AWS instances](https://sb-biodatacatalyst.readme.io/docs/list-of-available-amazon-web-services-instances)",
    "4-5": "Accepts dynamic expressions"
  },
  "cols": 7,
  "rows": 5
}
[/block]

<sup>1</sup> The hints prefixed with **sbg:** are specific for the Seven Bridges execution environment. CWL 1.0 introduces **coresMin** / **coresMax** (minimum and maximum number of CPU cores) and **ramMin** / **ramMax** (minimum and maximum amount of RAM) in [resource requirements](http://www.commonwl.org/v1.0/CommandLineTool.html#ResourceRequirement), which can be found on any level (**Workflow**, **Step**, **Tool**). If your CWL 1.0 app description contains only the **-Min** or the **-Max** value, the Seven Bridges execution environment will use the specified value as the number of cores or amount of RAM required for execution. If both the **-Min** and the **-Max** value are specified, the execution will ignore the **-Max** value and provide enough resources to accommodate the **-Min** requirement, in order to provide consistency in execution of apps described using either sbg:draft-2 or 1.0 version of CWL. Finally, if **sbg:CPURequirement** or **sbg:MemRequirement** are evaluated along with the corresponding CWL 1.0 **-Min** requirements (**coresMin** or **ramMin**), the execution will use the higher of these two values as the required number of cores or amount of RAM.

Disk space requirements introduced in CWL 1.0 (**tmpdirMin** / **tmpdirMax** and **outdirMin** / **outdirMax**) are unfortunately not currently supported by BioData Catalyst powered by Seven Bridges.