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