SYS_ACT_PARENT_NAME

ScriptEigener Objekttyp in der Automation Engine Function: Supplies the name of a superordinate task.

Syntax

SYS_ACT_PARENT_NAME([Activation type])

Syntax

Description/Format

Activation type

Allowed values:

ACT = Activator
PRC = Processor (default value)


Return code

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

This script function supplies the name of a superordinate task (parent).In the case of 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.

In order to facilitate that the name of a group may be retrieved, "Generate at Runtime" (Attributes tab) must be activated in the task using this script function. Otherwise, the name can only be retrieved for jobs in post process.

Examples

The first example checks whether the task runs in a group, workflow or schedule. If so, the name of this task is written in the activation protocol. If there is no superordinate task, the corresponding entry is made in the activation protocol.

:SET &NAME# = SYS_ACT_PARENT_NAME()
:
IF &NAME# NE " "
:   
PRINT "Name of parent: &NAME#."
:
ELSE
:  
 PRINT "No parent"
:
ENDIF

The second example determines the Activator of a task whose name is output in the activation log. In the case of manual activation, the protocol shows the name and department of the particular user.

:SET &NAME# = SYS_ACT_PARENT_NAME(ACT)
:
PRINT "Task was activated by &NAME#."

The third example also serves to determine the Activator of a task. If it was activated through the CallAPI, the following line may be printed in the activation protocol:

2004-01-27 13:19:36 - U0020408 Task was activated by *SCRIPT.

See also:

Script element Description

SYS_ACT_PARENT_NR

Supplies 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.

SYS_ACT_PARENT_TYPE

Returns the object type of the superordinate task.

Script Elements - Activation Data

About Scripts
Script Elements - Alphabetical Listing

Script Elements - Ordered by function