SYS_ACT_PARENT_NR

Activation Data

SYS_ACT_PREV_NAME

---

SYS_ACT_PARENT_TYPE

Script Function: Returns the object type of the superordinate task.

Syntax

SYS_ACT_PARENT_TYPE(Activation type)

Comments

This script function retrieves the object type of the superordinate task (parent). In the case of manual activation, this is "USER". 

If no activation type is specified, this script function retrieves 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, a workflow or a schedule. If so, the object type of this task is written in the activation protocol. If there is no superordinate task, the corresponding entry is made to the activation protocol.

:SET &TYPE# = SYS_ACT_PARENT_TYPE()
:IF &TYPE#  = " "
:   PRINT "No parent"
:ELSE
:   PRINT "Object type of parent is &TYPE#."
:ENDIF

The second example determines the Activator of a task. If it was activated  by a task, its object type is shown in the activation protocol. In the case of manual activation, the protocol shows the entry "Task was activated by USER".

:SET &TYPE# = SYS_ACT_PARENT_TYPE(ACT)
:PRINT "Task was activated by &TYPE#."

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

2004-01-28 11:19:26 - U0020408 Task was activated by API.

See also:

Script Elements - Activation Data

Object Types

About Scripts
Script Elements - Alphabetical Listing
Script Elements - Ordered by Function