GET_PARENT_NAME

Use the GET_PARENT_NAME script function to retrieve the processor or activator of a task, including if the task was activated via a CallAPI. The task can be any type of executable object. For more information about processors and activators, see Superordinate Tasks (Parents).

Tip: Use SYS_ACT_PARENT_NAME to retrieve the object name of the processor or activator of the current task (the task that contains the script function). For more information, see SYS_ACT_PARENT_NAME.

Syntax

GET_PARENT_NAME(RunID[, ACT|PRC])

GET_PARENT_NAME([ACT|PRC])

Parameters

Return Codes

The script function has the following return codes:

Example

The following script retrieves and uses the RunID of a task called MAWI.END.PROCESSING to return information about the activator of the task.

:SET &RunID# = GET_UC_OBJECT_NR(MAWI.END.PROCESSING)
:
SET &RET# = GET_PARENT_NAME(&RunID#, ACT)
:
PRINT "The task was activated by &RET#"

If the task was activated by a parent Workflow called JOBP.MM.PROCESSING, the output in the activation report would look as follows:

2018-11-06 15:26:01 - U00020408 The task was activated by JOBP.MM.PROCESSING

If a user called Smith from the DEV department manually executed the task, the output would show the user name:

2018-11-06 15:26:01 - U00020408 The task was activated by SMITH/DEV

See also:

seealso

Script Elements for Workflows and Tasks in Workflows