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

SYS_ACT_RESTART_COUNT

Script functionPre-defined run book template in the Automation Engine. One single step only, e.g. Start Windows Service, Copy file,…: Supplies the number of restarts that were made for 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."] tasks using the actionActions are predefined building blocks for recurring activities. They are commonly used for managing third party systems or in deployment scenarios. RESTART TASK (Postconditions).

Syntax

SYS_ACT_RESTART_COUNT()

Return code

Number of restarts

Comments

This scriptA particular Automation Engine object type. element retrieves the number of times a taskAn executable object that is running. Tasks are also referred to as activities. has already been restarted within a workflow using the action RESTART TASK. You can define this action in the task properties of the Postconditions tab.

This value can also be retrieved using the predefined variableIt stores or retrieves values dynamically at runtime. An individual Automation Engine object type. &$RESTART_COUNT#.

Example

The following example queries the number of times that the workflow task has been restarted and writes the corresponding information to the activation reportA report provides more detailed information about a task's execution or a component..

:SET &RCOUNT# = SYS_ACT_RESTART_COUNT()
:
IF &RCOUNT# = 0
:
PRINT "The task has not yet been restarted."
:
ELSE
:
PRINT "Number of restarts: &RCOUNT#"
:
ENDIF

 

See also:

Script Element Description

:RESTART

Sets restartA restart refers to the repetition of an object's execution. This action differs from a new start in some parts. points in an executable objectAutomation Engine controlled activities and processes are structured in the form of objects. See also: Task.

SYS_ACT_RESTART

Retrieves whether the object has been activated in restart mode.

SYS_ACT_RESTART_ME_NR 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 an object that has been activated in restart mode.

 


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

Copyright © 2016 Automic Software GmbH