GET_PARENT_NAME

ScriptEigener Objekttyp in der Automation Engine Function: Returns the name of the superordinate task (ParentEin Objekt kann auf verschiedenste Arten aktiviert werden. Der Verursacher der Aktivierung wird als übergeordnete Aufgabe (Parent) bezeichnet. (siehe auch Child, Children))

Syntax

GET_PARENT_NAME(RunID, [Activation Type])

Syntax	Description/Format
RunID"Kurzform für ""laufende Nummer"". Hierbei handelt es sich genauer um eine Zahl, welche die Durchführung einer Aufgabe eindeutig kennzeichnet. Die RunID kann zwischen 7 und 10 Stellen aufweisen. Sie wird von der Komponente Automation Engine vergeben."	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 CallAPIProgrammierschnittstelle, die entweder direkt oder aus einem anderen Programm aufgerufen werden kann, und ein Script im Automation Engine-System ausführt. " " - 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#"

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)