Automation Engine Script Guide > Ordered by Function > Activation Data > GET_PARENT_TYPE

GET_PARENT_TYPE

Script Function: Returns the object type of the superordinate task (Parent)

Syntax

GET_PARENT_TYPE(RunID, [Activation Type])

Syntax	Description/Format
RunID	Run number of the current task
Activation Type	Allowed values: ACT = Activator PRC = Processor (Default value)

Return codes
Object type of the superordinate task "USER" - With manual activation (only for activation type ACT) "API" - With activation via CallAPI (only for activation type ACT) " " - There is no superordinate task (only for activation type PRC)

Comments

With this script function, the name of the superordinate task of an object that is part of the object class of executable objects is retrieved. With manual activation, this is "USER".

If no activation type is specified, the script function retrieves the processor.

If the RunID of a group should be retrieved, "Generate at Runtime" (in the Attributes tab) must be activated in the task using this script function. Otherwise, the RunID can only be retrieved only for jobs in post process.

Example

The following example retrieves the running number of a task and subsequently the object type of its Activator.

:SET &RunID = GET_UC_OBJECT_NR(MAWI.END.PROCESSING)
:SET &RET# = GET_PARENT_TYPE(&RunID, ACT)
:PRINT "The type of the superordinate task is: &RET#"

Script element	Description
GET_PARENT_NAME	Returns the name of the superordinate task (Parent)
GET_PARENT_NR	Returns the run number (RunID) of the superordinate task (Parent)