GET_UC_OBJECT_NR
Use the GET_UC_OBJECT_NR script function to retrieve the RunID of a currently activate executable object.
Syntax
GET_UC_OBJECT_NR (Object Name)
Parameter
-
GET_UC_OBJECT_NR
Retrieves the RunID of an activated object -
Object Name
Name of the executable object
Format: script literal or script variable
Return Codes
The script function returns the following codes:
- RunID of the object
Note: If the object has been activated more than once, the function returns the oldest RunID. - A blank if the object is not active
Example
The following example uses the GET_UC_OBJECT_NR function to check whether or not the task is active. If the task is inactive, the function returns a blank and the script sends an error message.
:SET &RunID = GET_UC_OBJECT_NR(&task#)
:IF &RunID = ""
: STOP MSG,50,"&task#
is not active!"
:ENDIF
See also: