Job reference step

To call another saved Job, create a Job Reference step. Enter the name of the Job and its group.

The Job Reference form provides a Job browser to make it easier to select from the existing set of saved Jobs. Click the “Choose A Job…” link and navigate to the desired Job.

Finally, if the Job defines Options, you can specify them in the commandline arguments text field and can include variable expansion to pass any input options for the current job. Format:

-optname <value> -optname <value> ...

The format for specifying options is exactly the same as you would pass to the run commandline tool, and you can substitute values of input options to the current job. For example:

-opt1 something -opt2 ${option.opt2}

This would set the value “something” for the Job’s “opt1” option, and then pass the “opt2” option directly from the top-level job to the Job reference.

This is similar to calling the other Job with [run]:

run [filter-options] -j group/jobname -- -opt1 something -opt2 somethingelse

If the Job has required Options that are not specified on the arguments line, then a “defaultValue” of that option will be used if it is defined. If a required option does not have a default value, then the execution will fail because the option is not specified.

Job References can be run as either Node Steps or Workflow Steps (see Workflow Steps : Types of Steps). When you choose to use a Job Reference as a Node Step, you can use the Node context variables within the arguments string to the Job.

Overriding Node Filters

You can override the Node Filters used in the referenced Job. Click the “Override Node Filters?” button to expand the Node Filter area.

Enter a new filter in the “Node Filter” input field to preview the matched nodes.

Once you enter a new filter, you can modify the other aspects for the Node Dispatching used by the Job Reference:

• Thread Count
• Node failure behavior
• Node Rank attribute
• Node Rank order