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

SYS_RESTART_POINT

Script Function: Supplies the restartA restart refers to the repetition of an object's execution. This action differs from a new start in some parts. point from which the objectAutomation Engine controlled activities and processes are structured in the form of objects. See also: Task will be executed

Syntax

SYS_RESTART_POINT()

Return codes

Name of the restart point
" " - The scriptA particular Automation Engine object type. is not executed from a particular restart point or generally not in restart mode.

Comments

This script functionPre-defined run book template in the Automation Engine. One single step only, e.g. Start Windows Service, Copy file,… retrieves the restart point from which the script should  be processed when a taskAn executable object that is running. Tasks are also referred to as activities. was started with Execute..., thereby having specified a restart point.

Restart points are set using the script element :RESTART.

Example

In the following example, files are copied from the AE directory. When the jobAn Automation Engine object type for a process that runs on a target system. is restarted with "DB" being indicated as restart point, only files from the databaseA database is an organized collection of data including relevant data structures. directory (including all sub-directories) will be copied. A corresponding message is written in the activation reportA report provides more detailed information about a task's execution or a component..

:RESTART BIN, "Program directory"  
COPY C:\AEG\BIN\*.* C:\BACKUP\AEG\BIN\*.* /Y

:
INC DOS.ERRORLEVEL

:
RESTART DB, "Database directory"  
XCOPY C:\AEG\DB\*.* C:\BACKUP\AEG\DB\*.* /E /Y

:
INC DOS.ERRORLEVEL

:
SET &RET# = SYS_RESTART_POINT()
:
PRINT "Script was processed from &RET# on."

 

See also:

Script element Description

:RESTART

This is used to set restart points in an executable object.
RESTART_UC_OBJECT Repeats the execution of a task.
SYS_ACT_RESTART Determines if the object was 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 activated in restart mode.
SYS_LAST_RESTART_POINT Supplies the name of the previous restart point in the script.
SYS_LAST_RESTART_TEXT Supplies the text of the previous restart point as defined in the script.

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