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

SYS_ACT_ME_NR

Script Function: Returns the run number (RunIDShort for "run number". It is a number that provides unique information about a task's execution. The RunID can include 7 to 10 digits. It is assigned by the Automation Engine component .) of the own objectAutomation Engine controlled activities and processes are structured in the form of objects. See also: Task

Syntax

SYS_ACT_ME_NR()

Return code

Run number of the object in which this scriptA particular Automation Engine object type.functionPre-defined run book template in the Automation Engine. One single step only, e.g. Start Windows Service, Copy file,… is called.

Comments

In the case that the taskAn executable object that is running. Tasks are also referred to as activities. is restarted with the reference RunID, this script function supplies this reference RunID instead of the RunID of the execution. Always use SYS_ACT_RESTART_ME_NR to obtain the running number of the reactivated object.

Example

In this example, the RunID of a task is used in order to obtain parentThere are different ways of activating objects. The originator of an activation is referred to as the superordinate task (parent). See also: Child; Children information. If the task was started by a userIn the Automation Engine, a user is an instance of a User object, and generally the user is a specific person who works with Automic products. The User object is assigned a user ID and then a set of access rights to various parts of the Automation Engine system and product suite. These access rights come in the form of Automation Engine authorizations and privileges, Decision user roles and EventBase rights and ARA web application object rights. You can manage all these centrally in the ECC user management functions. See also, Unified user management., this user's name is printed in the activation reportA report provides more detailed information about a task's execution or a component.. If it was started by a task, the name of this task is printed.

:SET &RUNNR# = SYS_ACT_ME_NR() 
:
SET &PNAME# = GET_PARENT_NAME(, &RUNNR#, "ACT")
:
PRINT "Parent-Name: &PNAME#"

 

See also:

Script element Description

SYS_ACT_ME_NAME

Returns the name of the own object

SYS_ACT_ME_TYPE

Returns the object typeAn individual object is provided for the individual activities: There are User, UserGroup, Notification, Cockpit, CodeTable, Documentation, Event, Agent, FileTransfer, Group, Include, Job, Workflow, Calendar, Login, Client, RemoteTaskManager, Schedule, Script, Server, Sync, Variable and TimeZone objects of the own object

Script Elements - Activation Data

Sample Collection:
Retrieving Error Message and Number

About Scripts
Script Elements - Alphabetical Listing

Script Elements - Ordered by Function

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH