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

SYS_ACT_PREV_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 a previous taskAn executable object that is running. Tasks are also referred to as activities. in a workflowAn object of the Automation Engine that can include several executable objects and which runs them in a specified order. [Formerly called "ProcessFlow" and "JobPlan."].

Syntax

SYS_ACT_PREV_NR()

Return codes

RunID of the preceding task
"0" - The task is the first one in the workflow as its predecessor is the starting point.

Comments

Only tasks running in workflows must contain 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,….

Only use this script function if there is exactly one previous task. If there is more than one predecessor, a runtimeThe duration of a task's execution. It refers to the period between a task's start and end. It does not include its activation period (see also: activation and start). error occurs and the script is aborted.

Example

The activation reportA report provides more detailed information about a task's execution or a component. shows the run number (RunID) of the previous task in a workflow.

:SET &NR# = SYS_ACT_PREV_NR()
:
PRINT "RunID of the previous task is &NR#."

 

See also:

Script element Description

SYS_ACT_PREV_NAME

Returns the name of the previous jobAn Automation Engine object type for a process that runs on a target system. in a workflow.

Script Elements - Activation Data

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