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

GET_PARENT_NAME

Script Function: Returns the name of the superordinate task (Parent)

Syntax

GET_PARENT_NAME(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

Name of the superordinate task
"*SCRIPT" - The task has been activated via a CallAPI
" " - 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 executable objects may be retrieved. With manual activation, this is the name of the User object (e.g. SMITH/DEV).

If no activation type is indicated, this script function supplies the processor.

If the name of a group is to be retrieved, "Generate at Runtime" (in the Attributes tab) must be activated in the task that is used with this script function. Otherwise, the name can only be retrieved for jobs in post script.

Example

The following example retrieves the running number of a task and then its Activator.

:SET &RunID = GET_UC_OBJECT_NR(MM.END.PROCESSING)
:
SET &RET# = GET_PARENT_NAME(&RunID, ACT)
:
PRINT "The name of the superordinate task is: &RET#"

 

See also:

Script element Description

GET_PARENT_NR

Returns the run number (RunID) of the superordinate task (Parent)

GET_PARENT_TYPE

Returns the object type of the superordinate task (Parent)

Script Elements - Activation Data

About Scripts
Script Elements - Alphabetical Listing

Script Elements - Ordered by function