Go Sub

The GoSub action task transfers the execution of the calling process to the specified subprocess (see About processes and subprocesses). When a process encounters a GoSub action, it halts its own execution, start the subprocess and waits for it to complete before resuming its workflow with the next task.

Information can be passed from a process to a subprocess by setting the value of runtime parameters in the Go Sub task. The list of runtime parameters is filled with the list of local variables found in the selected subprocess.

While it is possible to place a GoSub action within a subprocess, doing so will hide the subprocess from any GoSub action, in order to avoid circular referencing (aka an infinite loop).

Task properties

General Tab
  • Subprocess: Drop down list containing all the available subprocesses in the current configuration.
  • Runtime Parameters: The local variables defined in the selected subprocess are displayed as runtime parameters, and their values can be set here. Right-click the field to open the contextual menu that allows to select variables, data and lookup functions (see Data selections). Clicking the button 'Use default value for selected item' resets the value to the default value of the variable defined under the subprocess.
  • Backup job file: Select if you want to use identical copies of the job file for the main process and the subprocess.
  • Backup job information: Select if you want to use identical copies of the job file information for the main process and subprocess. Once the subprocess completes its execution, the main process will retrieve the original job information values.
  • Backup emulation: Select if you want to use the emulation selected when the job file reaches the subprocess for the main process as well. Note that the emulation is not passed from a main process to a subprocess or vice versa.
  • Retrieve subprocess error: Select if you want to receive error(s) from the subprocess in order to handle them on its own.

On Error Tab

For a description of the options on the On Error tab see Using the On Error tab.

Miscellaneous Tab

The Miscellaneous tab is common to all tasks.

It contains a text area (Task comments) that lets you write comments about the task. These comments are saved when the dialog is closed with the OK button and are displayed in The Task Comments Pane.

Check the option Use as step description to display the text next to the icon of the plugin in the Process area.

The tab also provides an option to highlight the task in The Process area with the default color, set in the Preferences (see Colors), or the color selected or defined under Highlight color on this tab.
To revert the selected highlight color to the default color, open this tab, turn the Highlight option off and close the dialog with the OK button; then turn highlighting back on.
Highlighting can also be turned on and off via the task's contextual menu and with the Highlight button on the View ribbon.