Categories:

System Functions (System Information)

SYSTEM$GET_PREDECESSOR_RETURN_VALUE

Retrieves the return value for the predecessor task in a DAG of tasks. The return value is explicitly set by the predecessor task by calling the SYSTEM$SET_RETURN_VALUE function.

Syntax

SYSTEM$GET_PREDECESSOR_RETURN_VALUE('<task_name>')
Copy

Arguments

'task_name'

Identifier for the predecessor task that sets the return value to be retrieved.

  • If the task has multiple predecessor tasks that are enabled, this argument is required.

  • If the task has only one predecessor task that is enabled, the argument is optional. If this argument is omitted, the function retrieves the return value for the only enabled predecessor task.

  • If the immediate predecessor task name does not match the requested task name, but an ancestor predecessor does match the task name, the return value of the matching ancestor is returned.

Usage Notes

  • Task names are case sensitive.

  • When a task name is specified, it must match an enabled predecessor, otherwise the call will fail.

Examples

See complete examples for this function in SYSTEM$SET_RETURN_VALUE.