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
SYS_RESTART_POINT()
Return codes |
---|
Name of the restart point |
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.
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 |
---|---|
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 |