GET_PARENT_NR

ScriptEigener Objekttyp in der Automation Engine Function: Returns the run number (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.") 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_NR(RunID, [Activation Type])

Syntax

Description/Format

RunID

RUN number of the current task

Activation Type

Allowed values:

ACT = Activator
PRC = Processor (Default)


Return codes

RunID of the superordinate task
Session ID for manual activation (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 the name of the User object (e.g. SMITH/DEV).

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 then its Activator.

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

See also:

Script element Description

GET_PARENT_NAME

Returns the name 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