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

GET_UC_OBJECT_NR

Script Function: Returns the RunID of an activated object

Syntax

GET_UC_OBJECT_NR(Object Name)

Syntax	Description/Format
Object Name	Name of an executable object Format: script literal or script variable

Return code
Run number of the activated object " " - The indicated object is not active

Comments

The script function GET_UC_OBJECT_NR may be used to retrieve the run number (RunID) of an object that belongs to the object class of executable objects.

If the object has been activated more than once, the oldest RunID is returned.

Example

The following example checks whether or not the task is active.

:SET &RunID = GET_UC_OBJECT_NR(&task#)

:IF &RunID = ""
: STOP MSG,50,"&task# is not active!"
:ENDIF

See also:

Script element	Description
GET_PARENT_NR	Returns the run number (RunID) of the superordinate task (Parent).
SYS_ACT_TOP_NR	Supplies the run number (RunID) of the top workflow

Script Elements - Activation Data

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